SSO

✅ 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.

Fonctions SSO prises en charge

L'intégration CoderPad Okta prend en charge les connexions SSO initiées par le SP et par l'IdP.

Il ne prend pas actuellement en charge le provisionnement juste-à-temps (JIT) ou la déconnexion unique.

Fonctionnalités SCIM prises en charge

Les opérations SCIM suivantes sont prises en charge :

• Création d'utilisateurs
• Mise à jour des attributs de l'utilisateur (nom, nom de famille)
• Désactivation des utilisateurs
• Déprovisionnement des utilisateurs
• Gestion des groupes (Création / Renommage / Suppression / Affectation à des utilisateurs)
• Importation d'utilisateurs dans votre fournisseur d'identité
• Importation de groupes dans votre fournisseur d'identité

É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 .

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

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 d'assertions SP (Note : Vous n'en aurez pas besoin si vous utilisez Okta.)
• URL de connexion IDP

⚠️ Si votre écran CoderPad SSO est différent de celui ci-dessus et que vous devez effectuer des changements, veuillez contacter notre équipe d'assistance pour obtenir de l'aide.

É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
• Azure
• Espace de travail Google

Okta

1. Sur votre page Okta Applications, cliquez sur Browse App Catalog.

2. Sur la page App Integration Catalog, recherchez CoderPad et sélectionnez celui qui porte l'étiquette "SWA".

3. Cliquez sur Ajouter une intégration.

4. Dans Options de signature, sélectionnez SAML 2.0.

5. Laissez le champ Etat du relais par défaut vide.

6. Dans les Paramètres de connexion avancés, indiquez l'SP Entity ID, l'SP Assertion Consumer URL et l'IDP Login URL que vous avez obtenu de CoderPad. Pour le champ Format du nom d'utilisateur de l'application, il existe deux options :

A) Si vos adresses électroniques ne contiennent AUCUNE majuscule, sélectionnez Email.

B) Si l'adresse électronique de l'utilisateur contient des majuscules, CoderPad ne sera pas en mesure d'établir une correspondance avec l'utilisateur et affichera une erreur de connexion. Par conséquent, vous devez changer le Application username format en Custom, et dans la valeur utiliser String.toLowerCase(user.email).

7. Allez dans l'onglet Sign On et copiez l'Metadata URL.

8. Collez le contenu dans la page de configuration SSO de CoderPad.

9. Vous pouvez utiliser un sous-domaine CoderPad personnalisé pour tester votre configuration SSO.

✅Si vous rencontrez des erreurs lors de la connexion, il peut être intéressant de mettre en place une intégration Okta personnalisée au lieu de cette intégration standard, surtout si vous utilisez autre chose que user.email comme email de l'utilisateur dans Okta.

Ajout du provisionnement des utilisateurs SCIM

1. Après avoir sauvegardé la configuration SSO et actualisé la page, faites défiler vers le bas et copiez le SCIM Authentication Token.

2. Retournez à l'application Okta, allez à l'onglet Provisionnement et cliquez sur Configurer l'intégration API.

3. Collez le jeton d'authentification SCIM que vous avez copié depuis CoderPad dans le champ Token API.

4. Cliquez sur le bouton Test API Credentials pour vérifier que les informations d'identification sont correctes, puis cliquez sur Save.

5. Il est maintenant temps de modifier le provisionnement. Naviguez vers Provisionnement > To App et sélectionnez Editer :

6. Cochez Créer des utilisateurs, Mettre à jour les attributs des utilisateurs, Désactiver des utilisateurs.

7. Cliquez sur Sauver.

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

9. Cliquez sur Pousser les groupes >Trouver les groupes par nom.

✅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, allez à Étape 3 : Configuration des groupes SCIM et cliquez sur le lien de configuration.

12. Vous pouvez configurer chaque groupe à partir de la page de configuration du SCIM.

Les groupes peuvent gérer à la fois les permissions et les équipes (lors de l'utilisation de l'espace de travail en équipe). Lorsque vous activez l'option "synchroniser l'accès des utilisateurs en fonction de leurs groupes", l'accès des utilisateurs est automatiquement mis à jour en fonction des définitions des groupes qui leur ont été attribués.

ℹ️If Un groupe n'est pas configuré pour gérer les autorisations, les autorisations de ses utilisateurs resteront inchangées. De même, si un groupe n'est pas configuré pour gérer les équipes, les affectations d'équipe des utilisateurs ne seront pas affectées.

Quelques points à garder à l'esprit lorsque vous travaillez avec le SCIM :

• Vous ne pouvez pas ajouter ou supprimer des noms de groupes, cela se fait par l'intermédiaire de l'intégration SCIM sur votre IDP.
• Les groupes sont optionnels, les utilisateurs sans groupe auront le rôle normal de "membre" et les administrateurs pourront modifier leurs permissions par la suite.
• Les utilisateurs peuvent appartenir à plusieurs groupes.

13. 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.

14. Passez à 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.

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..

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

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

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 :

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

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

• Nom : Utilisateur.Email
• Attribut de la source : 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.

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

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 :

2. Sélectionnez le mode de provisionnement Automatique.

3. Ajoutez les paramètres suivants :

• URL du locataire = URL DU SCIM
• Token secret = Token d'authentification SCIM

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: nom d'affichage, 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 :

• 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é"

8. 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, allez à l'étape 3 : Configuration des groupes SCIM et cliquez sur le lien de configuration.

9. Sur cet écran, vous pouvez configurer chaque groupe à partir de la page de configuration du SCIM.

Les groupes peuvent gérer à la fois les permissions et les équipes (lors de l'utilisation de l'espace de travail en équipe). Lorsque vous activez l'option "synchroniser l'accès des utilisateurs en fonction de leurs groupes", l'accès des utilisateurs est automatiquement mis à jour en fonction des définitions des groupes qui leur ont été attribués.

ℹ️If Un groupe n'est pas configuré pour gérer les autorisations, les autorisations de ses utilisateurs resteront inchangées. De même, si un groupe n'est pas configuré pour gérer les équipes, les affectations d'équipe des utilisateurs ne seront pas affectées.

Quelques points à garder à l'esprit lorsque vous travaillez avec le SCIM :

• Vous ne pouvez pas ajouter ou supprimer des noms de groupes, cela se fait par l'intermédiaire de l'intégration SCIM sur votre IDP.
• Les groupes sont optionnels, les utilisateurs sans groupe auront le rôle normal de "membre" et les administrateurs pourront modifier leurs permissions par la suite.
• Les utilisateurs peuvent appartenir à plusieurs groupes.

10. 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 Azure 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 Azure pour se connecter.

11. Passez à Finish SSO configuration in 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.

• 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

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.

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 à Finish SSO configuration in CoderPad pour terminer la configuration SSO.

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.

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 permettions aux organisations d'avoir à la fois des comptes d'utilisateurs SSO et des comptes d'utilisateurs plus traditionnels (email/mot de passe), nous vous recommandons d'imposer 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 4.