|
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

Złącze do skrzynki

Złącze do skrzynki

  • Ostatnia aktualizacja

Dzięki złączu Box® możesz używać poleceń do interakcji z dyskami Box, np. do:

  • Wyszukaj pliki i zarządzaj nimi
  • Tworzenie i usuwanie folderów
  • Pobieranie adresów URL plików i folderów
Uwaga: To złącze jest zbudowane przez Workiva i łączy się z systemem innej firmy. Chociaż nasz zespół pomocy technicznej może pomóc w skonfigurowaniu tego łącznika w Twojej przestrzeni roboczej, nie jesteśmy w stanie rozwiązywać problemów ani w inny sposób pomagać w przypadku jakichkolwiek problemów, które powstały poza platformą Workiva.

Wymagania wstępne

Aby skonfigurować złącze, będziesz potrzebować

  • Niestandardowa aplikacja Box do integracji konta usługi
  • Identyfikator przedsiębiorstwa, identyfikator i klucz tajny klienta oraz klucz prywatny aplikacji niestandardowej

Utwórz integrację konta usługi w usłudze Box

Przed skonfigurowaniem łącznika Box utwórz niestandardową aplikację Box do integracji konta usługi. Aby skonfigurować parę kluczy publiczny/prywatny aplikacji, będziesz potrzebować:

  • OpenSSL
  • Edytor zwykłego tekstu, taki jak Windows Notepad
  • Uwierzytelnianie dwuskładnikowe (2FA) włączone w usłudze Box

Krok 1: Utwórz niestandardową aplikację Box

  1. Na stronie Dev Console in Box kliknij Create New App.
  2. Wybierz Custom App i kliknij Next.
    box-app-types.png
  3. W sekcji Authentication Method wybierz OAuth 2.0 with JWT, a następnie kliknij Next.
    box-auth-types-jwt.png
  4. Wprowadź unikalną nazwę, która pomoże zidentyfikować aplikację, na przykład Workiva Box App, i kliknij Create App , a następnie View Your App.
    box-app-name.png

Krok 2: Utwórz parę kluczy RSA aplikacji

Aby zabezpieczyć połączenie, konektor Box uwierzytelnia się przy użyciu pary kluczy publicznych/prywatnych Rivest-Shamir-Adleman (RSA) aplikacji niestandardowej. Aby utworzyć tę parę kluczy w OpenSSL, wprowadź następujące polecenia:

openssl genrsa -out private.pem 2048
openssl rsa -in private.pem -outform PEM -pubout -out public.pem

Polecenia te generują dwa pliki:

  • private.pem, który zawiera klucz klienta używany przez łącznik do uwierzytelniania w usłudze Box
  • public.pem, który jest wymagany do konfiguracji aplikacji niestandardowej

Krok 3: Skonfiguruj aplikację niestandardową

  1. Z Dev Console w Box wybierz Configuration dla aplikacji niestandardowej.
  2. W sekcji Authentication Method sprawdź, czy wybrana jest opcja OAuth 2.0 with JWT .
    box-auth.png
  3. W sekcji Application Access wybierz Enterprise i kliknij Save Changes.
    box-app-access.png
  4. W edytorze zwykłego tekstu otwórz plik public.pem i skopiuj całą jego zawartość, w tym wiersz nagłówka -----BEGIN PUBLIC KEY-----, wiersz stopki -----END PUBLIC KEY----- i wszelkie końcowe spacje.
  5. Z Dev Console w Box wybierz Configuration dla aplikacji niestandardowej i kliknij Add a Public Key w Add and Manage Public Keys.
    box-app-add-keys.png
  6. Wklej całą zawartość pliku public.pem i kliknij Verify and Save.
  7. Po wyświetleniu monitu wprowadź kod 2FA dla swojego konta Box i kliknij Submit.
  8. W sekcji OAuth 2.0 Credentials skopiuj identyfikator klienta aplikacji niestandardowej.
    box-oauth-2-creds.png

Krok 4: Autoryzuj aplikację niestandardową w Box

  1. Na stronie Admin Console w polu kliknij Apps.
  2. Na karcie Custom Apps kliknij Authorize New App.
  3. Wklej identyfikator klienta aplikacji niestandardowej i kliknij Next.
  4. W sekcji Autoryzacja aplikacji sprawdź, czy aplikacja jest autoryzowana dla wszystkich użytkowników, a następnie kliknij Autoryzuj.

Krok 5: Dodaj identyfikator konta usługi jako współpracownika do folderu Box

  1. Z Dev Console w Box wybierz Configuration dla aplikacji niestandardowej.
  2. Skopiuj identyfikator konta usługi.
  3. Przejdź do folderu Box, który zostanie udostępniony. W sekcji Udostępnianie znajdź sekcję Współpracownicy i kliknij Zaproś osoby, aby dodać identyfikator konta usługi.
    Screenshot - 4_19_2024 , 2_07_46 PM.png

Skonfiguruj złącze Box

Uwaga: Aby udostępnić łącznik do użytku w łańcuchach organizacji, administrator bezpieczeństwa organizacji najpierw włącza go z Konfiguracja.
  1. Na stronie Chain Builder kliknij Connectionscompare_arrows, a następnie Create w prawym górnym rogu.
  2. W sekcji Connector Connection wybierz Box i domyślny CloudRunner.
    box-connector_01.png
  3. W sekcji Basic Info wprowadź unikalną nazwę i opis, aby ułatwić identyfikację połączenia.
  4. W sekcji Properties wprowadź szczegóły połączenia:
    box-connector_02.png
    Właściwość Szczegóły
    Identyfikator klienta Wprowadź identyfikator klienta niestandardowej aplikacji Box, która ma być używana jako integracja konta usługi łącznika.
    Uwaga: Z Dev Console w Box, identyfikator klienta pojawia się w OAuth 2.0 Credentials na karcie Configuration aplikacji niestandardowej.
    Sekret klienta Wprowadź klucz tajny klienta aplikacji niestandardowej.
    Uwaga: Z Dev Console w Box, klucz tajny klienta pojawia się w OAuth 2.0 Credentials na karcie Configuration aplikacji niestandardowej.
    Klucz klienta Wprowadź całą zawartość pliku private.pem utworzonego dla aplikacji niestandardowej, w tym wiersz nagłówka -----BEGIN RSA PRIVATE KEY-----, wiersz stopki -----END RSA PRIVATE KEY----- oraz wszelkie końcowe spacje.
    Identyfikator przedsiębiorstwa Wprowadź identyfikator przedsiębiorstwa aplikacji niestandardowej.
    Uwaga: Z Dev Console w Box, identyfikator przedsiębiorstwa pojawia się w App Info na karcie General aplikacji niestandardowej.
    Uwaga: Wszystkie poufne dane uwierzytelniające są automatycznie szyfrowane i przechowywane przy użyciu szyfrowania Advanced Encryption Standard (AES) -256.
  5. Wybierz środowiska, w których ma być używane połączenie i kliknij Zapisz.
  6. Aby przetestować połączenie, utwórz i uruchom łańcuch z poleceniem konektora Get Folder Info i sprawdź, czy zwraca prawidłowe dane wyjściowe.

Rozwiązywanie problemów

Jeśli połączenie z Box nie powiedzie się:

  • Upewnij się, że aplikacja niestandardowa jest autoryzowana w Box.
  • Zweryfikuj identyfikator klienta aplikacji niestandardowej i klucz tajny wprowadzony dla łącznika. Z Dev Console w Box, identyfikator klienta i sekret pojawiają się w OAuth 2.0 Credentials na karcie Configuration aplikacji niestandardowej. Aby zresetować poświadczenia, kliknij Resetuj. 
  • Upewnij się, że cała zawartość plików public.pem i private.pem aplikacji niestandardowej jest wprowadzona odpowiednio w konfiguracji aplikacji i konektora. Uwzględnij wiersz nagłówka, wiersz stopki i wszelkie końcowe spacje. W razie potrzeby utwórz nową parę kluczy publicznych/prywatnych w OpenSSL i wprowadź ich zawartość w konfiguracjach aplikacji i konektora.
  • Zweryfikuj identyfikator przedsiębiorstwa aplikacji niestandardowej wprowadzony dla łącznika. Z Dev Console w Box, identyfikator przedsiębiorstwa pojawia się w App Info na karcie General aplikacji niestandardowej.
  • Sprawdź, czy udostępniany folder ma identyfikator konta usługi dodany jako współpracownik.
Dzięki złączu Box® możesz używać poleceń do interakcji z dyskami Box, np. do: Wyszukaj pliki i zarządzaj nimi Tworze...