Kontaktdon till box

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.pem i 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.pem och 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 compare_arrows, 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.pem` som 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.pem och private.pem arkiveringar 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.

Support

Community

Workiva supportcenter