Advanced Identity Cloud/PingAM Login Widget

What’s New

Latest updates

Advanced Identity Cloud/PingAM Login Widget 2.2.0

November 12, 2026 minor

Added

  • Added logo dimension configuration: set style.logo.width alongside style.logo.height to control the logo size.

  • Added Page Node theme support. The widget resolves a Page Node themeId and applies the matching page theme over the base theme when you supply a themeCatalog keyed by IDM theme _id in configure({ style }).

  • Added experimental custom page header and footer wrappers. The app renders editable header.svelte and footer.svelte files around the journey container, each receiving a journeyName prop so you can render per-journey content.

  • Added a style.callbacks option to configure() that carries per-callback style rules keyed by AM callback type name, for example hiding script-type TextOutputCallback output.

  • Added a generic fallback button for custom identity providers in the SelectIdP callback.

  • Added a localized Start Over action to the default OTP stage.

  • Added Svelte as a production dependency, so framework-agnostic TypeScript consumers can resolve the widget’s component declarations and instantiate new Widget({ target, props }) without adding Svelte themselves.

Changed

  • Logo theming now flows through root-level CSS custom properties instead of inline style attributes. Invalid style.logo.light or style.logo.dark values are dropped by config validation and log a console warning naming the rejected value.

  • Removed the generate header and generate footer CLI commands and the header/footer registry types. Header and footer wrappers are seeded by the framework’s build and you edit the generated files directly; framework upgrades never overwrite them.

Fixed

  • Fixed journey restart after a failed suspended-journey resume. A failed resume, such as an expired suspend email link, now restarts into the correct journey resolved from the URL or remembered per-browser, instead of the realm’s default journey.

  • Fixed terminal login failures being treated as restartable. When the journey resolves a failure URL (detail.failureUrl), the widget completes the journey as failed so the host app can act on it, for example to honor gotoOnFail. Bare failures, such as a wrong password, still restart the journey.

  • Fixed dark-mode styling on admin invite screens, and the privacy-policy checkbox no longer takes focus in the tab order until a jurisdiction is selected.

  • Fixed the session cookie lifetime in the login app’s AM proxy by forwarding the upstream Max-Age and Expires attributes, and added a two-second upstream timeout so a hung server connection fails fast instead of pinning the request open.

  • Fixed inline field validation messages not displaying for some inputs when a form was submitted with invalid values.

Advanced Identity Cloud/PingAM Login Widget 2.1.0

August 13, 2026 minor

Added

  • Added LinkedIn and Microsoft Entra ID as out-of-the-box identity providers in the SelectIdentityProvider callback, with branded sign-in buttons and dark mode variants.

Fixed

  • Restored several v1.3.0 configuration capabilities in 2.1.0 and exposed additional OIDC client options. Added top-level logger, middleware, serverConfig, and storage configuration, restored the token refresh threshold as oidcClient.oauthThreshold, and added OIDC passthrough options for par, loginHint, acrValues, and query.

Changed

  • Removed hardcoded backgroundRenew: true from token.get().

    The Advanced Identity Cloud/PingAM Login Widget no longer automatically passes the option to the OIDC client, add the property manually if required.

Advanced Identity Cloud/PingAM Login Widget 2.0

July 28, 2026 major

Key Features

  • Added passkey autofill support (WebAuthn Conditional UI), letting users sign in by selecting a passkey from the browser’s native autofill picker.

  • Added invisible reCAPTCHA v2, invisible hCaptcha, and reCAPTCHA Enterprise support via the captcha configuration option.

    Learn more in Implement a CAPTCHA.

  • Added runtime theming support: pass a theme object to configure({ style: { theme } }) to apply brand colors and fonts without rebuilding the widget.

Added

  • Added dedicated stages for MFA enrollment and recovery codes, and for the PingOne Advanced Identity Cloud admin registration flow (welcome, OTP verification, and privacy policy acceptance).

  • Added experimental support for custom callback and stage components, letting you override or extend the widget’s built-in UI. Refer to the Advanced Identity Cloud/PingAM Web Login Framework repository for details.

  • Added TextInputCallback support.

Changed

  • Migrated the Journey implementation from @forgerock/javascript-sdk to @forgerock/journey-client.

  • Migrated the OIDC token, userinfo, and logout implementations from @forgerock/javascript-sdk to @forgerock/oidc-client.

  • Migrated the PingOne Protect implementation from @forgerock/ping-protect to @forgerock/protect.

  • Migrated the Advanced Identity Cloud/PingAM Login Widget internal build to Svelte 5 and a pnpm monorepo architecture.

Fixed

  • Fixed a visual regression in the info alert that showed the wrong background color when runtime theming was active.

  • Fixed a typo and some grammar issues in the default English locale text.

  • Fixed an issue preventing ConfirmationCallback options beyond the second from being selectable.

  • Fixed the passkey prompt appearing twice during WebAuthn sign-in.

  • Fixed the failureUrl not being exposed in the journey error handler after login failure .

Breaking changes

  • The synchronous configuration() export and its .set() method are replaced by a single async configure() function. await it before calling any other Widget API.

  • The nested forgerock config object is replaced by a flat, top-level shape. Endpoint discovery is driven by a single top-level wellknown URL, and OAuth settings now live in an oidcClient sub-object.

  • The request module export is removed. Get tokens from user.tokens().get() and call fetch() with a manual Authorization header.

  • OAuth/OIDC, user info, and logout are now backed by @forgerock/oidc-client. PingOne Protect is backed by @forgerock/protect. @forgerock/javascript-sdk is no longer a dependency of the widget.

  • The serverConfig object, realmPath, tree, tokenStore, prefix, logLevel, logger, platformHeader, oauthThreshold, and all serverConfig.paths.* overrides are removed.

For migration guidance and before/after examples, refer to Breaking changes.

Advanced Identity Cloud/PingAM Login Widget 1.3.0

June 5, 2024 minor

Added

  • Added support for integration with PingOne Protect.

  • Added the name of the device to the recovery codes page.

Fixed

  • Corrected an issue that prevented use of the logLevel parameter in the Advanced Identity Cloud/PingAM Login Widget configuration.

  • Fixed an issue with configuration literals that caused ZodError messages in the console.

Advanced Identity Cloud/PingAM Login Widget 1.2.1

January 8, 2024 minor

Added

  • Support for CAPTCHA nodes.

Advanced Identity Cloud/PingAM Login Widget 1.1

July 17, 2023 minor

Added

  • Support for device profiling callbacks (DeviceProfileCallback)

  • Support for web authentication (WebAuthn) journeys and trees.

Advanced Identity Cloud/PingAM Login Widget 1.0

April 18, 2023 major

Changed

  • First public release