Oracle Cloud Infrastructure Documentation

Configuring OTP Phone Calls

Configure passcode settings to send users in an identity domain in IAM a one-time passcode (OTP) as a phone call. Use a phone call template to configure the phone call.

Before you can configure phone call settings, you must first set up a Vonage provider.
  1. Open the navigation menu  and select Identity & Security. Under Identity, select Domains.
  2. Select the name of the identity domain that you want to work in. You might need to change the compartment to find the domain that you want.
  3. On the domain details page, select Authentication.
  4. On the Authentication page, in the Phone call row, select Edit.
  5. Make any necessary changes to the Passcode length and Passcode validity duration (minutes). These settings apply to one-time passcodes sent in phone calls.
    • Passcode length: The number of characters in the passcode.
    • Passcode validity duration (minutes): The number of minutes for which the passcode will be valid, after the passcode was sent.
  6. Configure a phone call.
    1. If you haven't already done so, set up your Vonage provider. When you are ready, turn on Click here to proceed if the Vonage provider is already configured.
      You can enter the Vonage provider settings only after you turn on the setting.
    2. Enter the Vonage provider settings.
      Important

      You must base64 encode the Vonage private key before you upload it.
    3. Under Phone call template, select the language for the message.
    4. Modify the template to create the wording that's sent in the message to users.

      IAM provides a fixed list of message variables. Select Message variables to view the available variables and variable definitions.

      Note

      Add your company name to the Company name field on the Branding page in Settings. A company name longer than 30 characters are truncated in the message body. If you leave the Company name field, your company details don't appear in notifications such as Oracle Mobile Authenticator (OMA) when a user completes MFA enrollment.

  7. Select Save changes.
  8. Confirm the changes when prompted.