Tutorial: Setting up SMS sending

Serverless Authentication Setting up SMS sending

Some authentication-related functions may need sending SMS to users, when invoking the "phone" identity provider: Webcom.addAccount(), Webcom.sendOtp(), Webcom.sendVerificationCode().

Currently [[service]] may interface with two implementations for sending SMS (both provided by Orange services), which require to be set up in the [[console]]: paddock (for Orange customers only) and Contact Every One (or CEO).

In both cases, the first step is to request an account or application to the provider of the chosen SMS sending service. This step is out of the scope of the [[service]] service.

The second step is then to set up the credentials associated to your account or application at the chosen SMS sending service within the [[console]]. This step is specific to each service:

Setting up Paddock

  1. Log in the Orange Developer Inside portal, then click on the button "My apps" and select the application where you have subscribed the paddock service, called "SMS MT [INTERNET] Orange MSISDN", or create a new one and subscribe to the "SMS MT [INTERNET] Orange MSISDN" API.
    WARNING: You must ask for the INTERNET access to this API by sending an email to smsapi.support@orange.com (by default, the ODI portal only grants access from the intranet).

  2. In the "Details" section (top of the page), click on the "Show" button. Copy the displayed "Authorization header" field.

  3. Back to the [[console]], open the "authentication" tab within your [[service]] application.

  4. Check that the "phone" authentication mode is enabled (first top-left card) and go to the "phone" opened card.

  5. Open the "senders" section (if not already opened) and paste the previously copied "Authorization header" into the "paddock/credentials" field. Remove the "Basic " (including space) prefix of the pasted credentials and click on the "save" button.

Setting up CEO

  1. Open the network tab of the development tools of your web browser ("F12" key on most popular browsers) and log in the Contact Every One portal.

  2. Spot the HTTP request on https://contact-everyone.orange-business.com/api/web/groups?ids=XXXXX and copy the XXXXX identifier. If you don't want to use your default CEO group, select the good one and spot the HTTP request again.

  3. Back to the [[console]], open the "authentication" tab within your [[service]] application.

  4. Check that the "phone" authentication mode is enabled (first top-left card) and go to the "phone" opened card.

  5. Open the "senders" section (if not already opened) and paste the previously copied XXXXX identifier into the "ceo/groupId" field. Fill in the "ceo/username" and "ceo/password" fields with your CEO identifier and password and click on the "save" button.

↑ ↑