Zum Hauptinhalt springen

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 TQuell-Tenant ist Geschwister (kein Vorfahre)
Wer entscheidetDer übergeordnete Tenant (er hat T angelegt)S, über seine Freigabeliste
Benutzer findensourceUsers / Admin-Provisionierung oder die exakte Suche untenNur exakte Suche
Anmeldung an TDie Anmeldeseite von T bietet „Login via S“; Tenant-WechselNur Tenant-Wechsel / Token-Austausch aus einer S-Sitzung (in T wird kein Login-Provider angelegt)
FreigabeCreateExternalTenantUserMapping, Admin-ProvisionierungCreateExternalTenantUserMapping
EntzugMapping löschenMapping 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:

AntwortBedeutung
403, Code SourceTenantNotPermittedS 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üfungdie 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):

EreignisGeschrieben in
Identity.CrossTenantLookup (hit / miss)T und S; ein Fehltreffer für einen nicht existierenden Tenant nur in T
Identity.CrossTenantGrantCreated / …GrantChanged / …GrantRemovedT; S nur, wenn S Vorfahre von T ist oder T erlaubt
Identity.CrossTenantFirstExchangeT und S
Identity.CrossTenantExchangeRefused (Geschwister-Quelle)T und S
Identity.CrossTenantGrantPermissionsChangedS

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:

WerkzeugRisikoZweck
lookup_source_tenant_userMediumExakte Suche; errorCode: SourceUserNotFound für jeden Fehltreffer, SourceUserLookupRateLimited mit retryAfterSeconds
create_external_tenant_user_mappingHighFreigabe mit groupIds; gibt das gespeicherte Mapping zurück; Ablehnungen tragen errorCode
delete_external_tenant_user_mappingHighFreigabe entfernen (confirm=true)
get_cross_tenant_grant_permissionsLowFreigabeliste von S
set_cross_tenant_grant_permissionsHighFreigabeliste 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.

RouteIm TenantSDK
POST ExternalTenantUserMappings/sourceUserLookup — Body { "sourceTenantId", "identifier" }TLookupSourceUser (gibt null für SourceUserNotFound zurück)
POST ExternalTenantUserMappings — Body mit optionalem groupIdsTGrantExternalTenantUser (gibt das gespeicherte Mapping zurück)
GET / DELETE ExternalTenantUserMappings[/{rtId}]TGetExternalTenantUserMappings, DeleteExternalTenantUserMapping
GET / PUT CrossTenantGrantPermissions — Body { "targetTenantIds": [] }SGetCrossTenantGrantPermissions, 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.