Menu documentation

SSO

Dernière mise à jour le - Available in English

✅ Seuls les plans Enterprise prennent en charge l'intégration SSO. Si vous souhaitez mettre à niveau votre plan pour activer le SSO, veuillez contacter notre équipe de vente.

CoderPad prend en charge les intégrations SSO à l'aide du protocole SAML avec Okta, Microsoft Azure et Google Workspace. Le SSO peut également être combiné avec le provisionnement des utilisateurs via le protocole SCIM.

Conditions préalables à l'activation du SSO sur votre compte CoderPad :

  • Vous devez avoir les droits d'administrateur pour votre compte CoderPad Interview.
  • Vous devez avoir identifié la personne appropriée qui sera en mesure de mettre en œuvre les changements de configuration requis sur votre compte de fournisseur SSO, c'est-à-dire votre administrateur système.

Un échec de connexion à l'échelle du compte peut se produire pour vos utilisateurs au cours du processus de configuration. L'annulation de l'activation SSO sur le compte peut être effectuée à tout moment si la configuration échoue.

ℹ️ A tout moment, même lorsque la configuration SSO est active, il est possible pour un administrateur de se connecter au compte en utilisant l'email et le mot de passe tant que l'option d'application du SSO n'est pas active.

Étape 1 : Obtenir les valeurs de configuration SSO de CoderPad

Pour obtenir les valeurs SSO que vous devrez communiquer à votre fournisseur SSO, vous devrez d'abord accéder à l'écran Team Settings dans CoderPad Interview en cliquant sur cette option dans le menu des paramètres :gear :.

Une flèche pointant vers l'option "paramètres de l'équipe" dans le menu déroulant des paramètres en haut à droite de l'écran.

Ensuite, descendez jusqu'à la section Single Sign-On (SSO) et cliquez sur Configure SSO.

Une capture d'écran qui indique "Single sign-on (SSO)" avec un bouton "configure SSO" en dessous.

L'écran de configuration SSO s'ouvre alors. Dans Étape 1 : Fournir les métadonnées du fournisseur d'identité, vous verrez les trois valeurs dont vous aurez besoin pour votre fournisseur SSO :

  • ID de l'entité SP
  • URL du consommateur de SP Assertion
  • URL de connexion IDP
La section "step 1 : provide identity provider metadata" avec l'identifiant de l'entité SP, l'url du consommateur d'assertion sp, et l'url de connexion idp mis en évidence.

Étape 2 : Configuration du fournisseur SSO

Nous prenons actuellement en charge les fournisseurs SSO suivants. Cliquez sur le lien du fournisseur pour obtenir des instructions sur la manière de mettre en place l'intégration avec CoderPad :


Okta

⚠️Do ne téléchargez ni n'utilisez aucune des applications CoderPad de la boutique Okta, car elles sont obsolètes. Suivez plutôt ces instructions.

1. Connectez-vous à l'interface d'administration d'Okta

L'onglet "Mes applications" d'Okta sur le menu de gauche est sélectionné et une flèche pointe vers le bouton "Admin".

2. Dans le menu, sélectionnez Applications Applications :

L'élément "Applications" dans le menu de gauche est mis en évidence et une flèche pointe vers l'élément de menu hamburger à côté du logo "okta".

3. Sélectionnez Créer une intégration d'application, puis sélectionnez SAML 2.0. Cliquez sur Suivant pour continuer :

Flèche pointant vers le bouton "créer une intégration d'application" en haut à droite de la fenêtre.
Page "Create a new app integration" avec l'option "SAML 2.0" en surbrillance et sélectionnée.

4. Ajoutez ces paramètres généraux :

  • Configurer SAML :
    • URL de l'authentification unique = URL de connexion IDP
    • URI de l'audience (ID de l'entité SP) = ID de l'entité SP
    • Décocher Utilisez ceci pour l'URL du destinataire et l'URL de destination
    • URL du destinataire = URL du consommateur d'assertions SP
    • URL de destination = URL du consommateur d'assertions SP

Les paramètres SAML résultants devraient ressembler à ceci :

L'écran des paramètres SAML. L'URL SSO est https://saml.coderpad.io/login?idp=XXX, l'URL du destinataire et de la destination est https://cognito.coderpad.io/saml2/idpresponse, et l'uri de l'audience est urn:amazon:cognito:sp:us-east-1_y3aJWInG6.

Pour les autres champs, utilisez ces valeurs :

  • Nom Format ID = Non spécifié
  • Nom d'utilisateur de la demande = Email

5. Ajouter les déclarations d'attributs (le SAML ne fonctionnera pas sans elles) :

  • Nom = User.Email
  • Valeur = user.email
La fenêtre de déclaration d'attribut est affichée pour la valeur User.Email = user.email.

⚠️ Lorsque user.email contient des lettres majuscules (même la première lettre en majuscule), CoderPad ne sera pas en mesure de faire correspondre l'utilisateur, ce qui entraînera une erreur de connexion. Pour résoudre ce problème, veuillez consulter et suivre ce document du support OKTA.

Cet article de la base de connaissances montre comment convertir les noms d'utilisateur Okta en caractères minuscules lors de l'affectation d'utilisateurs à une application. La solution proposée s'appuie sur le langage d'expression Okta pour créer un format de nom d'utilisateur d'application personnalisé.

Dans les paramètres SAML, l'entrée "nom d'utilisateur de l'application" est affichée. Elle est définie comme personnalisée, puis String.toLowerCase(user.email) a été saisi dans la zone de texte. En dessous, String.toLowerCase(user.email) est également indiqué comme valeur de la clé User.Email.

6. Ensuite, vous devez obtenir le fichier de métadonnées du fournisseur d'identité auprès d'Okta. Dans l'onglet Sign On de l'application, copiez ou téléchargez le fichier de métadonnées du fournisseur d'identité.

Signer sur l'écran des méthodes avec une flèche pointant vers le lien "identity provider metadata" (métadonnées du fournisseur d'identité).

7. De retour sur la page CoderPad SSO Settings, téléchargez ou collez le fichier dans le champ de saisie correspondant.

L'écran des paramètres SSO de coderpad est affiché avec les options de sélection de fichier et de boîte de texte xml.

7. Testez la configuration : Demandez à l'un de vos utilisateurs de se connecter via le SSO pour vérifier qu'il fonctionne avant de passer aux étapes de provisionnement des utilisateurs.

Ajout du provisionnement des utilisateurs SCIM

Une fois le SSO activé, le provisionnement des utilisateurs peut être activé à l'aide du protocole SCIM :

1. Dans Okta, sélectionnez l'application CoderPad puis Général > Paramètres de l'application > Éditer.

L'écran de configuration de Coderpad avec une flèche pointant vers l'onglet "général". Le bouton "modifier" en haut à droite de la section des paramètres de l'application est mis en évidence.

2. Ensuite, sous Provisionnement, sélectionnez SCIM et cliquez sur Save.

Dans la section de provisionnement, l'option "SCIM" est sélectionnée et mise en évidence.

3. Depuis le nouvel Provisionnementonglet, cliquez sur Editer dans la section Connexion SCIM.

Écran de configuration du Coderpad avec une flèche pointant vers l'onglet "provisioning". Dans la section connexion SCIM, le bouton "modifier" est en surbrillance.

4. Entrez dans les configurations suivantes :

  • URL de base du connecteur SCIM = URL DU SCIM
  • Champ d'identification unique pour les utilisateurs = email
  • Actions de provisionnement prises en charge = Sélectionner toutes les options
  • Mode d'authentification = En-tête HTTP
  • Jeton au porteur (HTTP Header > Authorization > Bearer Token) = Token d'authentification SCIM

L'action Tester la configuration du connecteur devrait réussir à ce stade.

5. Modifiez le provisionnement. Naviguez vers Provisionnement Paramètres To App et sélectionnez Editer :

L'écran de configuration de Codingame avec une flèche pointant vers l'onglet "provisioning". Dans le menu de gauche, l'option "to app" est en surbrillance.

6. Cochez Créer des utilisateurs, mettre à jour les attributs des utilisateurs, désactiver les utilisateurs.

L'écran de provisionnement de l'application est affiché, avec les options de création d'utilisateurs, de mise à jour des attributs de l'utilisateur et de désactivation de l'utilisateur.

7. Cliquez sur Save.

8. Allez dans l'onglet Push Groups de l'App.

Écran de configuration du Codingame avec une flèche pointant vers l'onglet "Push groups".

9. Cliquez sur Push groups >Find groups by name.

Dans le menu déroulant "push groups", une flèche pointe vers l'option "find groups by name".

✅Il est recommandé de sélectionner tous les groupes affectés à l'App Okta.

10. Cliquez sur Save..

11. Les utilisateurs provisionnés par SCIM auront automatiquement des droits d'utilisateur mais pas de droits d'administrateur. Pour gérer les autorisations via SCIM, veuillez créer différents groupes et indiquer à notre équipe d'assistance quel groupe doit avoir quelles permissions (Admin ou Member) ; sinon, vos utilisateurs CoderPad risquent de ne pas disposer de l'accès approprié.

12. Désormais, les utilisateurs ajoutés à vos groupes seront automatiquement créés dans CoderPad avec les autorisations appropriées.

✅ Après avoir assigné de nouveaux utilisateurs avec le SCIM :

  1. Demandez-leur de se connecter d'abord via la tuile Okta de votre entreprise.
  2. Ils recevront alors un courriel contenant un lien sur lequel ils devront cliquer pour vérifier leur adresse électronique.
  3. Ils devront alors se rendre sur le site https://app.coderpad.io/login et saisissez leur adresse électronique une fois pour obtenir la création.
  4. Enfin, ils peuvent cliquer sur la tuile Coderpad dans OKTA pour se connecter.

13. Passez à Etape 3 : Finish SSO configuration in CoderPad pour terminer la configuration SSO.



Azure

1. Configurez une application d'entreprise dans Azure AD correspondant à CoderPad en cliquant sur Applications d'entreprise > + Nouvelle application > + Créez vos propres applications.

Centre d'administration MS Azure AD avec une flèche pointant vers "enterprise applications" et "new application".
Page des demandes avec le bouton "nouvelle demande" en haut au centre de la page mis en évidence.
Page de la galerie Azure AD avec le bouton "créer votre propre application" en surbrillance.

N'utilisez pas l'application Microsoft Entra SAML Toolkit - elle ne permet pas la configuration du SCIM.

2. Saisissez Coderpad comme nom de votre application, sélectionnez l'option Intégrer toute autre application que vous ne trouvez pas dans la galerie (Non-gallery), et cliquez sur Create..

La fenêtre "Créez votre propre application" est ouverte. Le nom de l'application est "coderpad" et l'option "intégrer toute autre application que vous ne trouvez pas dans la galerie" est sélectionnée. Le bouton "Créer" situé en bas de la fenêtre est mis en évidence.

3. Sélectionnez Single sign-on dans le menu de navigation de gauche, puis SAML card dans la galerie au centre.

L'écran de présentation de la nouvelle application est affiché avec une flèche pointant vers l'option "single sign-on" dans le menu naval de gauche.
L'écran d'authentification unique s'affiche avec la carte SAML en surbrillance.

4. Cliquez sur Editer dans la section Configuration SAML de base .

Le bouton "edit" est mis en évidence dans la case "Basic saml configuration" de l'écran d'ouverture de session basée sur SAML.

5. Saisissez les informations suivantes :

  • Identifiant (ID de l'entité) = ID de l'entité SP
  • Ajouter 2 URL de réponse (URL du service consommateur d'assertion) :
    • URL de connexion IDP - assurez-vous que l'URL de connexion IDP Défaut est cochée !
    • URL du consommateur de SP Assertion
  • URL d'inscription = URL de connexion IDP

Sauvegarder la configuration. Voici à quoi elle devrait ressembler :

L'écran d'édition de la configuration de base de saml est affiché. Le premier identifiant est urn:amazon:cognito:sp:us-east-1_y3aJWInG6. L'url de réponse est définie comme https://saml.coderpad.io/login?idp=XXXXXXX, et la case par défaut est cochée. L'url de connexion est définie sur la même url que l'url de réponse.

6. De retour sur la page SAML-based Sign-on, cliquez sur Edit dans la section Attributes & Claims, puis sélectionnez +Add new claim.

Sur l'écran d'ouverture de session basé sur le saml, le bouton "modifier" est mis en évidence dans la section des attributs et des demandes de remboursement.

Ajoutez les éléments suivants dans l'écran Gestion de la réclamation :

  • Nom : Utilisateur.Email
  • Attribut de la source : user.userprincipalname
L'écran Gérer la réclamation s'affiche. Le champ Nom contient "User.Email", le champ Source contient "Attribute" et l'attribut Source est défini comme user.userprincipalname.

✅ Nous nous attendons à ce que ce champ contienne exactement le même courriel que celui qui figure dans CoderPad. Si, pour une raison ou une autre, ce n'est pas le cas, utilisez un autre champ qui devrait correspondre à l'adresse électronique figurant dans CoderPad (en tenant compte des majuscules et des minuscules).

Laissez les autres champs tels quels, puis cliquez sur Sauver.

7. Dans la section Certificats SAML, téléchargez le fichier XML des métadonnées de la fédération.

La page des certificats SAML avec une flèche pointant vers le lien de téléchargement du fichier xml des métadonnées de la fédération.

8. De retour à la page CoderPad SSO Settings, téléchargez ou collez le fichier dans le champ de saisie correspondant.

L'écran des paramètres SSO de coderpad est affiché avec les options de sélection de fichier et de boîte de texte xml.

9. Testez la configuration : Demandez à l'un de vos utilisateurs de se connecter via le SSO pour vérifier qu'il fonctionne avant de passer aux étapes de provisionnement des utilisateurs.

Ajout du provisionnement des utilisateurs SCIM

Une fois le SSO activé, le provisionnement des utilisateurs peut être activé à l'aide du protocole SCIM :

1. À partir de l'application Azure AD, sélectionnez Provisionnement, puis Démarrer :

La page de provisionnement de CodinGame est représentée avec une flèche pointant vers l'option de provisionnement dans la nef de gauche. Le bouton "get started" au centre de la page est mis en évidence.

2. Sélectionnez le mode de provisionnement Automatique.

Le menu déroulant du mode de provisionnement est affiché avec une flèche pointant vers l'option "automatique".

3. Ajoutez les paramètres suivants :

  • URL du locataire = URL DU SCIM
  • Token secret = Token d'authentification SCIM
Page d'identification de l'administrateur avec l'url du locataire et les champs de saisie du jeton secret affichés.

4. L'action Tester la connexion devrait fonctionner correctement à ce stade.

5. Modifiez les mappages de provisionnement :

  • Pour Provisionner les groupes Azure Active Directoryconservez les valeurs par défaut :
    • Activé: Oui
    • Actions de l'objet cible: Créer, Mettre à jour, Supprimer
    • Mappages d'attributs: affichage
    • Nom, membres
  • Pour Provisionner les utilisateurs Azure Active Directorymettre à jour les mappages d'attributs :
    • Activé: Oui
    • Actions de l'objet cible: Créer, Mettre à jour, Supprimer
    • Mappages d'attributs :
      • nom d'utilisateurPrincipalName = nom d'utilisateur (c'est-à-dire l'adresse électronique de connexion)
      • Interrupteur([IsSoftDeleted]...) = actif
      • nom de famille = nom.prénom
      • nom de famille = nom.nom de famille

❗Veillez à effacer le mapping de l'attribut utilisateur avant de le mettre à jour. Tout mapping avec [type eq...] - c'est-à-dire addresses[type eq "work"].country - fera planter le SSO. La bibliothèque que nous utilisons ne prend pas en charge les charges utiles qui incluent des filtres de sélection de valeurs (comme [type eq....]), vous devrez donc vous assurer qu'ils sont supprimés.

6. Ajoutez des utilisateurs et des groupes à l'application :

La page "utilisateurs et groupes" est affichée avec une flèche pointant vers le lien "utilisateurs et groupes" dans le menu de gauche. En haut au centre de l'écran, le bouton "Ajouter un utilisateur/groupe" est mis en évidence.
  • Les utilisateurs ajoutés directement seront créés sans aucune autorisation sur votre compte CoderPad.
  • Les groupes permettent de définir un ensemble commun de permissions automatiquement attribuées aux utilisateurs de ce groupe.

7. Dans le menu de provisionnement :

  • Démarrer le provisionnement
  • Rafraîchir et attendre le "Statut du cycle actuel : Cycle initial terminé"
Tableau de bord Azure avec "Aperçu" en surbrillance dans le menu de navigation de gauche et une flèche pointant vers le bouton "Démarrer le provisionnement" au centre de l'écran.

8. Envoyez une dernière demande à l'équipe d'assistance CoderPad en précisant les autorisations requises pour chaque groupe rattaché à l'application Azure AD.

9. Désormais, les utilisateurs ajoutés à vos groupes seront automatiquement créés dans CoderPad avec les autorisations appropriées.

10. Passez à Étape 3 : Terminer la configuration SSO dans CoderPad pour terminer la configuration SSO.



Espace de travail Google

⚠️ Assurez-vous que vos certificats SAML sont à jour auprès de Google ! Les certificats périmés peuvent vous empêcher d'accéder à CoderPad.

1. Configurer une "App" dans Google Workspace correspondant à CoderPad : Admin Apps > Applications web et mobiles > Add App > Add custom SAML app.

Dans la nef de gauche, l'élément de menu "apps" est mis en évidence.
Le menu des applications a été élargi et le sous-élément "applications web et mobiles" est mis en évidence.
En haut de l'écran, l'onglet "Ajouter une application" est mis en évidence.
Le menu "add app" a été élargi et l'élément de menu "add custom SAML app" est mis en évidence.
  • Copiez et envoyez les paramètres suivants à l'équipe d'assistance CoderPad :
    • URL SSO
    • ID de l'entité
    • Certificat
  • Cliquez sur Continuer et saisissez la configuration suivante dans le champ Détails du fournisseur de services panneau :
    • URL DE L'AEC = URL du consommateur d'assertions SP
    • ID de l'entité = ID de l'entité SP
    • Laissez les autres champs inchangés
  • Cliquez sur Continuer et sur l'écran Attributs cliquez sur l'onglet AJOUTER UNE CARTE bouton :
    • Pour le Attributs de l'annuaire Google, sélectionnez Courriel principal
    • Pour le Attributs de l'application, type Utilisateur.Email
Un mappage de l'email primaire à User.email.

2. Cliquez sur Finish.

 3. Développez le panneau Accès utilisateur de l'application nouvellement créée et activez le service en sélectionnant l'option ON pour tout le monde.

Page d'accès utilisateur avec la flèche d'expansion en surbrillance.
Écran d'état des services avec l'option "Activé pour tous" sélectionnée et mise en évidence.

4. À des fins de test, ajoutez l'utilisateur administrateur de Google Workspace utilisé pour configurer le SSO en tant qu'utilisateur de votre compte CoderPad.

5. Contactez le support CoderPad pour planifier une réunion en temps réel entre l'un de nos ingénieurs et votre administrateur système. Au cours de cette réunion, CoderPad activera le SSO sur votre compte, et vous pourrez alors vérifier que l'utilisateur administrateur de Google Workspace peut effectivement se connecter à CoderPad via le SSO. Tous les ajustements finaux peuvent être effectués au cours de cet appel. Au lieu d'une réunion en temps réel, vous pouvez simplement demander l'activation du SSO en contactant le support.

6. Désormais, tout utilisateur ajouté au compte Google Workspace et au compte CoderPad sera authentifié via Google Workspace.

7. Passez à Étape 3 : Terminer la configuration SSO dans CoderPad pour terminer la configuration SSO.


Étape 3 : Terminer la configuration SSO dans CoderPad

Sous-domaine de connexion SSO

Maintenant que vous avez configuré les informations de votre IdP, vous pouvez personnaliser votre sous-domaine de connexion SSO. Vous disposerez ainsi d'une page de connexion spécifique à votre organisation.

Personnaliser l'ouverture de session avec le sous-domaine "yourcompany.coderpad.io".


Vous devez demander à vos utilisateurs d'utiliser ce sous-domaine pour se connecter ; ils seront accueillis par un écran de connexion spécifique aux utilisateurs SSO pour réduire la confusion.

Toutefois, si l'un de vos utilisateurs tente accidentellement de se connecter via d'autres pages de CoderPad - comme le bouton de connexion de notre page d'accueil - nous le redirigerons vers l'emplacement correct lors de la saisie de l'e-mail.

Application obligatoire du SSO

Bien que nous autorisions les organisations à avoir à la fois des comptes d'utilisateurs SSO et des comptes d'utilisateurs e-mail/mot de passe plus traditionnels, nous vous recommandons d'appliquer la connexion SSO. Les avantages de cette démarche sont les suivants :

  • Simplification de l'authentification à l'échelle de l'organisation
  • Réduction/simplification des demandes d'assistance informatique
  • Possibilité d'ajouter des mesures de sécurité (telles que 2FA)

Pour rendre le SSO obligatoire, il suffit de cocher la case Enforce SSO dans la section de l'étape 3.