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.

Quem pode usar esse recurso?

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 "Visualizando o uso da licença para o GitHub Enterprise" e "Exibir assinatura e uso da 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

Nota: para Assinante do Visual Studios, consulte "Sobre as assinaturas do Visual Studio com GitHub Enterprise".

Uma pessoa consome uma licença para GitHub Enterprise dependendo de critérios específicos. Se um usuário ainda não aceitou um convite para ingressar na empresa, a pessoa ainda consome uma licença. Para saber mais 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 da licença 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 em GitHub.com ou qualquer uma das organizações da empresa usar autenticação SAML ou provisionamento SCIM, primeiro verificaremos as identidades SAML ou SCIM vinculadas para ver se a identidade contém um dos atributos abaixo. Tentamos corresponder os valores desses atributos ao endereço de email principal de cada usuário de GitHub Enterprise Server user.

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

Se não houver correspondência ou se a autenticação SAML ou o provisionamento SCIM não estiver em uso, tentaremos corresponder o endereço de email principal em GitHub Enterprise Server com um endereço de email verificado para uma conta de usuário em GitHub.com. Para saber mais sobre a verificação de endereços de email do GitHub.com, confira "Verificar endereço de e-mail".

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 um dos seguintes: Owner, Member, Outside collaborator (para uma empresa com contas pessoais em GitHub.com) ou Repository collaborator (para uma empresa que usa contas de usuário gerenciadas no GitHub.com)
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
github_com_advanced_security_license_userSe o usuário consome ou não uma licença GitHub Advanced Security no GHEC
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
enterprise_server_advanced_security_user_idsAs instâncias do GHES em que o usuário está usando GitHub Advanced Security (presente somente se você estiver usando o GHES versão 3.12 ou posterior e tiver habilitado a sincronização de licença)
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 Assinante do Visual Studio
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

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 "Visualizar pessoas na sua empresa".

    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 "Verificando ou aprovando 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 "Sincronizando 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.