Przejdź do głównej zawartości

Połącz lokalizację Microsoft OneDrive for Business lub SharePoint z modułem PlaidCloud Document. Rejestrujesz aplikację Entra (Azure AD), wybierasz, do jakiej części dzierżawy może ona mieć dostęp, a PlaidCloud używa jej do odczytu i zapisu plików.

Zdecyduj, do jakiej części dzierżawy Microsoft 365 aplikacja może mieć dostęp. To najważniejszy wybór w całej konfiguracji.

Model Uprawnienie aplikacji Graph Do czego aplikacja ma dostęp Kiedy wybrać
Wybrane witryny (zalecane) Sites.Selected Tylko do konkretnych witryn, do których jawnie nadasz dostęp Gdy jakakolwiek witryna zawiera poufne dane — płace, kadry, finanse, dane medyczne (PHI)
Wszystkie witryny Sites.Read.All (odczyt) lub Sites.ReadWrite.All (odczyt i zapis) Do każdej witryny w dzierżawie Gdy żadna witryna nie jest poufna i chcesz najprostszej konfiguracji

Większość organizacji powinna wybrać model Wybrane witryny. Jeśli choćby jedna witryna zawiera poufne informacje, dostęp do całej dzierżawy je ujawnia. Z uprawnieniem Sites.Selected aplikacja nie ma dostępu do niczego, dopóki administrator nie nada jej dostępu do każdej wskazanej witryny, więc witryny, do których nigdy nie nadasz dostępu, pozostają całkowicie niedostępne.

  1. Zaloguj się do portalu Azure i przejdź do Microsoft Entra ID → App registrations → + New registration.
  2. Wpisz nazwę (na przykład PlaidCloud).
  3. W sekcji Supported account types wybierz Accounts in this organizational directory only (jedna dzierżawa — najczęstszy wariant).
  4. Pozostaw pole Redirect URI puste i kliknij Register.
  5. Na stronie przeglądu skopiuj wartości Application (client) ID (Twój Identyfikator klienta) i Directory (tenant) ID (Twój ID tenanta).
  6. Przejdź do Certificates & secrets → + New client secret, ustaw opis i okres ważności, wybierz Add i od razu skopiuj wartość Value klucza tajnego — nie zostanie ona wyświetlona ponownie.

Dodaj dokładnie jedno uprawnienie Microsoft Graph typu Application, zgodne z wybranym modelem dostępu:

  • Wybrane witryny: Sites.Selected
  • Wszystkie witryny: Sites.Read.All (tylko odczyt) lub Sites.ReadWrite.All (odczyt i zapis)

Kroki: API permissions → + Add a permission → Microsoft Graph → Application permissions → dodaj jedno uprawnienie z powyższej listy → Grant admin consent.

Jeśli wybrano model Wszystkie witryny, konfiguracja jest zakończona — przejdź do sekcji Dodawanie konta w PlaidCloud. Jeśli wybrano model Wybrane witryny, nadaj aplikacji dostęp do każdej witryny w następnym kroku.

Przyznanie aplikacji dostępu do każdej witryny (model Wybrane witryny)

Dział zatytułowany „Przyznanie aplikacji dostępu do każdej witryny (model Wybrane witryny)”

Uprawnienie Sites.Selected samo w sobie nie daje aplikacji żadnego dostępu — administrator SharePoint lub administrator globalny musi nadać jej dostęp do każdej witryny, do której ma mieć dostęp. W centrum administracyjnym nie ma do tego ekranu, dlatego używa się dwóch wywołań Microsoft Graph w Graph Explorer. Ponieważ dostęp do witryn nadaje się pojedynczo, do poufnych witryn po prostu nigdy nie jest on nadawany.

Jednorazowa konfiguracja. W Graph Explorer, po zalogowaniu jako administrator SharePoint lub administrator globalny, otwórz kartę Modify permissions i kliknij Consent przy Sites.FullControl.All (ten zakres pozwala ustawiać uprawnienia do witryn). Jeśli późniejsze zapytanie zwróci accessDenied, brakuje właśnie tej zgody — po jej udzieleniu wyloguj się i zaloguj ponownie, aby odświeżyć token.

Wyświetl listę witryn w dzierżawie (metoda GET):

GET https://graph.microsoft.com/v1.0/sites?search=*&$select=displayName,webUrl,id

Możesz też odczytać pojedynczą witrynę bezpośrednio na podstawie jej adresu URL:

GET https://graph.microsoft.com/v1.0/sites/contoso.sharepoint.com:/sites/TeamName

Skopiuj z odpowiedzi wartość id witryny — ma ona postać contoso.sharepoint.com,<guid>,<guid>.

Ustaw metodę POST dla kolekcji permissions tej witryny (wklej wartość id z kroku 1):

POST https://graph.microsoft.com/v1.0/sites/{site-id}/permissions

Na karcie Request body wklej poniższy kod — ustaw roles na ["read"] lub ["write"] i użyj wartości Application (client) ID swojej aplikacji:

{
"roles": ["read"],
"grantedToIdentities": [
{ "application": { "id": "your-client-id", "displayName": "PlaidCloud" } }
]
}

Uruchom zapytanie. W przypadku powodzenia zwracany jest obiekt uprawnienia z wartością id i Twoimi roles. Powtórz krok 2 dla każdej witryny, do której PlaidCloud ma mieć dostęp. Aby sprawdzić, jakie uprawnienia nadano w witrynie:

GET https://graph.microsoft.com/v1.0/sites/{site-id}/permissions
  1. Zaloguj się do PlaidCloud i wybierz obszar roboczy, w którym ma się znaleźć konto.
  2. Przejdź do Document → Manage → Nowe konto.
  3. Wybierz OneDrive jako Usługa.
  4. Wpisz nazwę i opis oraz wybierz Model zabezpieczeń (w razie wątpliwości pozostaw Private).
  5. W sekcji Dane uwierzytelniające wklej wartości Identyfikator klienta, Klucz tajny klienta i ID dzierżawy OneDrive z rejestracji aplikacji.
  6. W polu URL witryny SharePoint wklej adres URL witryny, do której aplikacja otrzymała dostęp (na przykład https://contoso.sharepoint.com/sites/TeamName). Lista Dysk/Witryna pokaże wtedy biblioteki dokumentów tej witryny — wybierz tę, która ma być katalogiem głównym konta. Spowoduje to wypełnienie pola Ścieżka początkowa.
  7. Wybierz Zapisz.

Asystent AI połączony przez łącznik PlaidCloud MCP może utworzyć lub zaktualizować konto za pomocą narzędzia document_account_upsert po wykonaniu opisanych powyżej czynności w Azure. Przekaż mu wartości z rejestracji aplikacji:

Pole konta Wartość
service_type onedrive
public_key Identyfikator aplikacji (klienta)
private_key Klucz tajny klienta
tenant_id Identyfikator katalogu (dzierżawy)
start_path Identyfikator dysku, opcjonalnie z dopisanym /folder

Poświadczenia są tylko do zapisu: document_account_describe je ukrywa. Narzędzie jest dostępne w Twojej własnej sesji MCP po zalogowaniu, a nie dla kroków przepływu pracy ani agentów w aplikacji.