Tout dans Ephemeral appartient à une organisation. Les personnes rejoignent une organisation avec un rôle, et les logiciels utilisent des clés API d'organisation avec leur propre rôle. Les deux types de rôles sont distincts.
Personnes
| Rôle | Peut |
|---|---|
| Propriétaire | Tout ce qu'un administrateur peut faire, plus modifier les rôles, retirer des administrateurs et transférer la propriété. Chaque organisation a un seul propriétaire. |
| Administrateur | Tout ce qu'un membre peut faire, plus gérer les connexions, les membres, les invitations, les clés API, la facturation et les licences de déploiement. |
| Membre | Lancer, consulter et annuler des exécutions ; gérer les fichiers et les workflows ; utiliser les connexions par leur nom. |
La personne qui crée une organisation en devient propriétaire. Les administrateurs peuvent inviter des personnes comme administrateurs ou comme membres, et retirer des membres. Seul le propriétaire peut retirer un administrateur ou modifier le rôle de quelqu'un. Le propriétaire ne peut pas être retiré ; pour quitter ce rôle, transférez la propriété à un membre existant : il devient propriétaire et vous devenez administrateur.
Clés API
Une clé API agit au nom de son organisation. Chaque clé a le rôle member ou admin, choisi à sa création. Le secret de la clé n'est affiché qu'une fois ; conservez-le sur votre serveur et révoquez la clé en cas de fuite. La révocation prend effet immédiatement.
- Utilisez une clé member pour le code applicatif qui lance des exécutions. C'est le choix par défaut.
- Utilisez une clé admin uniquement pour des outils de configuration de confiance qui doivent aussi créer ou modifier des connexions.
Les deux rôles couvrent toute l'organisation. Une clé member n'est pas en lecture seule, et aucune clé ne peut être limitée à certains workflows ou fichiers. Si vous avez besoin de cette séparation, utilisez des organisations distinctes.
Ce que peut faire chaque rôle
| Action | Utilisateur ou clé member | Clé admin | Utilisateur propriétaire ou administrateur |
|---|---|---|---|
| Lancer, consulter et annuler des exécutions | Oui | Oui | Oui |
| Importer, renommer et supprimer des fichiers | Oui | Oui | Oui |
| Enregistrer et supprimer des workflows | Oui | Oui | Oui |
| Lister les connexions disponibles et les utiliser par leur nom | Oui | Oui | Oui |
| Lire et modifier les paramètres des connexions, lancer OAuth | Non | Oui | Oui |
| Gérer les membres, les invitations, les clés API, la facturation et les licences | Non | Non | Oui |
Clés hébergées et auto-hébergées
| Service hébergé | Installation auto-hébergée | |
|---|---|---|
| Préfixe de clé | eak_ | eph_ |
| Créée dans | Le tableau de bord, sous Clés API, ou l'API des organisations | Le tableau de bord, sous Clés API, ou POST /v1/keys |
| Qui peut créer des clés | Un propriétaire ou un administrateur, connecté | Une clé admin |
| Première clé | Créée par vos soins après l'inscription | Émise par la requête d'amorçage lors de l'installation |
Une installation auto-hébergée n'a pas de comptes clients : ses clés admin gèrent donc aussi les clés de l'installation. Consultez auto-hébergement pour la première clé et organisations pour les endpoints de clés du service hébergé.
X-Ephemeral-Organization ; les clés API appartiennent déjà à une seule organisation.