OktaAlisa DuncanTutorial
Stretch Your Imagination and Build a Delightful Sign-In Experience
Summary
This tutorial shows how to customize the Okta-hosted Sign-In Widget (SIW) for a fictional to-do application while retaining Okta Identity Engine authentication flows. It covers configuring a custom domain and enabling SIW Gen3, then using brand settings, design tokens, custom CSS properties, and page code to change fonts, colors, layout, and background treatment. The implementation uses the widget’s afterTransform method and FormBag to revise the identify form, remove help, unlock, and divider elements, change the title, and add a custom blog link. It also explains the default HTML and JavaScript rendering configuration and describes updating an OpenID Connect application to use the brand’s custom sign-in URL as its issuer.
Context
The default Okta-hosted sign-in page has a neutral appearance, while custom domains enable code customizations beyond the default logo, background, favicon, and two colors. The tutorial uses a fictional to-do app as the setting for creating a more branded sign-in experience.
Approach / What changed
Configure a custom domain and enable SIW Gen3, then customize brand settings and the hosted page with design tokens, CSS custom properties, HTML, and JavaScript. Use afterTransform and FormBag to modify the identify form, remove selected elements, and add a custom footer link. Update the OIDC application to use the brand’s custom sign-in URL as its issuer.
Takeaways
SIW Gen3 is required for the tutorial’s code, and the example organization uses SIW version 7.36.
The afterTransform hook targets the identify form through FormBag, changing the title, removing help, unlock, and divider elements, and adding a footer link.
A custom domain enables the code editor and broader page customization; the OIDC application must use the brand’s custom URL as its issuer.
Source and freshness
- Source
- developer.okta.com
- Published
- Added to Yomu
Summaries are generated from the original by a language model. Check the original before relying on it.
Keep reading
Related reading
The Good Stuff
Paid picks we use ourselves. Links carry a referral code — a subscription through one earns us a commission at no extra cost to you.
The best engineering reads, once a week
One useful email. Unsubscribe anytime.