Alteração do URL da sua empresa

Sobre as alterações nos campos de dados dinâmico corporativos

Ao criar uma empresa, você escolhe um "slug" para a empresa, que é uma cadeia de caracteres usada no URL da sua empresa. Por exemplo, se você escolheu octo-enterprise como o slug, a URL da sua empresa em GitHub.com seria https://github.com/enterprises/octo-enterprise.

Se sua empresa paga pelo GitHub Enterprise Cloud com cartão de crédito ou PayPal, você pode alterar o slug nas configurações da empresa. Quando você altera o slug, GitHub não cria redirecionamentos da URL antiga. Seu antigo slug corporativo ficará imediatamente disponível para outro cliente usar.

Considerações ao alterar o slug da sua empresa

Antes de alterar o campo de dados dinâmico de uma empresa, certifique-se de ter considerado todas as partes da configuração, automações ou processos da empresa que possam depender do campo de dados dinâmico corporativo antigo. Para minimizar a interrupção, você deve abordar esses pontos imediatamente antes ou imediatamente após a troca do campo de dados dinâmico.

As partes do seu sistema que podem ser afetadas pela alteração do slug incluem, sem limitação, os seguintes pontos.

Logon único (SSO) do SAML

Se você tiver habilitado o logon único (SSO) SAML no nível corporativo, será necessário redefinir as configurações em seu provedor de identidade (IdP) para usar o novo campo de dados dinâmico corporativo. Quando você altera seu slug, as sessões de IdP existentes não são revogadas, mas os membros não conseguirão usar o SSO para acessar recursos da sua empresa até que você atualize as configurações do IdP. Se você tiver habilitado o SAML ou o SCIM no nível da organização, a alteração do slug não afetará o SSO. Para saber mais, confira Configurar o logon único SAML para sua empresa.

Antes de alterar o slug, para garantir que você terá acesso à sua empresa mesmo que o SSO não esteja funcionando, recomendamos que você baixe os códigos de recuperação da sua empresa. Para saber mais, confira Como fazer o download dos códigos de recuperação de logon único da conta empresarial.

Endpoints de API

Muitos pontos de extremidade da API GitHub para gerenciar uma empresa recebem o slug da empresa como parâmetro. Se você usar esses pontos de extremidade em automações, precisará atualizar as chamadas de API para usar o novo campo de dados dinâmico. Chamadas de API que usam o slug antigo deixarão de funcionar imediatamente. O ID da empresa, que pode ser usado como uma alternativa ao campo de dados dinâmico em muitos casos, não é afetado por uma alteração do campo de dados dinâmico.

OpenID Connect com GitHub Actions fluxos de trabalho

Se você usa o OpenID Connect (OIDC) nos fluxos de trabalho GitHub Actions e configurou seu provedor de nuvem para aceitar apenas tokens de uma URL exclusiva que inclua o slug da empresa, será necessário atualizar as configurações no seu provedor de nuvem. Para evitar que os fluxos de trabalho falhem, a opção mais robusta é configurar seu provedor para aceitar tokens do slug antigo e novo pouco antes de alterar o slug. Para saber mais, confira OpenID Connect.

GitHub Connect

Se sua empresa estiver vinculada a uma ou mais instâncias GitHub Enterprise Server por meio de GitHub Connect, após alterar o slug, você precisará redefinir a conexão desabilitando e, em seguida, reabilitando o GitHub Connect. Para obter mais informações, consulte Habilitando o GitHub Connect para GitHub.com na GitHub Enterprise Server documentação.

Mudando o campo de dados dinâmico da empresa

1. Navegue até sua empresa. Por exemplo, na página Enterprises em GitHub.com.

2. Na parte superior da página, clique em Configurações.

3. Na parte inferior da página, na seção "Zona de Perigo", clique em Alterar o slug de URL da empresa.

4. Na caixa de diálogo "Alterar o campo de dados dinâmico do URL da empresa", siga as instruções e clique em Alterar campo de dados dinâmico do URL da empresa.