Creating a registration link

To allow users to register with Bare.ID and create a user account, you can embed a corresponding link on your own website.

• Assemble the URL from the following elements:
  • Keycloak base URL including the name of the Bare.ID instance, as shown in the dashboard: e.g. http://login.example.com/auth/realms/Realmname
  • Registration endpoint of the OpenID Connect endpoint: /protocol/openid-connect/registrations
  • Client ID: e.g. ?client_id=BeispielApplikation
  • Redirect URI to which the user is redirected after a successful registration. For redirecting to the login, e.g. &redirect_uri=http://login.example.com/authentication/login
  • Additional parameters: e.g. &response_type=code&scope=openid%20email&kc_locale=de

In the example, this results in the following registration URL:

http://login.example.com/auth/realms/Realmname/protocol/openid-connect/registrations?client_id=BeispielApplikation&redirect_uri=http://login.example.com/authentication/login&response_type=code&scope=openid%20email&kc_locale=de

Note: Links for the forgot-password flow and for further self-service actions (changing the password, editing the profile, deleting the account) can be found in the article How do I embed static authentication links on my website?.

Optional parameters

• Language (kc_locale): The registration URL can be extended with the optional parameter &kc_locale=[two-letter language code]. This lets you specify the language in which the displayed frontend is rendered – for example de or en. This requires internationalization and the respective language to be enabled in the Bare.ID instance.