Set up Hosted Login

Mission Statement

The purpose of this document is to guide developers through a basic implementation of Hosted Login. Further customizations can be made as needed, but are outside the scope of this Quick Start Guide. Note that this document is designed to get Hosted Login v1 up and running. See Introduction to Hosted Login v2 for information on upgrading from Hosted Login v1 to Hosted Login v2.


The audience for this document is developers for ​Akamai​ Identity Cloud customers who are in the delivery phase for Hosted Login and are ready to get an implementation up-and-running.

This guide assumes the audience is already familiar with:

  • Making API calls
  • Working with:
    • Registration applications
    • API clients and settings
    • Schemas
    • Flows

It also assumes the audience has an existing website or app with which to integrate Hosted Login.

Hosted Login setup (step-by-step)

  1. Verify components
    Make sure you have everything you need to get Hosted Login up and running.

  2. Get an administrative access token
    Administrative access tokens are needed to call the Hosted Login APIs. Most of the steps in this guide require the use of an administrative access token.

  3. Create a token policy
    Token policies determine the lifetimes for your access and refresh tokens, and specify the scopes that can be returned following a successful authentication.

  4. Create a login policy
    Login policies connect Hosted Login to backend components such as the Identity Cloud entity type used to store user profile information.

  5. Create or modify a login client
    Create a new OpenID Connect login client or modify the provided client to work in your domain.

  6. Configure application client settings
    Application clients serve as a bridge between new world of Hosted Login and the tried-and-true Identity Cloud infrastructure.

  7. Make an authorization request
    Before you get too carried away, make sure you can log on to Hosted Login.

  8. Configure CNAMEs
    Unless you’re OK with having a Hosted Login URL similar to

  9. Redirect Hosted Login links
    By default, Hosted Login screens include links for such things as accessing your help center, your terms of service, and your privacy policy. Also by default, those links don’t actually go anywhere. Here's how to fix that.

  10. Configure social login
    If needed, configure Hosted Login to use social login. Note that this is optional: Hosted Login doesn’t require you to use social login.

  11. Next steps
    Links to Getting Started guides and additional documentation to help you utilize Hosted Login to its fullest.

Related articles

Hosted Login provisioning videos