Centrum wsparcia Workiva

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.
   
3. W sekcji Authentication Method wybierz OAuth 2.0 with JWT, a następnie kliknij Next.
   
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.
   

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 .
   
3. W sekcji Application Access wybierz Enterprise i kliknij Save Changes.
   
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.
   
   
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.
   

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.
   

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.
   
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:
   
   

   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.