Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Jednostka usługi Microsoft Entra (SPN) to nieinterakcyjna tożsamość oparta na aplikacji, której można przyznać precyzyjnie określone uprawnienia do zasobów platform Azure i Microsoft Fabric. Agenci danych platformy Fabric obsługują teraz uwierzytelnianie przy użyciu jednostki usługi, dzięki czemu można wywoływać opublikowanego agenta danych w ramach automatyzacji, usług działających w tle, aplikacji niestandardowych i potoków CI/CD bez konieczności korzystania z konta zalogowanego użytkownika.
W tym artykule wyjaśniono, jak zarejestrować nazwę główną usługi, nadać jej odpowiednie uprawnienia dostępu w obszarze roboczym Fabric i w bazowych źródłach danych, a następnie użyć jej do uwierzytelniania w usłudze Fabric Data Agent.
Ważna
Ta funkcja jest dostępna w wersji zapoznawczej.
Prerequisites
- Płatna pojemność F2 lub wyższa Fabric albo Power BI Premium dla pojemności (P1 lub wyższa) z włączoną usługą Microsoft Fabric.
- Włącz przetwarzanie między regionami i przechowywanie między regionami dla AI na podstawie wymagań wyjaśnionych w ustawieniach dzierżawy agenta danych Fabric.
- Co najmniej jedno z tych źródeł danych z danymi: magazyn danych, lakehouse, model semantyczny Power BI, baza danych KQL, dublowana baza danych lub ontologia. Musisz mieć uprawnienia do odczytu źródła danych.
- Uprawnienia do rejestrowania aplikacji w dzierżawie usługi Microsoft Entra (takie jak rola Administrator aplikacji w chmurze) lub dostęp do administratora Entra ID, który może podać poświadczenia jednostki usługi (SPN) — identyfikator aplikacji, klucz tajny i identyfikator dzierżawy.
- Dostęp administratora dzierżawy Microsoft Fabric wymagany do włączenia opcji Nazwy główne usługi mogą używać interfejsów API usługi Fabric w portalu administracyjnym usługi Fabric.
- Członkostwo administratora lub członka obszaru roboczego w celu udzielenia nazwy SPN dostępu do obszaru roboczego, który hostuje agenta danych.
Jak działa uwierzytelnianie jednostki usługi z agentem danych Fabric
Gdy podmiot usługi wywołuje agenta danych Fabric, agent danych traktuje SPN jak każdą inną tożsamość Microsoft Entra:
- SPN musi mieć dostęp do obszaru roboczego, w którym opublikowano agenta danych.
- SPN musi mieć uprawnienia do odczytu dla każdego źródła danych podłączonego do agenta danych (magazyn, lakehouse, model semantyczny, baza danych KQL, lustrzana baza danych lub ontologia). Agent danych odczytuje tylko schematy i uruchamia zapytanie w źródłach danych, do których może uzyskać dostęp wywołująca tożsamość.
- SPN uzyskuje token dostępu Microsoft Entra w celu uzyskania dostępu do zasobu Fabric i używa tego tokenu jako tokenu okaziciela podczas zadawania pytań agentowi danych. Ten punkt końcowy służy do wykonywania zapytań dotyczących agenta danych z pytaniami dotyczącymi języka naturalnego, a nie do zarządzania nim ani konfigurowania go.
Krok 1: Utwórz nazwę główną usługi w Microsoft Entra ID
Wykonaj kroki opisane w Utwórz aplikację Microsoft Entra i jednostkę usługi, która może uzyskiwać dostęp do zasobów. Podsumowanie to:
- Zaloguj się do centrum administracyjnego Microsoft Entra z uprawnieniami co najmniej Administratora aplikacji w chmurze.
- Przejdź do pozycjiRejestracje aplikacji>, a następnie wybierz pozycję Nowa rejestracja.
- Nadaj aplikacji nazwę, na przykład fabric-data-agent-spn.
- Pod Obsługiwane typy kont wybierz Konta tylko w tym katalogu organizacyjnym.
- Wybierz opcję Zarejestruj.
- Na stronie Przegląd rejestracji aplikacji skopiuj Identyfikator aplikacji (klienta) i Identyfikator katalogu (dzierżawy). Mogą one być wymagane później.
- Skonfiguruj poświadczenia na potrzeby rejestracji aplikacji. W zależności od zasad zabezpieczeń organizacji można użyć certyfikatu, poświadczeń tożsamości federacyjnej lub klucza tajnego klienta. Aby uzyskać wskazówki, zobacz Dodawanie poświadczeń do aplikacji.
Uwaga / Notatka
Zarządzanie jednostkami usługi należy do obowiązków administracyjnych w usłudze Entra ID. Jeśli nie możesz samodzielnie zarejestrować aplikacji, poproś administratora Entra ID o podanie identyfikatora App ID, klucza tajnego oraz identyfikatora tenant ID.
Krok 2. Włączanie jednostek usługi do używania interfejsów API Fabric
Administrator dzierżawy usługi Fabric musi zezwolić jednostkom usługi na wywoływanie interfejsów API usługi Fabric:
Przejdź do katalogu OneLake>Zarządzanie>Konfiguracje>>Ustawienia dewelopera.
Włącz Jednostki usługi mogą używać interfejsów API Fabric.
Określ zakres ustawienia na Całą organizację lub określoną grupę zabezpieczeń zawierającą jednostkę usługi.
Aby uzyskać więcej informacji, zobacz Jednostki usługi w usłudze Microsoft Fabric.
Krok 3. Udzielanie jednostce usługi dostępu do obszaru roboczego
Obszar roboczy Admin lub Member musi udzielić jednostce usługi dostępu do obszaru roboczego, który hostuje agenta danych Fabric:
Otwórz obszar roboczy w Fabric.
Wybierz pozycję Zarządzaj dostępem.
Wybierz pozycję Dodaj osoby lub grupy, wyszukaj jednostkę usługi według jej nazwy aplikacji i dodaj ją.
Przypisz rolę Członek lub Współautor . Admin jest wymagany tylko wtedy, gdy SPN musi również zarządzać obszarem roboczym.
Krok 4: Przyznaj jednostce usługi dostęp do źródeł danych
Agent danych Fabric wykonuje zapytania na podłączonych źródłach danych przy użyciu tożsamości wywołującego. Upewnij się, że SPN ma co najmniej uprawnienia do odczytu dla każdego źródła. SPN może jedynie wyświetlać dane i wysyłać do nich zapytania, do których przyznano mu dostęp, nawet jeśli sam agent danych został mu udostępniony.
Krok 5. Uzyskiwanie tokenu i wywoływanie agenta danych Fabric
Jednostka usługi uwierzytelnia się w usłudze Microsoft Entra ID przy użyciu przepływu poświadczeń klienta, aby zażądać tokenu dla zasobu Fabric (https://analysis.windows.net/powerbi/api/.default). Następnie używa uzyskanego tokenu dostępu jako tokenu okaziciela podczas wywoływania agenta danych.
Ograniczenia
- Tożsamości zarządzane nie są obecnie obsługiwane do uwierzytelniania agenta danych usługi Fabric. Zamiast tego należy użyć nazwy głównej usługi.
- SPN musi mieć jawnie przyznany dostęp do każdego źródła danych dodanego do agenta danych. Samo udostępnienie elementu agenta danych nie wystarczy, jeśli SPN nie ma uprawnień do odczytu źródeł danych, na których się on opiera.
- Uwierzytelnianie jednostki usługi nie jest jeszcze obsługiwane w przypadku agentów danych połączonych z bazą danych KQL (Kusto).