Modification de l’URL de votre entreprise

Si vous souhaitez modifier l’URL d’accès à votre entreprise, vous pouvez modifier le slug de l’entreprise.

Qui peut utiliser cette fonctionnalité ?

Enterprise owners can change the URL for the enterprise.

Dans cet article

À propos des modifications du slug 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 devient immédiatement disponible pour un autre client.

Remarque

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. Pour les entreprises hébergées sur le GHE.com, la modification du slug d’entreprise n’est pas prise en charge actuellement.

Considérations liées à la modification du slug de votre 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. Afin de réduire au maximum les perturbations, il est recommandé de traiter ces points juste avant ou immédiatement après la modification du slug.

Certaines parties de votre système peuvent être affectées par la modification du slug, y compris, sans s’y limiter, les éléments suivants.

Authentification unique basée sur SAML (SSO)

Si vous avez activé l’authentification unique SAML (SSO) au niveau de l’entreprise, vous devrez reconfigurer les paramètres de votre fournisseur d’identité (IdP) afin d’utiliser 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’aura aucun effet sur l’authentification unique. 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 de l’API GitHub utilisés pour gérer une entreprise emploient le slug d’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 servir d’alternative au slug dans de nombreux cas, n’est pas affecté par la modification du slug.

OpenID Connect avec les 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 « 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 slug, vous devez réinitialiser la connexion en désactivant puis 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

Remarque

Avant de modifier le slug d’une entreprise, assurez-vous d’avoir compris les conséquences potentielles. Pour plus d’informations, consultez Considérations liées à la modification du slug de votre entreprise.

  1. Accédez à votre entreprise. Par exemple, depuis la page Entreprises sur GitHub.com.

  2. En haut de la page, cliquez sur Paramètres.

  3. En bas de la page, dans la section Zone de danger, cliquez sur Modifier le slug d’URL d’entreprise.

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