How to integrate Unikname Connect with OAuth 2.0 or OpenID Connect?

Unikname Connect can be easily integrated with any website using OAuth 2.0 or OpenID Connect Authorization protocols.

Table Of Content

• Unikname Connect OAuth 2.0 / OIDC OpenID Connect features
• OAuth 2.0 / OIDC OpenID Connect setup
  • Detailed OAuth 2.0 / OIDC OpenID Connect Endpoints
• Unikname Connect for your technical stack, framework, plugin ...
• Troubleshooting

Prerequisites

✔️ You've signed-up for a Unikname-Connect account

See How to sign-up for a Unikname-Connect account?

✔️ You've got and setup the Trust certificate for your website

See How to get and setup the trust certificate for your website?

✔️ During the sign-up process you've received your Unikname-Connect Account ID and your API secret key.

📖 We assume you're familiar with the OAuth 2.0 or OpenID Connect protocols.

Unikname Connect OAuth 2.0 / OIDC OpenID Connect features

The current implementation of Unikname Connect provides support for OAuth 2.0 (opens new window) and OpenID Connect (opens new window) protocols:

• OAuth 2.0 Grant Types:
  • Authorization Code Grant (opens new window)
  • Refresh token (opens new window)
  • PKCE / Proof Key for Code Exchange (opens new window), which allows you not to use any secret key on your server
  • Implicit Grant (opens new window)
• Standard OAuth 2.0 and OIDC OpenID Connect endpoints
• Access token and id token as signed and/or encrypted JWT

OAuth 2.0 / OIDC OpenID Connect setup

Here are the informations you have to code or set up on your OAuth 2.0 service:

Attribut	Value/Description
OIDC discovery document	https://connect.unikname.com/oidc/.well-known/openid-configuration
OIDC client id	The Unikname-Connect Account ID you have received from Unikname's support request
OIDC client secret	The API secret key you have received from Unikname's support request
OIDC authorize scopes	openid by default.

Detailed OAuth 2.0 / OIDC OpenID Connect Endpoints

If the generic discovery document URL doesn't work for you, you can configure individual endpoints:

Endpoint	URL
Authorize	https://connect.unikname.com/oidc/authorize
Token	https://connect.unikname.com/oidc/accessToken
Userinfo	https://connect.unikname.com/oidc/profile

Unikname Connect for your technical stack, framework, plugin ...

We already provide "native" Unikname Connect integration for several technical stacks or products: Discourse, WordPress, Node.js ...

After browsing the full list of our integrations, you can also search for community integrations on our forum (opens new window) or ask for help to build a new one!

Troubleshooting

If you’re having issues when connecting (access denied ...), check that the credentials (the @unikname of your organization, Unikname Connect secret, client id/secret ...) you are using to connect to Unikname Connect authentication server are the good one.