Włącz uwierzytelnianie głównego komponentu usługi dla interfejsów API administratora

W tym artykule pokazano, jak włączyć uwierzytelnianie nazwy głównej usługi dla interfejsów API administratora tylko do odczytu w usłudze Power BI oraz interfejsów API administratora aktualizacji w usłudze Fabric.

Nazwa główna usługi to metoda uwierzytelniania, której można użyć, aby umożliwić aplikacji Microsoft Entra dostęp do zawartości usługi Fabric i interfejsów API. Podczas tworzenia aplikacji Microsoft Entra proces tworzy obiekt jednostki usługi. Obiekt nazwy głównej usługi, znany również po prostu jako nazwa główna usługi, umożliwia usłudze Microsoft Entra ID uwierzytelnianie aplikacji. Po uwierzytelnieniu aplikacja może uzyskiwać dostęp do zasobów dzierżawy Microsoft Entra.

Przykładem jest aplikacja, która uruchamia skanowanie metadanych i oceny ryzyka danych usługi Fabric w Zarządzanie stanem bezpieczeństwa danych w Microsoft Purview (DSPM) dla sztucznej inteligencji. Ta aplikacja używa uwierzytelniania za pomocą nazwy głównej usługi w celu uzyskania dostępu do interfejsów API administratora platformy Fabric. Tę aplikację należy skonfigurować tak, aby uwierzytelniła się przy użyciu poświadczeń federacyjnych (zalecane) lub klucza tajnego klienta.

Włącz uwierzytelnianie podmiotu usługi

Aby włączyć uwierzytelnianie głównego podmiotu usługi dla interfejsów API Fabric, wykonaj następujące kroki:

  1. Utwórz aplikację Microsoft Entra. Możesz pominąć ten krok, jeśli masz już aplikację Microsoft Entra, której chcesz użyć. Zanotuj identyfikator aplikacji, który jest potrzebny w kolejnych krokach.

    Ważne

    Upewnij się, że używana aplikacja w portalu Azure nie ma ustawionych żadnych zezwoleń, które wymagają zgody administratora dla Fabric. Zobacz, jak sprawdzić, czy aplikacja ma jakiekolwiek takie uprawnienia.

  2. Utwórz nową Microsoft Entra Security Group i wybierz Security jako typ grupy. Możesz pominąć ten krok, jeśli masz już Microsoft Entra grupę zabezpieczeń, której chcesz użyć.

  3. Dodaj swój identyfikator aplikacji jako członek utworzonej grupy zabezpieczeń. Aby to zrobić:

  4. Przejdź do Azure portal > Microsoft Entra ID > Groups i wybierz grupę zabezpieczeń utworzoną w Krok 2.

    1. Wybierz pozycję Dodaj członków.

  5. Włącz ustawienia administratora Fabric:

    1. Zaloguj się do Fabric przy użyciu poświadczeń konta administratora. Otwórz katalog usługi OneLake, a następnie wybierz kartę >Konfiguracje>Ustawienia dzierżawy.

    2. W obszarze Ustawienia interfejsu API administratora wybierz przełącznik dla typu interfejsów API administratora, które chcesz włączyć:

      Note

      Te ustawienia są wymagane do uruchomienia ocen ryzyka danych usługi Fabric w Microsoft Purview DSPM for AI. Aby uzyskać więcej informacji, zobacz DSPM pod kątem zagadnień dotyczących sztucznej inteligencji.

  6. Ustaw przełącznik na Włączone.

  7. Wybierz przycisk radiowy Określone grupy zabezpieczeń . W wyświetlonym poniżej polu tekstowym dodaj grupę zabezpieczeń utworzoną w kroku 2.

  8. Wybierz i zastosuj.

Obsługiwane interfejsy API Power BI dla administratorów do odczytu

Następujące interfejsy API administratora tylko do odczytu obsługują uwierzytelnianie jednostki usługi. Ta lista może nie być wyczerpująca; Aby uzyskać najnowsze informacje na temat interfejsów API, których nie ma na liście, zapoznaj się z dokumentacją interfejsu API REST Power BI.

Aplikacja korzystająca z uwierzytelniania jednostki usługi, która wywołuje interfejsy API administratora tylko do odczytu, nie może mieć wymaganych uprawnień zgody administratora dla Power BI ustawionych w portalu Azure. Aby sprawdzić przypisane uprawnienia:

  1. Zaloguj się do portalu Azure.

  2. Wybierz Microsoft Entra ID, a następnie Aplikacje dla przedsiębiorstw.

  3. Wybierz aplikację, której chcesz udzielić dostępu do Power BI.

  4. Wybierz Uprawnienia. Dla aplikacji nie mogą być zarejestrowane uprawnienia wymagające zgody administratora typu Aplikacja.

Obsługiwane interfejsy API administratora Fabryki dla aktualizacji

Jednostki usługi mogą uzyskiwać dostęp do interfejsów API administratora używanych do aktualizowania ustawień dotyczących interfejsów API administratora sieci szkieletowej, takich jak obszary robocze — przywracanie interfejsu API obszaru roboczego.

Aby dowiedzieć się, czy określony interfejs API administratora Fabric obsługuje uwierzytelnianie za pomocą jednostki usługi, zapoznaj się z dokumentacją interfejsu w odniesieniu do Fabric REST API. Wyszukaj sekcję "obsługiwane tożsamości przez Microsoft Entra", która wskazuje, czy uwierzytelnianie podmiotu usługi jest obsługiwane.

Uwagi i ograniczenia

  • Jednostka usługi może wykonywać wywołania interfejsu API REST, ale nie można otworzyć Fabric przy użyciu poświadczeń jednostki usługi.

  • Uprawnienia administratora Fabric są wymagane do włączenia zasady usługi w ustawieniach API administratora w Fabric.

Treści powiązane

  • Ostatnia aktualizacja o