Advanced Identity Cloud

Twilio Verify Sender node

Initiates a Twilio Verify request to send a one-time passcode to the user’s device as an additional authentication factor.

If you do not enable the Request Identifier property, make sure the shared node state has a userIdentifier field set with a valid phone number or an email ID when the flow reaches this node.

Follow this node with the Twilio Verify Collector Decision node in the authentication flow.

Outcomes

  • True: OTP sent successfully.

  • Error: Exception occurred, and the error message is stored in the shared store.

Properties

Property Usage

Account SID

The unique string to identify the account found in the Twilio account dashboard.

Authentication Token

The authentication token found in the Twilio account dashboard. You can use ESVs to set credentials appropriately for each environment in a multi-environment setup. Refer to Introduction to ESVs for more information on ESVs.

Service SID

The unique string to identify the service in the Twilio account dashboard.

Channel

The delivery channel for sending the one-time passcode:

SMS (default)

Phone numbers must contain the country code and can optionally contain special characters. The node removes all special characters before making the Twilio Verify request.

Valid identifiers include +15553231234 or 1(555)323-1234. Invalid identifiers include (555) 323-1234 as the country code is missing.

Call

The same rules apply for phone numbers.

Email

To use this channel, first integrate the Twilio Verify with SendGrid services, as described in Send Email Verifications with Verify and Twilio SendGrid.

WHATSAPP

The same rules apply for phone numbers.

Request Identifier

Whether to prompt the user for their identifier.

Optionally, this node can prompt the user for their identifier. By default, the authentication flow shared node state must contain a userIdentifier field that holds a valid phone number or email address.

Default: disabled

Identifier Shared State

The shared state variable to search for the user identifier.

Examples

For examples in context, refer to the Twilio examples.

Copyright © 2010-2024 ForgeRock, all rights reserved.