Udostępnij za pośrednictwem

Włączanie uwierzytelniania jednostki usługi dla interfejsów API administratora tylko do odczytu

  • Artykuł

Jednostka usługi to metoda uwierzytelniania, która może służyć do zezwalania aplikacji Entra firmy Microsoft na dostęp do zawartości i interfejsów API usługi Microsoft Fabric.

Podczas tworzenia aplikacji Microsoft Entra jest tworzony obiekt jednostki usługi. Obiekt jednostki usługi, znany również jako jednostka usługi, umożliwia identyfikatorowi Entra firmy Microsoft uwierzytelnianie aplikacji. Po uwierzytelnieniu aplikacja może uzyskiwać dostęp do zasobów dzierżawy firmy Microsoft Entra.

Method

Aby włączyć uwierzytelnianie jednostki usługi dla interfejsów API tylko do odczytu usługi Power BI, wykonaj następujące kroki:

  1. Utwórz aplikację Firmy Microsoft Entra. Możesz pominąć ten krok, jeśli masz już aplikację Firmy Microsoft Entra, której chcesz użyć. Zanotuj identyfikator aplikacji, aby wykonać późniejsze kroki.

    Ważne

    Upewnij się, że używana aplikacja nie ma żadnych uprawnień wymaganych przez administratora dla usługi Power BI ustawionej w witrynie Azure Portal. Zobacz, jak sprawdzić, czy aplikacja ma jakiekolwiek takie uprawnienia.

  2. Utwórz nową grupę zabezpieczeń firmy Microsoft Entra. Dowiedz się więcej na temat tworzenia podstawowej grupy i dodawania członków przy użyciu usługi Microsoft Entra. Możesz pominąć ten krok, jeśli masz już grupę zabezpieczeń firmy Microsoft Entra, której chcesz użyć. Pamiętaj, aby wybrać pozycję Zabezpieczenia jako typ grupy.

    Zrzut ekranu przedstawiający okno dialogowe tworzenia nowej grupy w witrynie Azure Portal.

  3. Dodaj identyfikator aplikacji jako członka utworzonej grupy zabezpieczeń. Aby to zrobić:

    1. Przejdź do witryny Azure Portal > Grupy identyfikatorów entra > firmy Microsoft i wybierz grupę zabezpieczeń utworzoną w kroku 2.
    2. Wybierz polecenie Dodaj członków.

    Ważne

    Upewnij się, że aplikacja nie ma żadnych uprawnień wymaganych przez administratora dla usługi Power BI ustawionej w witrynie Azure Portal. Zobacz, jak sprawdzić, czy aplikacja ma jakiekolwiek takie uprawnienia.

  4. Włącz ustawienia administratora sieci szkieletowej:

    1. Zaloguj się do portalu administracyjnego sieci szkieletowej. Aby wyświetlić stronę ustawień dzierżawy, musisz być administratorem sieci szkieletowej.

    2. W obszarze Ustawienia interfejsu API administracyjnego jednostki usługi mogą uzyskiwać dostęp do wyświetlanych interfejsów API administratora tylko do odczytu. Ustaw przełącznik na Włączone, a następnie wybierz przycisk radiowy Określone grupy zabezpieczeń i dodaj grupę zabezpieczeń utworzoną w kroku 2 w polu tekstowym, które zostanie wyświetlone poniżej.

      Zrzut ekranu przedstawiający ustawienie dzierżawy Zezwalaj jednostkom usługi.

  5. Zacznij korzystać z interfejsów API administratora tylko do odczytu. Zapoznaj się z listą obsługiwanych interfejsów API poniżej.

Ważne

Aplikacja korzystająca z uwierzytelniania jednostki usługi, która wywołuje interfejsy API administratora tylko do odczytu, nie może mieć żadnych wymaganych uprawnień zgody administratora dla usługi Power BI ustawionej w witrynie Azure Portal. Zobacz, jak sprawdzić, czy aplikacja ma jakiekolwiek takie uprawnienia.

Obsługiwane interfejsy API

Uwierzytelnianie jednostki usługi jest obecnie obsługiwane dla następujących interfejsów API administratora tylko do odczytu.

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

  1. Zaloguj się do Azure Portal.
  2. Wybierz pozycję Microsoft Entra ID, a następnie pozycję Aplikacje dla przedsiębiorstw.
  3. Wybierz aplikację, której chcesz udzielić dostępu do usługi Power BI.
  4. Wybierz pozycję Uprawnienia. Dla aplikacji nie może być wymagane uprawnienia zgody administratora typu Aplikacja zarejestrowana w aplikacji.

Rozważania i ograniczenia

  • Jednostka usługi może wykonywać wywołania interfejsu API rest, ale nie można otworzyć sieci szkieletowej przy użyciu poświadczeń jednostki usługi.
  • Uprawnienia administratora sieci szkieletowej są wymagane do włączenia jednostki usługi w ustawieniach interfejsu API administracyjnego w portalu administracyjnym sieci szkieletowej.

Powiązana zawartość