Skip to main content

Solução de problemas de uso de licenças para GitHub Enterprise

Você pode solucionar problemas de uso de licença para sua empresa auditando os relatórios de licença.

Who can use this feature

Enterprise owners can review license usage for GitHub Enterprise.

Sobre o uso inesperado de licenças

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

Se você encontrar erros, tente as etapas de solução de problemas.

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

Sobre o cálculo de licenças consumidas

GitHub fatura para cada pessoa que usa implementações do GitHub Enterprise Server, é membro de uma das suas organizações do GitHub Enterprise Cloud ou é um Visual Studio subscriber. Para obter mais informações sobre as pessoas em sua empresa que consomem uma licença, confira "Sobre preços por usuário".

Para que cada usuário consuma apenas uma estação, independentemente de quantas implantações eles usam, você precisa sincronizar o uso de licenças entre GitHub Enterprise Server e GitHub Enterprise Cloud. Para obter mais informações, confira "Sincronizando o uso de licenças entre o GitHub Enterprise Server e o GitHub Enterprise Cloud".

Depois de sincronizar o uso das licenças, GitHub corresponde as contas de usuário em GitHub Enterprise Server às contas de usuário em GitHub Enterprise Cloud por endereço de email.

Primeiro, verificamos o endereço de email primário de cada usuário em GitHub Enterprise Server. Em seguida, tentamos corresponder esse endereço com o endereço de email de uma conta de usuário em GitHub Enterprise Cloud. Se sua empresa usa o SSO do SAML, primeiro verificamos os atributos de SAML a seguir em busca de endereços de email.

  • http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name
  • http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress
  • username
  • NameID
  • emails

Se nenhum endereço de email encontrado nesses atributos corresponder ao endereço de email primário em GitHub Enterprise Server ou se sua empresa não usar o SSO do SAML, verificaremos cada um dos endereços de email verificados do usuário em GitHub Enterprise Cloud. Para obter mais informações sobre a verificação de endereços de email do GitHub.com, confira "Como verificar seu endereço de email" na documentação do GitHub Enterprise Cloud.

Campos nos arquivos de licença consumidos

O relatório de uso da licença do GitHub.com e o arquivo de uso de licença exportado do GitHub Enterprise Server incluem uma variedade de campos para ajudar você a solucionar problemas de uso de licença para sua empresa.

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

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

CampoDESCRIÇÃO
github_com_loginO nome de usuário da conta do GHEC do usuário
github_com_nameO nome de exibição da conta do GHEC do usuário
github_com_profileA URL da 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 uma das organizações às quais o usuário pertence no GHEC, o nome da organização e a função da pessoa nessa organização (Owner ou Member) separados por dois pontos

Organizações delimitadas por vírgulas
github_com_enterprise_rolePode ser uma entre: Owner, Member ou Outside collaborator
github_com_verified_domain_emailsTodos os endereços de email 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 ingressar em organizações em sua empresa
license_typePode ser Visual Studio subscription ou Enterprise
enterprise_server_userSe o usuário tem ou não pelo menos uma conta no GHES
enterprise_server_primary_emailsOs endereços de email primários associados a cada uma das contas do GHES do usuário
enterprise_server_user_idsPara cada uma das contas do GHES do usuário, a 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 email associado ao VSS do usuário
visual_studio_license_statusSe a licença do Visual Studio foi correspondida a um usuário do GitHub

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

Uso de licença exportada do GitHub Enterprise Server (arquivo JSON)

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

CampoDescrição
RecursosOs recursos do GitHub Connect habilitados em sua instância do GitHub Enterprise Server e a data e hora da habilitação.
Nome do hostO nome do host de sua instância do GitHub Enterprise Server.
Somente HTTPSe o Transport Layer Security (TLS) está ativado e configurado em sua instância do GitHub Enterprise Server. Pode ser: True ou False.
LicençaUm hash de sua licença do GitHub Enterprise Server.
Chave públicaA parte da chave pública da sua licença do GitHub Enterprise Server.
ID de servidorUUID gerado para sua instância do GitHub Enterprise Server.
VersãoA versão da sua instância do GitHub Enterprise Server.

Solução de problemas de licenças consumidas

Para garantir que cada usuário esteja consumindo apenas uma estação para diferentes implantações e assinaturas, tente as etapas de solução de problemas a seguir.

  1. Para ajudar a identificar usuários que estão consumindo várias estações, se sua empresa usar domínios verificados para GitHub Enterprise Cloud, examine a lista de membros corporativos que não têm um endereço de email de um domínio verificado associado à conta deles em GitHub.com. Muitas vezes, esses são os usuários que consomem erroneamente mais de uma estação licenciada. Para obter mais informações, confira "Como exibir os membros que não têm um endereço de email de um domínio verificado".

    Observação: para facilitar a solução de problemas, recomendamos o uso de domínios verificados com sua conta corporativa no GitHub.com. Para obter mais informações, confira "Como verificar ou aprovar um domínio para sua empresa".

  2. Depois de identificar usuários que estão consumindo várias estações, verifique se o mesmo endereço de email está associado a todas as contas do usuário. Para obter mais informações sobre quais endereços de email precisam corresponder, confira "Sobre o cálculo de licenças consumidas".

  3. Se um endereço de email foi atualizado ou verificado recentemente para corrigir uma incompatibilidade, exiba o carimbo de data/hora do último trabalho de sincronização de licenças. Se um trabalho não tiver sido executado desde que a correção foi feita, dispare manualmente um novo trabalho. Para obter mais informações, confira "Como sincronizar o uso da licença entre o GitHub Enterprise Server e o GitHub Enterprise Cloud."

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