|
Klassiske filtyper er ikke lenger tilgjengelige for bruk fra og med januar 2021. Du kan overføre klassiske filer eller laste ned en PDF-fil. Finn ut mer

Workiva kundestøttesenter

Kobling til boks

Kobling til boks

  • Sist oppdatert

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:

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.
    box-app-types.png
  3. Under Autentiseringsmetode velger du OAuth 2.0 med JWT, og klikker på Neste.
    box-auth-types-jwt.png
  4. Skriv inn et unikt navn for å identifisere appen, for eksempel Workiva Box App, og klikk på Create App og deretter View Your App.
    box-app-name.png

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.
    box-auth.png
  3. Under Application Access velger du Enterprise, og klikker på Save Changes.
    box-app-access.png
  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.
    box-app-add-keys.png
  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.
    box-oauth-2-creds.png

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.
    Screenshot - 4_19_2024 , 2_07_46 PM.png

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.
    box-connector_01.png
  3. Under Basic Info angir du et unikt navn og en beskrivelse for å identifisere tilkoblingen.
  4. Under Properties angir du detaljer om tilkoblingen:
    box-connector_02.png
    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.
Med Box® -kontakten kan du bruke kommandoer for å samhandle med Box-stasjoner, for eksempel for å Søk og administrer...