Box

Box è un servizio di gestione dei contenuti e condivisione di file su cloud per l'archiviazione, la condivisione e la collaborazione su file e cartelle. Puoi collegare Box enterprise come fonte di dati per la tua Knowledge Base gestita per eseguire la scansione di file e cartelle.

Funzionalità supportate

• Esegui la scansione di file e cartelle

• Rilevamento automatico di campi comuni del documento (come titolo, autore e date di creazione o modifica)

• Filtri di contenuto di inclusione per file e cartelle specifici (autenticazione OAuth 2.0)

• Filtraggio delle dimensioni massime dei file

• Sincronizzazione incrementale dei contenuti per contenuti aggiunti, aggiornati ed eliminati

• Autenticazione Client Credentials Grant (2LO) e OAuth 2.0 (3LO)

• Document-level controllo degli accessi (ACL), con autenticazione Client Credentials Grant

Metodi di autenticazione

Un'origine dati Box supporta due metodi di autenticazione. Scegline una prima di iniziare, perché determina le credenziali da creare e se è possibile utilizzare il controllo degli accessi a livello di documento. Consigliamo l'autenticazione Client Credentials Grant per nuove fonti di dati.

Metodi di autenticazione Box

Metodo	Come si autentica	Quando utilizzarlo	Configurazione
Client Credentials Grant ()CCG: consigliato	Il connettore si autentica come app Box utilizzando il flusso Client Credentials Grant (2LO), con accesso a livello aziendale. Nessun accesso utente.	Scansiona i contenuti all'interno di Box Enterprise e in qualsiasi fonte di dati che utilizza il controllo degli accessi a livello di documento.	Imposta le credenziali del cliente: concedi l'autenticazione
OAuth 2.0 () OAUTH2	Il connettore si autentica come app Box per conto di un utente specifico (3LO) ed esegue la scansione dei contenuti a cui l'utente può accedere.	Scansione dei contenuti per un utente specifico. Non supportato con il controllo degli accessi a livello di documento.	Configura l'autenticazione OAuth 2.0

Prerequisiti

In Box, assicurati di:

• Crea e configura un'app Box per l'autenticazione del connettore. La configurazione dell'app dipende dal metodo di autenticazione utilizzato: consulta la pagina di configurazione relativa al metodo: Configurare le credenziali del client Concedi l'autenticazione per Box oppureConfigurare l'autenticazione OAuth 2.0 per Box.

Nel tuo AWS account, assicurati di:

• Archivia le credenziali di autenticazione in un segreto di AWS Secrets Manager e prendi nota del nome della risorsa Amazon (ARN) del segreto stesso.

• Per le coppie chiave-valore esatte da memorizzare nel segreto, consulta la pagina di configurazione del metodo di autenticazione: Configurare le credenziali del client Concedi l'autenticazione per Box o. Configurare l'autenticazione OAuth 2.0 per Box

• Includi le autorizzazioni necessarie per connetterti alla tua fonte di dati nella role/permissions policy AWS Identity and Access Management (IAM) per la tua knowledge base. Per informazioni sulle autorizzazioni richieste, consulta. Autorizzazioni per accedere alle origini dati

Come configurare un'origine dati Box

La configurazione di un'origine dati Box prevede i seguenti passaggi:

1. Configurare l'autenticazione. Segui la pagina relativa al metodo scelto per creare le credenziali dell'app Box e memorizzarle in AWS: Configurare le credenziali del client Concedi l'autenticazione per Box oppureConfigurare l'autenticazione OAuth 2.0 per Box.

2. Connect la fonte di dati. Crea l'origine dati Box nella knowledge base utilizzando Console di gestione AWS o l'API. Consulta Connect a Box a data source.

3. (Facoltativo) Abilita il controllo degli accessi a livello di documento. Filtra i risultati delle query in base alle autorizzazioni Box di ciascun utente. Richiede l'autenticazione Client Credentials Grant. Consulta Document-level controlli di accesso.