Skip to main content

Solucionar problemas no uso da licença para o GitHub Enterprise

Você pode solucionar o uso da licença para sua empresa através de relatórios de licença auditados.

Enterprise owners can review license usage for GitHub Enterprise.

Sobre uso inesperado da licença

Se o número de licenças consumidas da sua empresa for inesperado, você pode revisar o seu relatório de licença consumido para auditar o uso da sua licença em todas as suas implantações corporativas e assinaturas. Para obter mais informações, consulte "Visualizando o uso da licença para o GitHub Enterprise" e "Visualizando a assinatura e o uso da conta corporativa".

Se você encontrar erros, você poderá tentar as etapas de solução de problemas.

Por razões de privacidade, os proprietários das empresas não podem acessar diretamente os detalhes das contas de usuários, a menos que você use Enterprise Managed Users.

Sobre o cálculo das licenças consumidas

GitHub cobra para cada pessoa que utiliza implantações de GitHub Enterprise Server, é integrante de uma das suas organizações em GitHub Enterprise Cloud ou é um Visual Studio subscriber. Para obter mais informações sobre as pessoas da sua empresa que consomem uma licença, consulte "Sobre preços por usuário".

Para cada usuário consumir uma única estação, independentemente de quantas implantações eles usam, você deve sincronizar o uso da licença entre GitHub Enterprise Server e GitHub Enterprise Cloud. Para obter mais informações, consulte "Sincronizando uso de licença entre GitHub Enterprise Server e GitHub Enterprise Cloud".

Depois de sincronizar o uso da licença, GitHub corresponde as contas de usuário em GitHub Enterprise Server a contas em GitHub Enterprise Cloud por endereço de e-mail.

Primeiro, verificamos o endereço de e-mail principal de cada usuário em GitHub Enterprise Server. Em seguida, tentamos corresponder esse endereço ao endereço de e-mail de uma conta de usuário em GitHub Enterprise Cloud. Se a empresa usa SSO SAML, primeiro verificamos atributos do SAML a seguir para endereços de e-mail.

  • http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name
  • http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress
  • nome de usuário
  • NameID
  • emails

Se nenhum endereço de e-mail encontrado nestes atributos corresponder ao endereço de e-mail principal em GitHub Enterprise Server, ou se sua empresa não usa o SAML SSO, verificamos os endereços de e-mail verificados por cada usuário no GitHub Enterprise Cloud. Para obter mais informações sobre a verificação de endereços de e-mail em GitHub.com, consulte "Verificando seu endereço de e-mail" na documentação de GitHub Enterprise Cloud.

Campos nos arquivos de licença consumidos

O relatório de uso da licença de GitHub.com e o arquivo de uso da licença exportado de GitHub Enterprise Server incluem uma série de campos para ajudar você a resolver o uso de licença para a sua empresa.

Relatório do uso da licença de GitHub.com (arquivo CSV)

O relatório de uso da licença para a sua empresa é um arquivo CSV que contém as seguintes informações sobre os integrantes da sua empresa. Alguns campos são específicos para a implantação do seu GitHub Enterprise Cloud (GHEC), GitHub Enterprise Server (GHES) ambientes conectados ou as suas assinaturas de Visual Studio (VSS) com o GitHub Enterprise.

CampoDescrição
github_com_loginO nome de usuário da conta GHEC do usuário
github_com_nameO nome de exibição da conta GHEC do usuário
github_com_profileA URL para a página de perfil do usuário no GHEC
github_com_userSe o usuário tem ou não uma conta no GHEC
github_com_member_rolesPara cada organização à qual o usuário pertence ao GHEC, o nome da organização e a função do usuário na organização (proprietário ou membro) separados por dois pontos

organizações delimitadas por vírgulas
github_com_enterprise_rolePode ser: Proprietário, Integranteou Colaborador externo
github_com_verified_domain_emailsTodos os endereços de e-mail associados à conta GHEC do usuário que correspondem aos domínios verificados da sua empresa
github_com_saml_name_idO nome de usuário do SAML
github_com_orgs_with_pending_invitesTodos os convites pendentes para a conta do GHEC do usuário para participar de organizações na empresa
license_typePode ser: Assinatura do Visual Studio ou Enterprise
enterprise_server_userSe o usuário tem ou não uma conta no GHES
enterprise_server_primary_emailsOs endereços de e-mail principais associados a cada uma das contas do GHES do usuário
enterprise_server_user_idsPara as contas do GHES de cada usuário, o ID de usuário da conta
total_user_accountsO número total de contas que a pessoa tem em GHEC e GHES
visual_studio_subscription_userSe o usuário é ou não um Visual Studio subscriber
visual_studio_subscription_emailO endereço de e-mail associado ao VSS do usuário
visual_studio_license_statusSe a licença do Visual Studio foi correspondida a um usuário de GitHub

Visual Studio subscribers que ainda não são integrantes de pelo menos uma organização na sua empresa serão incluídos no relatório com um status de convite pendente, e faltarão os valores para o campo "Nome" ou "Link do perfil".

GitHub Enterprise Server exportou o uso da licença (arquivo JSON)

O uso da sua licença de GitHub Enterprise Server é um arquivo JSON normalmente usado ao executar uma sincronização manual de licenças de usuário entre GitHub Enterprise Server e GitHub Enterprise Cloud. O arquivo contém as seguintes informações específicas ao seu ambiente GitHub Enterprise Server.

CampoDescrição
FuncionalidadesAs funcionalidades de GitHub Connect que estão habilitadas na instância do seu GitHub Enterprise Server, e a data e hora da habilitação.
Nome de hostO nome do host da sua instância de GitHub Enterprise Server.
Apenas HTTPSe a Segurança de camada de transporte (TLS) está habilitada e configurada na sua instância de GitHub Enterprise Server. Pode ser: Verdadeiro ou Falso.
LicençaUm hash da sua licença do GitHub Enterprise Server.
Chave públicaA parte de chave pública da sua licença de GitHub Enterprise Server.
ID do ServidorUUID gerado para sua instância de GitHub Enterprise Server.
VersãoA versão da sua instância do GitHub Enterprise Server.

Solução de problemas das licenças consumidas

Para garantir que cada usuário esteja apenas consumindo uma única estação para diferentes implantações e assinaturas, experimente as seguintes etapas de resolução de problemas.

  1. Para ajudar a identificar os usuários que estão consumindo várias estações, se sua empresa usa domínios verificados para GitHub Enterprise Cloud, revise a lista de integrantes da empresa que não possuem um endereço de e-mail de um domínio verificado associado à sua conta em GitHub.com. Frequentemente, estes são os usuários que consomem erroneamente mais de uma estação licenciada. Para obter mais informações, consulte "Visualizando integrantes sem um endereço de e-mail de um domínio verificado".

    Observação: Para facilitar a resolução de problemas, recomendamos usar domínios verificados com a sua conta corporativa em GitHub.com. Para obter mais informações, consulte "Verificando ou aprovando um domínio para sua empresa".

  2. Depois de identificar usuários que estão consumindo vários lugares, certifique-se que o mesmo endereço de e-mail está associado a todas as contas do usuário. Para obter mais informações sobre quais endereços de e-mail devem corresponder, consulte "Sobre o cálculo das licenças consumidas".

  3. Se um endereço de e-mail foi recentemente atualizado ou verificado para corrigir uma incompatibilidade, consulte o registro de hora do último trabalho de sincronização de licença. Se um trabalho não for executado desde que a correção foi feita, acione um novo trabalho manualmente. Para obter mais informações, consulte "Uso da licença de sincronização entre o GitHub Enterprise Server e o GitHub Enterprise Cloud".

Se você ainda tiver dúvidas sobre as suas licenças consumidas após revisar as informações de solução de problemas acima, você pode entrar em contato com Suporte do GitHub por meio do Portal de suporte do GitHub.