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

Unikname Connect can be easily integrated with any website using Auth2.0 or OpenID Connect Authorization protocols.

• Unikname Connect OAuth2.0 / OIDC features
• OAuth2.0 / OIDC setup
  • Detailed OAuth 2.0 / OIDC Endpoints
• 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 Auth2.0 or OpenID protocol.

Unikname Connect OAuth2.0 / OIDC features

The current implementation of Unikname Connect provides support for:

• Authorization Code Flow
• Implicit Flow
• Standard OAuth2.0 and OIDC endpoints

OAuth2.0 / OIDC setup

Here are the informations you have to code or set up on your OAuth2.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 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

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.