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 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

Se um usuário atender a uma ou mais das condições a seguir, o GitHub vai cobrar pelo usuário.

O usuário utiliza implantações de GitHub Enterprise Server.
O usuário é membro de uma das suas organizações na GitHub Enterprise Cloud.
O usuário tem acesso de gravação a um dos repositórios privados da sua organização.
O usuário é um Assinante do Visual Studio.

Cada convite para essas funções consumirá uma licença até que seja aceito ou expire. 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.

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 uma entre: `Owner`, `Member` ou `Outside collaborator`
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
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
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

Assinante do Visual Studios 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.

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 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".
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 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.