Conflitos de nome de usuário
GitHub normalizará o valor do atributo SCIM userName enviado por um provedor de identidade (IdP) em uma chamada à API SCIM para criar o nome de usuário de cada pessoa em GitHub. Se várias contas forem normalizadas no mesmo GitHub nome de usuário, ocorrerá um conflito de nome de usuário e somente a primeira conta de usuário será criada. Para saber mais, confira Considerações de nome de usuário para autenticação externa.
Como acessar a empresa quando o SSO não estiver disponível
Quando um erro de configuração ou um problema com o IdP do provedor de identidade impede o uso do SSO, você pode usar um Entre em contato com o administrador do seu site que tem acesso ao Console de Gerenciamento para atualizar suas configurações ou desativar o SAML temporariamente. Para obter mais informações, consulte Administrar sua instância por meio da interface do usuário da Web.
Erros de provisionamento SCIM
Microsoft Entra ID (anteriormente conhecido como Azure AD) tentará novamente as tentativas de provisionamento do SCIM automaticamente durante o próximo ciclo de sincronização da ID do Entra. O intervalo de provisionamento SCIM padrão para o Entra ID é de 40 minutos. Para obter mais informações sobre esse comportamento de repetição, confira a documentação da Microsoft ou entre em contato com Suporte da Microsoft se precisar de assistência adicional.
O Okta tentará novamente as tentativas de provisionamento SCIM que falharam, com a intervenção manual do administrador do Okta. Para obter mais informações sobre como um administrador do Okta pode tentar novamente uma tarefa com falha para um aplicativo específico, confira a documentação do Okta ou entre em contato com o suporte do Okta.
Em sua instância em que o SCIM geralmente funciona corretamente, as tentativas individuais de provisionamento de usuários via SCIM às vezes falham. Os usuários não poderão fazer login até que a conta deles seja provisionada para GitHub. Essas falhas de provisionamento de usuário de SCIM individuais resultam em um código de status de intervalo HTTP 400 e normalmente são causadas por problemas com a normalização do nome de usuário ou conflitos de nome de usuário, em que outro usuário com o mesmo nome de usuário normalizado já existe na empresa. Confira Considerações de nome de usuário para autenticação externa.
Erros de autenticação do SAML
Se os usuários estiverem recebendo erros ao tentar autenticar usando SAML, confira Solucionando problemas de autenticação SAML.
Erros de mapeamento de dados SAML e SCIM
Se você usar SAML com SCIM na sua instância GitHub Enterprise Server, e os dados SAML de um usuário não corresponderem à uma identidade existente provisionada pelo SCIM, GitHub retornará um erro.
Para o Entra ID, o erro terá a seguinte aparência:
Para todos os outros provedores de identidade, o erro será semelhante a:
Quando esse erro ocorrer, siga as etapas abaixo:
- Verifique se uma identidade SCIM foi provisionada para o usuário pesquisando os usuários em sua instância. Para obter mais informações sobre como encontrar usuários provisionados por SCIM em sua instância, consulte Visualizar pessoas na sua empresa.
- Se o usuário ainda não foi provisionado, o provedor de identidade ainda não enviou uma solicitação de provisionamento ou a solicitação de provisionamento falhou. Administradores empresariais podem usar eventos do log de auditoria para determinar por qual desses dois cenários eles são afetados. Para obter mais informações, consulte Provisionar usuários e grupos com SCIM usando a API REST.
- Se o usuário tiver sido provisionado com êxito em sua instância, você precisará garantir que o valor do atributo SAML listado na mensagem de erro corresponda ao valor do atributo SCIM listado. Para localizar o valor do atributo SCIM, consulte Visualizar e gerenciar o acesso SAML de um usuário à sua empresa.
- Por exemplo, para solucionar problemas da captura de tela acima, examinaríamos o valor da "ID externa" do SCIM do usuário. Usando esse valor, garantimos que o usuário tenha o valor correto definido com o Provedor de Identidade.
Para obter mais informações sobre como GitHub mapeia dados SAML e SCIM para usuários, consulte Pontos de extremidade da API REST para SCIM.