Roles y permisos
Cada pertenencia lleva uno de dos roles: administrador o miembro. No hay roles personalizados ni permisos por recurso. El rol se aplica a una sola organización: usted puede ser administrador en una y miembro en otra.
La versión corta: los administradores controlan el dinero y la pertenencia; los miembros controlan el cómputo.
Matriz de permisos
| Área | Acción | Administrador | Miembro |
|---|---|---|---|
| Facturación | Ver el saldo, las transacciones y el gasto diario | Sí | Sí |
| Facturación | Agregar créditos a través de Stripe Checkout | Sí | No |
| Invitaciones | Crear un enlace de invitación | Sí | No |
| Invitaciones | Listar las invitaciones pendientes | Sí | No |
| Invitaciones | Revocar una invitación | Sí | No |
| Miembros | Ver la lista de miembros | Sí | Sí |
| Miembros | Cambiar el rol de otro miembro | Sí | No |
| Miembros | Eliminar a un miembro | Sí | No |
| Miembros | Cambiar el nombre de la organización | Sí | No |
| Instancias | Desplegar una instancia nueva | Sí | Sí |
| Instancias | Iniciar y detener cualquier instancia de la organización | Sí | Sí |
| Instancias | Destruir cualquier instancia de la organización | Sí | Sí |
| Instancias | Leer los logs y los datos de conexión | Sí | Sí |
| Plantillas | Crear, editar y eliminar las plantillas de la organización | Sí | Sí |
| Plantillas | Duplicar una plantilla de sistema, pública o de la organización | Sí | Sí |
| Claves de API | Ver las claves de la organización, sus prefijos y quién las creó | Sí | Sí |
| Claves de API | Crear una clave personal | Sí | Sí |
| Claves de API | Crear una clave de equipo | Sí | No |
| Claves de API | Revocar su propia clave personal | Sí | Sí |
| Claves de API | Revocar cualquier clave de la organización | Sí | No |
| Registro de uso | Leer el registro de uso de la organización | Sí | Sí |
| Claves SSH | Agregar o quitar claves en su propia cuenta | Sí | Sí |
Las claves SSH quedan completamente fuera del sistema de roles: pertenecen a un usuario, no a una organización, y ningún rol da acceso a las de otra persona. Consulte Cambiar de organización.
Lo que pueden hacer los miembros y sorprende a la gente
Un miembro no es un observador de solo lectura. Un miembro puede:
- Desplegar, lo que empieza a gastar de inmediato el saldo prepagado compartido de la organización.
- Destruir cualquier instancia de la organización, incluida una que haya creado un administrador. Destruir elimina el disco de forma permanente; consulte Detener vs. destruir.
- Editar o eliminar cualquier plantilla que pertenezca a la organización, lo que cambia lo que sus compañeros de equipo lanzarán después.
Invite a alguien como miembro cuando las tres cosas le parezcan aceptables.
Lo que solo pueden hacer los administradores
Los administradores controlan las dos cosas que los miembros no pueden tocar: el dinero y la lista de miembros.
- Agregar créditos y abrir Stripe Checkout. Un miembro que intenta desplegar con el saldo vacío ve un mensaje que le indica pedírselo a un administrador en lugar de un botón de pago. Consulte Agregar créditos.
- Crear, listar y revocar invitaciones.
- Promover, degradar y eliminar miembros, y cambiar el nombre de la organización.
Todo lo demás de la matriz está abierto a ambos roles.
Cambiar el rol de alguien
En la página Equipo, use el selector de rol junto a la fila del miembro. El cambio se aplica a su siguiente solicitud; una consola abierta lo recoge en su próxima actualización.
No puede cambiar su propia fila: su rol aparece como una insignia en lugar de un selector. Pídaselo a otro administrador si necesita que lo degraden.
Eliminar a un miembro
El control para eliminar está al final de la fila de cada miembro. La persona pierde de inmediato el acceso a las instancias, las plantillas, las claves y el registro de uso de la organización, y la organización desaparece de su selector de espacios de trabajo. Sus propias claves SSH y su espacio de trabajo personal quedan intactos.
Cada clave personal que la persona creó en esta organización se revoca en el momento en que se la elimina y, en cualquier caso, una clave personal cuyo creador ya no es miembro se rechaza en cada solicitud. Todo lo que ejecutaba con una clave personal, como un trabajo de CI o un script de cron, recibe 401 TOKEN_INVALID a partir de entonces.
Las claves team pertenecen a la organización y siguen funcionando después de que se vaya quien las creó. Ponga la automatización compartida en una clave de equipo para que sobreviva a los cambios de personal, y revise las claves de equipo en la página Claves de API cuando se vaya alguien que tenía acceso a ellas.
Una clave de equipo actúa en nombre de la organización, no del administrador que la creó. Los despliegues hechos con ella pueden adjuntar la clave SSH de cualquier persona que sea miembro ahora y la de nadie que se haya ido —incluido el creador de la clave—, y una instancia desplegada con ella nombra la clave, no a una persona, en deployed_by. La clave sobrevive a la salida de su creador, pero esa persona vio su secreto una vez y puede conservar una copia: la página Claves de API marca esa clave con su creador salió. Pida a un administrador actual que cree una clave de reemplazo, pase la automatización a ella y revoque la anterior.
El último administrador
Una organización siempre conserva al menos un administrador. Eliminar al último administrador, o degradarlo a miembro, falla con LAST_ADMIN y el error "Una organización necesita al menos un administrador". Promueva primero a otra persona.
Las claves de API siempre actúan como miembro
Una clave de API lleva acceso de nivel miembro a la organización que la creó, sin importar quién la haya creado. Las acciones de administrador —facturación, invitaciones, gestión de miembros, emisión o revocación de otras claves— se rechazan en un token shk_ con ADMIN_REQUIRED. Esas llamadas necesitan una sesión iniciada.
Las claves de equipo y las claves personales dan el mismo acceso; se diferencian en quién las gestiona y en cuánto duran. Una clave de equipo la gestionan los administradores, pertenece a la organización y sobrevive a la membresía de quien la creó. Una clave personal pertenece a quien la creó y se revoca cuando esa persona es eliminada de la organización. Ninguno de los dos tipos tiene más privilegios que un miembro. Use una clave de equipo para la CI y para todo aquello de lo que dependa la organización. Consulte Claves de API.
Espacios de trabajo personales
Su espacio de trabajo personal tiene exactamente un miembro: usted, como administrador. No admite invitaciones y no puede albergar un equipo. Intentar crear una invitación ahí devuelve PERSONAL_ORG. Cree una organización de verdad cuando necesite a una segunda persona.