Skip to main content

Register applications

An application that wants to authenticate your users is a relying party, in OIDC terms. You register it on the provider's Applications tab with Add Application.

Registration does two things: it turns unknown software into a client your provider talks to, and it puts a name and logo on the consent screen where your users judge that software.

The important fields​

FieldNotes
Name and Origin / PublisherHow the application presents itself on the consent screen. Write them for your users, not for yourself: "Team wiki (wiki.example.com)" is better than "test-app-2".
Redirect URIsWhere the provider may send a user back after sign-in. Matched exactly.
LogoOptional. Shown on the consent screen.
A redirect URI is a security boundary, not a convenience

Anyone who can receive the redirect can complete the sign-in. List the exact callback URLs your application uses and nothing wider.

Confidential or public​

A client is confidential or public. That's not a switch; it follows from whether the client has a secret.

Has a secretRight for
ConfidentialYes. Press Generate Client Secret.A server-side application, which can keep the secret away from users.
PublicNo. It uses PKCE instead.A single-page or mobile application. Neither can keep a secret.
The client secret is shown once

Put it in your application's configuration right away; for a container, an environment file is the natural place.

Generating a new secret replaces the old one, which is also the fix for a leaked secret.

Advanced options​

Everything else has a working default. The advanced options are for an application that asks for something specific: post-logout redirect URIs, CORS origins for a browser client, and the token signature and encryption algorithms.

tip

Leave them alone until an application's documentation asks for them.

Permissions are set elsewhere

That's the per-application scope policy, in Scopes and consent. Connect your application covers the application's side once it's registered.