Workiva kundestøttesenter

Med Box® -kontakten kan du bruke kommandoer for å samhandle med Box-stasjoner, for eksempel for å

• Søk og administrer filer
• Opprett og slett mapper
• Hent URL-adresser for filer og mapper

Merk: Denne kontakten er bygget av Workiva og kobles til et tredjepartssystem. Supportteamet vårt kan hjelpe deg med å konfigurere denne koblingen i arbeidsområdet ditt, men vi kan ikke feilsøke eller på annen måte hjelpe deg med problemer som oppstår utenfor Workiva-plattformen.

Forutsetninger

For å sette opp kontakten trenger du

• En tilpasset Box-app for integrering av tjenestekontoer
• Den egendefinerte appens bedrifts-ID, klient-ID og -hemmelighet samt privat nøkkel

Opprett en tjenestekontointegrasjon i Box

Før du konfigurerer Box-tilkoblingen, må du opprette en egendefinert Box-app for integrering av tjenestekontoen. For å konfigurere appens offentlige/private nøkkelpar trenger du:

• OpenSSL
• En ren tekstredigerer, for eksempel Windows Notepad
• To-faktor autentisering (2FA) aktivert i Box

Trinn 1: Opprett en egendefinert Box-applikasjon

1. Fra Dev Console in Box klikker du på Create New App.
2. Velg Egendefinert app, og klikk på Neste.
   
3. Under Autentiseringsmetode velger du OAuth 2.0 med JWT, og klikker på Neste.
   
4. Skriv inn et unikt navn for å identifisere appen, for eksempel Workiva Box App, og klikk på Create App og deretter View Your App.
   

Trinn 2: Opprett appens RSA-nøkkelpar

For å sikre tilkoblingen autentiserer Box Connector seg ved hjelp av den tilpassede appens offentlige/private RSA-nøkkelpar (Rivest-Shamir-Adleman). For å opprette dette nøkkelparet i OpenSSL, skriver du inn disse kommandoene:

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

Disse kommandoene genererer to filer:

• private.pem, som inneholder klientnøkkelen som kontakten bruker til å autentisere seg med Box
• public.pem, som den egendefinerte appen trenger for konfigurasjonen

Trinn 3: Konfigurer den egendefinerte appen

1. Fra Dev Console i Box velger du Configuration for den egendefinerte appen.
2. Under Autentiseringsmetode, kontroller at OAuth 2.0 med JWT er valgt.
   
3. Under Application Access velger du Enterprise, og klikker på Save Changes.
   
4. Åpne filen public.pem i en klartekstredigerer, og kopier hele innholdet, inkludert topplinjen -----BEGIN PUBLIC KEY-----, bunnlinjen -----END PUBLIC KEY-----, og eventuelle mellomrom bak.
5. Fra Dev Console i Box velger du Configuration for den egendefinerte appen, og klikker på Add a Public Key under Add and Manage Public Keys.
   
   
6. Lim inn hele innholdet fra filen public.pem, og klikk på Verifiser og lagre.
7. Når du blir bedt om det, skriver du inn 2FA-koden for Box-kontoen din, og klikker på Submit.
8. Under OAuth 2.0 Credentials kopierer du den tilpassede appens klient-ID.
   

Trinn 4: Autoriser den tilpassede appen i Box

1. Fra Admin Console i boksen klikker du på Apps.
2. Klikk på Authorize New App i kategorien Custom Apps.
3. Lim inn den egendefinerte appens klient-ID, og klikk på Next.
4. Under App Authorization, kontroller at appen er autorisert for All Users, og klikk på Authorize.

Trinn 5: Legg til tjenestekontoens ID som en samarbeidspartner i en Box-mappe

1. Fra Dev Console i Box velger du Configuration for den egendefinerte appen.
2. Kopier tjenestens konto-ID.
3. Gå til Box-mappen som skal deles. Under Deling ser du etter Collaborators-delen og klikker på Invite People for å legge til tjenestekontoens ID.
   

Sett opp Box-kontakten

Merk: For å gjøre kontakten tilgjengelig for bruk i organisasjonens kjeder, må en sikkerhetsadministrator i organisasjonen først aktivere den fra Configuration.

1. Fra Chain Builder klikker du på Connectionscompare_arrows, og deretter Create øverst til høyre.
2. Under Connector Connection velger du Box og standard CloudRunner.
   
3. Under Basic Info angir du et unikt navn og en beskrivelse for å identifisere tilkoblingen.
4. Under Properties angir du detaljer om tilkoblingen:
   
   

   Egenskap	Detaljer
   Klient-ID	Angi klient-ID-en til den egendefinerte Box-appen som skal brukes som tjenestekontointegrasjon for kontakten. Merk: Fra Dev Console i Box vises klient-ID-en under OAuth 2.0 Credentials på fanen Configuration i den tilpassede appen.
   Klienthemmelighet	Skriv inn klienthemmeligheten til den egendefinerte appen. Merk: Fra Dev Console i Box vises klienthemmeligheten under OAuth 2.0 Credentials på fanen Configuration i den tilpassede appen.
   Klientnøkkel	Skriv inn hele innholdet i filen private.pem som er opprettet for den egendefinerte appen, inkludert topplinjen -----BEGIN RSA PRIVATE KEY-----, bunnlinjen -----END RSA PRIVATE KEY-----, og eventuelle etterfølgende mellomrom.
   Bedrifts-ID	Skriv inn den egendefinerte appens bedrifts-ID. Merk: Fra Dev Console i Box vises bedrifts-ID-en under App Info på fanen Generelt for den egendefinerte appen.

   Merk: Alle sensitive opplysninger krypteres automatisk og lagres med Advanced Encryption Standard (AES)-256-kryptering.

5. Velg miljøene som skal bruke tilkoblingen, og klikk på Lagre.
6. For å teste tilkoblingen oppretter du og kjører en kjede med og kommandoen Get Folder Info , og kontrollerer at den returnerer en gyldig utdata.

Feilsøking

Hvis tilkoblingen til Box mislykkes:

• Sørg for at den egendefinerte appen er autorisert i Box.
• Bekreft klient-ID-en og hemmeligheten som er angitt for den egendefinerte appen for tilkoblingen. Fra Dev Console i Box vises klient-ID-en og hemmeligheten under OAuth 2.0 Credentials på fanen Configuration i den tilpassede appen. Klikk på Tilbakestill for å tilbakestille legitimasjonen. 
• Sørg for at hele innholdet i den egendefinerte appens public.pem og private.pem filer er lagt inn i konfigurasjonene til henholdsvis appen og kontakten. Ta med topplinjen, bunnlinjen og eventuelle mellomrom. Hvis det er nødvendig, oppretter du et nytt offentlig/privat nøkkelpar i OpenSSL, og angir innholdet i konfigurasjonen av appen og kontakten.
• Bekreft den egendefinerte appens bedrifts-ID som er angitt for kontakten. Fra Dev Console i Box vises bedrifts-ID-en under App Info på fanen Generelt i den tilpassede appen.
• Kontroller at tjenestekontoens ID er lagt til som samarbeidspartner i mappen som deles.