Organisation

Kopiere einen Setup-Prompt mit den Installationsschritten und dem vollständigen Markdown-Guide für dieses Plugin.

Was ist eine Organisation?

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

Der Zugriff wird verwaltet über rollenbasierte Zugriffskontrolle (RBAC). 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.

Übersicht der Organisationseinstellungen

Die Einstellungen für die Organisation erreichst du, indem du auf Einstellungen in der linken Seitenleiste klickst und dann den Organisation Tab oben auswählst. Von dort aus kannst du zwischen folgenden Bereichen navigieren:

Tab	Beschreibung
Allgemein	Organisationsname, Logo und Management-E-Mail anzeigen und bearbeiten
Mitglieder	Teammitglieder und deren Berechtigungen verwalten
Gruppen	Benutzergruppen für die Massenvergabe von Rollen erstellen und verwalten
API Keys	API Keys für den programmatischen Zugriff verwalten
Tarife	Deinen Abonnement-Plan einsehen und verwalten
Credits	Zusätzliche Credits einsehen und kaufen
Sicherheit	Sicherheitsrichtlinien konfigurieren (2FA, Passwortvorgaben)
Nutzung	Nutzungsstatistiken deiner Organisation überwachen
Audit-Logs	Aktivitätsprotokolle deiner Organisation einsehen
Webhooks	Webhook-Integrationen konfigurieren
Abrechnung	Rechnungsdaten und Rechnungen verwalten

So wechselst du die Organisation

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

Mitglieder verwalten

Mitglieder anzeigen

Der Bereich Mitglieder zeigt alle Nutzer an, die Zugriff auf deine Organisation haben, 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.

Ein Mitglied einladen

Klicke auf den + Hinzufügen -Button im Bereich Mitglieder
Ein Rolle auswählen Ein Modal erscheint – wähle die Rolle auf Organisationsebene für das neue Mitglied:

The available org-level roles are:

Member — Nur Lesezugriff
Abrechnungsmanager — Nur Zugriff auf Abrechnung
Admin — Volle Administration (keine Abrechnung, kein Löschen)
Super-Admin — Volle Kontrolle

Klicke auf 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.

App-Rollen zuweisen

Zusätzlich zur Rolle auf Organisationsebene kannst du Mitgliedern Zugriff auf spezifische Apps mit einer gezielteren Rolle geben. Klicke auf den Zugriffskontrolle Button (Schild-Icon) neben einem Mitglied, um das App-Zugriffs-Modal zu öffnen:

In diesem Modal kannst du:

Eine App suchen und auswählen
Wähle eine App-Rolle aus dem Dropdown

Folgende App-Rollen sind verfügbar:

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

Klicke auf Zuweisen um die Rolle zu gewähren.

Mitgliederrolle bearbeiten

Klicke auf das Bearbeiten-Symbol (Schraubenschlüssel) neben einem Mitglied, um dessen Rolle auf Organisationsebene zu ändern. Das gleiche Wähle eine Rolle Modal öffnet sich, wobei die aktuelle Rolle bereits 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 herabstufen, musst du selbst ein Super Admin sein

Ein Mitglied entfernen

Klicke auf das Löschen-Symbol (Mülleimer) 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. Dadurch wird der Zugriff auf die Organisation, deren Apps und Channels sofort entzogen.

Rollen-Übersicht

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

Organisationsrollen

Wird beim Einladen eines Mitglieds zugewiesen. Sie gelten für die gesamte Organisation.

Rolle	Interner Name	Beschreibung
Super-Admin	`org_super_admin`	Volle Kontrolle — Abrechnung, Löschen, Übertragung. Wird dem Org-Ersteller automatisch zugewiesen.
Admin	`org_admin`	Volle Administration — Mitglieder, Apps und Channels verwalten. Keine Abrechnung, kein Löschen.
Abrechnungsmanager	`org_billing_admin`	Nur Abrechnung — Zahlungen, Rechnungen und Billing-Audits einsehen/aktualisieren. Kein Zugriff auf Apps oder Mitglieder.
Mitglied	`org_member`	Read-only Zugriff auf die gesamte Organisation und alle zugehörigen Apps.

App-Rollen

Beschränkt auf eine einzelne App. Nutzen Sie diese, wenn ein Teammitglied nur an einer App statt an der gesamten Organisation arbeiten soll.

Rolle	Interner Name	Beschreibung
App-Admin	`app_admin`	Volle Kontrolle über eine App — Channels, Geräte, Team. Die App kann nicht gelöscht oder übertragen werden.
App-Entwickler	`app_developer`	Bundles hochladen, Geräte verwalten, Builds triggern, Channels aktualisieren. Keine Löschungen oder Einstellungsänderungen.
App-Uploader	`app_uploader`	Lesezugriff + neue Bundle-Versionen hochladen.
App-Reader	`app_reader`	Nur Lesezugriff — Stats, Bundles, Channels, Logs, Geräte.

Channel-Berechtigungs-Overrides

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 App-Level Access Management unten, um dies zu konfigurieren.

Zugriffsmanagement auf App-Ebene

Jede App hat einen eigenen Access Tab, in dem du verwalten kannst, wer Zugriff auf die App hat und was die Personen tun dürfen – inklusive App-Rollen und kanalbezogener Permission-Overrides.

App-Zugriff einsehen

Navigiere zu deiner App und klicke auf Zugriff Tab. Die Liste zeigt alle Nutzer oder Gruppen 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 — Zeitpunkt der Rollenzuweisung
Aktionen — Channel-Berechtigungen (Schild-Icon), Rolle bearbeiten (Schraubenschlüssel-Icon) und entfernen (Papierkorb-Icon)

App-Rolle ändern

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

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 Operationen
App-Uploader — App-Daten lesen und Bundles hochladen
App-Reader — Nur Lesezugriff

Channel-Berechtigungen überschreiben

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

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

Berechtigung	Beschreibung
Read	Den Channel und das aktuelle Bundle ansehen
History	Die Historie der Bundle-Zuweisungen ansehen
Bundle verknüpfen	Das aktive Bundle für den 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 festlegen, was dir feingranulare Kontrolle gibt, ohne die allgemeine App-Rolle des Nutzers zu ändern.

Gruppen

Mit Groups kannst du Rollen einem ganzen Nutzerkreis gleichzeitig zuweisen, statt 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.

So funktionieren Gruppen

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.

Gruppen anzeigen

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).

Gruppe erstellen

Klicke auf die + Hinzufügen Schaltfläche zum Öffnen der Gruppenerstellung:

Ausfüllen:

Name (Pflichtfeld) und Beschreibung (optional)
Organisationsrolle — optional eine Rolle auf Organisationsebene zuweisen (Keine, Admin, Billing Manager oder Member)
Zugriffskontrolle Tab — App-Rollen zuweisen durch Klicken + App hinzufügen, Auswahl einer App und einer Rolle (z. B. App Uploader, App Developer)

Du benötigst Super-Admin oder Admin-Rechte , um Gruppen zu erstellen.

Gruppenmitglieder verwalten

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

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

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

Abrechnung

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

FAQ

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?

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

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 über Channel-Berechtigungsüberschreibungen. See Referenz zur Zugriffskontrolle für die vollständige Rollenliste.

Was ist der Unterschied zwischen Admin und App Admin?

Admin (org_admin) hat die volle Kontrolle ü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 Orga zu gewähren.

Weiter mit Organisation

Wenn Sie ... verwenden Organisation Um Dashboard- und API-Operationen zu planen, verbinde es mit API Übersicht für Details zur Implementierung in der Übersicht zu API, Einführung für das Implementierungsdetail in der Einleitung, API Keys für die Implementierungsdetails in API Keys, Geräte für die Implementierungsdetails in Devices und Bundles für die Implementierungsdetails in Bundles.