En Apidog, una organización se utiliza para gestionar de forma centralizada varios equipos y miembros. Con las organizaciones, usted puede controlar permisos, asignar roles y garantizar una colaboración eficiente en toda su empresa.Crear una organización#
Puede crear una o más organizaciones. Para crear una nueva organización:1.
En la ventana principal, haga clic en Organizations en el panel de navegación izquierdo para abrir la página de gestión de organizaciones.
2.
Haga clic en el botón + New Organization en la parte inferior izquierda.
3.
Introduzca el nombre de la organización.
4.
Haga clic en Create. Su nueva organización ya está configurada.
Miembros y roles de la organización#
Puede invitar miembros a su organización y asignarles diferentes roles:Org Admin: Tiene los permisos más altos (excepto el propietario de la organización). Puede gestionar miembros de la organización, equipos y la configuración de la organización.
Org Member: Puede unirse a la organización y a sus equipos, y colaborar en proyectos. No puede cambiar la configuración de la organización.
Invitar miembros a la organización#
Como propietario o administrador de la organización, usted puede incorporar personal directamente a la empresa desde el nivel de organización. Esto es muy adecuado para que los departamentos de RR. HH. o TI distribuyan cuentas de forma centralizada durante la incorporación de empleados.💡 Requisito previo:
Antes de enviar una invitación a la organización, su organización debe tener al menos un equipo creado; de lo contrario, no habrá ningún lugar donde asignar roles de equipo.
Para invitar miembros a la organización, vaya a Members dentro de su organización:Haga clic en Invite, donde puede elegir un método de invitación y conceder permisos según corresponda:Rol de organización: Por lo general, a los nuevos empleados se les asigna de forma uniforme el rol Member.
Todos los roles de equipo: Al invitarlos a la empresa, puede incorporarlos directamente a los grupos de negocio subordinados correspondientes. Puede establecer universalmente el mismo rol para todos los equipos, o hacer clic en "Custom" para abrir los detalles y especificar con precisión: "Solo se unen al Equipo A como miembros y permanecen sin unirse al Equipo B".
2.
Invitar por correo electrónico (o importación masiva):
Además de admitir configuraciones independientes para cada correo electrónico y la importación masiva mediante CSV, igual que en el nivel de equipo, también puede utilizar la herramienta Bulk Config en la parte superior para configurar rápida y uniformemente el Organization Role y los Team Roles asignados específicamente para este grupo de personas.
Cascada de permisos y asignación de roles predeterminada#
Es fundamental comprender que los roles de organización y los roles de equipo/proyecto funcionan en dos vías separadas. Comprender cómo los permisos se transmiten en cascada —o no— es esencial al asignar roles:Roles de organización frente a acceso de equipo: Los administradores de la organización tienen autoridad administrativa sobre la estructura de la empresa (por ejemplo, crear equipos, gestionar la facturación y supervisar el directorio de miembros). Sin embargo, no obtienen automáticamente acceso a los datos de API dentro de proyectos individuales. Para acceder a un proyecto o editarlo, un Org Admin aún debe añadirse al equipo o proyecto correspondiente.
Administrador de equipo → Editor de proyecto: Los usuarios asignados como administradores de equipo reciben automáticamente permisos de Editor para todos los proyectos dentro de ese equipo.
Miembro de equipo → Solo lectura de proyecto: Los usuarios asignados como miembros estándar del equipo reciben acceso seguro de solo lectura a los proyectos del equipo de forma predeterminada.
Prohibido / Sin unirse: Si un usuario no está asignado a un equipo (o está establecido como Prohibido), no recibe acceso a proyectos dentro de ese equipo.
Nota:
Estos son solo los permisos iniciales de referencia. Una vez dentro del equipo, los administradores de equipo pueden ajustar individualmente los permisos de proyecto o personalizar roles en función de las necesidades reales del negocio.
Roles de proyecto personalizados#
Los roles personalizados solo son compatibles con el nivel de proyecto. Los roles de organización actualmente no admiten personalización.
Relación entre organizaciones y equipos#
Organización: La unidad de gestión de más alto nivel, que representa una empresa o un grupo grande. Gestiona varios equipos.
Equipos: Una subunidad dentro de una organización, normalmente un departamento o grupo más pequeño. Gestiona varios proyectos.
Organización frente a equipo: ¿cuál debería elegir?#
Al utilizar Apidog, una pregunta común es: ¿debería gestionarlo todo directamente bajo una organización, o depender principalmente de equipos? La respuesta realmente depende de dos factores: el tamaño del equipo y el alcance del negocio.Si su equipo es pequeño y está enfocado#
Supongamos que tiene alrededor de diez personas trabajando en la misma línea de producto. En ese caso, un solo equipo es más que suficiente. Un equipo puede gestionar proyectos, APIs y miembros en un solo lugar: de forma simple y eficiente, sin la carga adicional de una organización.Si su empresa es grande y está distribuida#
Si cuenta con muchas personas y varias líneas de negocio no relacionadas, lo mejor es crear primero una organización y luego configurar equipos separados dentro de ella para cada área de negocio. Cada equipo gestiona sus propios proyectos y miembros, con límites claros y sin solapamientos.Los administradores pueden actualizar el nombre o los detalles de la organización desde Settings. Todos los miembros verán la información actualizada.Transferir la organización#
El propietario de la organización puede transferir la propiedad a otro miembro mediante Organization Settings → Danger Zone → Transfer.Disolver la organización#
El propietario de la organización puede eliminar permanentemente la organización en Organization Settings → Danger Zone → Dismiss Organization.Disolver una organización es permanente y no se puede deshacer. Todos los equipos y proyectos dentro de la organización se eliminarán.
