Tenantübergreifender Zugriff für Geschwister-Tenants
Ein Administrator eines Ziel-Tenants T kann einem Benutzer eines anderen Quell-Tenants S Zugriff auf T mit
ausgewählten Gruppen von T geben — auch wenn S kein übergeordneter Tenant (Vorfahre) von T ist, zum Beispiel einer
meshmakers-Mitarbeiterin, die den Kunden-Tenant customer-a betreut, einen Geschwister-Tenant unter demselben
übergeordneten Tenant. Der Administrator von T sieht das Benutzerverzeichnis von S nie:
- der Benutzer wird über den exakten Benutzernamen oder die exakte E-Mail-Adresse gefunden — es gibt keine Liste, keine Präfix- oder Platzhaltersuche;
- das funktioniert nur, wenn S T erlaubt — S führt eine Freigabeliste von Ziel-Tenants, standardmäßig leer;
- jede Suche, jede Freigabe, die erste Nutzung und das Entfernen werden in das Ereignisprotokoll beider Tenants geschrieben.
Vorfahren- und Geschwister-Quellen
| Quell-Tenant ist Vorfahre von T | Quell-Tenant ist Geschwister (kein Vorfahre) | |
|---|---|---|
| Wer entscheidet | Der übergeordnete Tenant (er hat T angelegt) | S, über seine Freigabeliste |
| Benutzer finden | sourceUsers / Admin-Provisionierung oder die exakte Suche unten | Nur exakte Suche |
| Anmeldung an T | Die Anmeldeseite von T bietet „Login via S“; Tenant-Wechsel | Nur Tenant-Wechsel / Token-Austausch aus einer S-Sitzung (in T wird kein Login-Provider angelegt) |
| Freigabe | CreateExternalTenantUserMapping, Admin-Provisionierung | CreateExternalTenantUserMapping |
| Entzug | Mapping löschen | Mapping löschen, oder S entfernt T aus seiner Freigabeliste |
Die Vorfahren werden aus dem Tenant-Register bestimmt. Die Abläufe für Vorfahren beschreibt Tenantübergreifende Authentifizierung.
Ablauf mit octo-cli
Das Beispiel verwendet den Quell-Tenant meshmakers, den Ziel-Tenant customer-a und die Benutzerin alice.
1. S erlaubt T (Administrator von S)
Nur Administratoren von S — Rollen UserManagement und TenantManagement, mit einem für S ausgestellten Token (an S
anmelden oder zuerst nach S wechseln) — lesen und ändern die Liste. Ein Administrator eines anderen Tenants, auch ein
Administrator des übergeordneten Tenants mit dessen Token, erhält 403.
octo-cli -c UseContext -n meshmakers
octo-cli -c GetCrossTenantGrantPermissions
octo-cli -c SetCrossTenantGrantPermissions -ttids "customer-a"
SetCrossTenantGrantPermissions ersetzt die ganze Liste und protokolliert, welche Tenants hinzugefügt und entfernt
wurden. Einträge werden getrimmt, kleingeschrieben und dedupliziert; höchstens 200 Einträge mit bis zu 64 ASCII-Buchstaben,
Ziffern, - oder _; nie S selbst. Eine ungültige Liste ergibt 400, und nichts ändert sich. Ob ein Eintrag existiert,
wird nicht geprüft. --none erlaubt niemandem etwas.
2. Benutzer finden (Administrator von T)
octo-cli -c UseContext -n customer-a
octo-cli -c LookupSourceTenantUser -st "meshmakers" -id "alice@meshmakers.io"
Die Antwort enthält SourceTenantId, UserId, UserName und DisplayName — nie die E-Mail-Adresse. Der eingegebene
Suchbegriff wird in kein Protokoll geschrieben. Jeder negative Fall ergibt dieselbe Antwort und den Exit-Code -3:
No user found that can be granted access (code SourceUserNotFound).
Das gilt für: S existiert nicht, S erlaubt T nicht, kein exakter Treffer, mehr als ein Treffer, ein tenantübergreifender
Schattenbenutzer, ein gesperrter oder blockierter Benutzer. Suchen sind pro Aufrufer und Ziel-Tenant begrenzt (Standard 20
pro 10 Minuten); über der Grenze nennt das Kommando die Wartezeit, z. B.
Too many lookups: … (HTTP 429, code SourceUserLookupRateLimited). Retry after 240 s.
3. Mit Gruppen freigeben
octo-cli -c CreateExternalTenantUserMapping -stid "meshmakers" -suid "<UserId>" -sun "alice" -g "Operators,Viewers"
-g nimmt Gruppennamen oder Gruppen-IDs von T. Der Benutzer erhält beim ersten Tenant-Wechsel genau die Rollen dieser
Gruppen (plus -rids, falls angegeben). Das Kommando gibt das Mapping so aus, wie es gespeichert wurde: der Benutzername
kommt aus dem Benutzerdatensatz von S, GroupNames nennt die Gruppen. Ablehnungen:
| Antwort | Bedeutung |
|---|---|
403, Code SourceTenantNotPermitted | S ist weder Vorfahre von T noch erlaubt S T, oder S hat diesen Benutzer nicht — eine Antwort für alle diese Fälle |
400, Code UnknownGroup (mit unknownGroupIds) | eine Gruppe ist keine Gruppe von T; nichts wird gespeichert |
409, Code ExternalTenantUserMappingAlreadyExists (mit existingMappingId) | der Benutzer hat in T bereits ein Mapping; ändere dessen Rollen |
403 aus der Rollenprüfung | die Gruppen vergeben Rollen, die der Aufrufer nicht vergeben darf |
4. Der Benutzer wechselt nach T
alice meldet sich an meshmakers an und wechselt nach customer-a (Tenant-Wechsel im Refinery Studio oder
Token-Austausch). Beim ersten Wechsel legt der Identity Service in T den tenantübergreifenden Benutzer
xt_meshmakers_alice mit den Rollen des Mappings an.
5. Auflisten und entfernen
octo-cli -c GetExternalTenantUserMappings -stid "meshmakers"
octo-cli -c DeleteExternalTenantUserMapping -id "<mapping-rtid>"
Die Liste zeigt SourceTenantId, SourceUserName und GroupNames jeder Freigabe.
Entzug
Der nächste Token-Austausch des Benutzers nach T wird abgelehnt, wenn
- das Mapping gelöscht ist,
- S T aus seiner Freigabeliste entfernt, oder
- dem Mapping keine wirksame Rolle mehr bleibt (direkte Rollen und die Rollen aller seiner Gruppen zusammen).
Ein bereits ausgestelltes Access-Token bleibt bis zu seinem Ablauf gültig; ausgetauschte Tokens sind kurzlebig und haben kein Refresh-Token. Suchen und neue Freigaben aus T enden sofort, wenn S T entfernt.
Audit
Beide Administratoren sehen die Ereignisse im eigenen Ereignisprotokoll (Kategorie = Ereignisname):
| Ereignis | Geschrieben in |
|---|---|
Identity.CrossTenantLookup (hit / miss) | T und S; ein Fehltreffer für einen nicht existierenden Tenant nur in T |
Identity.CrossTenantGrantCreated / …GrantChanged / …GrantRemoved | T; S nur, wenn S Vorfahre von T ist oder T erlaubt |
Identity.CrossTenantFirstExchange | T und S |
Identity.CrossTenantExchangeRefused (Geschwister-Quelle) | T und S |
Identity.CrossTenantGrantPermissionsChanged | S |
Der Suchbegriff eines Fehltreffers, E-Mail-Adressen, Tokens und Passwörter werden nie geschrieben. Lesen mit GraphQL auf
dem Tenant, Filter category LIKE "Identity.CrossTenant*".
MCP-Werkzeuge
KI-Assistenten nutzen dieselben Regeln über den OctoMesh-MCP-Server:
| Werkzeug | Risiko | Zweck |
|---|---|---|
lookup_source_tenant_user | Medium | Exakte Suche; errorCode: SourceUserNotFound für jeden Fehltreffer, SourceUserLookupRateLimited mit retryAfterSeconds |
create_external_tenant_user_mapping | High | Freigabe mit groupIds; gibt das gespeicherte Mapping zurück; Ablehnungen tragen errorCode |
delete_external_tenant_user_mapping | High | Freigabe entfernen (confirm=true) |
get_cross_tenant_grant_permissions | Low | Freigabeliste von S |
set_cross_tenant_grant_permissions | High | Freigabeliste von S ersetzen (confirm=true; [] erlaubt niemandem etwas) |
Werkzeuge mit hohem Risiko warten im KI-Assistenten auf die Bestätigung des Benutzers.
REST-API
Alle Routen sind tenantbezogen (/{tenant}/identity/api/v1/…); das SDK (IIdentityServicesClient) kapselt sie.
| Route | Im Tenant | SDK |
|---|---|---|
POST ExternalTenantUserMappings/sourceUserLookup — Body { "sourceTenantId", "identifier" } | T | LookupSourceUser (gibt null für SourceUserNotFound zurück) |
POST ExternalTenantUserMappings — Body mit optionalem groupIds | T | GrantExternalTenantUser (gibt das gespeicherte Mapping zurück) |
GET / DELETE ExternalTenantUserMappings[/{rtId}] | T | GetExternalTenantUserMappings, DeleteExternalTenantUserMapping |
GET / PUT CrossTenantGrantPermissions — Body { "targetTenantIds": [] } | S | GetCrossTenantGrantPermissions, UpdateCrossTenantGrantPermissions |
Fehler sind RFC-9457-Problem-Dokumente; Clients verzweigen anhand der Erweiterung code (ServiceProblem.TryParse im
SDK). Die Suche ist ein POST, damit der Suchbegriff nie in Zugriffsprotokollen erscheint.