Fennibi in Microsoft Entra ID freigeben — eine Anleitung für Administratoren
Welcher Verbindungsmodus zu Ihrer Organisation passt, welche Berechtigungen Fennibi anfordert und wie Sie als Administrator genau den Zugriff einrichten, den Fennibi braucht — und keinen darüber hinaus.
published on 2026-11-03, updated on 2026-11-12
Fennibi liest Ihre Power BI Semantic Models, um sie zu dokumentieren und Fragen aus ihren Daten zu beantworten. Ihre Nutzer verbinden Fennibi auf fennibi.com unter Konto → Konfiguration → Fabric-Verbindung. Je nach gewähltem Modus arbeitet Fennibi unter der Identität eines angemeldeten Nutzers, unter einem eigenen Service Principal Ihrer Organisation oder unter zwei Identitäten: der Service Principal oder eine gespeicherte Microsoft-Verbindung für die Dokumentation, die gerade angemeldete Person für den Live-Chat.
Diese Anleitung hilft Ihnen, den Modus zu wählen, und führt Sie anschließend durch seine Einrichtung. Keine andere Anwendung und keine andere Berechtigung in Ihrem Tenant ist davon betroffen.
| Feld | Wert |
|---|---|
| Anwendungs-ID (Client) von SemaDoc | 5f3da981-a67d-4650-a539-4d5b0d8b5f76 |
| Erforderliche Entra-Rolle | Cloudanwendungsadministrator, Anwendungsadministrator oder Globaler Administrator |
| Erforderliche Power-BI-Rolle | Fabric-Administrator (nur für die Mandanteneinstellungen in Abschnitt 6) |
1. Auf einen Blick: was Sie entscheiden und einrichten
- Wählen Sie den Verbindungsmodus (Abschnitt 2). Er entscheidet, unter welcher Identität Fennibi arbeitet, ob Row-Level Security greift und wer eine Power-BI-Lizenz braucht.
- Richten Sie diesen Modus ein: delegiert, allein oder kombiniert mit einer persönlichen Anmeldung (Abschnitt 3), delegiert nur während der Anmeldung (Abschnitt 4) oder ein Service Principal, allein oder kombiniert mit einer persönlichen Anmeldung (Abschnitt 5).
- Prüfen Sie die Power-BI-Mandanteneinstellungen (Abschnitt 6).
- Geben Sie jeder Identität die Rollen, die sie braucht: den verbindenden Nutzern oder dem Service Principal in den gewählten Arbeitsbereichen (Abschnitt 7).
- Wenn Sie Standardberichte nutzen, legen Sie fest, welche Modelle sie abdecken dürfen. Standardberichte brauchen einen Service Principal oder eine gespeicherte Microsoft-Verbindung, und jeder Leser des Kontos sieht dasselbe Ergebnis (Abschnitt 2).
- Optional: Begrenzen Sie, wie lange eine Verbindung gültig bleibt, und prüfen Sie die Zugriffe von Fennibi in Ihren Protokollen (Abschnitt 8).
2. Wählen Sie Ihren Verbindungsmodus
| Merkmal | Delegiert – Microsoft-Anmeldung je Nutzer | Delegiert, nur während der Anmeldung | Delegiert plus persönliche Anmeldung | Service-Principal (Superuser) | Service Principal plus persönliche Anmeldung |
|---|---|---|---|---|---|
| Dokumentation läuft unter | dem verbindenden Nutzer | der gerade angemeldeten Person | dem verbindenden Nutzer | Ihrer App-Registrierung | Ihrer App-Registrierung |
| Live-Chat läuft unter | dem verbindenden Nutzer | der gerade angemeldeten Person | der gerade angemeldeten Person | Ihrer App-Registrierung | der gerade angemeldeten Person |
| Was Fennibi speichert | das Aktualisierungstoken des Nutzers, verschlüsselt | nichts | das Aktualisierungstoken des verbindenden Nutzers, verschlüsselt | Ihren geheimen Clientschlüssel, verschlüsselt | Ihren geheimen Clientschlüssel, verschlüsselt |
| Row-Level Security im Chat | greift | greift | greift | greift nicht | greift |
| Power-BI-Lizenz für Chat-Nutzer | Pro oder PPU je Person¹ | Pro oder PPU je Person¹ | Pro oder PPU je Person¹ | keine | Pro oder PPU je Person¹ |
| Auf gewählte Arbeitsbereiche begrenzt | nein, alles, was der Nutzer sieht | nein, alles, was die Person sieht | nein, alles, was der Nutzer oder die Person sieht | ja | Dokumentation: ja; Chat: alles, was die Person sieht |
| Geplante Aktualisierung der Dokumentation², Läufe über die API | ja | nein | ja | ja | ja |
| Standardberichte | ja, unter dem verbindenden Nutzer | nein | ja, unter dem verbindenden Nutzer | ja | ja, unter Ihrer App-Registrierung |
| Ihre Einrichtung | Freigabe (Abschnitt 3) | Freigabe (Abschnitt 4) | Freigabe (Abschnitt 3.5) | App-Registrierung (Abschnitt 5) | App-Registrierung und Freigabe (Abschnitt 5) |
¹ Nicht nötig, wenn der Arbeitsbereich des Modells auf einer Fabric-Kapazität F64 (oder größer) oder einer Power BI Premium-Kapazität liegt. Dort kann ein Nutzer mit kostenloser Lizenz und der Rolle Anzeigender das Modell lesen. Prüfen Sie das anhand Ihrer Lizenzierung, bevor Sie sich darauf verlassen.
² Eine geplante Aktualisierung der Dokumentation ist keine Power-BI-Aktualisierung Ihres Semantic Models. Fennibi aktualisiert nie ein Modell oder seine Daten. Nach einem Zeitplan, den der Nutzer einrichtet, liest es die Struktur des Modells erneut und aktualisiert die Dokumentation, damit Änderungen am Modell (neue Measures, Tabellen oder Beziehungen) dort erscheinen.
Welcher Modus passt
- Um Fennibi auszuprobieren: Delegiert – Microsoft-Anmeldung je Nutzer. Eine Freigabe, in wenigen Minuten erledigt, und Fennibi sieht nur, was die testende Person sieht.
- Wenn Ihre Sicherheitsrichtlinie streng ist: ein Service Principal. Sie wählen die Arbeitsbereiche, Sie besitzen und rotieren das Anmeldegeheimnis, und der Zugriff hängt an keinem einzelnen Mitarbeiter. Soll Fennibi überhaupt kein Token einer Person halten, ist Delegiert, nur während der Anmeldung die Alternative. Für die Dokumentation unter einem Service Principal hängt es am Arbeitsbereich, siehe die nächsten beiden Punkte.
- Im Produktivbetrieb auf einer Fabric- oder Premium-Kapazität gehört die Dokumentation auf
einen Service Principal. Die Kapazität ist dafür Voraussetzung, keine Zusage: Prüfen Sie es mit
einem ersten Dokumentationslauf, bevor Sie sich darauf verlassen. Für den Live-Chat entscheidet
die Row-Level Security:
- Keine RLS auf Ihren Modellen, oder der Chat darf sie übergehen: Service-Principal (Superuser) für alles. Chat-Nutzer brauchen dann keine Power-BI-Lizenz, aber jeder Chat-Nutzer Ihres Fennibi-Kontos sieht, was der Service Principal sieht.
- RLS muss im Chat greifen: Service Principal plus persönliche Anmeldung. Die Dokumentation läuft unter dem Service Principal, und jede Person stellt ihre Fragen unter ihrer eigenen Identität, mit ihren eigenen RLS-Rollen. Eine Frage ohne Anmeldung wird abgelehnt, nie unter dem Service Principal beantwortet.
- Im Produktivbetrieb auf Pro-Arbeitsbereichen gehört die Dokumentation auf eine gespeicherte
Microsoft-Verbindung. Unter einem Service Principal scheitert die Dokumentation dort in unseren
Tests mit dem Fehler
PowerBINotLicensedvon Microsoft. Unter dem verbindenden Nutzer mit Pro-Lizenz läuft sie. Für den Live-Chat entscheidet wieder die Row-Level Security:- Keine RLS auf Ihren Modellen, oder eine Person nutzt das Konto: Delegiert – Microsoft-Anmeldung je Nutzer. Der Chat läuft unter dem verbindenden Nutzer, der als Administrator des Modells alles sieht.
- RLS muss im Chat greifen: Delegiert plus persönliche Anmeldung. Die Dokumentation läuft unter der gespeicherten Verbindung, und jede Person stellt ihre Fragen unter ihrer eigenen Identität, mit ihren eigenen RLS-Rollen. Eine Frage ohne Anmeldung wird abgelehnt, nie unter der gespeicherten Verbindung beantwortet.
Wo der Zugang liegt: drei Wege
Wer den Zugang zu Ihrem Tenant hat, liest Ihre Modelle selbst. Deshalb lohnt die Frage, wo dieser Zugang liegt. Es gibt drei gleichrangige Wege:
- Zugang bei Fennibi. Der geheime Clientschlüssel Ihres Service Principals oder das Aktualisierungstoken des verbindenden Nutzers liegt verschlüsselt bei Fennibi. Zeitpläne, Standardberichte und Läufe über die API laufen jederzeit, ohne dass bei Ihnen etwas laufen muss.
- Zugang bei Ihnen (Zugang bleibt bei Ihnen (Standalone-Bundle)). Fennibi kennt nur Tenant-ID und Client-ID Ihrer App-Registrierung, kein Geheimnis und kein Token. Das Geheimnis liegt beim Token-Boten des lokal installierten Standalone-Bundles in Ihrem Netz. Er reicht Fennibi kurzlebige App-Tokens (etwa 60 bis 90 Minuten gültig): mit jeder Anfrage aus dem Bundle, und für einen fälligen Zeitplanlauf, wenn er ausgehend danach fragt. Die Folge: Ein Zeitplan läuft nur, solange das Bundle läuft. Ist der Bote aus, endet der Lauf nach 30 Minuten ohne Abbuchung mit „Zugang beim Kunden nicht erreichbar". Wie beim Service Principal greift Row-Level Security für die App nicht. Die Einrichtung steht in Abschnitt 5.3.
- Kein dauerhafter Zugang (Delegiert, nur während der Anmeldung). Nichts liegt irgendwo. Fennibi arbeitet nur, solange eine Person im Browser angemeldet ist, und Zeitpläne pausieren. Das passt zum Ausprobieren ohne Installation.
Standardberichte
Standardberichte laufen zentral, nach Zeitplan oder von Hand, und jeder Leser des Kontos sieht dasselbe eingefrorene Ergebnis. Sie laufen deshalb immer unter einer festen Identität, auch wenn eine Person sie startet: unter dem Service Principal oder in den Modi Delegiert – Microsoft-Anmeldung je Nutzer und Delegiert plus persönliche Anmeldung unter dem gespeicherten Microsoft-Konto. Im Modus Delegiert, nur während der Anmeldung gibt es keine feste Identität. Dort lehnt Fennibi sie ab und nennt den Grund.
Für den Service Principal greift Row-Level Security nicht. Nehmen Sie in Standardberichte dann nur Modelle und Measures auf, deren Inhalt jeder Nutzer Ihres Fennibi-Kontos sehen darf.
Unter einem gespeicherten Microsoft-Konto entscheidet seine Rolle im Arbeitsbereich:
- Administrator, Mitglied oder Mitwirkender: RLS und OLS gelten für dieses Konto nicht. Alle Leser sehen ungefilterte Daten, auch aus RLS-geschützten Bereichen.
- Betrachter: RLS und OLS gelten. Der Bericht zeigt nur den Ausschnitt dieses Kontos und wirkt trotzdem wie das Gesamtbild.
Fennibi unterscheidet hier nicht nach Modellen mit oder ohne RLS. Das Konto zu wählen liegt in Ihrer Verantwortung. Welches Konto verbunden ist, steht auf der Seite Fabric-Verbindung. Verbindet sich ein anderes Konto, bleiben freigegebene Berichte freigegeben, und ihre Zahlen können sich ändern. Läuft das Token des Kontos ab, stoppen die Läufe, bis jemand die Verbindung neu herstellt. Alles, was unter der Person laufen soll, die fragt, gehört in einen eigenen Bericht im Live-Chat.
3. Die delegierte Verbindung einrichten
Dieser Abschnitt gilt für Delegiert – Microsoft-Anmeldung je Nutzer, für Delegiert plus persönliche Anmeldung (Abschnitt 3.5), für Delegiert, nur während der Anmeldung (Abschnitt 4) und für die persönliche Anmeldung von Service Principal plus persönliche Anmeldung (Abschnitt 5). Alle nutzen die Entra-Anwendung von SemaDoc, eine Freigabe deckt also alle ab.
Erlaubt Ihr Tenant Nutzern nicht, Anwendungen selbst zuzustimmen, bricht die Anmeldung mit „Administratorgenehmigung erforderlich" ab. Die folgenden Schritte geben nur die Anwendung SemaDoc frei und begrenzen, wer sie nutzen darf.
3.1 Was Sie freigeben
Die Anwendung von SemaDoc fordert ausschließlich delegierte Berechtigungen an. Mit ihnen handelt sie immer als der angemeldete Nutzer, nie unter einer eigenen Identität, und sieht nur die Arbeitsbereiche und Semantic Models, die dieser Nutzer ohnehin sehen kann. Row-Level Security greift.
| API | Berechtigung | Typ | Wofür Fennibi sie braucht |
|---|---|---|---|
| Power BI Service | Workspace.Read.All |
Delegiert | Die Arbeitsbereiche auflisten, auf die der Nutzer Zugriff hat |
| Power BI Service | Dataset.Read.All |
Delegiert | Semantic Models auflisten, rein lesende DAX-Abfragen gegen sie ausführen und ihre Aktualisierungshistorie lesen |
| Power BI Service | Report.Read.All |
Delegiert | Optional, nur angefordert, wenn das Konto unter Profil → Einstellungen „Berichtsabhängigkeiten ermitteln" freigibt: die Berichte auflisten, die auf ein Semantic Model zeigen (Name, Arbeitsbereich und Art, keine Inhalte). Ohne die Freigabe fordert Fennibi das Recht nicht an |
| Microsoft Graph | openid, profile |
Delegiert | Den Nutzer anmelden und den Kontonamen anzeigen |
| Microsoft Graph | offline_access |
Delegiert | Das Token des Nutzers erneuern, ohne dass er sich jedes Mal neu anmeldet. In den Modi Delegiert – Microsoft-Anmeldung je Nutzer und Delegiert plus persönliche Anmeldung bewahrt Fennibi es für den verbindenden Nutzer, für geplante Aktualisierungen der Dokumentation und für Standardberichte auf (Abschnitt 8); bei einer persönlichen Anmeldung und in den anderen Modi bleibt es im Browser-Tab des Nutzers, und Fennibi speichert nichts (Abschnitt 4) |
Die Anwendung erhält keine Schreibberechtigung, keine Administratorberechtigung und keine Anwendungsberechtigung. Microsoft setzt diese Grenzen bei jedem Token durch: Fennibi kann ein Semantic Model weder ändern noch löschen noch aktualisieren, erreicht keinen Arbeitsbereich, den der angemeldete Nutzer nicht erreicht, und hat keinen Zugriff auf E-Mails, Dateien oder andere Microsoft 365-Daten. Jeder Aufruf von Fennibi ist entweder eine Liste von Arbeitsbereichen, Semantic Models, Berichten oder Aktualisierungen oder eine rein lesende DAX-Abfrage.
3.2 Fennibi vorab freigeben (empfohlen)
Sie können Fennibi freigeben, bevor jemand in Ihrer Organisation versucht, sich zu verbinden. Öffnen Sie diesen Link und melden Sie sich als Administrator an. Er braucht keine Mandanten-ID, weil Microsoft den Tenant aus Ihrer Anmeldung übernimmt:
- Microsoft zeigt die Berechtigungsliste aus Abschnitt 3.1. Prüfen Sie sie und klicken Sie auf Akzeptieren.
- Anschließend leitet Microsoft Sie auf eine Bestätigungsseite auf fennibi.com weiter. Sie zeigt, ob die Zustimmung eingetragen wurde, und andernfalls die Fehlermeldung von Microsoft.
Ihr Tenant hat jetzt eine Unternehmensanwendung für genau diese Client-ID, mit genau den Berechtigungen aus Abschnitt 3.1. Ihre Richtlinie für die Benutzerzustimmung bleibt unverändert, Nutzer können also weiterhin keiner anderen Anwendung zustimmen.
Prüfen: Öffnen Sie https://portal.azure.com/ → suchen Sie nach Microsoft Entra ID →
Verwalten → Unternehmensanwendungen → Alle Anwendungen → suchen Sie nach
5f3da981-a67d-4650-a539-4d5b0d8b5f76 → Sicherheit → Berechtigungen. Der Reiter
Administratorzustimmung listet die Berechtigungen aus Abschnitt 3.1.
Warum es im Portal keine Schaltfläche „App hinzufügen" gibt: Das Azure-Portal zeigt nur Anwendungen, die in Ihrem Tenant bereits existieren. Eine Drittanbieteranwendung erscheint dort in dem Moment, in dem ihr zum ersten Mal zugestimmt wird. Die allererste Freigabe läuft deshalb über den Link oben oder über eine Anforderung eines Nutzers (Abschnitt 3.3). Alles Weitere erledigen Sie im Portal.
3.3 Alternative: Nutzer die Freigabe anfordern lassen
Wenn Sie lieber bei Bedarf freigeben, können Nutzer Ihnen beim Verbinden eine Anforderung senden:
- https://portal.azure.com/ → Microsoft Entra ID → Unternehmensanwendungen →
Sicherheit → Zustimmung und Berechtigungen → Einstellungen für die
Administratorzustimmung:
- Benutzer können Administratorzustimmung für Apps anfordern, für die sie keine Zustimmung erteilen können → Ja
- Wer kann Anforderungen zur Administratorzustimmung überprüfen? → fügen Sie sich selbst oder Ihre Administratorgruppe hinzu
- Speichern
- Der Nutzer klickt auf fennibi.com auf Mit Microsoft verbinden, sieht „Genehmigung erforderlich", gibt eine kurze Begründung ein und klickt auf Genehmigung anfordern.
- Sie erhalten eine E-Mail, oder Sie öffnen Unternehmensanwendungen → Aktivität → Administratorzustimmungsanforderungen. Öffnen Sie die Anforderung für SemaDoc, klicken Sie auf Berechtigungen überprüfen und zustimmen, vergleichen Sie die Liste mit Abschnitt 3.1 und klicken Sie auf Akzeptieren.
Das Ergebnis ist dasselbe wie in Abschnitt 3.2.
3.4 Begrenzen, wer Fennibi nutzen darf (empfohlen)
Nach der Freigabe könnte sich jeder Nutzer Ihres Tenants bei Fennibi anmelden. Um nur bestimmte Personen zuzulassen:
- https://portal.azure.com/ → Microsoft Entra ID → Unternehmensanwendungen → Alle Anwendungen → öffnen Sie die Anwendung SemaDoc (suchen Sie nach der Client-ID).
- Verwalten → Eigenschaften → Zuweisung erforderlich? = Ja → Speichern.
- Verwalten → Benutzer und Gruppen → Benutzer/Gruppe hinzufügen → weisen Sie die Nutzer
oder, besser, eine Sicherheitsgruppe zu (z. B.
Fennibi Users).
Microsoft weist nicht zugewiesene Nutzer jetzt schon bei der Anmeldung ab (Fehler AADSTS50105),
bevor Fennibi überhaupt erreicht wird. Um jemandem den Zugriff zu entziehen, entfernen Sie ihn
aus der Zuweisung oder der Gruppe.
Optional — bedingter Zugriff: Microsoft Entra ID → Sicherheit → Bedingter Zugriff → neue Richtlinie, deren Zielressourcen nur die Anwendung SemaDoc umfassen, etwa um MFA oder ein konformes Gerät zu verlangen oder um zu begrenzen, wie lange eine Verbindung gültig bleibt (Abschnitt 8).
3.5 Delegiert plus persönliche Anmeldung
Nutzen Sie diesen Modus auf Pro-Arbeitsbereichen, wenn im Chat Row-Level Security greifen muss. Die Dokumentation läuft unter einer gespeicherten Microsoft-Verbindung, wie bei Delegiert – Microsoft-Anmeldung je Nutzer, und jede Person stellt ihre Fragen unter ihrer eigenen Identität:
- Geben Sie die Anwendung SemaDoc wie in Abschnitt 3.2 oder 3.3 frei und begrenzen Sie sie auf den verbindenden Nutzer und die Chat-Nutzer (Abschnitt 3.4). Eine Freigabe deckt beide Anmeldungen ab.
- Die Person, unter deren Rechten die Dokumentation laufen soll, wählt auf der Seite Fabric-Verbindung den Modus Delegiert plus persönliche Anmeldung und klickt auf Mit Microsoft verbinden. Der Modus wird erst aktiv, wenn diese Anmeldung gelingt. Fennibi übernimmt Ihren Tenant aus ihr, niemand trägt also eine Mandanten-ID ein. Diese Person braucht für die Dokumentation Administratorrechte auf dem Semantic Model (Abschnitt 7), für sie greift RLS deshalb nicht. Ein Konto, das schon im Modus Delegiert – Microsoft-Anmeldung je Nutzer verbunden ist, wechselt per Speichern: Die gespeicherte Verbindung, die Modellverknüpfungen und die Zeitpläne bleiben.
- Chat-Nutzer klicken oben rechts auf Mit Microsoft anmelden, bevor sie eine Frage stellen. Die Anmeldung funktioniert wie in Abschnitt 4, gegen den Tenant der gespeicherten Verbindung: Das Token bleibt in ihrem Browser-Tab, und Fennibi speichert für sie nichts.
Was unter welcher Identität läuft:
| Unter der gespeicherten Verbindung | Unter der angemeldeten Person |
|---|---|
| Dokumentationsläufe (von Hand, nach Zeitplan, über die API) mit Beispielwerten, die Suche nach Modellen, der Verbindungstest, Standardberichte, die Modellpflege auf den Kontoseiten (Spaltenwerte anzeigen, ein Planraster messen, Beziehungsdetails, eine langsame Abfrage erneut ausführen) | Live-Fragen, die eigenen Berichte der Person, Messläufe |
Es gibt in keiner Richtung einen Rückfall. Eine Live-Frage ohne Anmeldung wird abgelehnt, nie unter der gespeicherten Verbindung beantwortet, die als Administrator des Modells an der RLS vorbei sähe. Ein Dokumentationslauf nutzt nie das Token einer Person. Jede Person sieht nur ihre eigenen Chats, Berichte und Messläufe.
4. „Delegiert, nur während der Anmeldung" einrichten
Dieser Modus ist für Organisationen, die wollen, dass Fennibi ihren Tenant nur erreicht, während eine Person vor dem Bildschirm sitzt. Geben Sie zuerst die Anwendung SemaDoc wie in Abschnitt 3 frei. Dann:
- Der Nutzer wählt auf der Seite Fabric-Verbindung den Modus Delegiert, nur während der Anmeldung, trägt die Mandanten-ID Ihres Tenants ein (eine GUID, aus Microsoft Entra ID → Übersicht → Mandanten-ID) und klickt daneben auf Mit Microsoft anmelden. Damit ist die Verbindung gespeichert; Fennibi löscht ein Aktualisierungstoken, das es für dieses Konto gehalten hat.
- Jedes weitere Mal, wenn er mit Fennibi arbeitet, klickt er oben rechts auf die Microsoft-Anmeldung. Die Anmeldung läuft in seinem eigenen Browser gegen Ihren Tenant, mit den üblichen Regeln von Microsoft für MFA und bedingten Zugriff.
- Das Zugriffstoken bleibt in diesem Browser-Tab, bis der Tab geschlossen wird oder das Token nach
etwa einer Stunde abläuft. Der Nutzer bleibt also angemeldet, wenn er eine andere Seite öffnet
oder neu lädt. Es liegt im Sitzungsspeicher des Tabs, nie in einem Cookie oder in einem
Speicher, der den Tab überdauert, und die Server von Fennibi speichern nichts. Das
Aktualisierungstoken verlässt nie den Arbeitsspeicher der Seite, für die es ausgestellt wurde.
Ist das aufbewahrte Token abgelaufen, meldet sich der Tab ohne Rückfrage (
prompt=none) über die bestehende Microsoft-Sitzung des Nutzers neu an: eine kurze Weiterleitung zu Microsoft und zurück, etwa einmal pro Stunde. Braucht Microsoft dafür den Nutzer (Sitzung abgelaufen, MFA fällig, mehrere Konten), bleibt der Tab abgemeldet, bis der Nutzer sich wieder anmeldet. Eine Abmeldung von Fennibi oder von Microsoft in der Kopfzeile oder ein Token, das Fennibi ablehnt, entfernt das Token sofort aus dem Tab. - Jede Live-Frage schickt das Token mit der Anfrage mit. Fennibi nutzt es für diese Anfrage und speichert es nirgends.
- Ein Dokumentationslauf, den der Nutzer startet, erhält das Token versiegelt für genau diesen Lauf und löscht es, wenn der Lauf endet, auch wenn er fehlschlägt. Ein Lauf, der länger dauert als das Token gilt (etwa eine Stunde), hält an und bittet den Nutzer, sich erneut anzumelden.
In diesem Modus lesen Dokumentationsläufe keine Beispielwerte aus Ihren Daten, und jede Person in einem Fennibi-Konto sieht nur ihre eigenen Chats und Berichte, weil jede unter ihrer eigenen Identität arbeitet. Zeitpläne ruhen, Läufe über die API und Standardberichte werden abgelehnt, weil für sie niemand angemeldet ist.
In den Entra-Anmeldeprotokollen sehen Sie jede Anmeldung als interaktive Benutzeranmeldung dieses Nutzers.
5. Einen Service Principal einrichten
Mit delegierten Berechtigungen kann Microsoft Fennibi nicht auf bestimmte Arbeitsbereiche begrenzen. Fennibi erreicht alles, was der angemeldete Nutzer erreicht. Mit einem eigenen Service Principal wählen Sie die Arbeitsbereiche selbst.
5.1 Service Principal
Im Azure-Portal: die App-Registrierung und ihren geheimen Clientschlüssel anlegen
- Öffnen Sie https://portal.azure.com/ → suchen Sie nach Microsoft Entra ID → Verwalten → App-Registrierungen → Neue Registrierung.
- Füllen Sie das Formular aus und klicken Sie auf Registrieren:
- Name: ein Name, den Sie später wiedererkennen, z. B.
Fennibi documentation - Unterstützte Kontotypen: Nur Konten in diesem Organisationsverzeichnis (einzelner Mandant)
- Umleitungs-URI: leer lassen. Der Service Principal meldet sich mit seinem geheimen Clientschlüssel an, ohne Browser.
- Name: ein Name, den Sie später wiedererkennen, z. B.
- Kopieren Sie auf der Seite Übersicht der neuen Registrierung die Anwendungs-ID (Client) und die Verzeichnis-ID (Mandant). Beide tragen Sie in Schritt 9 auf fennibi.com ein.
- Verwalten → Zertifikate & Geheimnisse → Reiter Geheime Clientschlüssel → Neuer
geheimer Clientschlüssel. Geben Sie eine Beschreibung ein (z. B.
fennibi.com), wählen Sie ein Ablaufdatum und klicken Sie auf Hinzufügen. - Kopieren Sie sofort den Wert des Schlüssels — nicht die Geheimnis-ID daneben. Das Portal zeigt den Wert nur jetzt und verbirgt ihn, sobald Sie die Seite verlassen. Notieren Sie das Ablaufdatum: Läuft der Schlüssel ab, kann sich Fennibi nicht mehr anmelden, und Dokumentationsläufe stehen still, bis Sie einen neuen eintragen.
- Lassen Sie die API-Berechtigungen unverändert. Ein Service Principal erhält seinen Power-BI-Zugriff aus der Mandanteneinstellung (Abschnitt 6) und seinen Arbeitsbereichsrollen (Schritt 8), nicht aus API-Berechtigungen der App-Registrierung.
Im Azure-Portal: den Service Principal in eine Sicherheitsgruppe aufnehmen
- Microsoft Entra ID → Verwalten → Gruppen → Neue Gruppe:
- Gruppentyp: Sicherheit
- Gruppenname: z. B.
Fennibi service principals - Mitglieder → Keine Mitglieder ausgewählt → suchen Sie nach dem Namen aus Schritt 2 → Auswählen
- Erstellen
In Power BI
- Aktivieren Sie im Power-BI-Verwaltungsportal Dienstprinzipale können Fabric-APIs verwenden für nur diese Gruppe (Abschnitt 6). Eine Änderung an einer Mandanteneinstellung kann bis zu 15 Minuten brauchen, bis sie wirkt. Öffnen Sie dann jeden Arbeitsbereich, den Fennibi dokumentieren soll → Zugriff verwalten → Personen oder Gruppen hinzufügen → suchen Sie nach dem Namen aus Schritt 2 → Rolle Mitwirkender → Hinzufügen. Fügen Sie ihn nur diesen Arbeitsbereichen hinzu. Mitwirkender ist nötig, um die Struktur eines Modells zu lesen (Abschnitt 7).
Auf fennibi.com
- Wählen Sie Konto → Konfiguration → Fabric-Verbindung → Service-Principal (Superuser) und tragen Sie die Mandanten-ID, die Client-ID (beide aus Schritt 3) und den Wert des geheimen Clientschlüssels (Schritt 5) ein. Fennibi speichert den Schlüssel verschlüsselt.
Das Anmeldegeheimnis gehört Ihnen: Sie rotieren den Schlüssel, und Sie entziehen den Zugriff, indem Sie den Schlüssel, die App-Registrierung oder ihre Mitgliedschaft im Arbeitsbereich löschen. Der Service Principal hängt an keinem einzelnen Mitarbeiter und funktioniert deshalb weiter, wenn eine Person das Unternehmen verlässt.
Row-Level Security greift nicht in diesem Modus, weil der Service Principal keine Person ist. Jeder Chat-Nutzer Ihres Fennibi-Kontos sieht die Daten, die der Service Principal sieht, und keiner von ihnen braucht dafür eine Power-BI-Lizenz.
5.2 Service Principal plus persönliche Anmeldung
Nutzen Sie diesen Modus, wenn die Dokumentation unter einem Service Principal laufen soll und der Live-Chat unter der eigenen Identität jeder Person, mit ihren RLS-Rollen:
- Richten Sie den Service Principal wie in Abschnitt 5.1 ein, Schritte 1 bis 8.
- Geben Sie die Anwendung SemaDoc wie in Abschnitt 3 für die Chat-Nutzer frei und begrenzen Sie sie auf diese (Abschnitt 3.4).
- Wählen Sie auf fennibi.com Service Principal plus persönliche Anmeldung und tragen Sie die Mandanten-ID, die Client-ID und den geheimen Clientschlüssel ein. Ein Wechsel von Service-Principal (Superuser) behält den Schlüssel, die Modellverknüpfungen und die Zeitpläne.
- Chat-Nutzer klicken oben rechts auf Mit Microsoft anmelden, bevor sie eine Frage stellen. Die Anmeldung funktioniert wie in Abschnitt 4: Das Token bleibt in ihrem Browser-Tab, und Fennibi speichert nichts.
Was unter welcher Identität läuft:
| Unter dem Service Principal | Unter der angemeldeten Person |
|---|---|
| Dokumentationsläufe (von Hand, nach Zeitplan, über die API), der Verbindungstest, Standardberichte, die Modellpflege auf den Kontoseiten (Spaltenwerte anzeigen, ein Planraster messen, Beziehungsdetails, eine langsame Abfrage erneut ausführen) | Live-Fragen, die eigenen Berichte der Person, Messläufe |
Es gibt in keiner Richtung einen Rückfall. Eine Live-Frage ohne Anmeldung wird abgelehnt, nicht unter dem Service Principal beantwortet, und ein Dokumentationslauf nutzt nie das Token einer Person.
5.3 Zugang bleibt bei Ihnen (Standalone-Bundle)
Nutzen Sie diesen Modus, wenn kein Geheimnis Ihres Tenants bei Fennibi liegen soll und Sie das Standalone-Bundle in Ihrem Netz betreiben:
- Richten Sie die App-Registrierung wie in Abschnitt 5.1 ein, Schritte 1 bis 8. Den geheimen
Clientschlüssel tragen Sie nicht auf fennibi.com ein, sondern nur in die Datei
.env.standaloneIhres Bundles. - Wählen Sie auf fennibi.com Zugang bleibt bei Ihnen (Standalone-Bundle) und tragen Sie Mandanten-ID und Client-ID ein. Ein mitgeschickter Schlüssel wird abgelehnt, und ein Wechsel aus einem Service-Principal-Modus löscht den dort gespeicherten.
- Erstellen Sie unter Profil → API-Key einen Schlüssel im Modus Token-Bote. Er kann nur wartende Zeitplanläufe abfragen und ihnen ein Token geben. Modelle lesen oder chatten kann er nicht.
- Starten Sie den Token-Boten im Bundle. Die Schritte stehen im README des Bundles.
Fennibi prüft jedes Token, bevor es eine Abfrage stellt: Signatur, Tenant, App, Zielgruppe Power BI und dass es ein App-Token ist. Ein Token eines fremden Tenants oder einer fremden App bedient Ihr Konto nie. Ein Token, das der Bote für einen Zeitplanlauf abgibt, liegt bei Fennibi nur, solange dieser Lauf dauert.
6. Power-BI-Mandanteneinstellungen
Öffnen Sie https://app.powerbi.com/ → Zahnradsymbol → Verwaltungsportal → Mandanteneinstellungen. Aktivieren Sie diese Einstellungen, entweder für die gesamte Organisation oder für eine Sicherheitsgruppe, die die Identitäten enthält, unter denen Fennibi arbeitet:
| Abschnitt | Einstellung | Nötig für | Warum |
|---|---|---|---|
| Integrationseinstellungen | REST-API zum Ausführen von Abfragen für Semantikmodelle | alle Modi | Fennibi führt seine rein lesenden DAX-Abfragen über diese REST-API aus |
| Integrationseinstellungen | XMLA-Endpunkte und „In Excel analysieren" mit lokalen Semantikmodellen zulassen | alle Modi | Die DAX-Abfrage-API, die die Struktur des Modells liest, prüft diesen Schalter. Ist er aus, antwortet Microsoft „XMLA endpoint feature is disabled" |
| Entwicklereinstellungen | Dienstprinzipale können Fabric-APIs verwenden | beide Service-Principal-Modi | Erlaubt Ihrer App-Registrierung überhaupt erst, die Power-BI-REST-API aufzurufen |
Die beiden Integrationseinstellungen sind in Power BI standardmäßig aktiviert. Handeln müssen Sie nur, wenn Ihre Organisation sie abgeschaltet hat. Beachten Sie, dass sie für jedes Werkzeug gelten, nicht nur für Fennibi.
Was nicht nötig ist: keine XMLA-Einstellung für Lesen und Schreiben auf einer Kapazität und keine eigene XMLA-Verbindung. Fennibi verbindet sich nicht selbst mit dem XMLA-Endpunkt. Es ruft nur die Power-BI-REST-API auf.
Die Ausnahme betrifft die Kapazität selbst: Die Dokumentation unter einem Service Principal setzt einen Arbeitsbereich auf einer Fabric- oder Premium-Kapazität voraus. Auf Pro-Arbeitsbereichen nehmen Sie dafür den Modus Delegiert – Microsoft-Anmeldung je Nutzer oder Delegiert plus persönliche Anmeldung (Abschnitt 2).
7. Berechtigungen und Lizenzen
Fennibi kann nie mehr als die Identität, unter der es arbeitet. Was diese Identität braucht, hängt von der Funktion ab:
| Funktion | Nötig auf dem Semantic Model | Typische Arbeitsbereichsrolle |
|---|---|---|
| Dokumentation (die Struktur des Modells lesen) | Berechtigung Schreiben. Die INFO-Funktionen von Microsoft, die ein Modell beschreiben, verlangen Administratorrechte auf dem Semantic Model | Mitwirkender, Mitglied oder Administrator |
| Live-Analyse (Fragen, die aus den Daten des Modells beantwortet werden) | Berechtigungen Lesen und Erstellen | Anzeigender mit Erstellen-Berechtigung oder eine höhere Rolle |
Einige optionale Strukturabfragen können zusätzlich die Rolle Administrator im Arbeitsbereich verlangen. Fehlt sie der Identität, überspringt Fennibi diesen Teil, vermerkt das im Laufbericht und macht weiter.
Weitere Voraussetzungen für eine Person, die sich verbindet oder anmeldet:
| Voraussetzung | Hinweis |
|---|---|
| Lizenz Power BI Pro oder Premium-Einzelbenutzer (PPU) | Nicht nötig auf einer Fabric-Kapazität F64 oder größer oder einer Power BI Premium-Kapazität (Abschnitt 2) |
| Modell in einem freigegebenen Arbeitsbereich | „Mein Arbeitsbereich" wird nicht aufgelistet |
| Der Anwendung SemaDoc zugewiesen | nur wenn Sie Abschnitt 3.4 umgesetzt haben |
Einem Service Principal lässt sich keine Power-BI-Lizenz zuweisen, und die Lizenz einer Person gilt nicht für ihn. Die Bedingung hängt deshalb am Arbeitsbereich: Die Dokumentation unter einem Service Principal setzt eine Fabric- oder Premium-Kapazität voraus, auf Pro-Arbeitsbereichen scheitert sie in unseren Tests (Abschnitt 2).
8. Wann Fennibi auf Ihren Tenant zugreift
In den Modi Delegiert – Microsoft-Anmeldung je Nutzer und Delegiert plus persönliche
Anmeldung bedeutet offline_access, dass Fennibi ein
Aktualisierungstoken des verbindenden Nutzers aufbewahrt, verschlüsselt gespeichert und nie in ein
Protokoll geschrieben. Dazu speichert Fennibi ebenso verschlüsselt seinen Anmeldenamen, damit Sie
auf der Seite Fabric-Verbindung sehen, wessen Rechte gelten. Eine Abmeldung von fennibi.com löscht es nicht. Das tut nur das Beenden
der Verbindung (Abschnitt 9). In den Service-Principal-Modi bewahrt Fennibi stattdessen Ihren
geheimen Clientschlüssel auf, ebenso verschlüsselt.
Fennibi greift in diesen Fällen auf Ihren Tenant zu:
| Anlass | Ausgelöst von | Läuft unter | Was Fennibi liest |
|---|---|---|---|
| Ein Dokumentationslauf | dem Nutzer, im Browser oder über seinen API-Key | der Dokumentationsidentität des Modus (Abschnitt 2) | die Struktur des Modells |
| Eine Live-Frage, ein eigener Bericht einer Person, ein Messlauf | der Person, im Browser | der Chat-Identität des Modus (Abschnitt 2) | die Daten, die die Frage braucht |
| Eine geplante Aktualisierung der Dokumentation (keine Power-BI-Aktualisierung, siehe Abschnitt 2) | einem Zeitplan, den der Nutzer für dieses Modell eingerichtet hat | der Dokumentationsidentität | die Struktur des Modells |
| Ein Standardbericht | einem Zeitplan, der API oder einer Person von Hand | immer der festen Identität des Kontos: dem Service Principal oder dem gespeicherten Microsoft-Konto | die Daten, die der Bericht braucht |
Sonst läuft nichts im Hintergrund. Sie müssen uns das nicht glauben:
- Das eigene Zugriffsprotokoll von Fennibi auf der Seite Fabric-Zugriffe (Link Fabric-Zugriffe ansehen auf der Seite Fabric-Verbindung) listet jeden Zugriff auf Ihren Tenant: wann, auf wessen Anstoß, zu welchem Zweck, unter welcher Identität und mit wie vielen Power-BI-Aufrufen. Es enthält keine Abfragen, Werte oder Tokens und reicht 90 Tage zurück, sodass Sie es Zeile für Zeile mit den beiden Microsoft-Protokollen unten abgleichen können.
- Microsoft Entra-Anmeldeprotokolle → Nicht interaktive Benutzeranmeldungen, gefiltert auf
die Anwendung
5f3da981-a67d-4650-a539-4d5b0d8b5f76, listen jedes Mal, wenn Fennibi das Token eines Nutzers erneuert. Anmeldungen Ihres Service Principals erscheinen unter Dienstprinzipalanmeldungen, gefiltert auf seine Client-ID. - Das Power-BI-Aktivitätsprotokoll (Microsoft Purview-Überwachung) listet jede Abfrage, die Fennibi unter diesem Nutzer oder Service Principal ausführt.
- Eine Richtlinie für bedingten Zugriff mit Sitzung → Anmeldehäufigkeit für die Anwendung SemaDoc begrenzt, wie lange eine delegierte Verbindung gültig bleibt. Nach diesem Zeitraum muss sich der Nutzer erneut anmelden, und geplante Aktualisierungen der Dokumentation ruhen, bis er es tut.
Wenn Fennibi überhaupt kein Token einer Person halten soll, wählen Sie Delegiert, nur während der Anmeldung (Abschnitt 4) oder einen der Service-Principal-Modi (Abschnitt 5).
9. Zugriff widerrufen
Jede der folgenden Möglichkeiten wirkt ab der nächsten Anfrage von Fennibi.
Die Anwendung von SemaDoc (delegierte Modi und die persönliche Anmeldung): unter https://portal.azure.com/ → Microsoft Entra ID → Unternehmensanwendungen → SemaDoc:
- Ein Nutzer: Benutzer und Gruppen → die Zuweisung entfernen.
- Alle, vorübergehend: Eigenschaften → Aktiviert für die Anmeldung von Benutzern? = Nein.
- Alle, dauerhaft: Eigenschaften → Löschen. Das entfernt die Zustimmung und macht jedes Aktualisierungstoken ungültig, das Fennibi für Ihren Tenant hält.
Ihr Service Principal: Löschen Sie seinen geheimen Clientschlüssel oder die App-Registrierung, oder entfernen Sie ihn aus einem Arbeitsbereich, um nur diesen Arbeitsbereich zu entziehen.
Auf fennibi.com kann ein Nutzer eine delegierte Verbindung jederzeit unter Konto → Konfiguration → Fabric-Verbindung → Verbindung trennen beenden. Fennibi löscht dann das gespeicherte Aktualisierungstoken und den Anmeldenamen. Ein Wechsel der Verbindung in einen delegierten Modus löscht einen gespeicherten geheimen Clientschlüssel. Das Löschen des Fennibi-Kontos löscht beides. Wo Fennibi ein Token nur im Browser-Tab hält, gibt es nichts zu löschen: Der Zugriff endet, wenn sich der Nutzer abmeldet oder den Tab schließt.
Tags: Power BI, Microsoft Entra ID, Administratorzustimmung, Service Principal, Row-Level Security, Sicherheit, Semantic Model