To configure ACUL, make sure your custom configuration files and assets are hosted on a public CDN.
Auth0 Dashboard
You can use the Dashboard to customize your screens with ACUL: A. Navigate to Dashboard > Branding > Universal Login- Select Customize authentication screens.
- Select a
screento customize. - From Settings > Rendering mode select Advanced mode.
- (Optional) Select Use custom page template.
- (Optional) Select Advanced mode filters.
- Select Head Tags to add your own HTML
Head Tags. - (Optional) Select Additional Data to select which additional data to send to the browser. B. Select Save & Publish
/v2/prompts/patch-rendering endpoint.
The ACUL rendering configuration object
The ACUL rendering configuration is a single JSON object that is used to enable ACUL and list all the available properties, per screen, which consist of specific assets, context data, and applicable conditional logic. The ACUL rendering configuration object can be used with IaC tools and the Auth0 Management API. To learn more, review the/v2/prompts/patch-rendering endpoint.
Infrastructure-as-Code (IaC)
Configure ACUL with IaC tools, including:- The Auth0 CLI’s
auth0 aculcommand. - The Auth0 Terraform Provider’s
auth0_prompt_screen_rendererresource. - The Auth0 Deploy CLI’s
promptsresource.
Auth0 Management API
Use ACUL Management API endpoints to configure Universal Login screens individually or to update multiple screens with one API call. You must have Management API access token in the request. Individual screen configuration-
The
GET /v2/prompts/{prompt}/screen/{screen}/renderingendpoint allows you to retrieve the configuration for a single screen. -
The
PATCH /v2/prompts/{prompt}/screen/{screen}/renderingendpoint allows you to configure ACUL on a single screen.
-
The
GET /v2/prompts/renderingendpoint allows you to retrieve configurations for all the screens. -
The
PATCH /v2/prompts/renderingendpoint allows you to update screens in bulk.