Skip to main content
Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais recentes, acesse a documentação em inglês. Se houver problemas com a tradução desta página, entre em contato conosco.

Esta versão do GitHub Enterprise foi descontinuada em 2022-06-03. Nenhum lançamento de patch será feito, mesmo para questões críticas de segurança. Para obter melhor desempenho, melhorar a segurança e novos recursos, upgrade to the latest version of GitHub Enterprise. Para ajuda com a atualização, contact GitHub Enterprise support.

Considerações de nome de usuário para autenticação externa

Ao usar CAS, LDAP ou SAML para autenticação, GitHub Enterprise Server irá seguir certas regras para determinar o nome de usuário para cada conta na sua instância.

Sobre nomes de usuário com autenticação externa

Você pode configurar a autenticação externa para GitHub Enterprise Server, usando o CAS, LDAP ou SAML. Para obter mais informações, consulte "Sobre a autenticação para sua empresa".

Ao usar a autenticação externa, your GitHub Enterprise Server instance cria automaticamente um nome de usuário para cada pessoa quando esta efetua o login em your GitHub Enterprise Server instance por meio do seu sistema de autenticação externa pela primeira vez.

Os nomes de usuário não deve exceder 39 caracteres.

Sobre a normalização de usuário

Os nomes de usuário para contas de usuário em GitHub Enterprise Server podem conter apenas caracteres alfanuméricos e traços (-).

Ao configurar o CAS, LDAP ou autenticação SAML, GitHub Enterprise Server usa um identificador da conta do usuário no provedor de autenticação externo para determinar o nome de usuário correspondente em GitHub Enterprise Server. Se o identificador incluir caracteres não compatíveis, GitHub Enterprise Server normalizará o nome de usuário para cada uma das seguintes regras.

  1. GitHub Enterprise Server normalizará qualquer caractere não alfanumérico do nome de usuário da sua conta em um traço. Por exemplo, um nome de usuário de mona.the.octocat será normalizado para mona-the-octocat. Observe que nomes de usuários normalizados também não podem iniciar ou terminar com um traço. Eles também não podem conter dois traços consecutivos.

  2. Nomes de usuário criados a partir de endereços de e-mail são criados a partir dos caracteres normalizados que precedem o caractere @.

  3. Se várias contas forem normalizadas para o mesmo nome de usuário GitHub Enterprise Server, será criada apenas a primeira conta de usuário. Usuários subsequentes com o mesmo nome de usuário não serão capazes de fazer o login.

Exemplos de normalização de nome de usuário

Identificador no provedorNome de usuário normalizado em GitHubResultado
The.Octocatthe-octocatNome de usuário criado com sucesso.
!The.Octocat-the-octocatEste nome de usuário não é criado, porque começa com um traço.
The.Octocat!the-octocat-Este nome de usuário não é criado, porque termina com um traço.
The!!Octocatthe--octocatEste nome de usuário não é criado, porque contém dois traços consecutivos.
The!Octocatthe-octocatEste nome de usuário não é criado. Embora o nome de usuário normalizado seja válido, ele já existe.
The.Octocat@example.comthe-octocatEste nome de usuário não é criado. Embora o nome de usuário normalizado seja válido, ele já existe.
mona.lisa.the.octocat.from.github.united.states@example.commona-lisa-the-octocat-from-github-united-statesEste nome de usuário não é criado, porque excede o limite de 39 caracteres.

Sobre a normalização de usuário com SAML

Se você configurar a autenticação do SAML para your GitHub Enterprise Server instance, GitHub Enterprise Server determinará o nome de usuário de cada pessoa por uma das seguintes afirmações na resposta SAML, em ordem decrescente.

  1. O atributo de nome de usuário personalizado, se definido e presente
  2. Declaração http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name, se houver;
  3. Declaração http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress, se houver;
  4. Elemento NameID.

GitHub Enterprise Server exige o elemento NameID mesmo que outros atributos estejam presentes. Para obter mais informações, consulte "Referência de configuração do SAML".

GitHub Enterprise Server cria um mapeamento entre NameID do IdP e o nome de usuário em your GitHub Enterprise Server instance. Portanto, o NameID deve ser persistente, único e não sujeito a alterações para o ciclo de vida do usuário.

Observação: Se o NameID para um usuário for alterado no IdP, a pessoa verá uma mensagem de erro ao efetuar o login em your GitHub Enterprise Server instance. Para restaurar o acesso da pessoa, você deverá atualizar o mapeamento de NameID da conta do usuário. Para obter mais informações, consulte "Atualizando NameID do SAML de um usuário."