|
Klasyczne typy plików nie są już dostępne od stycznia 2021 r. Możesz przenieść swoje klasyczne pliki lub pobrać plik PDF. Dowiedz się więcej

Centrum wsparcia Workiva

Łącznik do Microsoft OneDrive

Łącznik do Microsoft OneDrive

  • Ostatnia aktualizacja

Łącznik Microsoft® OneDrive® umożliwia używanie poleceń w łańcuchu w celu zarządzania plikami i folderami w usłudze Microsoft OneDrive lub SharePoint®. Na przykład za pomocą tego łącznika możesz:

  • Kopiuj, usuwaj i wyszukuj pliki i foldery
  • Pobieranie i przesyłanie plików
  • Wyświetl listę dostępnych dysków
Uwaga : Ten łącznik został stworzony przez firmę Workiva i łączy się z systemem innej firmy. Chociaż nasz zespół wsparcia może pomóc w skonfigurowaniu tego łącznika w Twojej przestrzeni roboczej, nie jesteśmy w stanie rozwiązywać problemów ani udzielać pomocy w przypadku problemów, które mają swoje źródło poza platformą Workiva.

Wymagania wstępne

Aby umożliwić połączenie, łącznik korzysta z interfejsu API Microsoft Graph. Aby zabezpieczyć połączenie, łącznik korzysta z uwierzytelniania OAuth za pośrednictwem wyznaczonej aplikacji zarejestrowanej w portalu rejestracji aplikacji firmy Microsoft lub usłudze Azure® Active Directory®.

Aby skonfigurować łącznik, będziesz potrzebować:

Przykładowa konfiguracja Microsoft Azure dla OneDrive

Rejestracja aplikacji

  1. Zaloguj się do portalu Microsoft Azure: https://azure.microsoft.com/en-us/account/
  2. Przejdź do usług Azure Active Directory .
  3. Przejdź do Rejestracje aplikacji w obszarze Zarządzaj i kliknij Nowa rejestracja .
  4. Podaj żądaną Nazwę aplikacji , a następnie naciśnij Zarejestruj .

Konfigurowanie uwierzytelniania aplikacji

  1. Zaloguj się do portalu Microsoft Azure: https://azure.microsoft.com/en-us/account/
  2. Przejdź do usług Azure Active Directory .
  3. Przejdź do Rejestracje aplikacji w obszarze Zarządzaj.
  4. Przejdź do Uwierzytelnianie w zaktualizowanym panelu Zarządzaj.
  5. W sekcji „Obsługiwane typy kont” wybierz opcję Konta w dowolnym katalogu organizacyjnym (dowolny dzierżawca Microsoft Entra ID — wielodzierżawca) .
  6. W obszarze Dodaj platformę wybierz Sieć .
  7. W polu Adres URI przekierowania wprowadź powyższy prawidłowy adres URL wywołania zwrotnego.
  8. Upewnij się, że zaznaczone jest pole wyboru MultiTenant w obszarze Obsługiwane typy kont .
Uwaga: Ponieważ łącznik OneDrive wymaga włączenia opcji MultiTenant, administratorzy platformy Azure są odpowiedzialni za zapewnienie prawidłowej konfiguracji aplikacji pod kątem zgodności z zabezpieczeniami. Ta opcja, jeśli jest poprawnie używana z zabezpieczeniami platformy Azure, nie udostępnia aplikacji każdemu. Poniżej znajdziesz sugestie dotyczące dodatkowych kroków, które możesz podjąć.

Konfigurowanie certyfikatów i sekretów

  1. Zaloguj się do portalu Microsoft Azure: https://azure.microsoft.com/en-us/account/
  2. Przejdź do usług Azure Active Directory .
  3. Przejdź do Rejestracje aplikacji w obszarze Zarządzaj .
  4. Przejdź do Certyfikaty w zaktualizowanym panelu Zarządzaj .
  5. Kliknij Nowy klucz klienta w środkowym panelu.
  6. Po podaniu krótkiego Opisu i Daty ważności zostanie wyświetlony Tajemniczy Klucz Klienta. Dane te należy zapisać w celu ich bezpiecznego przechowywania i wprowadzić do łącznika Microsoft OneDrive.

Konfigurowanie uprawnień API

  1. Zaloguj się do portalu Microsoft Azure: https://azure.microsoft.com/en-us/account/
  2. Przejdź do usług Azure Active Directory .
  3. Przejdź do Rejestracje aplikacji w obszarze Zarządzaj .
  4. Przejdź do Uprawnienia API w zaktualizowanym panelu Zarządzaj .
  5. Kliknij Dodaj uprawnienie w środkowym panelu.
  6. Wybierz Microsoft Graph w obszarze Interfejsy API firmy Microsoft .
  7. Wybierz Uprawnienia delegata jako Typ żądania .
  8. Z listy uprawnień, których będziesz potrzebować:
    User.Read , wszystko co znajduje się w FILES i OpenId.offline_access .
  9. Kliknij Udziel zgody administratora .
  10. Zdefiniuj poziom dostępu wymagany przez łącznik.Łącznik Microsoft OneDrive obsługuje
    następujące zakresy :
    • Pliki.Odczyt.Zapis.Wybrane
    • Pliki.ReadWrite.AppFolder
    • Pliki.OdczytZapis.Wszystkie
    • Pliki.OdczytZapis
    • Pliki.Odczyt.Wybrane
    • Pliki.Odczyt.Wszystkie
    • Pliki.Odczyt
    • dostęp_offline

Minimalnym wymaganym zakresem jest offline_access .

Dlaczego Files.Read.All i Files.ReadWrite.All są potrzebne

Łącznik Workiva OneDrive komunikuje się ze środowiskiem Microsoft za pośrednictwem interfejsu API Microsoft Graph przy użyciu uprawnień delegowanych OAuth — co oznacza, że ​​łącznik uwierzytelnia uwierzytelnionego użytkownika i działa w jego imieniu.

Dlaczego nie można używać Sites.Selected

Sites.Selected to uprawnienie specyficzne dla programu SharePoint przeznaczone do przepływów dostępu na poziomie aplikacji (tylko aplikacja). Nie jest ono zgodne z modelem uprawnień delegowanych, z którego korzysta łącznik Workiva. Ogranicza także dostęp wyłącznie do wstępnie zatwierdzonych witryn programu SharePoint, co uniemożliwia łącznikowi wykonywanie dynamicznych operacji opartych na ścieżce, takich jak wyszukiwanie, kopiowanie elementu i usuwanie elementu.

 

Włączanie bezpieczeństwa

  1. Zaloguj się do portalu Microsoft Azure: https://azure.microsoft.com/en-us/account/
  2. Przejdź do usług Azure Active Directory .
  3. Kliknij Aplikacje korporacyjne w obszarze Zarządzaj .
  4. Aby rozpocząć proces edycji, wybierz swoją aplikację z listy. Jeśli Twoja aplikacja nie jest domyślnie wyświetlana, kliknij Wszystkie aplikacje w obszarze Zarządzaj .
  5. Kliknij Właściwości w obszarze Zarządzaj .
  6. Na ekranie Właściwości ustaw następujące właściwości, aby zezwolić na korzystanie z dostępu API utworzonego powyżej:

    • Czy użytkownicy mogą się logować? = Tak

    • Wymagane przypisanie użytkownika? = Tak

    • (Opcjonalnie) Widoczne dla użytkowników? = Nie
  7. Kliknij Użytkownicy i grupy w obszarze Zarządzaj .
  8. Teraz możesz używać standardowych procesów usługi Azure AD, aby w razie potrzeby dodawać użytkowników. Oto
    lista użytkowników, którzy mogą korzystać z usługi OneDrive i mają odpowiednią licencję Microsoft OneDrive.

Skonfiguruj łącznik Microsoft OneDrive

Uwaga: Aby udostępnić łącznik do użytku w łańcuchach organizacji, administrator zabezpieczeń organizacji najpierw go włączy z Konfiguracji .
  1. W Chain Builder kliknij Connections compare_arrows , a następnie Create w prawym górnym rogu.
  2. W obszarze Połączenie łącznika wybierz Microsoft OneDrive i domyślny CloudRunner.
    microsoft-onedrive-connector_01.png
  3. W polu Informacje podstawowe wprowadź unikalną nazwę i opis, aby ułatwić identyfikację złącza.
  4. W polu OAuth wprowadź identyfikator klienta OAuth i klucz tajny dla aplikacji Azure łącznika.
    microsoft-onedrive-connector_02.png
  5. Aby określić poziom dostępu łącznika, wprowadź zakres uwierzytelniania aplikacji platformy Azure.
    Minimalnie wymagany jest zakres offline_access .
  6. Aby autoryzować połączenie i dane uwierzytelniające OAuth, kliknij Połącz .

  7. W obszarze Właściwości wprowadź szczegóły połączenia:
    microsoft-onedrive-connector_03.png

    Właściwość Szczegóły
    Typ napędu Wybierz typ dysku, z którym chcesz się połączyć, np. Dysk, Grupa, Użytkownik lub Witryna. Aby
    połączyć się z własnym dyskiem użytkownika, wybierz Aktualny użytkownik (ja) .
    Identyfikator typu napędu Wprowadź identyfikator dysku, do którego chcesz się podłączyć, na podstawie Typu dysku . Na przykład, jeśli Typ dysku to „Użytkownik”, wprowadź identyfikator użytkownika; jeśli to „Lokalizacja”, wprowadź identyfikator witryny.
    Uwaga: Aby pobrać je z programu Sharepoint, możesz użyć narzędzia Graph Explorer firmy Microsoft.
  8. Wybierz środowiska, których chcesz używać z połączeniem i kliknij Zapisz .
  9. Aby przetestować połączenie, utwórz i uruchom łańcuch za pomocą polecenia Pobierz plik [ łącznika i sprawdź, czy zwraca on prawidłowy wynik.

Rozwiązywanie problemów

Jeśli połączenie z usługą Microsoft OneDrive lub SharePoint nie powiedzie się:

Łącznik Microsoft® OneDrive® umożliwia używanie poleceń w łańcuchu w celu zarządzania plikami i folderami w usłudze...