Zum Inhalt springen

Organisation

Mit der Organisation kannst du Apps mit deinem Team teilen und gleichzeitig genau steuern, wer was darf. Jedes Capgo Konto gehört zu mindestens einer Organisation, und du kannst so viele Organisationen erstellen, wie du benötigst.

Der Zugriff wird über rollenbasierte Zugriffskontrolle (RBAC)verwaltet. Jedem Teammitglied wird eine Rolle zugewiesen – entweder auf Organisationsebene oder spezifisch für eine App –, die bestimmt, was es sehen und tun kann. Der Channel-Zugriff lässt sich durch individuelle Berechtigungen pro Channel noch feiner abstimmen.


Organisationseinstellungen im Überblick

Abschnitt: „Übersicht der Organisationseinstellungen“
Organisationseinstellungen im Überblick

Die Organisationseinstellungen erreichst du, indem du auf Einstellungen in der linken Seitenleiste klickst und dann den Organisation Tab oben auswählst. Von dort kannst du zwischen folgenden Bereichen wechseln:

TabBeschreibung
AllgemeinOrganisationsname, Logo und Management-E-Mail anzeigen und bearbeiten
MitgliederTeammitglieder und deren Berechtigungen verwalten
GruppenBenutzergruppen für die Massenzuweisung von Rollen erstellen und verwalten
API SchlüsselVerwalte API Keys für den programmatischen Zugriff
TarifeDein Abonnement verwalten und einsehen
CreditsZusätzliche Credits einsehen und kaufen
SicherheitSicherheitsrichtlinien konfigurieren (2FA, Passwortvorgaben)
NutzungNutzungsstatistiken deiner Organisation überwachen
Audit-LogsAktivitätsprotokolle deiner Organisation anzeigen
WebhooksWebhook-Integrationen konfigurieren
AbrechnungRechnungsdaten und Rechnungen verwalten

So wechselst du zwischen Organisationen

Abschnitt mit dem Titel „Organisation wechseln“

Klicke auf die Organisations-Selector Dropdown oben links in der Sidebar, um zwischen den Organisationen zu wechseln, auf die du Zugriff hast.


Mitgliederliste der Organisation

Im Bereich Mitglieder werden alle Nutzer mit Zugriff auf deine Organisation angezeigt, inklusive:

  • Mitglied: Avatar und Name
  • Rolle: Aktuelle Rolle (Super Admin, Admin, Billing Manager oder Member) mit einem Aktiv oder Ausstehend Badge
  • Aktionen: Rolle bearbeiten, App-Zugriff verwalten oder aus der Organisation entfernen

Aktive Mitglieder werden nach Rollenpriorität sortiert. Ausstehende Einladungen werden mit einem orangefarbenen Ausstehend badge.

  1. Klicke auf das + Hinzufügen Button im Bereich Mitglieder
  2. Ein Wähle eine Rolle aus Ein Modal erscheint – wähle die Rolle auf Organisationsebene für das neue Mitglied:
Modal zur Rollenauswahl

Die verfügbaren Rollen auf Organisationsebene sind:

  • Mitglied — Nur Lesezugriff
  • Abrechnungsmanager — Nur Abrechnungszugriff
  • Admin — Volle Administration (keine Abrechnung, kein Löschen)
  • Super-Admin — Volle Kontrolle
  1. Klicken Bestätigen, fülle dann das Einladungsformular aus (E-Mail, optional Vor-/Nachname, Captcha) und klicke auf Einladung senden.

Der eingeladene Nutzer erhält eine E-Mail mit einem Magic Link. Nach der Annahme wird er mit der gewählten Rolle der Organisation hinzugefügt.

Zusätzlich zur Rolle auf Organisationsebene kannst du Mitgliedern über gezieltere Rollen Zugriff auf bestimmte Apps gewähren. Klicke auf den Zugriffskontrolle Button (Schild-Icon) neben einem Mitglied, um das Modal für den App-Zugriff zu öffnen:

Access Control Modal

In diesem Modal kannst du:

  1. Eine App suchen und auswählen
  2. Wähle eine App-Rolle aus dem Dropdown
App-Rollen-Dropdown

Folgende App-Rollen stehen zur Verfügung:

  • App-Admin — Vollständige Administration einer App
  • App-Entwickler — Bundles hochladen, Geräte verwalten, keine destruktiven Aktionen
  • App-Uploader — App-Daten lesen und Bundles hochladen
  • App-Reader — Nur Lesezugriff auf eine App
  1. Klicken Zuweisen um die Rolle zu vergeben.

Rolle eines Mitglieds bearbeiten

Abschnitt „Rolle eines Mitglieds bearbeiten“

Klicke auf das Bearbeiten-Symbol (Schraubenschlüssel) neben einem Mitglied, um dessen Rolle auf Organisationsebene zu ändern. Dasselbe Wähle eine Rolle aus Modal erscheint, in dem die aktuelle Rolle vorausgewählt ist.

Einschränkungen:

  • Die Rolle des Organisationserstellers kann nicht geändert werden
  • Der letzte Super Admin kann nicht entfernt werden – es muss immer mindestens einer vorhanden sein
  • Um einen Super Admin zu befördern oder herabzustufen, musst du selbst Super Admin sein
Dialog „Löschen bestätigen“

Klicke auf das Löschen-Symbol (Papierkorb) neben einem Mitglied. Ein Bestätigungsdialog erscheint, der darauf hinweist, dass dieser Schritt nicht rückgängig gemacht werden kann. Klicke Löschen auf Bestätigen. Damit wird der Zugriff auf die Organisation, deren Apps und Channels sofort entzogen.


Capgo nutzt rollenbasierte Zugriffskontrolle mit Rollen, die nach Scope organisiert sind. Du kannst eine Rolle auf der Organisationsebene (Zugriff auf alles) vergeben oder den Zugriff auf einen einzelnen AppDer Channel-Zugriff lässt sich durch spezifische Berechtigungs-Overrides pro Channel weiter anpassen.

Wird bei der Einladung eines Members zugewiesen. Diese gelten für die gesamte Organisation.

RolleInterner NameBeschreibung
Super-Adminorg_super_adminVolle Kontrolle — Abrechnung, Löschen, Transfer. Wird dem Org-Ersteller automatisch zugewiesen.
Adminorg_adminVolle Administration — Mitglieder, Apps und Channels verwalten. Keine Abrechnung, kein Löschen.
Abrechnungsmanagerorg_billing_adminNur Abrechnung — Zahlungen, Rechnungen und Billing-Audits einsehen/aktualisieren. Kein Zugriff auf Apps oder Mitglieder.
Mitgliedorg_memberRead-only-Zugriff auf die Organisation und alle ihre Apps.

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 — Channels, Geräte und Team. Die App kann nicht gelöscht oder übertragen werden.
App-Entwicklerapp_developerBundles hochladen, Geräte verwalten, Builds triggern, Channels aktualisieren. Keine Löschungen oder Einstellungsänderungen.
App-Uploaderapp_uploaderLesezugriff + neue Bundle-Versionen hochladen.
App-Readerapp_readerNur Lesezugriff — Stats, Bundles, Channels, Logs, Geräte.

Standardmäßig wird der Channel-Zugriff von der App-Rolle vererbt. Du kannst spezifische Channel-Berechtigungen pro Nutzer oder Gruppe überschreiben — zum Beispiel einem App Reader erlauben, Bundles auf dem staging Channel zu verknüpfen. Siehe Zugriffsmanagement auf App-Ebene unten, wie du dies konfigurierst.


Zugriffsmanagement auf App-Ebene

Abschnitt „App-level access management“

Jede App hat einen eigenen Auskunft Tab, in dem du verwalten kannst, wer Zugriff auf die App hat und was erlaubt ist – inklusive App-Rollen und kanalbezogener Permission-Overrides.

App Access Tab

Navigiere zu deiner App und klicke auf den Auskunft Tab. Die Access-Liste zeigt jeden Nutzer oder jede Gruppe mit:

  • E-Mail — der E-Mail des Nutzers (oder dem Gruppennamen)
  • Rolle — der Rolle auf App-Ebene (App Admin, App Developer, App Uploader oder App Reader)
  • Gewährt am — dem Zeitpunkt der Rollenzuweisung
  • Aktionen — Channel-Berechtigungen (Schild-Icon), Rolle bearbeiten (Schraubenschlüssel-Icon) und entfernen (Papierkorb-Icon)

Klicke auf das bearbeiten Schaltfläche (Schraubenschlüssel-Icon) neben einem Nutzer, um dessen App-Rolle zu ändern:

App-Rolle auswählen

Wähle die neue Rolle aus und klicke auf Bestätigen. Die verfügbaren Rollen sind:

  • App-Entwickler — Bundles hochladen, Geräte verwalten, aber keine destruktiven Aktionen
  • App-Uploader — App-Daten lesen und Bundles hochladen
  • App-Reader — Nur Lesezugriff

Channel-Berechtigungen überschreiben

Abschnitt „Overriding channel permissions“

Klicke auf das Channel-Berechtigungen Schaltfläche (Schild-Icon) neben einem User, um dessen Standard-Channel-Berechtigungen zu überschreiben:

Modal für Channel-Berechtigungen

Das Modal zeigt die aktuelle App-Rolle des Users und listet alle Channels mit drei Berechtigungen auf, die einzeln überschrieben werden können:

BerechtigungBeschreibung
LiesChannel und das aktuelle Bundle anzeigen
VerlaufVerlauf der Bundle-Zuweisungen anzeigen
Bundle zuordnenAktives Bundle auf dem Channel festlegen oder ändern

Jede Berechtigung ist standardmäßig auf Standard (erlauben) — das heißt, es wird die App-Rolle übernommen. Du kannst jede Berechtigung explizit Erlauben oder Verweigern für einen bestimmten Channel, was dir eine feingranulare Kontrolle ermöglicht, ohne die allgemeine App-Rolle des Nutzers zu ändern.


Mit Groups kannst du Rollen für eine ganze Gruppe von Nutzern gleichzeitig zuweisen, anstatt jedes Mitglied einzeln zu verwalten. Eine Group gehört zu einer Organisation und kann Role Bindings auf jeder Ebene halten — entweder auf Org- oder App-Ebene.

Beispiel: Erstelle eine „QA Team“ Group und weise ihr die App-Entwickler Rolle in deiner Production-App, und jedes Mitglied dieser Gruppe erhält sofort Developer-Zugriff auf diese App. Wenn jemand dem Team beitritt oder es verlässt, füge die Person einfach der Gruppe hinzu oder entferne sie — die einzelnen Role Bindings müssen nicht angepasst werden.

  • Eine Gruppe ist org-scoped — sie gehört zu einer Organisation und kann nicht über mehrere Orgs hinweg existieren.
  • Du weist einer Gruppe Rollen genauso zu wie einem User — die Gruppe erscheint als Principal in den Role Bindings.
  • Wenn die Berechtigungen eines Users geprüft werden, werden seine Gruppenmitgliedschaften automatisch aufgelöst. Wenn eine seiner Gruppen eine Rolle besitzt, die die erforderliche Berechtigung gewährt, wird der Zugriff erteilt.
  • Ein User kann mehreren Gruppen angehören, wobei die Berechtigungen aller Gruppen kombiniert werden.
Gruppenliste

Navigiere zu den Gruppen Tabs in deinen Organisationseinstellungen. Die Gruppenliste zeigt den Namen, der Beschreibung, der Rolle, des Erstellungsdatums, und der Aktionen (bearbeiten oder löschen).

Klicke auf das + Hinzufügen Button, um die Seite zur Gruppenerstellung zu öffnen:

Seite zur Gruppenerstellung

Ausfüllen:

  1. Name (Pflichtfeld) und Beschreibung (optional)
  2. Organisationsrolle — optional eine Rolle auf Org-Ebene zuweisen (Keine, Admin, Billing Manager oder Mitglied)
  3. Zugriffskontrolle Tab — App-Rollen per Klick zuweisen, + App hinzufügeneine App auswählen und eine Rolle wählen (z. B. App Uploader, App Developer)

Du brauchst Super-Admin oder Admin um Gruppen zu erstellen.

Gruppenmitglieder verwalten

Abschnitt „Mitglieder verwalten“

Klicke auf eine Gruppe, um die Detailansicht zu öffnen. Wechsle zum Mitglieder Tab:

Gruppendetails — Mitglieder-Tab

Hier siehst du die aktuellen Mitglieder und deren E-Mail-Adressen. Klicke auf + Hinzufügen um Mitglieder hinzuzufügen:

Mitglieder zur Gruppe hinzufügen

Das Modal zeigt alle Organisationsmitglieder. Suche nach Namen, wähle die gewünschten Mitglieder aus und klicke auf Add members.


Nur Super-Admin (org_super_admin) und Abrechnungsmanager (org_billing_admin) kann die Abrechnung verwalten. Pläne sind an eine Organisation gebunden, nicht an dein persönliches Konto.


Kann ich mehr als eine Organisation erstellen?

Abschnitt: „Kann ich mehr als eine Organisation erstellen?“

Ja. Du kannst so viele Organisationen erstellen, wie du benötigst, und über den Organisations-Selector in der Sidebar zwischen ihnen wechseln.

Wie konfiguriere ich Sicherheitsrichtlinien?

Abschnitt: „Wie konfiguriere ich Sicherheitsrichtlinien?“

Super Admins können die 2FA-Erzwingung, Passwortrichtlinien und die API Key-Sicherheit über das Sicherheit Tab. Siehe Organisationssicherheit für Details.

Kann ich jemandem Zugriff nur auf eine App oder einen Channel geben?

Abschnitt: „Kann ich jemandem Zugriff auf nur eine App oder einen Channel geben?“

Ja — weise ihnen eine app-spezifische Rolle zu (wie App-Entwickler oder App-Reader) über die Members-Seite oder den Access-Tab der App. Du kannst den Zugriff pro Channel weiter verfeinern mit Channel-Permission-Overrides. Siehe Access-Control-Referenz für die vollständige Liste der Rollen.

Admin (org_admin) hat die volle Berechtigung über die gesamte Organisation – alle Apps, alle Channels und alle Mitglieder. App-Admin (app_admin) hat die gleiche Kontrolle, aber nur für eine spezifische App und deren Channels. Nutze App Admin, um die volle Kontrolle über eine App zu delegieren, ohne Zugriff auf den Rest der Organisation zu gewähren.

Wenn du es nutzt Organisation 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.