Zum Inhalt springen

Access-Control-Referenz

Capgo nutzt rollenbasierte Zugriffskontrolle (RBAC) um zu steuern, was jedes Teammitglied tun kann. Rollen sind nach Scope — von der gesamten Organisation bis hin zu einem einzelnen Bundle.

Für eine visuelle Anleitung zur Verwaltung von Mitgliedern im Dashboard siehe Organisation.


Jede Rolle gehört zu einem Bereich, der bestimmt, auf welche Ressource sie Zugriff gewährt.

UmfangGilt fürBeispielanwendungsfall
OrganisationDie gesamte Organisation und alle ihre AppsDein Mitgründer erhält Super Admin; dein Buchhalter erhält Billing Manager
App hinzuEine einzelne App und ihre ChannelsEin Freelancer an einer App erhält die Rolle App Developer
KanalEin einzelner Channel innerhalb einer AppEin QA-Engineer verwaltet nur den staging Channel
BundleEine einzelne Bundle-VersionEin Reviewer benötigt Lesezugriff auf ein bestimmtes Release

Ein Mitglied kann pro Scope-Ziel eine Rolle innehaben — z. B. eine Org-Rolle, eine Rolle für App A und eine andere für App B.


Diese Rollen werden beim Einladen eines Mitglieds zugewiesen. Sie gewähren Zugriff auf die gesamte Organisation.

RolleInterner NameBeschreibung
Super-Adminorg_super_adminEntspricht dem Owner. Volle Kontrolle, inklusive Löschen der Org, Abrechnungsmanagement und App-Transfer. Wird dem Org-Ersteller automatisch zugewiesen.
Adminorg_adminVollständige Administration — Mitglieder, Apps und Channels verwalten. Kann die Organisation nicht löschen, Abrechnungen nicht ändern, Apps nicht übertragen oder Nutzer zu Super Admins befördern.
Abrechnungsmanagerorg_billing_adminNur Billing-Zugriff: Abrechnungsdaten, Rechnungen und Billing-Audit-Logs einsehen und aktualisieren. Kein Zugriff auf Apps oder Mitglieder.
Mitgliedorg_memberNur-Lesezugriff auf die Organisation und alle ihre Apps.
BerechtigungBeschreibungSuper-AdminAdminAbrechnungsmanagerMitglied
org.readOrganisation anzeigen✅✅✅✅
org.update_settingsOrg-Name, Logo und Management-E-Mail bearbeiten✅✅❌❌
org.deleteOrganisation dauerhaft löschen✅❌❌❌
org.read_membersMitgliederliste anzeigen✅✅❌✅
org.invite_userNeue Mitglieder einladen✅✅❌❌
org.update_user_rolesMitgliederrollen ändern (Admin kann niemanden zum Super Admin befördern – blockiert durch die Rollenhierarchie)✅✅❌❌
org.read_billingAbrechnungsinfos und aktuellen Plan anzeigen✅✅✅❌
org.update_billingZahlungsmethode und Plan aktualisieren✅❌✅❌
org.read_invoicesRechnungen anzeigen✅✅✅❌
org.read_auditAktivitätsprotokoll der Organisation anzeigen✅✅❌❌
org.read_billing_auditAbrechnungsbezogenes Audit-Log anzeigen✅✅✅❌

Beschränkt auf eine einzelne App. Nutze diese, wenn ein Teammitglied nur an einer App und nicht an der gesamten Organisation arbeiten soll.

RolleInterner NameBeschreibung
App-Adminapp_adminVolle Kontrolle über eine App – Kanäle, Geräte, Benutzerrollen für die App. Die App kann nicht gelöscht oder übertragen werden (das sind Operationen auf Organisationsebene).
App-Entwicklerapp_developerBundles hochladen, Geräte verwalten, native Builds auslösen, Kanaleinstellungen aktualisieren. Kein Löschen, keine Änderungen an App-Einstellungen, keine Kanalerstellung.
App-Uploaderapp_uploaderLesezugriff + neue Bundle-Versionen hochladen.
App-Readerapp_readerNur Lesezugriff – Statistiken, Bundles, Kanäle, Logs, Geräte.
App-Vorschauapp_previewAn Organisation und App gebundener Preview-CI-Lebenszyklus: ein Bundle hochladen und einen Preview-Kanal erstellen. Das Erstellen dieses Kanals gewährt automatisch Lebenszyklusrechte nur für diesen Kanal.
BerechtigungBeschreibungApp-AdminApp-EntwicklerApp-UploaderApp-Reader
app.readApp-Details, Stats und Metadaten einsehen✅✅✅✅
app.update_settingsApp-Einstellungen bearbeiten✅❌❌❌
app.read_bundlesListe der hochgeladenen Bundles anzeigen✅✅✅✅
app.upload_bundleNeue Bundle-Version hochladen✅✅✅❌
app.create_channelNeuen Channel erstellen✅❌❌❌
app.read_channelsChannels anzeigen✅✅✅✅
app.read_logsUpdate-Delivery-Logs anzeigen✅✅✅✅
app.manage_devicesGeräte zuweisen, überschreiben oder entkoppeln✅✅❌❌
app.read_devicesGeräteliste anzeigen✅✅✅✅
app.build_nativeNative Cloud Build auslösen✅✅❌❌
app.read_auditAktivitätsprotokoll auf App-Ebene anzeigen✅✅✅✅
app.update_user_rolesApp-spezifische Rollenzuweisungen verwalten✅❌❌❌
bundle.deleteBundle löschen✅❌❌❌

Nutzt App-Vorschau (app_preview) für einen organisations- und app-gebundenen CI-Key, der den PR-Preview-Lifecycle verwaltet, ohne weitreichenden App- oder organisationsweiten Zugriff.

Der app_preview Die Bindung gewährt nur diese Berechtigungen auf App-Ebene:

BerechtigungErlaubt
app.readDie ausgewählte App lesen
app.read_bundlesHochgeladene Bundles lesen
app.upload_bundleEin Bundle hochladen
app.create_channelEinen Channel erstellen

Wenn ein App Preview Key einen Channel erstellt, weist Capgo diesem Key automatisch ein Child- channel_preview Binding nur für den neuen Channel zu:

BerechtigungErlaubt
channel.readDen vom Key erstellten Channel lesen
channel.promote_bundleDas eigene hochgeladene Bundle des Keys auf diesem Channel setzen
channel.deleteDiesen Channel löschen

Da app_preview behält app.read, kann der Schlüssel Channel-Metadaten in der ausgewählten App auflisten. Die automatische Kindbindung ist eine Verwaltung Grenze: Der Key erlaubt keine Lifecycle-Änderungen an einem Channel, den er nicht erstellt hat.

Capgo protokolliert den Preview-Key, der jeden Channel erstellt und jedes Bundle hochgeladen hat. Daher kann ein App-Preview-Key jeden nicht öffentlichen Preview-Channel, den er benötigt, erstellen, sein eigenes Bundle promoten und diesen Channel und das Bundle atomar mit channel delete --delete-bundle; das kann er bei einem bestehenden Default-/Main-Channel, dem Channel eines anderen Preview-Keys oder dem Bundle eines anderen Keys nicht tun.

Es enthält nicht app.update_settings, Geräte- oder Rollenverwaltung, channel.update_settings, channel.rollback_bundle, erzwungene Geräteverwaltung oder generische bundle.delete.


Gilt nur für einen einzelnen Channel. Nützlich, um gezielten Zugriff auf einen bestimmten Release-Channel zu gewähren.

RolleInterner NameBeschreibung
Channel-Adminchannel_adminVolle Kontrolle über einen Channel: Einstellungen, Bundles promoten/zurückrollen, Forced Devices verwalten.
Channel-Betrachterchannel_readerRead-only — aktuelles Bundle, Historie, Forced Devices, Audit-Log.
Channel-Vorschauchannel_previewVom System dem App Preview Key zugewiesen, der den Channel erstellt hat: Lesen, eigenes Bundle promoten und den Channel löschen.
BerechtigungBeschreibungChannel-AdminChannel-BetrachterChannel-Vorschau
channel.readChannel und das aktuelle Bundle anzeigen✅✅✅
channel.update_settingsKanaleinstellungen bearbeiten (Plattform-Toggles, Update-Policy…)✅❌❌
channel.deleteKanal löschen✅❌✅
channel.read_historyBundle-Zuweisungsverlauf anzeigen✅✅❌
channel.promote_bundleDas aktive Bundle für den Kanal festlegen✅❌✅
channel.rollback_bundleAuf ein vorheriges Bundle zurückrollen✅❌❌
channel.manage_forced_devicesBestimmte Geräte diesem Kanal fest zuweisen✅❌❌
channel.read_forced_devicesListe der fest zugewiesenen Geräte anzeigen✅✅❌
channel.read_auditKanal-Aktivitätsprotokoll anzeigen✅✅❌

Beschränkt auf eine einzelne Bundle-Version. Selten benötigt – die meisten Teams nutzen stattdessen Rollen auf App-Ebene.

RolleInterner NameBeschreibung
Bundle-Adminbundle_adminEin bestimmtes Bundle lesen, Metadaten aktualisieren und löschen.
Bundle-Viewerbundle_readerNur-Lese-Zugriff auf ein bestimmtes Bundle.

Im Dashboard wird der Channel-Zugriff standardmäßig durch die App-Rolle des Benutzers bestimmt. Für eine feinere Steuerung können Sie bestimmte Channel-Berechtigungen überschreiben pro Benutzer oder Gruppe, ohne deren App-Rolle zu ändern.

Overrides are configured from the app’s Auskunft Tab, indem Sie auf die Schaltfläche „Kanalberechtigungen“ (Schild-Symbol) neben einem Benutzer klicken. Siehe Organisation — Channel-Berechtigungen überschreiben für einen visuellen Überblick.

BerechtigungBeschreibungStandardverhalten
LiesChannel und das aktuelle Bundle anzeigenVon der App-Rolle geerbt
VerlaufVerlauf der Bundle-Zuweisungen anzeigenVon der App-Rolle geerbt
Bundle zuordnenAktives Bundle auf dem Channel setzen oder ändernVon der App-Rolle geerbt

Jede Berechtigung kann wie folgt festgelegt werden:

  • Standard — von der App-Rolle erben (Standard)
  • Erlauben — explizit gewähren, unabhängig von der App-Rolle
  • Verweigern — explizit blockieren, unabhängig von der App-Rolle

So können Sie beispielsweise einem App Reader die Möglichkeit geben, Bundles auf dem staging Channel zu verknüpfen, ohne ihn zum App Developer hochzustufen.


Rollen bilden eine Hierarchie. Eine übergeordnete Rolle erbt alle Berechtigungen ihrer untergeordneten Rollen. Das bedeutet, dass eine org_admin kann alles, was ein app_admin alles kann, was wiederum alles kann, was eine channel_admin kann, und so weiter.

Super Admin (org_super_admin)
└── Admin (org_admin)
└── App Admin (app_admin)
├── App Developer (app_developer)
│ └── App Uploader (app_uploader)
│ └── App Reader (app_reader)
├── Bundle Admin (bundle_admin)
│ └── Bundle Viewer (bundle_reader)
└── Channel Admin (channel_admin)
└── Channel Viewer (channel_reader)

So funktioniert es in der Praxis:

  • Ein Admin auf Org-Ebene kann alles tun, was ein App-Admin kann, für jede App in der Org.
  • Ein App-Admin für eine bestimmte App alles, was ein Channel-Admin kann, für jeden Channel in dieser App.
  • Ein App-Entwickler kann alles, was ein App-Uploader kann, plus mehr.

Die Hierarchie fließt nur nach unten — ein channel_admin erhält niemals Berechtigungen auf Organisationsebene, selbst wenn er auch eine App-Rolle hat.


Statt jedem Benutzer einzeln Rollen zuzuweisen, können Sie Gruppen erstellen und Rollen der Gruppe zuweisen. Jedes Gruppenmitglied erbt diese Rollen automatisch.

  • Eine Gruppe gehört zu eine Organisation — sie kann nicht mehrere Orgs umfassen.
  • Gruppen können Rollenbindungen auf jeder Ebene: Org, App, Channel oder Bundle. Beispielsweise kann einer Gruppe die App-Entwickler Rolle für App A und die Channel-Admin Rolle für den staging Channel von App B.
  • Bei der Prüfung der Berechtigungen eines Benutzers werden alle Gruppenmitgliedschaften transparent aufgelöst. Wenn eine seiner Gruppen die erforderliche Berechtigung gewährt, wird der Zugriff freigegeben.
  • Ein Benutzer kann zu mehrere Gruppen, und Berechtigungen aus allen Gruppen addieren sich.
  • Gruppenbasierte Berechtigungen gelten nur für User-Principals — API Keys erben keine Gruppenrollen.
SzenarioOhne GruppenMit Gruppen
5 QA-Engineers benötigen Developer-Zugriff auf 3 Apps15 einzelne Role-Bindings1 Gruppe + 3 Rollenbindungen
Jemand tritt dem QA-Team bei3 Rollenbindungen manuell hinzufügenDiese der Gruppe hinzufügen
Jemand verlässt das QA-Team3 Rollenbindungen manuell entfernenDiese aus der Gruppe entfernen

Alle Gruppen-Endpoints erfordern Authentifizierung und laufen unter /private/groups.

Terminalfenster
curl -X GET "https://api.capgo.app/private/groups/<ORG_ID>" \
-H "authorization: <API_KEY>"

Erfordert org.read_members Berechtigung.

Terminalfenster
curl -X POST "https://api.capgo.app/private/groups/<ORG_ID>" \
-H "authorization: <API_KEY>" \
-H "Content-Type: application/json" \
-d '{
"name": "QA Team",
"description": "Quality assurance engineers"
}'

Erfordert org.update_user_roles Berechtigung (Super-Admin oder Admin).

Terminalfenster
curl -X PUT "https://api.capgo.app/private/groups/<GROUP_ID>" \
-H "authorization: <API_KEY>" \
-H "Content-Type: application/json" \
-d '{
"name": "QA Team",
"description": "Updated description"
}'
Terminalfenster
curl -X DELETE "https://api.capgo.app/private/groups/<GROUP_ID>" \
-H "authorization: <API_KEY>"

Beim Löschen einer Gruppe werden auch alle ihre Rollenbindungen entfernt. Mitglieder werden nicht aus der Organisation gelöscht.

Gruppenmitglieder auflisten

Section titled “List group members”
Terminalfenster
curl -X GET "https://api.capgo.app/private/groups/<GROUP_ID>/members" \
-H "authorization: <API_KEY>"

Mitglied zu einer Gruppe hinzufügen

Section titled “Add a member to a group”
Terminalfenster
curl -X POST "https://api.capgo.app/private/groups/<GROUP_ID>/members" \
-H "authorization: <API_KEY>" \
-H "Content-Type: application/json" \
-d '{ "user_id": "<USER_UUID>" }'

Der Nutzer muss bereits Mitglied der Organisation sein. Das Hinzufügen eines bereits vorhandenen Mitglieds ist ein No-op.

Terminalfenster
curl -X DELETE "https://api.capgo.app/private/groups/<GROUP_ID>/members/<USER_UUID>" \
-H "authorization: <API_KEY>"

Terminalfenster
curl -X GET "https://api.capgo.app/organization/members" \
-H "authorization: <API_KEY>" \
-H "Content-Type: application/json" \
-d '{ "orgId": "<ORG_ID>" }'

Antwort:

[
{
"uid": "user-uuid",
"email": "alice@example.com",
"image_url": "https://...",
"role": "org_admin",
"is_tmp": false
}
]
Terminalfenster
curl -X POST "https://api.capgo.app/organization/members" \
-H "authorization: <API_KEY>" \
-H "Content-Type: application/json" \
-d '{
"orgId": "<ORG_ID>",
"email": "bob@example.com",
"invite_type": "org_admin"
}'

Zulässige Werte für invite_type:

WertZugewiesene Rolle
org_super_adminSuper-Admin
org_adminAdmin
org_billing_adminAbrechnungsmanager
org_memberMitglied
Terminalfenster
curl -X DELETE "https://api.capgo.app/organization/members" \
-H "authorization: <API_KEY>" \
-H "Content-Type: application/json" \
-d '{
"orgId": "<ORG_ID>",
"email": "bob@example.com"
}'

Terminalfenster
npx @capgo/cli organization list --apikey <API_KEY>
Terminalfenster
npx @capgo/cli organization members <ORG_ID> --apikey <API_KEY>

Die integrierten Rollen decken die meisten Teamstrukturen ab. Die Erstellung benutzerdefinierter Rollen ist in unserer Roadmap – falls Ihr Team dies benötigt, nehmen Sie Kontakt mit uns auf. Ihr Use Case hilft uns dabei, diese Funktion priorisieren zu können.

Wenn du es nutzt Access-Control-Referenz um Dashboard- und API-Operationen zu planen, verbinde es mit API Übersicht für Details zur Implementierung im API Overview, Einführung für die Implementierungsdetails in der Einleitung, API Schlüssel für die Implementierungsdetails in API Keys, Geräte für die Implementierungsdetails in Devices und Bundles für die Implementierungsdetails in Bundles.