Synchronisation d’une équipe avec un groupe de fournisseurs d’identité

À propos de la synchronisation d’équipe

Si la synchronisation des équipes est activée pour votre organisation ou votre compte d'entreprise, vous pouvez synchroniser une équipe GitHub avec un groupe IdP. Ainsi, les modifications apportées à l'adhésion au groupe IdP sont automatiquement répercutées sur GitHub, ce qui réduit le besoin de mises à jour manuelles et de scripts personnalisés. Pour plus d’informations, consultez Gestion de la synchronisation des équipes pour votre organisation et Gestion de la synchronisation d’équipe pour les organisations de votre entreprise.

Vous pouvez connecter jusqu’à cinq groupes IdP à une GitHub équipe. Vous pouvez affecter un groupe IdP à plusieurs GitHub équipes.

La synchronisation d’équipe ne prend pas en charge les groupes IdP avec plus de 5 000 membres.

Une fois qu’une équipe GitHub est connectée à un groupe IdP, votre administrateur idP doit apporter des modifications à l’appartenance à l’équipe via le fournisseur d’identité. Vous ne pouvez pas gérer les membres de l’équipe sur GitHub ni à l’aide de l’API.

Si votre organisation appartient à un compte d’entreprise, l’activation de la synchronisation d’équipe pour le compte d’entreprise remplace les paramètres de synchronisation d’équipe au niveau de l’organisation. Pour plus d’informations, consultez « Gestion de la synchronisation d’équipe pour les organisations de votre entreprise ».

La synchronisation d’équipe n’est pas un service d’attribution d’utilisateurs. Dans la plupart des cas, elle n’invite pas les non-membres à rejoindre des organisations. Cela signifie qu’un utilisateur est ajouté avec succès à une équipe uniquement s’il est déjà membre de l’organisation. Toutefois, vous pouvez également autoriser la synchronisation d’équipe à réinviter des utilisateurs qui étaient précédemment membres de l’organisation et qui ont été supprimés. Pour plus d’informations, consultez Gestion de la synchronisation des équipes pour votre organisation et Gestion de la synchronisation d’équipe pour les organisations de votre entreprise.

Toutes les modifications de la composition de l’équipe effectuées via votre IdP apparaîtront dans le journal d’audit sur GitHub comme des modifications effectuées par le bot de synchronisation de l’équipe. La synchronisation d’équipe récupère (fetch) les informations de groupe de votre fournisseur d’identité au moins une fois par heure et reflète les modifications apportées à l’appartenance au groupe de fournisseurs d’identité dans GitHub. La connexion d’une équipe à un groupe IdP peut entraîner la suppression de certains membres de l’équipe. Pour plus d’informations, consultez Conditions requises pour les membres d’équipes synchronisées.

Des équipes parentes ne peuvent pas se synchroniser avec des groupes IdP. Si l’équipe que vous souhaitez connecter à un groupe de fournisseurs d’identité est une équipe parente, nous vous recommandons de créer une équipe ou de supprimer les relations imbriquées qui font de votre équipe une équipe parente. Pour plus d’informations, consultez À propos des équipes d'organisation, Créer une équipe d’organisation et Déplacement d’une équipe dans la hiérarchie de votre organisation.

Pour gérer l’accès au dépôt pour n’importe quelle équipe GitHub, y compris les équipes connectées à un groupe IdP, vous devez effectuer les modifications avec GitHub. Pour plus d’informations, consultez « À propos des équipes d'organisation » et « Gestion de l’accès de l’équipe à un dépôt de l’organisation ».

Vous pouvez également gérer la synchronisation d’équipe avec l’API. Pour plus d’informations, consultez Points de terminaison d’API REST pour la synchronisation d’équipe.

Conditions requises pour les membres d’équipes synchronisées

Une fois que vous avez connecté une équipe à un groupe IdP, la synchronisation d’équipe ajoute chaque membre du groupe IdP à l’équipe GitHub correspondante uniquement si :

• Si la synchronisation de l’équipe n’est pas autorisée à envoyer des invitations à des personnes qui ne sont pas membres de votre organisation, cette personne est déjà membre de l’organisation dans GitHub.
• La personne s’est déjà connectée à GitHub avec son compte personnel et s’est authentifiée au compte de l’organisation ou de l’entreprise par authentification unique SAML au moins une fois.
• L’identité SSO de la personne est membre du groupe de fournisseurs d’identité.

Les équipes ou les membres de groupe existants qui ne répondent pas à ces critères seront automatiquement supprimés de l’équipe GitHub et perdront l’accès aux référentiels. La révocation de l’identité liée d’un utilisateur a également pour effet de supprimer l’utilisateur de toute équipe mappée aux groupes de fournisseur d’identité. Pour plus d’informations, consultez « Affichage et gestion de l’accès SAML d’un membre à votre organisation » et « Visualisation et gestion de l’accès SAML d’un utilisateur à votre entreprise ».

Un membre d'équipe supprimé peut être réintégré automatiquement à une équipe une fois qu'il s'est authentifié auprès du compte d'organisation ou d'entreprise via SSO et qu'il est déplacé vers le groupe IdP connecté.

Pour éviter toute suppression involontaire de membres d’équipe, nous vous recommandons de mettre en œuvre un SSO SAML dans votre compte d’organisation ou d’entreprise, et de créer de nouvelles équipes afin de synchroniser les données d'adhésion, tout en vérifiant l'appartenance au groupe du fournisseur d'identité (IdP) avant de synchroniser les équipes existantes. Pour plus d’informations, consultez « Appliquer l’authentification unique SAML pour votre organisation » et « Configuration d'une authentification unique (SSO) SAML pour votre entreprise ».

Prérequis

Pour connecter une équipe sur GitHub à un groupe IdP, l'équipe doit déjà exister dans votre organisation. Même si vous avez configuré le provisionnement SCIM, la création d'un groupe dans votre IdP ne crée pas automatiquement une équipe sur GitHub.

Avant de pouvoir connecter une GitHub équipe à un groupe IdP, un propriétaire d’organisation ou d’entreprise doit activer la synchronisation d’équipe pour votre organisation ou compte d’entreprise. Pour plus d’informations, consultez « Gestion de la synchronisation des équipes pour votre organisation » et « Gestion de la synchronisation d’équipe pour les organisations de votre entreprise ».

Pour éviter toute suppression involontaire de membres d’équipe, visitez le portail d’administration de votre fournisseur d’identité, et vérifiez que chaque membre de l’équipe actuelle se trouve également dans les groupes de fournisseurs d’identité que vous souhaitez connecter à cette équipe. Si vous n’avez pas accès à votre fournisseur d’identité, vous pouvez contacter l’administrateur de votre fournisseur d’identité.

Vous devez vous authentifier avec SAML SSO. Pour plus d’informations, consultez « Authentification avec connexion unique ».

Connexion d’un groupe IdP à une équipe

Lorsque vous connectez un groupe IdP à une GitHub équipe, tous les utilisateurs du groupe sont automatiquement ajoutés à l’équipe.

1. Dans le coin supérieur droit de GitHub, cliquez sur votre photo de profil, puis sur Vos organisations.

2. Cliquez sur le nom de votre organisation.

3. Sous le nom de votre organisation, cliquez sur Teams.

   

4. Cliquez sur le nom de l’équipe.

5. En haut de la page de l'équipe, cliquez sur Paramètres.

   

6. Sous « Groupes de fournisseurs d’identité », sélectionnez le menu déroulant Sélectionner des groupes et cliquez sur jusqu’à 5 groupes de fournisseurs d’identité.

7. Cliquez sur Save changes.

Déconnexion d’un groupe de fournisseurs d’identité d’une équipe

1. Dans le coin supérieur droit de GitHub, cliquez sur votre photo de profil, puis sur Vos organisations.

2. Cliquez sur le nom de votre organisation.

3. Sous le nom de votre organisation, cliquez sur Teams.

   

4. Cliquez sur le nom de l’équipe.

5. En haut de la page de l'équipe, cliquez sur Paramètres.

   

6. Sous « Groupes de fournisseurs d’identité », à droite du groupe IdP que vous souhaitez déconnecter, cliquez sur .

7. Cliquez sur Save changes.