# 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

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 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.
Still need help?
Live-chat with us by clicking on this button on the right:
OR
Open a topic on our Unikname forum