Equipo

Invita a tus compañeros, asigna responsabilidades y retira el acceso sin dejar a la organización ni a sus automatizaciones sin una persona responsable.

La pertenencia hace que una persona forme parte de la organización. Los roles y los permisos sobre recursos determinan lo que puede hacer. Gestiona ambos aspectos de forma conjunta cuando alguien se incorpore, cambie de responsabilidades o se marche.

Invita a la identidad correcta con el nivel de autoridad previsto #

Invita a la persona con su dirección de correo electrónico y elige el nivel de autoridad que debe recibir. Para gestionar invitaciones se necesita org:manage_team o la política de invitaciones correspondiente. Comprueba si ya hay una invitación pendiente antes de crear otra para la misma persona.

La persona invitada debe aceptar la invitación con la sesión iniciada con esa dirección de correo electrónico. Una clave de servicio no puede aceptar una invitación. Si la cuenta no coincide, corrige la identidad o la invitación en lugar de pasar el token a otra cuenta. Si la invitación ha caducado o se ha revocado, comprueba su estado actual antes de volver a intentarlo.

Con RBAC activado, las invitaciones no pueden conceder los permisos del rol Propietario. Invita primero a la persona y, una vez que se haya incorporado, utiliza la operación protegida de gestión de la propiedad. Quien realiza la llamada no puede delegar permisos que excedan los suyos. Actualiza la invitación pendiente si el rol previsto cambia antes de que se acepte.

Sin acceso a RBAC, las invitaciones asignan el rol Propietario de forma predeterminada. Confirma ese amplio nivel de autoridad antes de enviar; que no haya un selector de roles personalizados no significa que el acceso esté restringido. Los cambios en el acceso a RBAC también pueden restablecer a Propietario el rol de los miembros existentes y de las invitaciones pendientes, como se describe en Cambios de acceso.

Adapta los roles a las responsabilidades #

Los miembros pueden consultar la lista de miembros. Para asignar roles se necesitan RBAC y org:manage_team, y se aplican comprobaciones para impedir la escalada de permisos. Un miembro sin rol asignado puede seguir teniendo permisos adicionales sobre recursos. Por tanto, quitar un rol no equivale a dar de baja a un miembro.

Solo una persona con el rol Propietario puede conceder ese rol a otra persona o retirarlo, y debe quedar al menos un miembro con ese rol. Antes de renunciar al rol o marcharte, asígnaselo a quien vaya a sucederte y verifica la asignación. La protección que impide eliminar al último miembro con el rol Propietario preserva la continuidad; la organización sigue siendo responsable de elegir a la persona adecuada para asumirlo.

Retira el acceso y comprueba qué llamadas dependen de él #

Da de baja a un miembro o abandona la organización para poner fin a la participación de una persona. Revisa las automatizaciones que mantenía. Las claves de API personales dependen de que quien las creó siga siendo miembro y pierden el acceso a la organización cuando esa persona deja de serlo. Las claves de servicio de la organización son independientes y requieren una revisión aparte de su alcance o revocación.

Además de las credenciales, comprueba las invitaciones pendientes, los permisos sobre recursos compartidos y la continuidad de la propiedad. No elimines la organización para resolver la salida de un miembro. En Claves de API se explica cómo sustituir y revocar credenciales.

Tras el cambio, comprueba el estado actual de la pertenencia y los roles, así como cualquier registro de auditoría disponible. Pide a quien realiza las llamadas afectadas que verifique el acceso previsto a través de la interfaz admitida, en lugar de compartir una clave con más permisos para eludir una denegación.