One-Time Passcode Integration Kit

Customizing templates

The One-Time Passcode Integration Kit includes templates that can present one-time passcode (OTP) authentication challenges and other messages.

  • You can customize the HTML portions of these templates to suit your organization’s branding and presentation needs.

  • You can use the HTML Prefix Field to configure adapter instance-specific templates. Learn more in the One-Time Passcode IdP Adapter settings reference.

  • You can access the user information attributes configured in the User Attribute Mapping table during the Configuring an adapter instance procedure in the templates using the $userData.<target_attribute_name> velocity variable.

The following table lists the available templates and their uses. You can find more information about templates in Customizable user-facing pages in the PingFederate documentation.

Template files included in the One-Time Passcode Integration Kit
Template file Description

otp.adapter.device.selection.template.html

Presents the user with a form to select a device on which to receive the OTP.

otp.adapter.mfa.failed.template.html

Presents the user with a form to indicate failed verification of the OTP they entered previously.

otp.adapter.otp.required.template.html

Presents the user with a form to input the OTP.

otp.adapter.otp.verified.template.html

Presents the user with a form to indicate successful verification of the OTP they entered previously.