Workiva-ondersteuningscentrum

Met de Box®-connector kunt u gebruiken om de commando's te gebruiken voor interactie met Box-schijven, zoals om:

• Bestanden zoeken en beheren
• Mappen maken en verwijderen
• URL's voor bestanden en mappen ophalen

Opmerking: Deze connector is gebouwd door Workiva en maakt verbinding met een systeem van derden. Hoewel ons Support team kan helpen bij het configureren van deze connector binnen uw workspace, kunnen wij geen problemen oplossen of op een andere manier helpen met problemen die hun oorsprong vinden buiten het Workiva platform.

Vereisten

Om de connector in te stellen, hebt u het volgende nodig:

• Een aangepaste Box-app voor de integratie van de serviceaccount
• De bedrijfs-ID, client-ID en -geheim en privésleutel van de aangepaste app

Een serviceaccountintegratie maken in Box

Voordat u de Box-connector instelt, moet u een aangepaste Box-app maken voor de integratie van de serviceaccount. Om het publieke/private sleutelpaar van de app te configureren, hebt u het volgende nodig:

• OpenSSL
• Een platte-teksteditor, zoals Windows Kladblok
• Authenticatie met twee factoren (2FA) ingeschakeld in Box

Stap 1: Maak een aangepaste Box-toepassing

1. Vanuit Dev Console in Box, klik op Create New App.
2. Selecteer Custom App en klik op Next.
   
3. Selecteer onder Authenticatiemethode OAuth 2.0 met JWT en klik op Volgende.
   
4. Voer een unieke naam in om de app te helpen identificeren, zoals Workiva Box App, en klik op App maken en vervolgens op Uw app bekijken.
   

Stap 2: Het RSA-sleutelpaar van de app maken

Om de verbinding te beveiligen, verifieert de Box-connector met behulp van het Rivest-Shamir-Adleman (RSA) publieke/private sleutelpaar van de aangepaste app. Om dit sleutelpaar te maken in OpenSSL, voert u deze opdrachten in:

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

Deze opdrachten genereren twee bestanden:

• private.pem, die de clientsleutel bevat die de connector gebruikt om te authenticeren met Box
• public.pem, die de aangepaste app nodig heeft voor zijn configuratie

Stap 3: De aangepaste app configureren

1. Vanuit Dev Console in Box, selecteer Configuration voor de aangepaste app.
2. Controleer onder Authenticatiemethode of OAuth 2.0 met JWT is geselecteerd.
   
3. Selecteer onder Toegang tot toepassingen, Enterprise, en klik op Wijzigingen opslaan.
   
4. Open het bestand public.pem in een tekstverwerker en kopieer de volledige inhoud, inclusief de kopregel -----BEGIN PUBLIC KEY-----, de voettekstregel -----END PUBLIC KEY-----, en eventuele spaties.
5. Ga naar Dev Console in Box, selecteer Configuratie voor de aangepaste app en klik op Een openbare sleutel toevoegen onder Openbare sleutels toevoegen en beheren.
   
   
6. Plak de volledige inhoud van het bestand public.pem en klik op Verify and Save.
7. Voer de 2FA-code voor uw Box-account in wanneer daarom wordt gevraagd en klik op Submit.
8. Kopieer onder OAuth 2.0 Credentials de client-ID van de aangepaste app.
   

Stap 4: Autoriseer de aangepaste app in Box

1. Vanuit Admin Console in Box, klik op Apps.
2. Klik op het tabblad Aangepaste apps op Nieuwe app autoriseren.
3. Plak de client-ID van de aangepaste app en klik op Volgende.
4. Controleer onder App Autorisatie of de app is geautoriseerd voor Alle gebruikers en klik op Autoriseer.

Stap 5: De service account id toevoegen als medewerker aan een Box-map

1. Vanuit Dev Console in Box, selecteer Configuration voor de aangepaste app.
2. Kopieer de service accound id.
3. Ga naar de map Box die zal worden gedeeld. Zoek onder Sharing (Delen) naar de sectie Collaborators (Samenwerkers) en klik op Invite People (Mensen uitnodigen) om de account-id van de service toe te voegen.
   

De Box-connector instellen

Opmerking: Om de connector beschikbaar te maken voor gebruik in de ketens van uw organisatie, moet een beveiligingsbeheerder van de org deze eerst inschakelen vanuit Configuratie.

1. Ga naar Chain Builder, klik op Connectionscompare_arrows, en vervolgens op Create rechtsboven.
2. Selecteer onder Connector Connection, Box en de standaard CloudRunner.
   
3. Voer onder Basisinfo een unieke naam en beschrijving in om de verbinding te helpen identificeren.
4. Onder Eigenschappen, voert u de details van de verbinding in:
   
   

   Eigendom	Details
   Klant-ID	Voer de client-ID in van de aangepaste Box-app die u wilt gebruiken als integratie van de serviceaccount van de connector. Opmerking: Vanuit Dev Console in Box verschijnt de client-ID onder OAuth 2.0 Credentials op het tabblad Configuratie van de aangepaste app.
   Geheim van de klant	Voer het clientgeheim van de aangepaste app in. Opmerking: Vanuit Dev Console in Box verschijnt het clientgeheim onder OAuth 2.0 Credentials op het tabblad Configuratie van de aangepaste app.
   Cliëntsleutel	Voer de volledige inhoud in van het bestand private.pem dat voor de aangepaste app is gemaakt, inclusief de kopregel -----BEGIN RSA PRIVATE KEY-----, de voettekstregel -----END RSA PRIVATE KEY-----, en eventuele spaties achteraan.
   Bedrijfs-ID	Voer de ondernemings-ID van de aangepaste app in. Opmerking: Vanuit Dev Console in Box verschijnt de ondernemings-ID onder App Info op het tabblad General van de aangepaste app.

   Opmerking: Alle gevoelige gegevens worden automatisch versleuteld en opgeslagen met Advanced Encryption Standard (AES)-256 codering.

5. Selecteer de omgevingen om de verbinding te gebruiken en klik op Opslaan.
6. Om de verbinding te testen, maakt een ketting aan en voert deze uit met de opdracht Get Folder Info van de connector, en controleer of deze een geldige uitvoer geeft.

Probleemoplossing

Als de verbinding met Box mislukt:

• Zorg ervoor dat de aangepaste app geautoriseerd is in Box.
• Controleer de client-ID en het geheim van de aangepaste app die voor de connector zijn ingevoerd. Vanuit Dev Console in Box verschijnen de client-ID en het geheim onder OAuth 2.0 Credentials op het tabblad Configuratie van de aangepaste app. Om de referenties opnieuw in te stellen, klikt u op opnieuw instellen. 
• Zorg ervoor dat de volledige inhoud van de public.pem en private.pem bestanden van de aangepaste app worden ingevoerd in de configuraties van respectievelijk de app en de connector. Voeg de kopregel, voettekstregel en eventuele spaties toe. Maak indien nodig een nieuw openbaar/privé sleutelpaar aan in OpenSSL, en voer de inhoud ervan in de configuraties van de app en connector in.
• Controleer de bedrijfs-ID van de aangepaste app die is ingevoerd voor de connector. Vanuit Dev Console in Box verschijnt de ondernemings-ID onder App Info op het tabblad General van de aangepaste app.
• Controleer of aan de map die wordt gedeeld de serviceaccount-ID is toegevoegd als medewerker.