Skip to main content

Login success

Overview​

The login success page acts as a user-friendly confirmation screen displayed immediately after a user successfully logs in. Its primary purpose is to enhance the user experience by providing a clear and reassuring acknowledgment that the login was successful, helping users feel confident and informed about their authentication status.

Introduction to Login success​

Login success page enhances the positive user experience, and enabling it per app contributes to the adaptability of the application.

When is the login success page used​

When you want to inform the user about successfully logging in to the app, the login success page comes into play.

Here is an example of the login success page: after the user logs in, they get the selection tab "To the portal." The user can click on it and log in to the user profile portal.

login-success-page

CriteriaExampleConfiguration
A valid URL to be configured for login_success hosted pages and mapped with the app.We have provided a URL as an example.
Enable Login success page for the app in the Advanced settings .login-success-page-mapped

Understanding the Flow and APIs​

Step 1: Redirection to login_success page​

After a successful login the user is redirected to the login success page. This might look like this:

login-success-page


curl `https://demo.cidaas.de/identity/login_success?track_id=5161846c-29cb-493a-8720-fc995ddd9a30&requestId=ac400efe-a58b-4d14-841c-bf17b7512a7b&sub=3b024166-2a34-4110-9f60-af4e72ee5229&q=3b024166-2a34-4110-9f60-af4e72ee5229&client_id=da6a6a31-a604-4148-afaa-84a70951230e`

 --compressed

The URL is defined by the hosted page key: login_success.

login-success-page-mapped

It returns a track_id which is required as an input to continue the login process.

Step 2: Rendering UI​

There are two important aspects involved in login_success hosted page: 1. creating a login_success hosted page_ 2. configuring the hosted page to the desired app.

1. Creating the hosted page for login_success.

  • Here we create the hosted pages for the login success page with a valid URL. You can also use the below API to add or update a hosted page.

    login-success-page-mapped

2. Configuring login success hosted page to the app.

  • Here we configure the hosted pages , login_success as of now, to the desired app.You can also use the below API to edit or update the app details.

    login-success-page-mapped

Step 3: Continue the login Process​

The final call will allow you to issue a token or code, depending on the grant you are using. It will verify the token and grant you access to the user profile of the app.

curl 'https://demo.cidaas.de/login-srv/precheck/continue/958ccb4c-3985-4b17-b325-14cd10da292e' \
  -X 'POST' \
  --compressed

Developer Perspective​

APIDescriptionLink
POST Hosted pages groupThis API allows you to add or update a hosted page to the specified hosted pages group.View API
PUT Update app settingsThis API is used to edit/update the app-details, app-settings, etc. Here you can enable login_success_page. For more information, see App Management documentation.View API
POST Continue LoginTo continue the login so that a code or token is issued, the continue API call will proceed.View API

Need help implementing this?​

Please contact us on our Developer Support Page.