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

install-unikname-connect-step

OAuth2.0 / OpenID Connect

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

Table Of Content

Prerequisites

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

✔️ You've got 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 / 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.