Por defecto, los miembros de la organización no pueden crear equipos en una organización de Apidog. El propietario o administrador de una organización puede habilitar este permiso para que los miembros puedan crear equipos propiedad de la organización desde la página de inicio.
El creador se convierte en el Propietario del Equipo del nuevo equipo, pero sigue siendo un Miembro de la Organización. La creación de equipos no otorga acceso a las páginas de gestión de la organización.
Antes de empezar
Necesitas:
- Acceso de Propietario de la organización o Administrador de la organización;
- una cuenta de Miembro de la organización para pruebas;
- una convención de nombres y propiedad para los nuevos equipos;
- un miembro activo de la organización que pueda actuar como propietario de respaldo si es necesario.
Esta configuración cambia quién puede crear equipos propiedad de la organización. No cambia los roles de la organización, los permisos del proyecto ni los permisos de los equipos existentes.
Paso 1: Permitir a los miembros de la organización crear equipos
- Abre la configuración de la organización.
- Ve a Roles y permisos.
- Habilita la opción que permite a los miembros de la organización crear equipos.
- Guarda la configuración.
El permiso está deshabilitado por defecto y puede ser cambiado por un Propietario o Administrador de la organización.
Los Propietarios y Administradores de la organización pueden crear equipos de la organización independientemente de esta configuración.
Paso 2: Probar la creación de equipos como miembro de la organización
Utiliza una cuenta de Miembro de la organización piloto.
- Inicia sesión como el miembro.
- Abre la página de inicio de Apidog.
- Crea un nuevo equipo dentro de la organización.
- Introduce el nombre del equipo y completa el flujo de creación.
- Abre el nuevo equipo.
Confirma todo lo siguiente:
- el equipo pertenece a la organización;
- el miembro que lo creó es el Propietario del Equipo;
- el miembro puede gestionar el nuevo equipo de acuerdo con el rol de Propietario del Equipo;
- el miembro aún no puede acceder a las páginas de gestión de la organización.
La última verificación es importante. Un Propietario del Equipo gestiona ese equipo, pero no se convierte en Administrador de la organización.
Paso 3: Revisar equipos y estado del propietario
Los Propietarios y Administradores de la organización pueden monitorear los equipos de la organización desde la página de gestión de equipos.
- Abre la página de gestión de equipos de la organización.
- Revisa el Propietario del Equipo asignado a cada equipo.
- Verifica el estado del propietario para cuentas inactivas o no disponibles.
- Busca o filtra por Propietario del Equipo y estado del propietario cuando sea necesario un seguimiento.
Utiliza la lista de equipos para identificar aquellos cuyos propietarios puedan no estar disponibles y requieran una transferencia de propiedad.
Una regla de operación simple es revisar el estado del propietario durante las revisiones de acceso regulares y antes de eliminar un miembro de la organización.
Paso 4: Transferir la propiedad del equipo
Los Propietarios y Administradores de la organización pueden transferir uno o más equipos a otro miembro elegible de la organización.
- Abre la página de gestión de equipos de la organización.
- Selecciona el equipo o equipos que necesitan un nuevo propietario.
- Selecciona Cambiar Propietarios.
Múltiples equipos seleccionados pueden ser asignados al mismo nuevo propietario.
- Selecciona el nuevo Propietario del Equipo.
- Confirma la transferencia.
El nuevo propietario debe ser un miembro elegible y activo 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 cuando la organización utiliza SSO SAML.
Los usuarios SSO pendientes, eliminados, deshabilitados o incompletamente asociados no pueden ser seleccionados.
Qué cambia después de la transferencia de propiedad
Después de la transferencia:
- el miembro seleccionado se convierte en Propietario del Equipo;
- Apidog añade al nuevo propietario al equipo si es necesario;
- el propietario anterior se convierte en Administrador del Equipo si permanece en el equipo;
- la transferencia se registra en los Registros de Auditoría de la organización.
La transferencia de propiedad solo cambia el Propietario del Equipo. No mueve el equipo dentro o fuera de la organización.
Verificar la configuración
Realiza estas comprobaciones antes de habilitar el permiso para todos los miembros:
| 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 de la organización |
| Revisión del propietario | El Propietario/Administrador de la organización puede ver el equipo y el estado del propietario |
| Transferencia de propiedad | El nuevo propietario elegible recibe la propiedad y el evento aparece en los Registros de Auditoría |
Después del piloto, comunica las convenciones requeridas de nombres, propietarios y creación de proyectos a los miembros que utilizarán el permiso.
Resolución de problemas
| Problema | Qué verificar |
|---|---|
| Un miembro no puede crear un equipo | Confirma que la configuració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 otorga permisos de Administrador de la organización. |
| No se puede seleccionar un nuevo propietario | Confirma que la cuenta está activa y, para una organización SAML, vinculada a la identidad SSO de la organización. |
| Un antiguo propietario aún tiene acceso al equipo | Si el antiguo propietario permanece en el equipo, su rol cambia a Administrador del Equipo. Revisa si ese acceso aún es necesario. |
| El equipo se movió a otra organización | La transferencia de propiedad no mueve los equipos. Revisa si se realizó una acción de transferencia de equipo separada. |
Limitaciones importantes
- La configuración permite a los miembros crear equipos propiedad de la organización; no les permite gestionar la organización.
- El creador recibe el rol incorporado de Propietario del Equipo. Los permisos personalizados para los roles de equipo no son compatibles actualmente.
- La propiedad a nivel de equipo no determina automáticamente cada rol de proyecto. Revisa el acceso al proyecto por separado.
- La transferencia de propiedad no transfiere el equipo entre organizaciones.
Tutoriales relacionados de gobernanza de API:
Estos tutoriales cubren controles complementarios para gobernar un espacio de trabajo de API empresarial:
- 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 de proveedores de identidad.
- Escáner de Secretos — revisa posibles credenciales expuestas en los activos compatibles de Apidog.
- Registros de Auditoría — investiga y exporta la actividad administrativa de la organización.
- Aprovisionamiento SCIM — gestiona los usuarios de la organización a lo largo del 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 equipos creados por miembros mientras se mantiene la supervisión de la propiedad.
- Integración de GitHub Enterprise Cloud — conecta repositorios compatibles de GHE.com para flujos de trabajo de OpenAPI.
Documentación oficial relacionada: