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
- Fra Dev Console in Box klikker du på Create New App.
- Velg Egendefinert app, og klikk på Neste.
- Under Autentiseringsmetode velger du OAuth 2.0 med JWT, og klikker på Neste.
- 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
- Fra Dev Console i Box velger du Configuration for den egendefinerte appen.
- Under Autentiseringsmetode, kontroller at OAuth 2.0 med JWT er valgt.
- Under Application Access velger du Enterprise, og klikker på Save Changes.
- Åpne filen
public.pemi en klartekstredigerer, og kopier hele innholdet, inkludert topplinjen-----BEGIN PUBLIC KEY-----, bunnlinjen-----END PUBLIC KEY-----, og eventuelle mellomrom bak. - 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.
- Lim inn hele innholdet fra filen
public.pem, og klikk på Verifiser og lagre. - Når du blir bedt om det, skriver du inn 2FA-koden for Box-kontoen din, og klikker på Submit.
- Under OAuth 2.0 Credentials kopierer du den tilpassede appens klient-ID.
Trinn 4: Autoriser den tilpassede appen i Box
- Fra Admin Console i boksen klikker du på Apps.
- Klikk på Authorize New App i kategorien Custom Apps.
- Lim inn den egendefinerte appens klient-ID, og klikk på Next.
- 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
- Fra Dev Console i Box velger du Configuration for den egendefinerte appen.
- Kopier tjenestens konto-ID.
- 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.
- Fra Chain Builder klikker du på Connections, og deretter Create øverst til høyre.
- Under Connector Connection velger du Box og standard CloudRunner.
- Under Basic Info angir du et unikt navn og en beskrivelse for å identifisere tilkoblingen.
- 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.pemsom 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.
- Velg miljøene som skal bruke tilkoblingen, og klikk på Lagre.
- 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.pemogprivate.pemfiler 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.