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.

Who can use this feature

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, consulta «Visualización del uso de licencias de GitHub Enterprise» y «Visualización de la suscripción y el uso de la cuenta empresarial».

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

GitHub factura por cada persona que usa implementaciones de GitHub Enterprise Server, que es miembro de una de las organizaciones de GitHub Enterprise Cloud o que es un Visual Studio subscriber. Para obtener más información sobre las personas de la empresa que consumen una licencia, consulta «Acerca de los precios 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, consulte "Sincronizar el uso de licencias de usuario manualmente 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 usa el inicio de sesión único (SSO) de SAML, primero comprobamos los siguientes atributos de SAML para las direcciones de correo electrónico.

  • 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 se encuentra ninguna dirección de correo electrónico en estos atributos que coincida con la dirección de correo electrónico principal en GitHub Enterprise Server, o si tu empresa no usa el SSO de SAML, comprobamos cada una de las direcciones de correo electrónico del usuario verificadas en GitHub Enterprise Cloud. Para más información sobre la comprobación de direcciones de correo electrónico en GitHub.com, vea "Comprobación de la dirección de correo electrónico".

Campos de los archivos de licencias consumidas

El informe de uso de licencias de GitHub.com y el archivo exportado de uso de licencias de GitHub Enterprise Server 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.com (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 Owner, Member o Outside collaborator
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
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
total_user_accountsEl número total de cuentas que tiene la persona en GHEC y GHES
visual_studio_subscription_userSi el usuario es un Visual Studio subscriber 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

Si un Visual Studio subscriber aún no es miembro de al menos una organización de la empresa, se incluirá en el informe con el estado de invitación pendiente y no aparecerá ningún valor en el campo "Nombre" o "Vínculo del perfil".

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.com. Por lo general, estos son los usuarios que consumen erróneamente más de un puesto con licencia. Para obtener más información, consulta "Visualización de miembros sin una dirección de correo electrónico de un dominio verificado".

    Nota: Para facilitar la solución de problemas, recomendamos que uses dominios verificados con tu cuenta de empresa en GitHub.com. Para más información, vea "Comprobación o aprobación de un dominio para la 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, consulta "Sincronización del uso de licencias entre GitHub Enterprise Server y la Nube de GitHub Enterprise".

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.