Curity Identity Server Customization Recipes

Example Docker deployments to demonstrate customization techniques and custom themes in action.

Example Recipes

Each recipe has its own example customizations, that you can use the following links to view:

Recipe Name	Description
basics	Simple customizations to change text, logos and styles
email	Customizations for email based login flows, to change text, styles and templates
multi-brand	How to implement different branded customizations per client application

Deploy Customizations

Run the deployment, after which you can use Desktop or Web OAuth Tools to test customizations.
If you use the web version. you can use ngrok to enable OAuth Tools to reach your local deployment.

export RECIPE='basics'
export USE_NGROK=false
./deploy.sh

After deployment, sign in to the Admin UI and inspect the OAuth configuratiuon with the following details:

• URL: https://localhost:6749/admin
• Username: admin
• Password: Password1

The example deployments activate the Username is Email option from the Account Manager:

Navigate to Token Service → Clients to view OAuth client settings.
If you use the multi-brand recipe, edit a client and view its User Authentication tab to inspect the assigned template area.

Run OAuth Tools

The deployment outputs a URL that you can use to create an OAuth Tools environment:

The OAuth Tools issuer URL is http://localhost:8443/oauth/v2/oauth/anonymous

Once you have an OAuth Tools environment, add a code flow and use the following settings to test.
For the multi-brand recipe, change the client ID to either web-client1 or web-client2.

• Client ID: web-client
• Client Secret: Password1
• Scope: openid
• Prompt: login

Select the HTML Form authenticator and use the Create Account option to register a new test user.
Then, authenticate as the user and also run Reset Password flows that trigger emails.
View received emails by browsing to the test email inbox at http://localhost:1080:

Free Resources

Once you have finished customization testing, free resources by running the following script:

./teardown.sh

Website Documentation

See the Branding and User Experience tutorials for more on ways to customize the look and feel.

More Information

Please visit curity.io for more information about the Curity Identity Server.