All Products
Search
Document Center

Identity as a Service:Configure an SMS gateway

Last Updated:Mar 31, 2026

IDaaS includes a built-in SMS channel, but it is intended for testing only and enforces low sending quotas. To support SMS login, secondary authentication, and password recovery in production, configure a custom SMS gateway — either your own or one provided by Alibaba Cloud Short Message Service (SMS).

Prerequisites

Before you begin, make sure you have:

  • An active IDaaS instance with CIAM enabled

  • The API endpoint URL, account ID, and account password from your SMS service provider

  • The SMS signature (the text prefix that appears before each message body, for example, 【Cloud IDaaS Platform】)

Configure an SMS gateway

  1. Log on to the IDaaS console. In the navigation pane on the left, select CIAM, select the target IDaaS instance, and click Manage in the Actions column.

  2. In the left menu, click Branding > Gateway Service.

  3. Select the tab for your SMS service provider. The following example uses China Mobile.

  4. Fill in the gateway parameters.

    ParameterDescriptionExample value
    Gateway nameA display name for this SMS gateway configurationCIAM
    Gateway numberThe SMS gateway number assigned by your provider (optional)
    SMS URLThe API endpoint provided by your SMS service providerhttps:/*********/msg/send
    API accountThe account ID provided by your SMS service providerIDaaS_SSO
    API passwordThe account password provided by your SMS service provider********
    SMS titleThe signature prefix displayed before each SMS message body【Cloud IDaaS Platform】
    API extension fieldAny additional parameters required by your SMS service provider (optional)
    Gateway descriptionA description for this gateway configuration (optional)
    Enable SMS gatewayClick the button to enable this gateway
    Test SMS contentThe message body to use when sending a test SMS
    Send test messageThe phone number to receive the test SMS
  5. Click Save.

Verify the configuration

After saving, send a test message to confirm the gateway is working:

  1. In the Test SMS content field, enter a short test message.

  2. In the Send test message field, enter a phone number you can access.

  3. Check that the phone receives the message with the correct signature prefix.

If the test message does not arrive, check the following:

  • SMS URL — confirm it is the correct API endpoint from your provider.

  • API account and API password — confirm they match the credentials issued by your provider.

  • Enable SMS gateway — confirm the button is enabled.