Create OAuth client panel
Key point: For administrators to create a new OAuth client.

This panel lets administrators register the details of a new app using OAuth 2.0 to communicate with the PageSeeder service API.

  • Client name – a unique name for the client (required).
  • Description – description of the client for information only.
  • Website – Website of the client for information only.
  • Grant type – the OAuth 2.0 grant type for the client. PageSeeder supports the 4 basic grant types.
  • Redirect URI – a required OAuth field for some grant types. PageSeeder uses this value in OAuth redirection.
  • Member – defines on behalf of which member the client is connecting (for client credentials grant only).
  • Access token max age – the length of time access tokens issued by this client are valid for.
  • Refresh token max age – the length of time refresh tokens issued by this client are valid for (for Authorisation code grant only).
  • Scope – the scope allowed for this client. PageSeeder doesn’t support any scope other than openid, profile and email as defined in the OpenID connect core 1.0 specification.
  • Webhook secret – if using Webhooks, you can specify the secret here.
  • App name – use this field to group clients for the same app.

Why a client name and an app name? The client name is unique and for security – we only allow one type of grant per client. So the app name lets you group clients that are designed for the same app. You might have multiple clients for the same app when:

  • The app uses different grant types.
  • There are multiple versions of an app connecting to the same PageSeeder instance (staging, production, etc.).
  • There are multiple deployments of an app connecting to the same PageSeeder instance.

Select Specify client credentials manually if you need to specify a client ID and secret manually instead of letting PageSeeder issue a random set of credentials. It’s usually more secure when you use random generated credentials, but if you’re migrating an existing client or require specific values, this option lets you enter them in text fields. The client ID must be a 16-digit hexadecimal value.

How to find this page

Click Register new client on the OAuth clients page.