Administrar la sincronización de equipos para tu organización

Puedes habilitar e inhabilitar la sincronización entre tu Proveedor de Identidad (IdP) y tu organización en GitHub.

Organization owners can manage team synchronization for an organization.

Team synchronization is available for organizations and enterprise accounts using Nube de GitHub Enterprise. Para obtener más información, consulta la sección "Productos de GitHub".

Nota: Si tu empresa utiliza Usuarios Administrados de Enterprise, no puedes utilizar la sincronización de equipos y, en su lugar, debes configurar SCIM para administrar la membrecía con tu proveedor de identidad. Para obtener más información, consulta la sección "Configurar el aprovisionamiento de SCIM para los Usuarios Administrados Empresariales".

Nota: La sincronización de equipos con Okta se encuentra actualmente en beta y está sujeta a cambios. Por favor contacta a tu representante de cuenta de Ventas de GitHub para registrarte para el beta.

Acerca de la sincronización de equipo

Puedes habilitar la sincronización de equipos entre tu IdP y GitHub para permitir a los propietarios de la organización y a los mantenedores de equipo conectar equipos en tu organización con grupos de IdP.

Cuando sincronizas un equipo de GitHub con un grupo de IdP, los cambios a este grupo se reflejan automáticamente en GitHub, reduciendo la necesidad de hacer actualizaciones manuales y scripts personalizados. Puedes utilizar un IdP con la sincronización de equipos para gestionar las tareas administrativas tales como el incorporar miembros nuevos, otorgar permisos nuevos para hacer movimientos dentro de una organización, y eliminar el acceso de un miembro a la organización.

Puedes utilizar la sincronización de equipos con los IdP compatibles.

  • Azure AD
  • Okta

Después de que habilites la sincronización de equipos, los mantenedores de equipo y propietarios de organización pueden conectar los equipos a un grupo de IdP en GitHub o a través de la API. Para obtener más información, consulta las secciones "Sincronizar un equipo con un grupo de proveedor de identidad" y "Sincronización de equipo".

También puedes habilitar la sincronización de equipos para las organizaciones que pertenezcan a tu cuenta empresarial. Para obtener más información, consulta la sección "Requerir los parámetros de seguridad en tu cuenta empresarial".

Si tu organización pertenece a una cuenta empresarial, el habilitar la sincronización de equipo o el aprovisionamiento de SCIM para la cuenta empresarial anulará tus ajustes de sincronización de equipos a nivel organizacional. Para obtener más información, consulta las secciones "Administrar la sincronización de equipos para las organizaciones de tu cuenta empresarial" y "Configurar el aprovisionamiento de SCIM para los Usuarios Administrados Empresariales".

Límites de uso

Hay límites de uso para la característica de sincronización de equipos. El exceder estos límites ocasionará una degradación del rendimiento y podrá causar fallas de sincronización.

  • Cantidad máxima de miembros en un equipo de GitHub: 5,000
  • Cantidad máxima de miembros en una organización de GitHub: 10,000
  • Cantidad máxima de equipos en una organización de GitHub: 1,500

Habilitar la sincronización de equipo

Los pasos para habilitar la sincronización de equipos dependen del IdP que quieras utilizar. Existen prerrequisitos aplicables a cada IdP para habilitar la sincronización de equipos. Cada IdP individual tiene prerrequisitos adicionales.

Prerrequisitos

Para habilitar la sincronización de equipos con cualquier IdP, debes obtener acceso administrativo con tu IdP o trabajar con tu administrador de IdP para configurar la integración y los grupos de IdP. La persona que configura tus grupos e integración de IdP debe tener alguno de los permisos requeridos.

IdPPermisos requeridos
Azure AD
  • Administrador global
  • Administrador de Rol Privilegiado
Okta
  • Usuario de servicio con permisos administrativos de solo lectura

Debes habilitar el inicio de sesión único de SAML para tu organización y tu IdP compatible. Para obtener más información, consulta la sección "Requerir el inicio de sesión único de SAML en tu organización".

Debes autenticarte con tu organización utilizando el SSO de SAML y el IdP compatible. Para obtener más información, consulta "Acerca de la autenticación con el inicio de sesión único de SAML".

Habilitar la sincronización de equipos para Azure AD

Para habilitar la sincronización de equipo para Azure AD, tu instalación de Azure AD necesita los siguientes permisos.

  • Lectura de todos los perfiles completos de usuarios
  • Inicio de sesión y lectura del perfil de usuario
  • Lectura de los datos del directorio
  1. En la esquina superior derecha de GitHub, haz clic en tu foto de perfil y luego en Tus organizaciones. Tus organizaciones en el menú de perfil

  2. Junto a la organización, haz clic en Configuración. El botón de configuración

  3. En la barra lateral izquierda, da clic en Seguridad de la organización.

    Configuración de seguridad de la organización

  4. Confirma que el SSO de SAML esté habilitado. Para obtener más información, consulta "Administrar el inicio de sesión único de SAML para tu organización".

  5. Debajo de "Sincronización de equipo", da clic en Habilitar para Azure AD. Botón para habilitar la sincronización de equipo en la página de configuraciones de seguridad

  6. Confirma la sincronización de equipos.

    • Si tienes acceso IdP, haz clic en Enable team synchronization (Habilitar sincronización de equipo). Serás redireccionado a la página de SSO de SAML de tu proveedor de identidad y se te solicitará que selecciones tu cuenta y revises los permisos requeridos.
    • Si no tienes acceso de IdP, copia el vínculo de redirección de IdP y compártelo con tu administrador de IdP para continuar habilitando la sincronización de equipo. Botón para habilitar el redireccionamiento de la sincronización de equipo
  7. Revisa la información de locatario del proveedor de identidad que deseas conectar a tu organización, después haz clic en Approve (Aprobar). Solicitud pendiente para habilitar la sincronización de equipo a un locatario IdP específico con la opción de aprobar o cancelar la solicitud

Habilitar la sincronización de equipos para Okta

Para habilitar la sincronización de equipos para Okta, en tu administrador de IdP deberás:

  1. En la esquina superior derecha de GitHub, haz clic en tu foto de perfil y luego en Tus organizaciones. Tus organizaciones en el menú de perfil

  2. Junto a la organización, haz clic en Configuración. El botón de configuración

  3. En la barra lateral izquierda, da clic en Seguridad de la organización.

    Configuración de seguridad de la organización

  4. Confirma que el SSO de SAML esté habilitado. Para obtener más información, consulta "Administrar el inicio de sesión único de SAML para tu organización".

  5. Debajo de "Sincronización de equipo", da clic en Habilitar para Okta. Botón de habilitar sincronización de equipo para Okta en la página de configuraciones de seguridad

  6. Debajo del nombre de tu organización, teclea un token SSWS válido y la URL de tu instancia de Okta. Formulario organizacional de Okta para habilitar la sincronización de equipos

  7. Revisa la información de locatario del proveedor de identidad que deseas conectar a tu organización, después da clic en Crear. Botón de crear en habilitar la sincronización de equipos

Inhabilitar la sincronización de equipo

Advertencia: Cuando inhabilitas la sincronización de equipos, cualquier miembro del equipo que se haya asignado al equipo de GitHub a través de un grupo de IdP se eliminará del mismo y podría perder acceso a los repositorios.

  1. En la esquina superior derecha de GitHub, haz clic en tu foto de perfil y luego en Tus organizaciones. Tus organizaciones en el menú de perfil

  2. Junto a la organización, haz clic en Configuración. El botón de configuración

  3. En la barra lateral izquierda, da clic en Seguridad de la organización.

    Configuración de seguridad de la organización

  4. Dentro de "Team synchronization" (Sincronización de equipo), haz clic en Disable team synchronization (Inhabilitar la sincronización de equipo). Inhabilita la sincronización de equipo

¿Te ayudó este documento?

Política de privacidad

¡Ayúdanos a hacer geniales estos documentos!

Todos los documentos de GitHub son de código abierto. ¿Notas algo que esté mal o que no sea claro? Emite una solicitud de cambios.

Haz una contribución

O, aprende cómo contribuir.