Okta

Vous pouvez configurer le SSO en utilisant soit l'application GitGuardian de l'Okta Integration Network (recommandé), soit une application SAML personnalisée.

Prérequis

• Un compte Okta avec des privilèges d'administrateur
• Un workspace GitGuardian avec un rôle Owner ou Manager
• Votre Workspace ID GitGuardian (trouvé dans l'URL de votre tableau de bord ou dans les paramètres du workspace)

Fonctionnalités prises en charge

• SSO initié par le SP : les utilisateurs peuvent se connecter à GitGuardian directement depuis l'URL de l'application
• SSO initié par l'IdP : les utilisateurs peuvent se connecter à GitGuardian depuis le tableau de bord Okta
• Provisioning Just-in-Time (JIT) : les nouveaux utilisateurs sont automatiquement créés dans GitGuardian lors de leur première connexion

astuce

GitGuardian prend également en charge le provisioning SCIM pour Okta. Consultez le guide de configuration SCIM pour les instructions de configuration.

SSO initié par le SP

Les utilisateurs peuvent se connecter directement à GitGuardian sans passer par Okta au préalable :

1. Accédez à l'URL de votre tableau de bord GitGuardian (par exemple, https://dashboard.gitguardian.com).
2. Saisissez votre adresse email.
3. Si votre domaine email est réservé, vous serez automatiquement redirigé vers Okta pour l'authentification.
4. Après authentification avec Okta, vous serez redirigé vers GitGuardian.

Application Okta OIN

L'application GitGuardian est disponible dans l'Okta Integration Network.

1. Dans Okta, accédez à Applications > Applications et cliquez sur Browse App Catalog.

2. Recherchez « GitGuardian » et sélectionnez l'application GitGuardian.

3. Cliquez sur Add Integration.

4. Sur la page General Settings, configurez les éléments suivants :

   • Application label : entrez un nom pour l'application (par exemple, « GitGuardian »).
   • GitGuardian Workspace ID : entrez votre Workspace ID GitGuardian.
   • GitGuardian API FQDN : entrez api.gitguardian.com ou api.eu1.gitguardian.com (ou votre domaine d'API self-hosted).
   • GitGuardian Dashboard FQDN : entrez dashboard.gitguardian.com ou dashboard.eu1.gitguardian.com (ou votre domaine de tableau de bord self-hosted).

   

5. Cliquez sur Done pour créer l'application.

6. Accédez à l'onglet Sign On pour voir la configuration SAML.

7. Faites défiler vers le bas pour trouver les métadonnées SAML et copiez les valeurs suivantes :

   • Sign on URL
   • Issuer
   • Signing Certificate (téléchargez ou copiez)

   

8. Dans votre tableau de bord GitGuardian, accédez à Settings > Authentication et cliquez sur Configure.

   

9. Configurez le fournisseur d'identité avec les valeurs de l'étape précédente :

   • Entity Id : collez la valeur Issuer
   • Single Sign-On URL : collez la valeur Sign on URL
   • X509 Cert : collez le contenu du Signing Certificate
   • Assurez-vous que la case I have mapped the attributes first_name and last_name in my IdP est cochée

   

10. Assignez des utilisateurs à l'application dans l'onglet Assignments.

11. Important : Réservez votre domaine email pour activer la découverte automatique du SSO.

Application SAML personnalisée Okta

Si vous préférez créer une application SAML personnalisée, suivez ces étapes :

1. Dans Okta, accédez à Applications > Applications et cliquez sur Create New App.

   

2. Définissez les informations générales pour votre application SAML (nom, logo) que les utilisateurs verront lors de la connexion.

   

3. Cliquez sur Next et configurez les paramètres SAML de base :

   • Single sign on URL : collez la valeur ACS URL du tableau de bord GitGuardian.
   • Audience URI (SP Entity ID) : collez la valeur SP Entity ID du tableau de bord GitGuardian.
   • Default RelayState : laisser vide.
   • Name ID format : définir sur EmailAddress.

   

4. Cliquez sur Show Advanced Settings et vérifiez les éléments suivants :

   • Response et Assertion Signature sont tous les deux définis sur Signed.
   • Signature Algorithm est défini sur RSA-SHA256.
   • Digest Algorithm est défini sur SHA256.
   • Les assertions ne sont pas chiffrées.

   

5. Complétez les étapes restantes de configuration de l'application.

   

6. Accédez à l'onglet Sign On et configurez les mappings d'attributs :

   • first_name est mappé sur le prénom de l'utilisateur.
   • last_name est mappé sur le nom de famille de l'utilisateur.

   

7. Toujours sur l'onglet Sign On, cliquez sur View Setup Instructions et utilisez les valeurs fournies pour configurer le fournisseur d'identité dans le tableau de bord GitGuardian :

   • Entity Id : collez la valeur Identity Provider Issuer.
   • Single Sign-On URL : collez la valeur Identity Provider Single Sign-On URL.
   • X509 Cert : collez le contenu du X.509 Certificate.
   • Assurez-vous que la case I have mapped the attributes first_name and last_name in my IdP est cochée.

   

8. Important : N'oubliez pas de réserver votre domaine email pour activer la découverte automatique du SSO.