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 avez choisi octo-enterprise comme slug, l’URL de votre entreprise serait GitHub.comhttps://github.com/enterprises/octo-enterprise.

Si votre entreprise paye GitHub Enterprise Cloud par carte de crédit ou par PayPal, vous pouvez modifier l’indicateur dans les paramètres de votre entreprise. Lorsque 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 modifier votre slug d’entreprise. Pour les entreprises hébergées sur GHE.com, il n’est actuellement pas possible de modifier l’identifiant de l’entreprise.

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 GitHub points de terminaison d’API permettant de gérer une entreprise prennent 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 servir d’alternative au slug dans de nombreux cas, n’est pas affecté par la modification du slug.

OpenID Connect avec GitHub Actions flux de travail

Si vous utilisez OpenID Connect (OIDC) dans GitHub Actions les flux de travail et que vous avez configuré votre fournisseur de cloud pour accepter uniquement des jetons à partir d’une URL unique qui inclut votre slug d’entreprise, vous devez mettre à jour les paramètres dans 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 GitHub Enterprise Server instances via GitHub Connect, après avoir modifié la slug, vous devez réinitialiser la connexion en désactivant, puis en reenabling GitHub Connect. Pour plus d’informations, consultez Activation de GitHub Connect pour GitHub.com dans la GitHub Enterprise Server documentation.

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.