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 no GitHub.com será https://github.com/enterprises/octo-enterprise.

Se sua empresa pagar por GitHub Enterprise Cloud usando cartão de crédito ou PayPal, você poderá alterar o campo de dados dinâmico nas configurações de sua empresa. Quando você altera o slug, a GitHub não configura nenhum redirecionamento da URL antiga. Seu antigo slug corporativo ficará imediatamente disponível para outro cliente usar.

Observação

Se você pagar por GitHub Enterprise Cloud via fatura ou se sua empresa usar Enterprise Managed Users, entre em contato com Equipe de vendas do GitHub para alterar o campo de dados dinâmico da empresa. Para empresas hospedadas no GHE.com, não é possível alterar o slug da empresa no momento.

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 de API de GitHub para gerenciar uma empresa usam o campo de dados dinâmico corporativo 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.

Fluxos de trabalho GitHub Actions com OpenID Connect

Se você usar o OpenID Connect (OIDC) em fluxos de trabalho de GitHub Actions e tiver configurado seu provedor de nuvem para aceitar apenas tokens de uma URL exclusiva que inclua o slug da sua 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, será necessário redefinir a conexão desabilitando e reativando GitHub Connect. Para obter mais informações, consulte Habilitando o GitHub Connect para GitHub.com na documentação do GitHub Enterprise Server.

Mudando o campo de dados dinâmico da empresa