Vonage Provider custom configuration (Tutorial)

Configure a SMS with Vonage Provider to ensure every user can login securely.

Before you begin

Role required: adaptive_auth_admin

Procedure

1. Navigate to All > System Web Services > Outbound > REST Message and perform the REST message configuration based on the information from Vonage API Dashboard.

   [Omitted image "vonage-dashboard.png"] Alt text: Vonage API Dashboard

2. Click New to create a new REST Message.

3. Provide a Name and Endpoint.

   [Omitted image "vonage-rest.png"] Alt text: Vonage REST Message configuration

4. Click Submit.

5. Open the created record, in the HTTP Methods related list, click New and select the HTTP method as POST.

6. Fill the following fields:

   • Endpoint: https://${baseURL}/sms/json

   • Content:api_key=${apiKey}&api_secret=${apiSecret}&text=${text}&from=${from}&to=${to}

   • Content-Type: application/x-www-form-urlencoded [Omitted image "vonage-http-method.png"] Alt text: HTTP Method

7. Update the record.

8. Click Auto-generate variables from the Related Links section.

9. Import SI shared in the folder and copy the apiKey and secret from the Vonage API dashboard.

   Note:

   The apiKey and secret are located in your Vonage account settings in the Vonage Dashboard.

   [Omitted image "vonage-script.png"] Alt text: Script

10. Create a custom Table Phone Numbers with two columns, For example:

    • Column Label: User, Type: Reference, Reference: User (sys_user).

    • Column Label: Phone Number, Type: Phone Number(E164). [Omitted image “vonage-phone-number.png”] Alt text: Phone Number

11. Create a custom provider in Multi-Factor Provider table.

    [Omitted image "vonage-provider-config.png"] Alt text: Provider Configuration page

    To know more about provider configuration, see Configure MFA Provider.