Solução de problemas de uso de licenças para 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 saber mais, 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

Note

Para Assinante do Visual Studio, 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 saber mais, 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 a sua empresa no GitHub Enterprise Cloud ou uma das organizações da empresa usar a autenticação SAML ou o provisionamento do SCIM, primeiro verificaremos as identidades do SAML ou do 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 do SCIM não estiver em uso, tentaremos corresponder o endereço de email principal no GitHub Enterprise Server com um endereço de email verificado para uma conta de usuário no GitHub Enterprise Cloud. Para obter mais informações sobre a verificação de endereços de email do GitHub Enterprise Cloud, confira Verificar endereço de e-mail na documentação do GitHub Enterprise Cloud.

Campos nos arquivos de licença consumidos

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

Relatório de uso de licença do GitHub Enterprise Cloud (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.

Campo	DESCRIÇÃO
github_com_login	O nome de usuário da conta do GHEC do usuário
github_com_name	O nome de exibição da conta do GHEC do usuário
github_com_profile	A URL da página de perfil do usuário no GHEC
github_com_user	Se o usuário tem ou não uma conta no GHEC
github_com_member_roles	Para 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_role	Pode ser um dos seguintes: `Owner`, `Member`, `Outside collaborator` (para uma empresa com contas pessoais no GitHub.com) ou `Repository collaborator` (para uma empresa que usa contas de usuário gerenciadas)
github_com_verified_domain_emails	Todos os endereços de email associados à conta GHEC do usuário que correspondem aos domínios verificados da sua empresa
github_com_saml_name_id	O nome de usuário do SAML
github_com_orgs_with_pending_invites	Todos os convites pendentes para a conta do GHEC do usuário ingressar em organizações em sua empresa
github_com_advanced_security_license_user	Se o usuário consome ou não uma licença GitHub Advanced Security no GHEC
license_type	Pode ser `Visual Studio subscription` ou `Enterprise`
enterprise_server_user	Se o usuário tem ou não pelo menos uma conta no GHES
enterprise_server_primary_emails	Os endereços de email primários associados a cada uma das contas do GHES do usuário
enterprise_server_user_ids	Para cada uma das contas do GHES do usuário, a ID de usuário da conta
enterprise_server_advanced_security_user_ids	As instâncias do GHES em que o usuário está usando GitHub Advanced Security
total_user_accounts	O número total de contas que a pessoa tem em GHEC e GHES
visual_studio_subscription_user	Se o usuário é ou não um Assinante do Visual Studio
visual_studio_subscription_email	O endereço de email associado ao VSS do usuário
visual_studio_license_status	Se 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.

Campo	Descrição
Recursos	Os recursos do GitHub Connect habilitados em sua instância do GitHub Enterprise Server e a data e hora da habilitação.
Nome do host	O nome do host de sua instância do GitHub Enterprise Server.
Somente HTTP	Se o Transport Layer Security (TLS) está ativado e configurado em sua instância do GitHub Enterprise Server. Pode ser: `True` ou `False`.
Licença	Um hash de sua licença do GitHub Enterprise Server.
Chave pública	A parte da chave pública da sua licença do GitHub Enterprise Server.
ID de servidor	UUID gerado para sua instância do GitHub Enterprise Server.
Versão	A 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.

Para ajudar a identificar usuários que estão consumindo várias estações, se a sua empresa usar domínios verificados do GitHub Enterprise Cloud, revise a lista de membros corporativos que não têm um endereço de email de um domínio verificado associado às respectivas contas no GitHub Enterprise Cloud. Muitas vezes, esses são os usuários que consomem erroneamente mais de uma estação licenciada. Para saber mais, confira Visualizar pessoas na sua empresa.

Note

Para facilitar a solução de problemas, recomendamos o uso de domínios verificados com sua conta empresarial do GitHub Enterprise Cloud. Para saber mais, confira Verificando ou aprovando um domínio para sua empresa.
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.
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 saber mais, 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.