WikiAPI-Kataloggroups

groups

6 Funktionen in dieser Kategorie.

groups.list GET /api/admin/groups

Alle importierten Gruppen auflisten

Hilfe

Listet alle in die lokale DB importierten LDAP-Gruppen mit Mitglieder- und Datenquellen-Anzahl auf.

Beispiel-Prompts

  • Zeige alle Gruppen
  • Welche Gruppen gibt es?
raw_response: Ja
groups.members GET /api/admin/groups/{group_id}/members

Mitglieder einer Gruppe anzeigen

Hilfe

Listet alle Benutzer auf, die Mitglied einer bestimmten Gruppe sind.

Parameter

Name Typ Required Default Beschreibung
group_id integer Ja Gruppen-ID

Beispiel-Prompts

  • Zeige Mitglieder von Gruppe 3
  • Wer ist in der IT-Gruppe?
raw_response: Ja
groups.delete DELETE /api/admin/groups/{group_id}

Importierte Gruppe loeschen

Hilfe

Loescht eine importierte Gruppe und alle Zuordnungen (Cascade). Betroffene Datenquellen-Berechtigungen werden entfernt.

Parameter

Name Typ Required Default Beschreibung
group_id integer Ja Gruppen-ID

Beispiel-Prompts

  • Loesche Gruppe 5
  • Entferne die HR-Gruppe

Confirmation

Diese Funktion erfordert eine Bestaetigung. Template: gruppe {group_id} loeschen

Changelog

Area: groups | Action: delete

raw_response: Ja | PK-Param: group_id
groups.import_ldap POST /api/admin/groups/import

Gruppen aus LDAP importieren

Hilfe

Importiert LDAP-Gruppen in die lokale Datenbank. Bereits vorhandene Gruppen werden aktualisiert (Upsert nach DN). Optional kann ein alternativer base_dn oder spezifische group_dns angegeben werden.

Parameter

Name Typ Required Default Beschreibung
base_dn string Nein Alternativer LDAP Base-DN (optional)
group_dns array Nein Nur diese DNs importieren (optional, leer = alle)

Beispiel-Prompts

  • Importiere Gruppen aus LDAP
  • Importiere nur die Gruppen cn=IT und cn=HR aus dem LDAP

Confirmation

Diese Funktion erfordert eine Bestaetigung. Template: ldap gruppen importieren

Changelog

Area: groups | Action: create

raw_response: Ja
groups.sync_members POST /api/admin/groups/sync-members

LDAP-Gruppenmitgliedschaften synchronisieren

Hilfe

Synchronisiert die Gruppenzugehoerigkeit aller aktiven LDAP-Benutzer mit dem LDAP-Verzeichnis. Betrifft nur Benutzer mit auth_source='ldap'.

Beispiel-Prompts

  • Synchronisiere LDAP-Mitgliedschaften
  • Aktualisiere Gruppenzuordnungen aus dem LDAP

Confirmation

Diese Funktion erfordert eine Bestaetigung. Template: ldap mitgliedschaften synchronisieren

Changelog

Area: groups | Action: update

raw_response: Ja
groups.ldap_preview GET /api/admin/groups/ldap

LDAP-Gruppen vorab anzeigen (ohne Import)

Hilfe

Zeigt alle Gruppen im LDAP-Verzeichnis an, ohne sie zu importieren. Bereits importierte Gruppen werden markiert.

Parameter

Name Typ Required Default Beschreibung
base_dn string Nein Alternativer LDAP Base-DN (optional)

Beispiel-Prompts

  • Welche Gruppen gibt es im LDAP?
  • Zeige LDAP-Gruppen Vorschau
raw_response: Ja