Permitir que los miembros creen equipos en una organización de Apidog
Por defecto, los miembros de la organización no pueden crear equipos en una organización de Apidog. El Propietario o Administrador de la organización puede habilitar este permiso desde la página de inicio.
Quien crea el equipo se convierte en su Propietario del Equipo, pero continúa siendo un Miembro de la Organización. Crear equipos no concede acceso a las páginas de gestión de la organización.
Antes de empezar
Necesitas:
- acceso de Propietario o Administrador de la organización;
- una cuenta de Miembro de la organización para realizar pruebas;
- una convención para nombrar y asignar propietarios a los equipos;
- un miembro activo que pueda actuar como propietario de respaldo.
Esta configuración solo cambia quién puede crear equipos propiedad de la organización. No modifica los roles de la organización, los permisos de los proyectos ni los permisos de los equipos existentes.
1. Permitir que los miembros creen equipos
- Abre la configuración de la organización.
- Ve a Roles y permisos.
- Habilita la opción para que los miembros de la organización creen equipos.
- Guarda los cambios.
El permiso está deshabilitado por defecto y solo puede cambiarlo un Propietario o Administrador de la organización.
Los Propietarios y Administradores pueden crear equipos de la organización independientemente de esta configuración.
2. Probar la creación como miembro
Utiliza una cuenta piloto con el rol de Miembro de la organización:
- Inicia sesión con la cuenta piloto.
- Abre la página de inicio de Apidog.
- Crea un equipo nuevo dentro de la organización.
- Introduce el nombre y completa el flujo de creación.
- Abre el equipo recién creado.
Confirma que:
- el equipo pertenece a la organización;
- quien lo creó es el Propietario del Equipo;
- puede gestionar el equipo según los permisos de ese rol;
- sigue sin poder acceder a las páginas de gestión de la organización.
Esta última comprobación es fundamental: ser Propietario del Equipo no convierte al usuario en Administrador de la organización.
3. Revisar los equipos y el estado de sus propietarios
Los Propietarios y Administradores de la organización pueden supervisar los equipos desde la página de gestión de equipos:
- Abre la página de gestión de equipos.
- Revisa el Propietario del Equipo asignado a cada equipo.
- Comprueba si el propietario está inactivo o ya no está disponible.
- Filtra por propietario y estado cuando necesites hacer seguimiento.
Usa la lista para identificar equipos cuyos propietarios podrían no estar disponibles y requieran una transferencia.
Incluye esta revisión en los controles de acceso periódicos y antes de eliminar a un miembro de la organización.
4. Transferir la propiedad de un equipo
Los Propietarios y Administradores de la organización pueden transferir uno o varios equipos a otro miembro elegible:
- Abre la página de gestión de equipos.
- Selecciona los equipos que necesitan un nuevo propietario.
- Selecciona Cambiar propietarios.
Puedes asignar varios equipos al mismo propietario nuevo.
- Selecciona el nuevo Propietario del Equipo.
- Confirma la transferencia.
El nuevo propietario debe ser un miembro activo y elegible de la organización.
El nuevo propietario debe:
- tener una cuenta de Apidog utilizable;
- ser un miembro activo de la organización;
- tener una identidad SSO asociada con la organización si se utiliza SSO SAML.
No se pueden seleccionar usuarios SSO pendientes, eliminados, deshabilitados o asociados de forma incompleta.
Qué ocurre después de la transferencia
Después de transferir la propiedad:
- el miembro seleccionado se convierte en Propietario del Equipo;
- Apidog lo añade al equipo si es necesario;
- el propietario anterior pasa a ser Administrador del Equipo si permanece en él;
- la transferencia queda registrada en los Registros de Auditoría de la organización.
La transferencia solo cambia el Propietario del Equipo. No mueve el equipo dentro o fuera de la organización.
Verificar la configuración
Antes de habilitar el permiso para todos los miembros, realiza una prueba piloto:
| Verificación | Resultado esperado |
|---|---|
| El miembro crea un equipo | El equipo se crea dentro de la organización |
| Rol del creador en el equipo | El creador es el Propietario del Equipo |
| Rol del creador en la organización | El creador sigue siendo Miembro de la organización |
| Configuración de la organización | El creador no puede abrir las páginas de gestión |
| Revisión del propietario | El Propietario o Administrador puede ver el equipo y el estado del propietario |
| Transferencia de propiedad | El nuevo propietario recibe la propiedad y el evento aparece en los Registros de Auditoría |
Tras el piloto, comunica a los miembros las convenciones de nombres, propietarios y creación de proyectos.
Resolución de problemas
| Problema | Qué verificar |
|---|---|
| Un miembro no puede crear un equipo | Confirma que la opción está habilitada y que el usuario es un Miembro activo de la organización correcta. |
| El miembro espera acceso a la configuración de la organización | La propiedad del equipo no concede permisos de Administrador de la organización. |
| No se puede seleccionar un nuevo propietario | Confirma que la cuenta está activa y, en organizaciones SAML, vinculada a la identidad SSO correcta. |
| Un antiguo propietario aún tiene acceso | Si permanece en el equipo, su rol cambia a Administrador del Equipo. Revisa si ese acceso sigue siendo necesario. |
| El equipo se movió a otra organización | La transferencia de propiedad no mueve equipos. Comprueba si se realizó una transferencia de equipo independiente. |
Limitaciones importantes
- El permiso permite crear equipos propiedad de la organización, pero no gestionar la organización.
- El creador recibe el rol integrado de Propietario del Equipo. Actualmente no se admiten permisos personalizados para los roles de equipo.
- La propiedad del equipo no determina automáticamente los roles de los proyectos. Revisa el acceso a cada proyecto por separado.
- Transferir la propiedad no transfiere el equipo entre organizaciones.
Tutoriales relacionados de gobernanza de API
- Marco de Gobernanza de API: conecta la propiedad, los controles, la evidencia y las decisiones del ciclo de vida.
- Mapeo de Grupos SAML con Microsoft Entra ID: asigna acceso a equipos desde grupos del proveedor de identidad.
- Escáner de Secretos: revisa posibles credenciales expuestas en activos compatibles de Apidog.
- Registros de Auditoría: investiga y exporta la actividad administrativa de la organización.
- Aprovisionamiento SCIM: gestiona los usuarios durante todo el ciclo de vida de la identidad.
- Políticas Empresariales: configura controles de credenciales, membresía, sesiones SSO e invitaciones.
- Equipos de API de Autoservicio Gobernados: permite crear equipos manteniendo la supervisión de la propiedad.
- Integración de GitHub Enterprise Cloud: conecta repositorios compatibles de GHE.com para flujos de trabajo de OpenAPI.
Top comments (0)