Todo en Ephemeral pertenece a una organización. Las personas se unen a una organización con un rol, y el software usa claves de API de la organización con un rol propio. Los dos tipos de rol son independientes.
Personas
| Rol | Puede |
|---|---|
| Propietario | Todo lo que puede un administrador, además de cambiar roles, eliminar administradores y transferir la propiedad. Cada organización tiene un propietario. |
| Administrador | Todo lo que puede un miembro, además de gestionar conexiones, miembros, invitaciones, claves de API, facturación y licencias de despliegue. |
| Miembro | Iniciar, leer y cancelar ejecuciones; gestionar archivos y flujos de trabajo; usar conexiones por su nombre. |
Quien crea una organización pasa a ser su propietario. Los administradores pueden invitar a personas como administradores o miembros y eliminar miembros. Solo el propietario puede eliminar a un administrador o cambiar el rol de alguien. No se puede eliminar al propietario; para dejar el cargo, transfiere la propiedad a un miembro existente, que pasa a ser el propietario mientras tú pasas a ser administrador.
Claves de API
Una clave de API actúa en nombre de su organización. Cada clave tiene el rol member o admin, que eliges al crearla. El secreto de la clave se muestra una sola vez; guárdalo en tu servidor y revoca la clave si se filtra. La revocación surte efecto de inmediato.
- Usa una clave de miembro para el código de aplicación que inicia ejecuciones. Es la opción predeterminada.
- Usa una clave de administrador solo para herramientas de configuración de confianza que además necesiten crear o modificar conexiones.
Ambos roles abarcan toda la organización. Una clave de miembro no es de solo lectura, y ninguna clave se puede limitar a flujos de trabajo o archivos concretos. Si necesitas esa separación, usa organizaciones distintas.
Qué puede hacer cada rol
| Acción | Usuario o clave de miembro | Clave de administrador | Usuario propietario o administrador |
|---|---|---|---|
| Iniciar, leer y cancelar ejecuciones | Sí | Sí | Sí |
| Subir, renombrar y eliminar archivos | Sí | Sí | Sí |
| Guardar y eliminar flujos de trabajo | Sí | Sí | Sí |
| Listar las conexiones disponibles y usarlas por su nombre | Sí | Sí | Sí |
| Leer y modificar los ajustes de las conexiones, iniciar OAuth | No | Sí | Sí |
| Gestionar miembros, invitaciones, claves de API, facturación y licencias | No | No | Sí |
Claves del servicio alojado y autoalojadas
| Servicio alojado | Instalación autoalojada | |
|---|---|---|
| Prefijo de la clave | eak_ | eph_ |
| Se crea en | El panel, en Claves de API, o la API de organizaciones | El panel, en Claves de API, o POST /v1/keys |
| Quién puede crear claves | Propietario o administrador, con la sesión iniciada | Una clave de administrador |
| Primera clave | La creas tú después de registrarte | La emite la solicitud de arranque durante la configuración |
Una instalación autoalojada no tiene cuentas de clientes, así que sus claves de administrador también gestionan las claves de la instalación. Consulta autoalojamiento para la primera clave y organizaciones para los endpoints de claves del servicio alojado.
X-Ephemeral-Organization; las claves de API ya pertenecen a una organización.