Alles in Ephemeral gehört zu einer Organisation. Personen treten einer Organisation mit einer Rolle bei, und Software nutzt API-Schlüssel der Organisation mit einer eigenen Rolle. Die beiden Rollenarten sind voneinander getrennt.
Personen
| Rolle | Darf |
|---|---|
| Inhaber | Alles, was ein Admin darf, außerdem Rollen ändern, Admins entfernen und das Eigentum übertragen. Jede Organisation hat einen Inhaber. |
| Admin | Alles, was ein Mitglied darf, außerdem Verbindungen, Mitglieder, Einladungen, API-Schlüssel, Abrechnung und Bereitstellungslizenzen verwalten. |
| Mitglied | Ausführungen starten, lesen und abbrechen; Dateien und Workflows verwalten; Verbindungen per Name verwenden. |
Wer eine Organisation erstellt, wird ihr Inhaber. Admins können Personen als Admins oder Mitglieder einladen und Mitglieder entfernen. Nur der Inhaber kann einen Admin entfernen oder die Rolle einer Person ändern. Der Inhaber kann nicht entfernt werden; um zurückzutreten, übertragen Sie das Eigentum auf ein bestehendes Mitglied, das dann Inhaber wird, während Sie Admin werden.
API-Schlüssel
Ein API-Schlüssel handelt im Namen seiner Organisation. Jeder Schlüssel hat die Rolle member oder admin, die Sie beim Erstellen wählen. Das Geheimnis des Schlüssels wird nur einmal angezeigt; bewahren Sie es auf Ihrem Server auf und widerrufen Sie den Schlüssel, falls er offengelegt wird. Der Widerruf wirkt sofort.
- Verwenden Sie einen member-Schlüssel für Anwendungscode, der Ausführungen startet. Das ist die Standardeinstellung.
- Verwenden Sie einen admin-Schlüssel nur für vertrauenswürdige Einrichtungstools, die auch Verbindungen erstellen oder ändern müssen.
Beide Rollen gelten für die gesamte Organisation. Ein member-Schlüssel ist nicht schreibgeschützt, und kein Schlüssel lässt sich auf bestimmte Workflows oder Dateien beschränken. Brauchen Sie diese Trennung, verwenden Sie getrennte Organisationen.
Was jede Rolle darf
| Aktion | Mitglied (Benutzer oder Schlüssel) | Admin-Schlüssel | Inhaber oder Admin (Benutzer) |
|---|---|---|---|
| Ausführungen starten, lesen und abbrechen | Ja | Ja | Ja |
| Dateien hochladen, umbenennen und löschen | Ja | Ja | Ja |
| Workflows speichern und löschen | Ja | Ja | Ja |
| Verfügbare Verbindungen auflisten und per Name verwenden | Ja | Ja | Ja |
| Verbindungseinstellungen lesen und ändern, OAuth starten | Nein | Ja | Ja |
| Mitglieder, Einladungen, API-Schlüssel, Abrechnung und Lizenzen verwalten | Nein | Nein | Ja |
Schlüssel beim gehosteten Dienst und bei Self-Hosting
| Gehosteter Dienst | Selbst gehostete Installation | |
|---|---|---|
| Schlüsselpräfix | eak_ | eph_ |
| Erstellt in | Dem Dashboard unter API-Schlüssel oder der Organisations-API | Dem Dashboard unter API-Schlüssel oder mit POST /v1/keys |
| Wer Schlüssel erstellen kann | Inhaber oder Admin, angemeldet | Ein Admin-Schlüssel |
| Erster Schlüssel | Von Ihnen nach der Registrierung erstellt | Bei der Einrichtung durch die Bootstrap-Anfrage ausgestellt |
Eine selbst gehostete Installation hat keine Kundenkonten, daher verwalten ihre Admin-Schlüssel auch die Schlüssel der Installation. Den ersten Schlüssel beschreibt Self-Hosting, die Schlüssel-Endpunkte des gehosteten Dienstes Organisationen.
X-Ephemeral-Organization; API-Schlüssel gehören bereits zu einer Organisation.