À propos de la modification des slugs d’entreprise
Lorsque vous créez une entreprise, vous choisissez un « slug » pour l’entreprise. Il s’agit d’une chaîne utilisée dans l’URL de votre entreprise. Par exemple, si vous choisissez octo-enterprise
comme slug, l’URL de votre entreprise sur GitHub.com serait https://github.com/enterprises/octo-enterprise
.
Si votre entreprise paie GitHub Enterprise Cloud par carte de crédit ou PayPal, vous pouvez modifier le slug dans les paramètres de votre entreprise. Si vous modifiez le slug, GitHub ne configure aucune redirection à partir de l’ancienne URL. Votre ancien slug d’entreprise peut immédiatement être utilisé par d’autres clients.
Note
Si vous payez GitHub Enterprise Cloud par facture ou si votre entreprise utilise Enterprise Managed Users, vous devez contacter L’équipe commerciale GitHub pour faire modifier votre slug d’entreprise.
Considérations relatives à la modification de votre champ de données dynamiques d’entreprise
Avant de modifier le slug d’une entreprise, assurez-vous d’avoir pris en compte toutes les parties de la configuration, des automatisations ou des processus de votre entreprise qui peuvent dépendre de l’ancien slug d’entreprise. Pour réduire les perturbations, vous devez traiter ces points immédiatement avant ou immédiatement après la modification du slug.
Les parties de votre système susceptibles d’être affectées par la modification du champ de données dynamiques incluent les éléments suivants, entre autres.
Authentification unique SAML (SSO)
Si vous avez activé l’authentification unique (SSO) SAML au niveau de l’entreprise, vous devez reconfigurer les paramètres dans votre fournisseur d’identité (IdP) pour qu’ils utilisent le nouveau slug d’entreprise. Si vous modifiez le slug, les sessions IdP existantes ne seront pas révoquées, mais vos membres ne pourront pas utiliser la SSO pour accéder aux ressources de votre entreprise tant que vous n’aurez pas mis à jour les paramètres IdP. Si vous avez activé SAML ou SCIM au niveau de l’organisation, la modification du slug n’affectera pas la SSO. Pour plus d’informations, consultez « Configuration d'une authentification unique (SSO) SAML pour votre entreprise ».
Avant que vous ne modifiiez le slug, pour que vous puissiez toujours accéder à votre entreprise même si la SSO ne fonctionne pas, nous vous recommandons de télécharger les codes de récupération pour votre entreprise. Pour plus d’informations, consultez « Téléchargement des codes de récupération de votre compte d’entreprise pour l’authentification unique ».
Points de terminaison d’API
De nombreux points de terminaison d’API GitHub pour la gestion d’entreprise utilisent le slug de l’entreprise comme paramètre. Si vous utilisez ces points de terminaison dans des automatisations, vous devez mettre à jour les appels d’API afin qu’ils utilisent le nouveau slug. Les appels d’API qui utilisent l’ancien slug cesseront immédiatement de fonctionner. L’ID d’entreprise, qui peut être utilisé à la place du slug dans de nombreux cas, n’est pas affecté par un changement de slug.
OpenID Connect avec workflows GitHub Actions
Si vous utilisez OpenID Connect (OIDC) dans les flux de travail GitHub Actions et que vous avez configuré votre fournisseur de cloud pour qu’il accepte uniquement les jetons d’une URL unique qui inclut votre slug d’entreprise, vous devez mettre à jour les paramètres de votre fournisseur de cloud. Pour prévenir l’échec des flux de travail, l’option la plus robuste consiste à configurer votre fournisseur pour qu’il accepte les jetons de l’ancien et du nouveau slug juste avant de modifier le slug. Pour plus d’informations, consultez « À propos du renforcement de la sécurité avec OpenID Connect ».
GitHub Connect
Si votre entreprise est liée à une ou à plusieurs instances GitHub Enterprise Server via GitHub Connect, après avoir modifié le champ de données dynamiques, vous devez réinitialiser la connexion en désactivant puis en réactivant GitHub Connect. Pour plus d’informations, consultez Activation de GitHub Connect pour GitHub.com dans la documentation GitHub Enterprise Server.
Modification du slug de l’entreprise
Note
Avant de modifier le slug d’une entreprise, assurez-vous d’avoir compris les conséquences potentielles. Pour plus d’informations, consultez Considérations relatives à la modification de votre champ de données dynamiques d’entreprise.
-
Dans le coin supérieur droit de GitHub, cliquez sur votre photo de profil.
-
En fonction de votre environnement, cliquez sur Votre entreprise ou sur Vos entreprises, puis cliquez sur l'entreprise que vous souhaitez consulter.
-
Sur le côté gauche de la page, dans la barre latérale du compte d’entreprise, cliquez sur Paramètres.
-
En bas de la page, dans la section Zone de danger, cliquez sur Modifier le slug d’URL d’entreprise.
-
Dans la boîte de dialogue Modifier le slug d’URL d’entreprise, suivez les instructions, puis cliquez sur Modifier le slug d’URL d’entreprise.