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.
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
¹ 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
PowerBINotLicensed von 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.
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:
https://login.microsoftonline.com/organizations/adminconsent?client_id=5f3da981-a67d-4650-a539-4d5b0d8b5f76&redirect_uri=https://semadoc.io/en/entra-consent-done
- 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:
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.
- 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:
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.standalone Ihres 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:
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:
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:
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:
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