Skip to content

Latest commit

 

History

History
341 lines (172 loc) · 6.59 KB

configure-sinch-service-in-administration-console-f4a04ed.md

File metadata and controls

341 lines (172 loc) · 6.59 KB

Configure Sinch Service in Administration Console

Configure Sinch Service to enable Phone Verification via SMS or SMS Two-Factor Authentication in the administration console.

Prerequisites

  • You have either an account in Sinch Authentication 365 or in Sinch Verification Service. Once you create a Sinch service account, you receive an e-mail with your account information.

  • You are assigned the Manage Tenant Configuration role. For more information about how to assign administrator roles, see Edit Administrator Authorizations.

Context

Sinch service enables multichannel two-factor authentication (2FA), adding another layer of security to customers' online accounts, beyond their login and password. The service enables you to configure tokens – such as one-time passwords (OTPs), personal identification numbers (PINs), and verification codes – that are tailored to businesses and particular use cases.

For the integration between Identity Authentication and Sinch service, you must provide information in the administration console for Identity Authentication. You can have eithet a Sinch Authentication 365 or Sinch Verification configuration. You can clear the fields by choosing the Remove Configuration button at the top of the screen.

Based on your Sinch service type, provide the following:

Sinch Authentication 365

Configuration

Notes

Account ID

This is your Authentication 365 Account ID. The information is available in the accounts menu of Authentication 365 web-based administrative user interface. For more information, see Sinch Authentication 365/Account Information.

OAuth Token URL

The OAuth token URL. Example: https://<domain>/oauth/token

Client ID

Your API Secret Key for Sinch Authentication 365. For more information, see, Sinch Authentication 365/API Key Management.

Client Secret

Your API Key Code for Sinch Authentication 365. For more information, see Sinch Authentication 365/API Key Management..

Code Timeout

The timeout in seconds. Provide a number between 30 and 900.

Code Length

The length of the generated code. Code length must be between 4 and 8 digits.

Send Code URL

The Sinch Authentication 365 URL that is used to generate the tokens (codes). Example: https://authentication.<domain>/tokens/generate

Validate Code URL

The Sinch Authentication 365 URL that is used to validate the tokens (codes). Example: https://authentication.<domain>/tokens/validate

SMS text

The text that the user will receive in the SMS. The text is followed by the verification code. For example: "Your verification code is: [the generated token]".

Remember:

All fields are required.

Sinch Verification

Configuration

Notes

Application Key

The Application Key obtained via Sinch customer dashboard.

Application Secret

The Application Secret obtained via Sinch customer dashboard.

Code Timeout

Optional.

Request the Sinch Support team to configure this parameter for the client's Sinch account.

Remember:

Before configuring this property in the administration console for Identity Authentication, first request this property to the Sinch Support team.

SMS Text Template

Optional.

Request the Sinch Support team to enable this configuration.

The SMS text in the configuration must include the {{CODE}} placeholder, where Sinch will include the actual code. For example, "This is your OTP code {{CODE}}!"

Remember:

Before configuring this property in the administration console for Identity Authentication, first request this property to the Sinch Support team.

Remember:

It takes 2 minutes for the configuration changes to take place.

To configure the administration console, follow the procedure below:

Procedure

  1. Access the tenant's administration console for Identity Authentication by using the console's URL.

    Note:

    The URL has the following pattern:

    https://<tenant ID>.accounts.ondemand.com/admin

    Tenant ID is an automatically generated ID by the system. The first administrator created for the tenant receives an activation e-mail with a URL in it. This URL contains the tenant ID. For more information about your tenants, see Viewing Assigned Tenants and Administrators.

    If you have a configured custom domain, the URL has the following pattern: <your custom domain>/admin.

  2. Under Applications and Resources, choose the Tenant Settings tile.

    At the top of the page you can view the administrative and license relevant information of the tenant.

  3. Choose the Sinch Service Configuration list item.

  4. Choose the Edit button.

  5. Select your Sinch service type and enter the information that is required for the chosen type.

    • Sinch Verification
    • Sinch Authentication 365

  6. Save your entries.

Related Information

Sinch Authentication 365

Sinch Verification API

Sinch Verification Developer Documentation