---
title: "Single Sign-On (SSO) via OpenID Connect (OIDC)"
description: "This article explains how to configure Single Sign-On (SSO) using OpenID Connect (OIDC) by connecting your identity provider to our platform."
url: https://help.tagd.ai/en/articles/36-single-sign-on-sso-via-openid-connect-oidc
collection: "Supported SSO Integrations"
updated: 2026-10-07
language: en
alternates: [sv, nb, fi]
---

# Single Sign-On (SSO) via OpenID Connect (OIDC)

This article explains how to configure Single Sign-On (SSO) using OpenID Connect (OIDC) by connecting your identity provider to our platform.

Single Sign-On (SSO) using OpenID Connect (OIDC) allows your organization to authenticate users through a centralized Identity Provider (IdP), while Tagd acts as the relying party. Your identity provider stays in charge of authentication, including multi-factor authentication and conditional access, and Tagd never sees a password.

Prerequisite: An identity provider that supports OpenID Connect with the authorization code flow and a published discovery document (for example, Microsoft Entra ID (Azure AD), Okta or Google Workspace).

**Important:** Tagd authenticates to your token endpoint using client\_secret\_post. client\_secret\_basic, which is the default in most identity providers, is not supported. If your identity provider cannot use client\_secret\_post, use [SAML 2.0](https://help.tagd.ai/en/articles/31-single-sign-on-sso-via-saml.md) instead.

### Step 1: Collect relying party details

The following details are required when configuring your Identity Provider:

<table style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><td colspan="1" rowspan="1"><p><strong>Parameter</strong></p></td><td colspan="1" rowspan="1"><p><strong>Value</strong></p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Sign-in redirect URI</strong></p></td><td colspan="1" rowspan="1"><p>https://tagd-prod-platform.auth.eu-north-1.amazoncognito.com/oauth2/idpresponse</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Grant type</strong></p></td><td colspan="1" rowspan="1"><p>Authorization code</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Scopes</strong></p></td><td colspan="1" rowspan="1"><p>openid email profile</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Client authentication</strong></p></td><td colspan="1" rowspan="1"><p>client_secret_post</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>ID token signing</strong></p></td><td colspan="1" rowspan="1"><p>RS256, ES256 or HS256, with a kid published at your JWKS endpoint</p></td></tr></tbody></table>

### Step 2: Configure your Identity Provider (IdP)

In your Identity Provider create an application,

1.  Create a new OpenID Connect application of type Web Application, a confidential client with a client secret. A single-page or native/mobile application type will not work
    
2.  Set the grant type to Authorization Code and enter the sign-in redirect URI provided above
    
3.  Set client authentication to client\_secret\_post
    
4.  Configure the claims to be included in the ID token
    
    1.  email (Mandatory, granted by the email scope)
        
    2.  given\_name (first name, granted by the profile scope)
        
    3.  family\_name (last name, granted by the profile scope)
        
    4.  groups (Mandatory, minimum one group is required). If groups is listed under scopes\_supported in your discovery document (https://<your-issuer>/.well-known/openid-configuration), nothing needs to be configured. Otherwise add a groups claim to the application. The claim must be issued in the ID token or userinfo response, not only in the access token. Group names may only contain letters, digits and . - \* \_ (for example Acme-Legal, not Acme Legal)
        
5.  Assign test users to both the application and the group. A user who is not assigned cannot sign in
    
6.  Choose a sign-out URL (Mandatory). Either your identity provider's sign-out endpoint, which also signs the user out of your identity provider, or a landing page such as your intranet. The URL must start with https://. Also add it to the application's sign-out redirect URIs
    
7.  Choose your preferred sign-in alias, for example "company". Your login link will be https://prod.tagd.ai/api/v1/auth/login?org=company. Use lowercase letters, digits and hyphens only
    

### Step 3: Send SSO details to Tagd

Send the following details to [support@tagd.ai](mailto:support@tagd.ai)

-   Issuer URL, exactly as your discovery document reports it (https://, no trailing slash)
    
-   Client ID
    
-   Client secret, sent through a secure channel such as a password manager share link. Not in the body of an email or a chat message
    
-   Confirmation that client authentication is set to client\_secret\_post
    
-   Sign-out URL
    
-   Preferred sign-in alias
    
-   Test user email address
    
-   Group names to sync, spelled exactly as they appear in the groups claim
    
-   Claim names, if they differ from email, given\_name, family\_name and groups
    
-   Optional: a group that should grant the Tagd Administrator role
    
-   Name and email of a technical contact for the go-live
    

Never send user passwords, private keys or identity provider API tokens. Once provided, OpenID Connect authentication will be configured by our team for your organization.

### Step 4: Test the SSO setup

Before rolling out SSO to all users the setup is tested together with someone from our team.

-   Open the login link and verify that it redirects straight to your identity provider
    
-   Perform a test login using an IdP user account, including any multi-factor step
    
-   Verify that the user's name and email appear correctly in Tagd
    
-   Verify that the user is added to the mapped group in Tagd and has the expected role
    
-   Verify that signing out ends the Tagd session and lands on your sign-out URL
    
-   Verify that a user who is not assigned to the application cannot sign in
    

We strongly recommend testing with a limited group of users first. Report any issues to [support@tagd.ai](mailto:support@tagd.ai)

### Step 5: GO-LIVE

Coordinate the go-live of the SSO integration in collaboration with your designated contact from our team:

-   Decide on go-live date, and make sure your technical contact is reachable during the go-live.
    
-   Assign users to the Tagd app in your identity provider. When a user signs in via SSO for the first time, their account will be automatically created or linked based on their email address. Group memberships from your identity provider add the user to the matching Tagd groups.
    
-   Inform your users about the setup and share the login link. Users sign in with their corporate credentials and do not need a separate Tagd password.
