Skip to main content

Solución de problemas del uso de licencias de GitHub Enterprise

Con la auditoría de informes de licencias, puedes solucionar problemas relacionados con el uso de licencias de tu empresa.

¿Quién puede utilizar esta característica?

Enterprise owners can review license usage for GitHub Enterprise.

Acerca del uso inesperado de licencias

Si el número de licencias consumidas de la empresa es inesperado, puedes revisar el informe de licencias consumidas para auditar el uso de licencias en todas las implementaciones y suscripciones empresariales. Para obtener más información, vea «Ver el uso de licencia para GitHub Enterprise» y «Ver la suscripción y el uso de tu cuenta de empresa».

Si detectas algún error, puedes llevar a cabo pasos para solucionar los problemas.

Por motivos de privacidad, los propietarios de la empresa no pueden acceder directamente a los detalles de las cuentas de usuario a menos que uses Enterprise Managed Users.

Acerca del cálculo de licencias consumidas

Nota: Para Suscriptor de Visual Studio, consulta "Acerca de las suscripciones a Visual Studio con GitHub Enterprise".

Una persona consume una licencia para GitHub Enterprise en función de criterios específicos. Si un usuario aún no ha aceptado una invitación para unirse a la empresa, el usuario sigue consumiendo una licencia. Para más información sobre las personas de la empresa que consumen una licencia, consulta "Acerca del precio por usuario".

Para que cada usuario consuma un solo puesto, independientemente del número de implementaciones que use, debes sincronizar el uso de licencias entre GitHub Enterprise Server y GitHub Enterprise Cloud. Para obtener más información, vea «Sincornizar el uso de licencias entre GitHub Enterprise Server y GitHub Enterprise Cloud».

Después de sincronizar el uso de licencias, GitHub empareja las cuentas de usuario en GitHub Enterprise Server con las cuentas de usuario en GitHub Enterprise Cloud mediante la dirección de correo electrónico.

En primer lugar, comprobamos la dirección de correo electrónico principal de cada usuario en GitHub Enterprise Server. A continuación, intentamos hacer coincidir esa dirección con la dirección de correo electrónico de una cuenta de usuario en GitHub Enterprise Cloud. Si tu empresa de GitHub Enterprise Cloud o cualquiera de las organizaciones de la empresa usan la autenticación SAML o el aprovisionamiento de SCIM, primero comprobamos las identidades vinculadas de SAML o SCIM para ver si la identidad contiene uno de los atributos siguientes. Intentamos hacer coincidir los valores de estos atributos con la dirección de correo electrónico principal de cada usuario de GitHub Enterprise Server.

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

Si no hay ninguna coincidencia o si la autenticación SAML o el aprovisionamiento de SCIM no están en uso, intentamos hacer coincidir la dirección de correo electrónico principal de GitHub Enterprise Server con una dirección de correo electrónico verificada de una cuenta de usuario de GitHub Enterprise Cloud. Para más información sobre la comprobación de direcciones de correo electrónico en GitHub Enterprise Cloud, consulta "Verificar tu dirección de correo electrónico."

Campos de los archivos de licencias consumidas

El informe de uso de licencias de GitHub Enterprise Cloud y el archivo de uso de licencias de GitHub Enterprise Server exportado incluyen varios campos que te ayudarán a solucionar los problemas relacionados con el uso de licencias de tu empresa.

Informe de uso de licencias de GitHub Enterprise Cloud (archivo CSV)

El informe de uso de licencias de la empresa es un archivo CSV que contiene la información siguiente sobre los miembros de la empresa. Algunos campos son específicos de la implementación de la GitHub Enterprise Cloud (GHEC), los entornos conectados de GitHub Enterprise Server (GHES) o las suscripciones de Visual Studio (VSS) con GitHub Enterprise.

CampoDescripción
github_com_loginNombre de usuario de la cuenta GHEC del usuario
github_com_nameNombre para mostrar de la cuenta GHEC del usuario
github_com_profileDirección URL de la página de perfil del usuario en GHEC
github_com_userSi el usuario tiene o no una cuenta en GHEC
github_com_member_rolesPara cada una de las organizaciones a las que pertenece el usuario en GHEC, nombre de la organización y rol del usuario en esa organización (Owner o Member), separados por dos puntos

Organizaciones delimitadas por comas
github_com_enterprise_rolePuede ser uno de los siguientes: Owner, Member, Outside collaborator (para una empresa con cuentas personales en GitHub.com) o Repository collaborator (para una empresa que utilice cuentas de usuario administradas).
github_com_verified_domain_emailsTodas las direcciones de correo electrónico asociadas a la cuenta GHEC del usuario que coinciden con los dominios verificados de la empresa
github_com_saml_name_idNombre de usuario de SAML
github_com_orgs_with_pending_invitesTodas las invitaciones pendientes de la cuenta GHEC del usuario para unirse a organizaciones dentro de tu empresa
github_com_advanced_security_license_userSi el usuario consume o no una licencia de GitHub Advanced Security en GHEC
license_typePuede ser Visual Studio subscription o Enterprise
enterprise_server_userSi el usuario tiene al menos una cuenta en GHES o ninguna
enterprise_server_primary_emailsLas direcciones de correo electrónico principales asociadas a cada una de las cuentas GHES del usuario
enterprise_server_user_idsPara cada una de las cuentas GHES del usuario, el Id. de usuario de la cuenta
enterprise_server_advanced_security_user_idsLas instancias de GHES en las que el usuario usa GitHub Advanced Security (solo están presentes si usa la versión 3.12 o posterior de GHES y ha habilitado la sincronización de licencias)
total_user_accountsEl número total de cuentas que tiene la persona en GHEC y GHES
visual_studio_subscription_userSi el usuario es un Suscriptor de Visual Studio o no.
visual_studio_subscription_emailDirección de correo electrónico asociada a la VSS del usuario
visual_studio_license_statusSi la licencia de Visual Studio se ha emparejado con un usuario GitHub o no

Uso de licencias exportado de GitHub Enterprise Server (archivo JSON)

El uso de licencias de GitHub Enterprise Server es un archivo JSON que suele usarse al realizar una sincronización manual de las licencias de usuario entre implementaciones de GitHub Enterprise Server y la GitHub Enterprise Cloud. El archivo contiene la siguiente información específica del entorno de GitHub Enterprise Server.

CampoDescripción
CaracterísticasCaracterísticas de GitHub Connect que están habilitadas en la instancia de GitHub Enterprise Server, con la fecha y hora de su habilitación.
Nombre de hostNombre de host de tu instancia de GitHub Enterprise Server.
Solo HTTPIndica si la Seguridad de la capa de transporte (TLS) está habilitada y configurada en tu instancia de GitHub Enterprise Server. Puede ser True o False.
LicenciaHash de tu licencia de GitHub Enterprise Server.
Clave públicaParte de la clave pública de tu licencia de GitHub Enterprise Server.
Id. de servidorUUID generado para tu instancia de GitHub Enterprise Server.
VersiónVersión de tu instancia de GitHub Enterprise Server.

Solución de problemas relacionados con las licencias consumidas

Para asegurarse de que cada usuario solo consume un único puesto para diferentes implementaciones y suscripciones, prueba los pasos de solución de problemas siguientes.

  1. Para ayudar a identificar a los usuarios que consumen varios puestos, si tu empresa usa dominios verificados para GitHub Enterprise Cloud, revisa la lista de miembros de la empresa que no tienen una dirección de correo electrónico de un dominio verificado asociado a su cuenta en GitHub Enterprise Cloud. Por lo general, estos son los usuarios que consumen erróneamente más de un puesto con licencia. Para obtener más información, vea «Visualizar a las personas en tu empresa».

    Nota: Para facilitar la solución de problemas, recomendamos que uses dominios verificados con tu cuenta de empresa en GitHub Enterprise Cloud. Para obtener más información, vea «Verificar o aprobar un dominio para tu empresa».

  2. Después de identificar a los usuarios que consumen varios puestos, asegúrate de que la misma dirección de correo electrónico esté asociada a todas las cuentas del usuario. Para obtener más información sobre qué direcciones de correo electrónico deben coincidir, consulta «Acerca del cálculo de licencias consumidas».

  3. Si una dirección de correo electrónico se ha actualizado recientemente o se ha verificado para corregir un error de coincidencia, consulta la marca de tiempo del último trabajo de sincronización de licencias. Si un trabajo no se ha ejecutado después de que se haya realizado la corrección, desencadena manualmente un nuevo trabajo. Para obtener más información, vea «Sincornizar el uso de licencias entre GitHub Enterprise Server y GitHub Enterprise Cloud».

Si te queda alguna duda sobre las licencias consumidas después de consultar esta información para la solución de problemas, puedes ponerte en contacto con el Soporte de GitHub a través del Portal de soporte de GitHub.