Acerca de la gestión de equipos con Enterprise Managed Users
Con Enterprise Managed Users, puedes administrar la pertenencia a equipos y organizaciones dentro de tu empresa a través del proveedor de identidades mediante la conexión de equipos de GitHub a grupos en el proveedor de identidades.
En las secciones siguientes se explica cómo GitHub usa trabajos de aprovisionamiento y conciliación de SCIM para mantener la pertenencia a equipos y organizaciones sincronizadas con el IdP.
Cuando GitHub recibe una llamada API de SCIM de grupo de su IdP, genera un evento external_group.scim_api_success o external_group.scim_api_failure en el registro de auditoría de la empresa. Estos eventos capturan información detallada sobre la llamada, incluida la carga y la operación realizada, y se registra en el registro de auditoría con el actor establecido en el usuario de configuración, la cuenta que se utiliza para configurar el aprovisionamiento de SCIM.
Una vez GitHub almacena los datos del grupo en el nivel empresarial, ejecuta un trabajo de conciliación diario para sincronizar la pertenencia al equipo con los datos almacenados del grupo de IdP. Esta conciliación también se ejecuta siempre que una API de SCIM de grupo actualiza la pertenencia a grupos y si un administrador vincula o desvincula un equipo a un grupo almacenado.
Cuando un cambio en un grupo de IdP o una nueva conexión de equipo da como resultado que un usuario se une a un equipo de una organización de la que aún no era miembro, GitHub agrega automáticamente el usuario a la organización. Al desconectar un grupo de un equipo, GitHub quita los usuarios que se convirtieron en miembros de la organización a través de la pertenencia al equipo si no tienen pertenencia a la organización por ningún otro medio.
Los equipos que se conectan con los grupos de IdP no pueden ser equipos padres ni hijos de otro equipo. Si el equipo que quieres conectar a un grupo de IdP es un equipo padre o hijo, te recomendamos crear un equipo nuevo o eliminar las relaciones anidadas que hacen de tu equipo un equipo padre.
Para administrar el acceso a los repositorios de cualquier equipo de la empresa, incluidos los equipos conectados a un grupo de IdP, debe hacer cambios en GitHub. Para más información, consulta Administrar el acceso de equipo a un repositorio de la organización.
Requisitos para conectar grupos de IdP con equipos
Para poder conectar un grupo de IdP con un equipo en GitHub, debe asignar el grupo a la aplicación GitHub Enterprise Managed User en el IdP. Para más información, consulta Configuración del aprovisionamiento de SCIM para usuarios administrados de empresa.
Puedes conectar a un equipo de tu empresa a un grupo de IdP. Puedes asignar el mismo grupo de IdP a varios equipos de tu empresa.
Si estás conectando un equipo a un grupo de IdP, primero debes eliminar a cualquier miembro que se haya agregado manualmente. Después de que conectas a un equipo de tu empresa a un grupo de IdP, tu administrador de IdP debe realizar cambios en la membresía del equipo a través del proveedor de identidad. No puedes administrar directamente los miembros del equipo en GitHub.
Si usa Microsoft Entra ID (anteriormente conocido como Azure AD) como idP, solo puede conectar un equipo a un grupo de seguridad. No se admiten las pertenencias a grupos anidados ni los grupos de Microsoft 365.
Sincronización de un equipo empresarial
Los propietarios de empresas pueden crear equipos en el nivel empresarial.
La mayoría de las instrucciones de este artículo se aplican a equipos de nivel de la organización. Para obtener instrucciones sobre cómo crear un equipo empresarial y sincronizarlo con un grupo de IdP, consulta Creación de equipos empresariales.
Creación de un nuevo equipo de organización conectado a un grupo de IdP
Cualquier miembro de una organización puede crear un equipo nuevo y conectarlo a un grupo de IdP.
-
En la esquina superior derecha de GitHub, haz clic en la foto del perfil y luego en Your organizations.
-
Haz clic en el nombre de tu organización.
-
En el nombre de la organización, haz clic en Teams.
-
En la parte superior de la página, haga clic en Nuevo equipo.
-
Debajo de "Crear un equipo nuevo", teclea el nombre para tu equipo nuevo.
-
Opcionalmente, en el campo de "Descripción", teclea una descripción del equipo.
-
Para conectar un equipo, en "Grupos de proveedores de identidad", selecciona el menú desplegable Seleccionar grupos y haz clic en el equipo que quieras conectar.
-
En "Visibilidad del equipo", seleccione una visibilidad para el equipo.
-
Haga clic en Create team.
Administración de la conexión entre un equipo de una organización existente y un grupo de IdP
Los propietarios de la organización pueden administrar la conexión existente entre un grupo de IdP y un equipo. Si la empresa no usa cuentas de usuario administradas, los encargados del mantenimiento del equipo también pueden administrar la conexión.
Nota:
Antes de conectar un equipo existente en GitHub a un grupo de IdP por primera vez, primero se deben quitar todos los miembros del equipo de GitHub. Para más información, consulta Eliminar de un equipo a miembros de la organización.
-
En la esquina superior derecha de GitHub, haz clic en tu foto de perfil y después en Your profile.
-
En la esquina superior derecha de GitHub, haz clic en la foto del perfil y luego en Your organizations.
-
En el nombre de la organización, haz clic en Teams.
-
Haga clic en el nombre del equipo.
-
En la parte superior de la página del equipo, haz clic en Settings.
-
Opcionalmente, debajo de "Grupo de Proveedor de Identidad", a la derecha del grupo de IdP que quieres desconectar, haz clic en .
 -
Para conectar un grupo de IdP, debajo de "Grupo de Proveedor de Identidad"; selecciona el menú desplegable y haz clic en un grupo de proveedor de identidad de la lista.
 -
Haga clic en Guardar cambios.
Ver los grupos de IdP, la membresía de grupos y los equipos conectados
Los propietarios de la empresa pueden revisar una lista de grupos de IdP, las pertenencias de cada grupo y los equipos conectados a cada grupo. Los grupos de IdP y las pertenencias que aparecen en esta vista se basan en la información enviada desde el IdP a GitHub a través de SCIM. Debes editar la membrecía de un grupo en tu IdP.
- Vaya a su empresa. Por ejemplo, desde la página Empresas en GitHub.com.
- Para ver una lista de grupos de IdP, en la barra lateral izquierda, haz clic en Proveedor de identidades.
- Para ver a los miembros y equipos conectados a un grupo de IdP, haz clic en el nombre del grupo.
-
- En Identity provider, haz clic en Groups.
- Para ver los equipos conectados al grupo de IdP, haga clic en Teams (Equipos).
Si un equipo no se puede sincronizar con el grupo en tu IdP, el equipo mostrará un error. Para más información, consulta Resolución de problemas de pertenencia al equipo con grupos de proveedores de identidad.
Eliminación de miembros de organizaciones
La forma en que se agrega un miembro a una organización propiedad de su empresa determina cómo debe eliminarse de una organización.
- Si un miembro se agregó a una organización manualmente, debes quitarlo manualmente. La anulación de la asignación de la aplicación de GitHub Enterprise Managed User en su IdP suspenderá al usuario, pero no lo eliminará de la organización.
- Si un usuario se convirtió en miembro de una organización porque fue añadido a grupos IdP, elimínelo de todos los grupos IdP asignados asociados a la organización.
Para descubrir cómo se agregó un miembro a una organización, puedes filtrar la lista de miembros por tipo. Consulte Visualizar a las personas en tu empresa.