Med Box® -anslutningen kan du använda kommandon för att interagera med Box-enheter, t.ex:
- Söka och hantera filer
- Skapa och ta bort mappar
- Hämta URL:er för filer och mappar
Obs: Denna kontakt är byggd av Workiva och ansluts till ett system från tredje part. Vår support kan hjälpa till att konfigurera den här anslutningen i din arbetsyta, men vi kan inte felsöka eller på annat sätt hjälpa till med problem som uppstår utanför Workiva-plattformen.
Förkunskapskrav
För att sätta upp kontakten behöver du:
- En anpassad Box-app för integration av servicekonton
- Den anpassade appens företags-ID, klient-ID och -hemlighet samt privata nyckel
Skapa en integration av ett servicekonto i Box
Innan du konfigurerar Box-anslutningen ska du skapa en anpassad Box-app för integrationen av servicekontot. För att konfigurera appens offentliga/privata nyckelpar behöver du:
- OpenSSL
- En redigerare för vanlig text, t.ex. Windows Notepad
- Tvåfaktorsautentisering (2FA) aktiverad i Box
Steg 1: Skapa en anpassad Box-applikation
- Från Dev Console in Box klickar du på Create New App.
- Välj Custom App, och klicka på Next.
- Under Authentication Method väljer du OAuth 2.0 with JWT och klickar på Next.
- Ange ett unikt namn för att identifiera appen, t.ex. Workiva Box App, och klicka på Create App och sedan View Your App.
Steg 2: Skapa appens RSA-nyckelpar
För att säkra anslutningen autentiseras Box Connector med hjälp av den anpassade appens RSA-nyckelpar (Rivest-Shamir-Adleman) (offentlig/privat). Ange följande kommandon för att skapa detta nyckelpar i OpenSSL:
openssl genrsa -out private.pem 2048
openssl rsa -in private.pem -outform PEM -pubout -out public.pem
Dessa kommandon genererar två filer:
-
private.pem, som innehåller den klientnyckel som anslutningsdonet använder för att autentisera sig med Box -
public.pem, som den anpassade appen kräver för sin konfiguration
Steg 3: Konfigurera den anpassade appen
- Från Dev Console in Box väljer du Configuration för den anpassade appen.
- Under Authentication Method, kontrollera att OAuth 2.0 with JWT är valt.
- Under Application Access, välj Enterprise, och klicka på Save Changes.
- Öppna filen
public.pemi en redigerare för vanlig text och kopiera hela innehållet, inklusive rubriken-----BEGIN PUBLIC KEY-----, sidfotens rad-----END PUBLIC KEY-----och eventuella efterföljande mellanslag. - Från Dev Console i Box väljer du Configuration för den anpassade appen och klickar på Add a Public Key under Add and Manage Public Keys.
- Klistra in hela innehållet från filen
public.pemoch klicka på Verifiera och spara. - Ange 2FA-koden för ditt Box-konto när du uppmanas att göra det och klicka på Submit.
- Under OAuth 2.0 Credentials kopierar du den anpassade appens klient-ID.
Steg 4: Auktorisera den anpassade appen i Box
- Från Admin Console i rutan klickar du på Apps.
- På fliken Custom Apps klickar du på Authorize New App.
- Klistra in den anpassade appens klient-ID och klicka på Next.
- Under App Authorization kontrollerar du att appen är auktoriserad för All Users och klickar på Authorize.
Steg 5: Lägg till servicekontots id som medarbetare i en Box-mapp
- Från Dev Console in Box väljer du Configuration för den anpassade appen.
- Kopiera tjänstens accound-id.
- Gå till den Box-mapp som ska delas. Leta efter avsnittet Collaborators under Sharing och klicka på Invite People för att lägga till tjänstekontots id.
Sätt upp Box-anslutningen
Obs: För att göra kontakten tillgänglig för användning i din organisations kedjor, en org säkerhetsadministratör först aktivera den från Konfiguration.
- Från Chain Builder, klicka på Connections , och sedan Create längst upp till höger.
- Under Connector Connection väljer du Box och standard CloudRunner.
- Under Basic Info anger du ett unikt namn och en beskrivning som hjälper dig att identifiera anslutningen.
- Under Properties anger du information om anslutningen:
Egenskap Information Klient-ID Ange klient-ID för den anpassade Box-app som ska användas som integration av anslutningens servicekonto. Obs: Från Dev Console i Box visas klient-ID:t under OAuth 2.0 Credentials på fliken Configuration i den anpassade appen.
Klientens hemlighet Ange den anpassade appens klienthemlighet. Obs: Från Dev Console in Box visas klienthemligheten under OAuth 2.0 Credentials på fliken Configuration för den anpassade appen.
Nyckel till klient Ange hela innehållet i filen private.pemsom skapats för den anpassade appen, inklusive rubriken-----BEGIN RSA PRIVATE KEY-----, sidfotens rad-----END RSA PRIVATE KEY-----, och eventuella efterföljande mellanslag.Företagets ID Ange den anpassade appens företags-ID. Obs: Från Dev Console in Box visas företags-ID:t under App Info på fliken General för den anpassade appen.
Obs: Alla känsliga uppgifter krypteras automatiskt och lagras med Advanced Encryption Standard (AES)-256-kryptering.
- Välj de miljöer som ska använda anslutningen och klicka på Save.
- För att testa anslutningen, skapa och kör en kedja med anslutningens Get Folder Info kommando, och kontrollera att den returnerar en giltig utdata.
Felsökning
Om anslutningen till Box misslyckas:
- Se till att den anpassade appen är auktoriserad i Box.
- Verifiera den anpassade appens klient-ID och hemlighet som angetts för anslutningen. Från Dev Console i Box visas klient-ID:t och hemligheten under OAuth 2.0 Credentials på fliken Configuration för den anpassade appen. För att återställa inloggningsuppgifterna klickar du på Återställ.
- Se till att hela innehållet i den anpassade appens
public.pemochprivate.pemarkiveringar anges i appens respektive connectorens konfigurationer. Inkludera rubrik, sidfot och eventuella efterföljande mellanslag. Om det behövs skapar du ett nytt offentligt/privat nyckelpar i OpenSSL och anger innehållet i konfigurationerna för appen och kontakten. - Verifiera den anpassade appens företags-ID som angetts för anslutningen. Från Dev Console i Box visas företags-ID:t under App Info på den anpassade appens flik Allmänt.
- Kontrollera att tjänstekonto-ID:t har lagts till som medarbetare i den mapp som ska aktie.