Przejdź do treści

Konfiguracja OneDrive

Navigator współpracuje z OneDrive przez Microsoft Graph. Z tego artykułu dowiesz się, jak zarejestrować aplikację w Microsoft Entra ID i włączyć integrację.

Integracja pozwala:

  • otwierać i edytować pliki dokumentów w Office Online: Otwórz w Office Online i Edytuj w Office Online na liście plików,
  • pobierać historyczne wersje plików edytowanych w OneDrive,
  • udostępniać pliki osobom spoza Navigatora akcją systemową udostępniania przez OneDrive.

Plik otwierany w Office Online trafia do OneDrive użytkownika, który go otwiera, do folderu <Kod firmy>/<ID pliku>. Kolejne otwarcia korzystają z tej samej kopii.

Zanim zaczniesz

  • Każdy użytkownik Office Online w Navigatorze potrzebuje licencji Microsoft 365 z OneDrive, a jego OneDrive musi już istnieć, czyli użytkownik musi go choć raz otworzyć.
  • Adres e-mail użytkownika w Navigatorze musi być taki sam jak adres jego konta Microsoft 365. Po nim Navigator odnajduje OneDrive użytkownika.
  • Do rejestracji aplikacji potrzebna jest rola Administrator aplikacji (Application Administrator), Administrator aplikacji w chmurze (Cloud Application Administrator) albo Deweloper aplikacji (Application Developer). Zgody administratora udziela Administrator globalny (Global Administrator) albo Administrator ról uprzywilejowanych (Privileged Role Administrator).

Osobna rejestracja aplikacji

OneDrive nie zależy od logowania kontem Microsoft (patrz Logowanie kontem Microsoft (Entra ID)) ani od skrzynek pocztowych Microsoft 365. Każda z tych funkcji wymaga innych uprawnień, więc zarejestruj dla każdej osobną aplikację.

Wybór sposobu uwierzytelniania

Navigator łączy się z OneDrive jako aplikacja, a nie jako zalogowany użytkownik.

Klucz tajny Login i hasło
Logowanie Aplikacja loguje się kluczem tajnym, bez hasła. Login i hasło konta technicznego wymieniane na token OAuth.
Dostęp do plików OneDrive wszystkich użytkowników organizacji. Tylko pliki, do których ma dostęp konto techniczne.
Uwierzytelnianie wieloskładnikowe (MFA) Nie przeszkadza. Konto techniczne nie może wymagać MFA.
Typ uprawnień w Entra ID Aplikacji (Application) Delegowane (Delegated)
Zalecane Tak Nie

Zalecany jest Klucz tajny. Tylko on daje dostęp do OneDrive każdego użytkownika, a zmiana albo wygaśnięcie hasła nie przerywa integracji.

Rejestracja aplikacji

  1. Zaloguj się do centrum administracyjnego Microsoft Entra (https://entra.microsoft.com).
  2. Przejdź do Tożsamość > Aplikacje > Rejestracje aplikacji (Identity > Applications > App registrations) i wybierz Nowa rejestracja (New registration).
  3. Wpisz dowolną nazwę, np. Navigator OneDrive.
  4. W Obsługiwanych typach kont (Supported account types) wybierz Konta tylko w tym katalogu organizacyjnym (Accounts in this organizational directory only).
  5. Identyfikator URI przekierowania (Redirect URI) zostaw pusty. Integracja go nie używa.
  6. Kliknij Zarejestruj (Register).
  7. Ze strony Przegląd (Overview) skopiuj Identyfikator aplikacji (klienta) (Application (client) ID) i Identyfikator katalogu (dzierżawy) (Directory (tenant) ID).

Klucz tajny

  1. W rejestracji aplikacji przejdź do Certyfikaty i wpisy tajne (Certificates & secrets) i na karcie Wpisy tajne klienta (Client secrets) wybierz Nowy wpis tajny klienta (New client secret).
  2. Podaj opis i okres ważności i kliknij Dodaj.
  3. Skopiuj zawartość kolumny Wartość (Value). Widać ją tylko zaraz po utworzeniu klucza.
  4. Przejdź do Uprawnienia interfejsu API (API permissions), wybierz Dodaj uprawnienie (Add a permission) > Microsoft Graph > Uprawnienia aplikacji (Application permissions).
  5. Zaznacz Files.ReadWrite.All (odczyt i zapis plików w OneDrive użytkowników i ich udostępnianie) i User.Read.All (odczyt użytkowników i ich adresów, potrzebny do odnalezienia OneDrive).
  6. Kliknij Dodaj uprawnienia, a potem Udziel zgody administratora (Grant admin consent). Poprawne uprawnienia mają w kolumnie stanu zielony znacznik.

Domyślne uprawnienie delegowane User.Read nie jest potrzebne i możesz je usunąć.

Ważność klucza

Klucz tajny ma ograniczony okres ważności. Przed jego wygaśnięciem wygeneruj nowy klucz i wpisz go w Navigatorze, inaczej Office Online przestanie działać. Zapisz sobie datę wygaśnięcia klucza.

Login i hasło

Navigator loguje się do Microsoft Graph kontem technicznym Microsoft 365 i widzi tylko pliki, do których to konto ma dostęp.

  1. Przejdź do Uprawnienia interfejsu API (API permissions), wybierz Dodaj uprawnienie (Add a permission) > Microsoft Graph > Uprawnienia delegowane (Delegated permissions).
  2. Zaznacz Files.ReadWrite.All i User.Read.All, kliknij Dodaj uprawnienia i Udziel zgody administratora (Grant admin consent).
  3. Na karcie Uwierzytelnianie (Authentication), w Ustawieniach zaawansowanych (Advanced settings), ustaw Zezwalaj na przepływy klientów publicznych (Allow public client flows) na Tak. Bez tego Navigator nie uzyska tokenu.

Konto techniczne nie może wymagać MFA, bo logowanie odbywa się bez udziału użytkownika. Gdy zasady dostępu warunkowego wymuszają MFA, użyj klucza tajnego.

Ustawienia w Navigatorze

W ustawieniach systemu, w sekcji OneDrive, wypełnij:

Ustawienie Wartość
Identyfikator aplikacji w Azure Identyfikator aplikacji (klienta).
Identyfikator dzierżawy w Azure Identyfikator katalogu (dzierżawy).
Uwierzytelnij przez Klucz tajny albo Login i hasło.
Klucz tajny Wartość klucza. Tylko przy kluczu tajnym.
Nazwa użytkownika, Hasło użytkownika Adres e-mail i hasło konta technicznego. Tylko przy loginie i haśle.

Integracja działa, gdy wypełnione są identyfikatory i dane wybranego sposobu uwierzytelniania. Na liście plików dokumentu pojawiają się wtedy Otwórz w Office Online i Edytuj w Office Online.

Sprawdź konfigurację, otwierając dowolny plik przyciskiem Otwórz w Office Online. Przy błędzie połączenia Navigator pokaże komunikat. Najczęstsze przyczyny to brak zgody administratora, wygasły klucz tajny albo inny adres e-mail użytkownika w Navigatorze niż w Microsoft 365.

Co dalej

  • WebDAV: edycja plików w programach na komputerze.