Aller au contenu
Centre d'aide Clevera

Configurer le SSO avec Okta

Configuration étape par étape d'Okta pour l'authentification unique (SSO) de Clevera, avec SAML 2.0 ou OpenID Connect : les paramètres de l'application Okta, les valeurs Okta à saisir dans chaque champ Clevera, l'attribution des utilisateurs et les tests.

Mis à jour 6 min de lecture

Configurez l'authentification unique entre Okta et Clevera afin que votre équipe puisse se connecter avec son compte Okta. Vous pouvez vous connecter via SAML 2.0 ou OpenID Connect (OIDC) ; ce guide détaille les deux méthodes, côté Okta et pour les champs correspondants dans Clevera.

La console d'administration d'Okta change régulièrement. Si une étiquette ci-dessous ne correspond pas à ce que vous voyez, recherchez le paramètre ayant la même signification et utilisez les guides généraux pour obtenir la liste complète des valeurs : SAML, OIDC.

Avant de commencer

  • Vous êtes le Propriétaire d'un espace de travail Clevera sur un Plan personnalisé.
  • Vous êtes un administrateur Okta capable de créer et d'attribuer des intégrations d'applications.
  • Vous connaissez les domaines d'e-mail utilisés par vos collaborateurs dans Okta, tels que acme.example.

Ouvrez d'abord la boîte de dialogue de configuration de Clevera pour pouvoir y copier les valeurs : ouvrez le menu de l'espace de travail en haut de la barre latérale, choisissez Paramètres de l'équipe, puis Sécurité, et cliquez sur Configurer le SSO. Choisissez Okta comme Fournisseur d'identité.

Étape 1 de la boîte de dialogue de configuration SSO avec Okta et SAML 2.0 sélectionnés, ainsi que l'ID d'entité, l'URL ACS et l'URL des métadonnées à copier
Copiez ces trois valeurs dans votre fournisseur d'identité.

Se connecter avec SAML 2.0

  1. Créer l'application dans Okta

    Dans la console d'administration Okta, accédez à Applications → Applications et cliquez sur Create App Integration. Choisissez SAML 2.0 et cliquez sur Suivant. Nommez-la Clevera et cliquez sur Suivant.

  2. Saisir les valeurs de Clevera

    Sous SAML Settings, remplissez :

    Champ Okta Valeur depuis Clevera
    Single sign-on URL ACS URL (Reply URL) : https://app.clevera.ai/sso/saml/callback. Gardez Use this for Recipient URL and Destination URL coché.
    Audience URI (SP Entity ID) Entity ID / Audience URI (copiez-le depuis la boîte de dialogue Clevera ; il se termine par l'ID de votre espace de travail)
    Default RelayState Laissez vide
    Name ID format EmailAddress
    Application username Email
  3. Vérifier la signature

    Cliquez sur Show Advanced Settings et vérifiez que Response et Assertion Signature sont toutes deux Signed, que Signature Algorithm est RSA-SHA256 et que Assertion Encryption est Unencrypted. Clevera nécessite que la réponse et l'assertion soient signées.

  4. Ajouter des attributs de nom

    Sous Attribute Statements, ajoutez firstName avec la valeur user.firstName et lastName avec la valeur user.lastName. Clevera les utilise pour nommer les nouveaux comptes. Cliquez sur Suivant, répondez à la question de feedback d'Okta en indiquant qu'il s'agit d'une application interne, puis cliquez sur Terminer.

  5. Copier les valeurs d'Okta dans Clevera

    Dans l'onglet Sign On de l'application, ouvrez les détails de configuration SAML (View SAML setup instructions ou More details dans les consoles plus récentes). Dans Clevera, réglez Protocol sur SAML 2.0, cliquez sur Continuer et collez :

    Valeur Okta Champ Clevera
    Identity Provider Issuer (ou Issuer) IdP Entity ID
    Identity Provider Single Sign-On URL (ou Sign on URL) SSO sign-in URL
    X.509 Certificate (ou Signing Certificate) X.509 certificate

    Laissez Logout URL vide, sauf si vous utilisez la déconnexion unique d'Okta.

    Étape 2 de la boîte de dialogue de configuration SSO avec l'ID d'entité IdP, l'URL de connexion et le certificat renseignés
    L'URL de déconnexion est facultative.
  6. Attribuer des utilisateurs

    Dans l'onglet Assignments de l'application, cliquez sur Assign et ajoutez les personnes ou les groupes qui doivent utiliser Clevera. Les personnes non attribuées ne pourront pas se connecter via Okta.

Terminez ensuite dans Clevera : domaines et rôles.

Se connecter avec OpenID Connect

  1. Créer l'application dans Okta

    Accédez à Applications → Applications → Create App Integration. Choisissez OIDC - OpenID Connect, puis Web Application, et cliquez sur Suivant.

  2. Définir l'URI de redirection

    Dans la boîte de dialogue de configuration de Clevera, réglez Protocol sur OpenID Connect et copiez l'URI de redirection (URL de rappel) depuis la zone grise. Remplissez ensuite Okta :

    Champ Okta Valeur
    App integration name Clevera
    Grant type Authorization Code
    Sign-in redirect URIs L'URI de redirection (URL de rappel) : https://app.clevera.ai/sso/oidc/callback
    Sign-out redirect URIs Supprimez l'exemple ; laissez vide
    Controlled access Choisissez qui peut utiliser l'application, ou Skip group assignment for now pour attribuer plus tard

    Cliquez sur Enregistrer.

  3. Copier les identifiants

    Dans l'onglet Général de l'application, sous Client Credentials, copiez le Client ID et le Client secret. Laissez Client authentication réglé sur Client secret.

  4. Remplir dans Clevera

    Dans Clevera, cliquez sur Continuer et saisissez :

    Champ Clevera Valeur
    Client ID Client ID d'Okta
    Client secret Client secret d'Okta
    Discovery URL https:// votre domaine Okta /.well-known/openid-configuration, par exemple https://acme.okta.com/.well-known/openid-configuration

    Si vous utilisez un serveur d'autorisation personnalisé, utilisez plutôt sa propre URL de découverte, par exemple https://acme.okta.com/oauth2/default/.well-known/openid-configuration.

    Étape 2 de la boîte de dialogue de configuration SSO pour OpenID Connect avec l'ID client, le secret et l'URL de découverte
    Avec une URL de découverte, les champs de point de terminaison restent masqués.
  5. Attribuer des utilisateurs

    Dans l'onglet Assignments, attribuez les personnes ou les groupes qui doivent utiliser Clevera.

Terminer dans Clevera

  1. Dans Domaines et rôles, ajoutez chaque domaine d'e-mail que possèdent vos utilisateurs Okta, choisissez Créer des comptes à la première connexion et le Rôle par défaut pour les nouveaux membres SSO.
  2. Dans Examiner, cliquez sur Enregistrer la configuration.
  3. Cliquez sur Exécuter le test, activez Activer le SSO, et connectez-vous en tant qu'utilisateur test attribué dans une fenêtre privée, en partant de la page de connexion Clevera.
  4. Une fois que cela fonctionne pour tout le monde, activez Exiger le SSO si vous souhaitez que le SSO soit le seul moyen d'accès.

Les membres saisissent ensuite leur e-mail professionnel sur la page de connexion Clevera et cliquent sur Continuer avec Okta.

Dépannage

Problème À vérifier
"SSO authentication failed…" juste après la connexion Okta, avec SAML Response et Assertion Signature sont toutes deux Signed ; le certificat dans Clevera est le certificat de signature actuel de l'application ; l'Audience URI correspond exactement à l'ID d'entité de Clevera.
"SSO session expired. Please try again." après avoir cliqué sur la tuile Clevera dans Okta Attendu : la connexion doit commencer sur la page de connexion Clevera.
Okta indique que l'utilisateur n'est pas attribué à l'application Attribuez-le dans l'onglet Assignments de l'application.
"Your email domain is not authorized for this team's SSO." L'e-mail Okta de la personne utilise un domaine qui ne figure pas dans les Domaines d'e-mail autorisés. Ajoutez-le dans Clevera.
Okta affiche une erreur d'URI de redirection (OIDC) Les Sign-in redirect URIs doivent être exactement l'URI de redirection (URL de rappel) de Clevera, https://app.clevera.ai/sso/oidc/callback.

Plus de messages : Résoudre les problèmes de connexion SSO.