M365Con 2027 – bezpłatna konferencja online · 11–22 Jan 2027 · 120 sessions m365con.net

Blog · Mirko Peters

Graph Data Connect i uprawnienia Microsoft Graph wyjaśnione: konfiguracja, zgoda, zasada najmniejszych uprawnień

By ·

Czym jest Microsoft Graph Data Connect, czym różni się od interfejsu Graph API, jakie są kroki konfiguracji i zatwierdzania oraz jak działają uprawnienia Graph (delegowane, aplikacji i zgody).

Automatically translated with AI from the original post. Read the English original

Microsoft Graph Data Connect i uprawnienia Microsoft Graph to dwa osobne tematy, które często wyszukuje się razem. Data Connect to usługa masowego wyodrębniania danych do analiz w Microsoft 365. Uprawnienia Graph kontrolują, co aplikacja może robić za pośrednictwem interfejsu Graph API. Oba opierają się na zgodzie i oba nagradzają ten sam nawyk: żądania najmniejszego dostępu, który wystarczy do wykonania zadania.

Najważniejsze wnioski

  • Graph Data Connect masowo wyodrębnia dane Microsoft 365 do usługi Azure Storage w celu analiz. Interfejs Graph API nadaje się do pracy z niewielkimi ilościami danych od wybranych użytkowników i grup.
  • Konfiguracja wymaga administratora globalnego, który ją włączy, rejestracji aplikacji w Entra, konta usługi Azure Storage oraz zatwierdzenia przez administratora żądania dostępu do danych.
  • Potoki generują narzut rzędu 45 minut, a pierwsze uruchomienie, łącznie z wyrażeniem zgody, może trwać ponad 40 minut.
  • Uprawnienia Graph występują w dwóch typach. Uprawnienia delegowane działają w imieniu zalogowanego użytkownika. Uprawnienia aplikacji działają bez użytkownika i wymagają zgody administratora.
  • Microsoft zaleca model delegowany, jeśli spełnia potrzeby aplikacji, oraz najmniejsze uprawnienie, które działa.
  • Nazwy uprawnień mają postać {resource}.{operation}.{constraint}, na przykład Application.ReadWrite.OwnedBy.

Czym jest Graph Data Connect

Microsoft opisuje Data Connect jako bezpieczny i skalowalny dostęp do zbiorów danych Microsoft 365 w usługach Microsoft Fabric, Azure Synapse i Azure Data Factory, na potrzeby analiz w przedsiębiorstwie. Dane pochodzą z źródeł takich jak Microsoft Entra ID, Outlook, Teams, SharePoint, Viva Insights i grupy Microsoft.

Zbiory danych dzielą się na trzy grupy: podstawowe (surowe treści tworzone przez klienta), oczyszczone (znormalizowane lub pozbawione duplikatów) oraz wyselekcjonowane (przygotowane pod konkretny scenariusz). Lista zbiorów zawiera na przykład TeamsCallRecords_v1, SharePointPermissions_v1, GroupMembers_v0 i PlannerTasks_v0. Zbiory danych Viva Insights wymagają licencji Viva Insights, co jest jedyną uwagą dotyczącą licencji na stronie zbiorów danych.

Data Connect czy Graph API

Według często zadawanych pytań dotyczących Data Connect oba rozwiązania docierają do tych samych danych. Data Connect wyodrębnia duże ilości danych zbiorczo w skali całej organizacji. Interfejsy Graph API nadają się do pracy z niewielkimi ilościami danych od wybranych użytkowników i grup. Z pytań wynika, że warto je łączyć, na przykład używając Data Connect do początkowego wyodrębnienia, a Graph API do późniejszej pracy w czasie rzeczywistym.

Znane ograniczenia według często zadawanych pytań:

  • Potoki generują narzut rzędu 45 minut, niezależnie od rozmiaru danych.
  • Użytkownicy Exchange lokalnego nie są obsługiwani, także w konfiguracjach hybrydowych.
  • Wiadomości i wydarzenia z kont zasobów nie są obsługiwane.
  • Dostęp do zbiorów danych między dzierżawami nie jest dostępny. Zasoby Azure i Microsoft 365 muszą znajdować się w tej samej dzierżawie Entra.

Kroki konfiguracji

Przewodnik szybkiego startu przeprowadza przez te kroki. Nazwy menu podano tak, jak wymienia je Microsoft.

  1. Włącz Data Connect. Zaloguj się na stronie admin.microsoft.com jako administrator globalny. Wybierz Ustawienia > Ustawienia organizacji, a następnie na karcie Usługi wybierz Microsoft Graph Data Connect. Zaznacz opcję włączenia usługi dla całej organizacji i zapisz zmiany.
  2. Utwórz aplikację w Microsoft Entra. W centrum administracyjnym Microsoft Entra przejdź do Rejestracje aplikacji > Nowa rejestracja. Wybierz opcję „Tylko konta w tym katalogu organizacji”. Skopiuj identyfikator aplikacji (klienta) i identyfikator dzierżawy, utwórz klucz tajny klienta i natychmiast zapisz jego wartość. Właściciel aplikacji potrzebuje skrzynki pocztowej oraz – zgodnie z przewodnikiem szybkiego startu – działającej subskrypcji E5.
  3. Utwórz usługę Azure Storage. Utwórz konto magazynu w regionie zgodnym z regionem Twojej dzierżawy Microsoft 365. Przypisz aplikacji rolę Storage Blob Data Contributor w obszarze Kontrola dostępu (IAM) i utwórz prywatny kontener.
  4. Zarejestruj aplikację w usłudze Data Connect w portalu Azure. Wybierz miejsce docelowe, aplikację oraz zestawy danych i kolumny.
  5. Zatwierdź żądanie. Administrator otwiera Ustawienia > Ustawienia organizacji > Zabezpieczenia i prywatność > Aplikacje Microsoft Graph Data Connect. Aplikacja pokazuje status Wstępna zgoda. Przejrzyj zestawy danych i wybierz Zatwierdź. Przewodnik szybkiego startu ostrzega, że nie można zatwierdzić żądania samodzielnie.
  6. Uruchom potok w usłudze Synapse, Data Factory lub Fabric. Stan przechodzi przez etapy: Initializing, Consent Pending, Extracting Data, Persisting Data i Succeeded. Pierwsze uruchomienie może trwać ponad 40 minut.

Obsługiwane ujścia danych obejmują Azure Data Lake Storage Gen2, Azure Storage Blob, Azure SQL DB (wyłącznie w przepływach danych mapowania) oraz Microsoft Fabric OneLake. Jedynym obsługiwanym mechanizmem uwierzytelniania jest uwierzytelnianie jednostki usługi.

Zgoda i koszty

Zgoda obejmuje zakres ekstrakcji: zestawy danych, kolumny, użytkowników i ujście. Uruchomienie o tym samym zakresie nie wymaga nowego żądania. Rozliczenie odbywa się w ramach subskrypcji Azure, za każde uruchomienie potoku, z zaokrągleniem ułamkowych jednostek w górę. Przykład z często zadawanych pytań: 20 uruchomień po 500 wierszy każde jest rozliczane jako 20 jednostek, a nie 10. Przeczytane strony nie podają stawek.

Uprawnienia Graph: podstawy

Dla interfejsu Graph API Microsoft definiuje dwa typy uprawnień.

| | Delegowane | Aplikacji | |---|---|---| | Działa | W imieniu zalogowanego użytkownika | Bez użytkownika | | Faktyczny dostęp | Ograniczony uprawnieniami aplikacji i uprawnieniami samego użytkownika | Wszystkie dane objęte uprawnieniem | | Kto może wyrazić zgodę | Użytkownicy lub administratorzy dla wszystkich użytkowników | Wyłącznie administrator | | Inne nazwy | Zakresy | Role aplikacji |

Zgodę na uprawnienia aplikacji wymaga roli Administratora ról uprzywilejowanych lub Administratora globalnego. Zgoda użytkowników na uprawnienia delegowane może być nadal ograniczona przez zasady zgody aplikacji w dzierżawie.

Nazewnictwo i zasada najmniejszych uprawnień

Uprawnienia są zapisywane w formacie {resource}.{operation}.{constraint}. Przykłady na stronie używają operacji takich jak Read i ReadWrite oraz ograniczeń takich jak All i OwnedBy. Jeśli nie podano ograniczenia, dostęp jest ograniczony do danych należących do zalogowanego użytkownika. Na przykład Application.ReadWrite.OwnedBy pozwala zarządzać wyłącznie aplikacjami utworzonymi przez aplikację lub należącymi do niej, a Application.ReadWrite.All – wszystkimi.

Zalecenie Microsoft: przydziel minimalne potrzebne uprawnienie. Z ostrożnością używaj uprawnień Directory.AccessAsUser.All, Directory.ReadWrite.All i Directory.Read.All i w miarę możliwości wybieraj uprawnienia o węższym zakresie. Zgoda specyficzna dla zasobu pozwala użytkownikowi przyznać dostęp do jednej instancji zasobu, na przykład zespołu, zamiast do całej dzierżawy. Obsługuje ją tylko część funkcji.

Typowe problemy

  • Rejestracja agenta łącznika kończy się niepowodzeniem. Dokumentacja Learn stwierdza, że uprawnienia delegowane nie są obsługiwane w przypadku rejestracji agenta łącznika. Zażądaj uprawnień aplikacji o najmniejszym zakresie i udziel zgody administratora dla całej dzierżawy.
  • Członkowie pokazują wyłącznie id i @odata.type. Aplikacja nie ma uprawnienia do odczytu tego typu członka.
  • Zbyt wiele uprawnień w jednej aplikacji. Aplikacje, których odbiorcy logowania obejmują osobiste konta Microsoft, mogą żądać najwyżej 30 uprawnień; odbiorcy organizacyjni mogą żądać do 400.

Czego nie mówi dokumentacja

Przeczytane strony Data Connect nie opisują, jak długo zatwierdzenie pozostaje ważne, i nie podają cennika. Nie wymieniają również wymagań licencyjnych poza konfiguracją z przewodnika szybkiego startu.

Powiązane

Źródła

FAQ

Czym różni się Graph Data Connect od interfejsu Microsoft Graph API?

Według często zadawanych pytań dotyczących Data Connect na Microsoft Learn oba rozwiązania zapewniają dostęp do tych samych danych, ale na różne sposoby. Data Connect służy do masowego wyodrębniania dużych ilości danych dla całej organizacji, natomiast interfejsy Graph API nadają się do pracy z niewielkimi ilościami danych od wybranych użytkowników i grup.

Kto zatwierdza aplikację Graph Data Connect?

W przewodniku szybkiego startu Microsoft administrator zatwierdza żądanie w centrum administracyjnym Microsoft 365, w sekcji Ustawienia > Ustawienia organizacji > Zabezpieczenia i prywatność > Aplikacje Microsoft Graph Data Connect. Przewodnik wyraźnie zaznacza, że nie można samodzielnie zatwierdzić własnych aplikacji.

Czy każde uruchomienie potoku wymaga nowego żądania zgody?

Nie. Według często zadawanych pytań dotyczących Data Connect, dopóki zakres zbiorów danych, kolumn, użytkowników i ujścia pozostaje taki sam, uruchomienie nie wymaga nowego żądania zgody. Uruchomienie tego samego zakresu dla różnych dat jest objęte tą zasadą.

Czy aplikacja powinna używać uprawnień delegowanych, czy uprawnień aplikacji?

Microsoft Learn podaje, że uprawnienia aplikacji są bardzo uprzywilejowane i że z punktu widzenia zasady najmniejszych uprawnień zaleca się model delegowany, o ile spełnia on potrzeby aplikacji. Uprawnienia aplikacji zawsze wymagają zgody administratora.

Entities in this article

Tematy tego artykułu:

Microsoft Graph Data Connect – Część Microsoft Graph Microsoft Graph permissions – Podtemat w ramach tematu „Microsoft Graph” Microsoft Graph – Narzędzie dla deweloperów firmy Microsoft

Related articles

Więcej artykułów na pokrewne tematy:

RSS