Ping SDKs

Compatibility

Supported versions

The Ping SDKs support the following server versions:

  • PingAM 6.5, 7.0, 7.1, 7.2, 7.3, 7.4, 7.5 and later

  • PingOne Advanced Identity Cloud

Supported operating systems and browsers

Select a platform below to view the supported operating systems and browsers.

  • Android

  • iOS

  • JavaScript / Login Widget

The Ping SDK for Android supports the following versions of the Android operating system:

  • Android 6.0 (Marshmallow)

  • Android 7.0 / 7.1 (Nougat)

  • Android 8.0.0 / 8.1.0 (Oreo)

  • Android 9 (Pie)

  • Android 10

  • Android 11

  • Android 12

  • Android 13

  • Android 14

  • Android 15

    We are updating how we determine which Android versions form our support policy for the Ping SDK for Android.

    From March 1st, 2025, the support policy is as follows:

    • Every public major release of Android within the last 5 years.

      For example, this would mean support for Android 10 (API level 29) and later versions.

Supported browsers on Android

  • Chrome - Two most recent major versions.

The Ping SDK for iOS supports the following versions of the iOS operating system:

  • iOS 12

  • iOS 13

  • iOS 14

  • iOS 15

  • iOS 16

  • iOS 17

  • iOS 18

    We are updating how we determine which iOS versions form our support policy for the Ping SDK for iOS.

    From March 1st, 2025, the support policy is as follows:

    • Every public major release of iOS within the last 3 years.

      For example, this would mean support for iOS 16 and later versions.

Supported browsers on iOS

  • Safari - Two most recent major versions.

The Ping SDK for JavaScript, and the Ping (ForgeRock) Login Widget support the desktop and mobile browsers listed below.

Minimum supported Desktop browser versions

  • Chrome 83

  • Firefox 77

  • Safari 13

  • Microsoft Edge 83 (Chromium)

Supported Mobile browsers

  • iOS (Safari) - Two most recent major versions of the operating system.

  • Android (Chrome) - Two most recent major versions of the operating system.

Supported callbacks

Callback name Callback description Android iOS JavaScript

AppIntegrity

Collects a generated token from the client to verify the integrity of the app

✅

SDK 4.3

✅

SDK 4.3

❌

BooleanAttributeInputCallback

SDK 2.1

Collects true or false.

✅

✅

✅

ChoiceCallback

Collects single user input from available choices, retrieves selected choice from user interaction.

✅

✅

✅

ConfirmationCallback

Retrieve a selected option from a list of options.

✅

✅

✅

ConsentMappingCallback

SDK 2.0

Prompts the user to consent to share their profile data.

✅

❌

❌

DeviceBinding

Cryptographically bind a mobile device to a user account.

✅

SDK 4.0

✅

SDK 4.0

❌

DeviceProfileCallback

SDK 2.0

Collects meta and/or location data about the authenticating device.

✅

✅

✅

DeviceSigningVerifier

Verify ownership of a bound device by signing a challenge.

✅

SDK 4.0

✅

SDK 4.0

❌

HiddenValueCallback

Returns form values that are not visually rendered to the end user.

✅

✅

✅

KbaCreateCallback SDK 2.0

Collects knowledge-based answers. For example, the name of your first pet.

✅

✅

✅

MetadataCallback (1)

Injects key-value metadata into the authentication process.

For example, the WebAuthn nodes use this callback to return the data the SDK requires to perform authentication and registration.

✅

✅

✅

NameCallback

Collects a username.

✅

✅

✅

NumberAttributeInputCallback

SDK 2.1

Collects a number.

✅

✅

✅

PasswordCallback

Collects a password or one-time pass code.

✅

✅

✅

PingOneProtectEvaluationCallback

SDK 4.4

Collects captured contextual data from the client to perform risk evaluations.

✅

✅

✅

PingOneProtectInitializeCallback

SDK 4.4

Instructs the client to start capturing contextual data for risk evaluations

✅

✅

✅

PollingWaitCallback

Instructs the client to wait for the given period and resubmit the request.

✅

✅

✅

ReCaptchaCallback

Provides data required to use a CAPTCHA in your apps.

✅ (2)

✅

✅

ReCaptchaEnterpriseCallback

Provides data required to use reCAPTCHA Enterprise in your apps.

✅ (2)

SDK 4.6

✅

SDK 4.6

✅

SDK 4.6

RedirectCallback

Redirects the user’s browser or user-agent.

❌

❌

✅

StringAttributeInputCallback

SDK 2.0

Collects the values of attributes for use elsewhere in a tree.

✅

✅

✅

SuspendedTextOutputCallback

SDK 2.1

Pause and resume authentication, sometimes known as "magic links".

✅

✅

✅

TextInputCallback

Collects text input from the end user. For example, a nickname for their account.

✅

SDK 4.4

✅

SDK 4.4

✅

SDK 3.4

TextOutputCallback

Provides a message to be displayed to a user with a given message type.

✅

✅

✅

TermsAndConditionsCallback

SDK 2.0

Collects a user’s acceptance of the configured Terms & Conditions.

✅

✅

✅

ValidatedCreatePasswordCallback

SDK 2.0

Collects a password value with optional password policy validation.

✅

✅

✅

ValidatedCreateUsernameCallback

SDK 2.0

Collects a username value with optional username policy validation.

✅

✅

✅

(1) The WebAuthn Authentication node and the WebAuthn Registration node both use a MetaDataCallback when the Return challenge as JavaScript is NOT enabled.

You must not enable this option when handling WebAuthn journeys with the Ping SDK for Android and iOS.

The Ping SDK for JavaScript handles either the MetaDataCallback or the JavaScript-based payload.

(2) Requires the presence of Google Play Services.

Supported features

The Ping SDKs support the following functionality:

OAuth 2.0

Authorization code grant with PKCE

Authentication trees and nodes

The SDKs do not support authentication chains nor modules.

Prototyping with FRUI module

The FRUI module is for prototyping your UI only, and is not for production use.

Copyright © 2010-2024 ForgeRock, all rights reserved.