One-Time Passcode Integration Kit

Twilio Programmable API Notification Publisher settings reference

Field descriptions for the Twilio Programmable API Notification Publisher configuration screen.

Table 1. Standard fields
Field Description

Account SID

The Account SID that you noted in Getting your Twilio API credentials.

Auth Token

The Auth Token that you noted in Getting your Twilio API credentials.

From Number

The Twilio phone number, sender ID, or Wireless SIM that sends the message to the user.

This value appears as the sender. Phone numbers must be in E.164 format. For details, see E.164 in the Twilio documentation.

Alphanumeric sender IDs are not available in all countries. For a list of supported countries, see International support for Alphanumeric Sender ID in the Twilio Help Center.

Delivery Method

The method used to send the one-time passcode.

The default setting is SMS.

Block VoIP Numbers

When selected, the Twilio Lookup API is used to ensure SMS messages are not sent to VoIP phone numbers.

This is a paid service. See Lookup in the Twilio documentation.

This check box is cleared by default.

Blocked Numbers

One-time passcodes are not sent to phone numbers that match these values.

Separate multiple values with a comma.

The default values are the following toll-free numbers: +1800,+1888,+1877,+1866,+1855,+1844,+1833.

Test Phone

The phone number used to test the configuration on the Actions tab.
Advanced fields
Field Description

Messages File

The name of the messages file to use for notifications.

The adapter uses the corresponding .properties file in <pf_install>/pingfederate/server/default/conf/language-packs.

The default value is twilio-programmable-api-publisher-messages.

Voice Option

The Twilio voice to use for voice calls. Select Twilio’s basic "Man" or "Woman" voice, or select Other to specify one of the more advanced voices.

For a list of languages and locales supported by each voice, see What Languages can the <Say> TwiML Verb Speak? in the Twilio Help Center.

The default setting is Woman.

Other Voice Option

If you selected a Voice Option of Other, specify the specific voice to use. For example, alice or Polly.Joanna.

For a list of voice names, see What Languages can the <Say> TwiML Verb Speak? in the Twilio Help Center.

This field is blank by default.

API Request Timeout

The amount of time in milliseconds that PingFederate allows when establishing a connection with the Twilio API or waiting for a response to a request. A value of 0 disables the timeout.

The default value is 5000.

Connection Timeout

The amount of time in milliseconds that PingFederate allows to establish a connection with the Twilio API. A value of 0 disables the timeout.

The default value is 5000.

Proxy Settings

Defines proxy settings for outbound HTTP requests.

The default value is System Defaults.

Custom Proxy Host

The proxy server host name to use when Proxy Settings is set to Custom.

This field is blank by default.

Custom Proxy Port

The proxy server port to use when Proxy Settings is set to Custom.

This field is blank by default.