IBM Cloud Docs
Box

Box

Eseguire la ricerca per indicizzazione sui documenti memorizzati in un'origine dati Box.

IBM Cloud Pak for Data IBM Software Hub

Queste informazioni si applicano solo alle distribuzioni installate. Per ulteriori informazioni sulla connessione a Box da una distribuzione gestita, consultare Box.

Documenti sottoposti a ricerca per indicizzazione

  • Vengono sottoposti a scansione solo i documenti supportati da Discovery nelle cartelle Box; tutti gli altri vengono ignorati. Per ulteriori informazioni, consultare Tipi di file supportati.
  • La protezione a livello di documento è supportata solo per i connettori configurati per utilizzare App + Enterprise Access come livello di accesso dell'applicazione Box. Quando questa opzione è abilitata, gli utenti possono eseguire la scansione e interrogare gli stessi contenuti a cui possono accedere quando sono collegati a Box. Per ulteriori informazioni, consultare Supporto della sicurezza a livello di documento.
  • Quando una fonte viene ricaricata, i nuovi documenti vengono aggiunti, i documenti aggiornati vengono modificati nella versione corrente e i documenti eliminati vengono eliminati dall'indice della raccolta.
  • Tutti i connettori dell'origine dati Discovery sono di sola lettura. Indipendentemente dalle autorizzazioni concesse all'account di ricerca per indicizzazione, Discovery non scrive, aggiorna o elimina mai alcun contenuto nell'origine dati originale.
  • Le note Box sono memorizzate in formato JSON, quindi Discovery ingerisce anche tutte le note Box nelle cartelle specificate.

Requisiti dell'origine dati

Oltre ai requisiti dell'origine dati per tutte le distribuzioni installate, l'origine dati Box deve soddisfare i seguenti requisiti:

  • È necessario ottenere tutte le licenze di servizio richieste per l'origine dati a cui si desidera connettersi. Per ulteriori informazioni sulle licenze, contattare l'amministratore di sistema dell'origine dati.

procedura

prerequisita

Se si desidera abilitare la sicurezza a livello di documento, è necessario eseguire alcune operazioni per configurarlo. Per ulteriori informazioni, vedi Informazioni sulla sicurezza a livello di documento.

Devi creare un'applicazione personalizzata in Box prima di poterti collegare a Box da Discovery. Chiunque può creare l'app personalizzata, ma solo un amministratore Box può autorizzarla.

Per creare un'applicazione personalizzata, completare i seguenti passaggi:

  1. Assicurati di avere un account Box. Durante questo processo, si ottengono il file di configurazione e l'ID client.

  2. Successivamente, crea un'app personalizzata che utilizza Autenticazione server con JWT come metodo di autenticazione.

    Per i passaggi dettagliati, vedere Impostazione con JWT nella Documentazione per sviluppatori di Box.

    Segui queste linee guida quando crei l'applicazione:

    1. Durante la procedura di configurazione, scegliere di utilizzare il metodo Autenticazione server con JWT per verificare l'identità dell'applicazione con una coppia di chiavi.

    2. Scegliere il livello di accesso appropriato per il contenuto Box su cui si desidera eseguire la ricerca per indicizzazione:

      • File Box condivisi con utenti gestiti: accesso app più accesso enterprise
      • File Box condivisi con l'account di servizio: Solo accesso app
      • File Box condivisi con l'account di servizio e i suoi utenti app: Solo accesso app

      Il supporto per la configurazione dell'accesso a livello Box solo con l'accesso app è stato aggiunto con la release 4.6.

    3. Configura il livello di accesso seguendo la procedura appropriata per il tuo tipo di livello di accesso dell'app:

      • Accesso app più accesso enterprise

        Scegli i seguenti ambiti di applicazione:

        • Leggere tutte le cartelle archiviate in Box
        • Scrivi tutte le cartelle memorizzate in Box
        • Gestisci utenti

        Abilita la seguente funzione avanzata:

        • Generare token di accesso utente
      • Solo accesso app

        Per eseguire la ricerca per indicizzazione sui file condivisi solo con l'account di servizio, completare la seguente procedura:

        1. Scegli i seguenti ambiti di applicazione:

          • Leggere tutte le cartelle archiviate in Box
          • Scrivi tutte le cartelle memorizzate in Box
        2. Condividere le cartelle e i file Box di destinazione con l'account di servizio completando la seguente procedura:

          1. Dalla pagina Impostazioni generali, copiare l'email per l'ID account di servizio.
          2. Quando si è collegati come utente gestito, condividere la cartella o i file su cui si desidera che il connettore sia in grado di eseguire la ricerca per indicizzazione.
          3. Aggiungere l'email dell'ID account di servizio come persona da invitare a condividere i file.

          Per ulteriori informazioni, consultare la documentazione di Box.

        Per eseguire la ricerca per indicizzazione dei file condivisi con l'account di servizio e i loro utenti dell'app, completa la seguente procedura:

        1. Scegli i seguenti ambiti di applicazione:

          • Leggere tutte le cartelle archiviate in Box
          • Scrivi tutte le cartelle memorizzate in Box
          • Gestisci utenti
        2. Abilita la seguente funzione avanzata:

          • Generare token di accesso utente
        3. Condividere le cartelle e i file di Box di destinazione con gli utenti dell'app appropriati.

          Per ulteriori informazioni, consultare la documentazione di Box.

  3. Creare le chiavi per l'autenticazione. Assicurati di completare le seguenti attività:

    1. Dalla pagina Impostazioni generali, fare clic su Aggiungi una chiave pubblica.
    2. Salvare il file di configurazione scaricato generato per la chiave privata.
    3. Fai clic su Save Changes.
    4. Dalla pagina Configurazione, copiare il valore ID client.
  4. Successivamente, è necessario chiedere a un amministratore di Box di autorizzare l'applicazione. Nella console di gestione Box, completa le seguenti attività:

    1. Nella pagina App> Gestore app personalizzate, fare clic su Aggiungi app.

    2. Inserisci l'ID cliente e poi clicca su Avanti.

      Per ulteriori informazioni, vedi Approvazione app personalizzata.

  5. Passo amministratore Box: dalla console di amministrazione Box, controlla che le informazioni sull'app siano accurate e fai clic su Authorize.

Connessione all'origine dati Box

Dal tuo progetto Discovery, completa la seguente procedura:

  1. Dal riquadro di spostamento, scegliere Gestisci raccolte.

  2. Fare clic su Nuova raccolta.

  3. Fare clic su Casella, quindi su Avanti.

  4. Denominare la raccolta.

  5. Se la lingua dei documenti in Box non è l'inglese, selezionare la lingua appropriata.

    Per un elenco delle lingue supportate, vedi Supporto linguistico.

  6. Facoltativo. Modificare la pianificazione della sincronizzazione.

    Per ulteriori informazioni, vedi Opzioni di pianificazione della ricerca per indicizzazione.

  7. Nella sezione Immetti le tue credenziali, fai clic su Seleziona file e quindi sfoglia per trovare il file di configurazione che è stato generato e scaricato quando hai aggiunto la chiave pubblica come parte della procedura prerequisita.

    È possibile scaricare nuovamente un file di configurazione dalla pagina di configurazione sul sito Box Developer.

  8. Facoltativo. Nella sezione Specifica cosa si desidera sottoporre a ricerca per indicizzazione, scegliere il contenuto di un utente specifico o una cartella specifica con il contenuto su cui si desidera eseguire la ricerca per indicizzazione. Se non specifichi nulla, il servizio esegue la ricerca per indicizzazione di tutto il contenuto disponibile per l'app personalizzata.

    • Per eseguire la ricerca per indicizzazione di un'intera azienda, immetti box://app.box.com/.

    • Per eseguire la scansione di una cartella specifica, inserire box://app.box.com/user/USER'S_ACCOUNT_ID/folder/FOLDER_ID/FolderName.

      Ad esempio, box://example.app.box.com/user/460250779/folder/158001591642/My Folder

    • Per eseguire la scansione di un utente specifico, inserire box://app.box.com/user/USER'S_ACCOUNT_ID/.

  9. Facoltativo: se si utilizza un server proxy per accedere al server di origine dati, nella sezione Impostazioni proxy, impostare il passaggio Abilita impostazioni proxy su On. Aggiungere valori ai seguenti campi:

    Nome utente
    Facoltativo. Il nome utente utilizzato per l'autenticazione, se il server proxy richiede l'autenticazione. Se non si conosce il nome utente, è possibile ottenerlo dall'amministratore del server proxy.
    Password
    Facoltativo. La password utilizzata per l'autenticazione, se il server proxy richiede l'autenticazione. Se non si conosce la password, è possibile ottenerla dall'amministratore del server proxy.
    Nome host o indirizzo IP del server proxy
    Il nome host o l'indirizzo IP del server proxy.
    Numero porta del server proxy
    La porta di rete a cui si desidera connettersi sul server proxy.
  10. Facoltativo. Se si desidera attivare la sicurezza a livello di documento, nella sezione Sicurezza, impostare l'opzione Abilita sicurezza a livello di documento su On.

    Quando questa opzione è abilitata, gli utenti possono eseguire la scansione e interrogare gli stessi contenuti a cui possono accedere quando sono collegati a Box. Per ulteriori informazioni, consultare Supporto della sicurezza a livello di documento.

  11. Se si desidera che il crawler estragga il testo dalle immagini sul sito, espandere Ulteriori impostazioni di elaborazionee impostare Applica OCR (optical character recognition) su On.

    Quando OCR è abilitato e i tuoi documenti contengono immagini, l'elaborazione richiede più tempo. Per ulteriori informazioni, consultare Riconoscimento dei caratteri ottici.

  12. Fai clic su Finish.

La raccolta viene creata rapidamente. È necessario più tempo per l'elaborazione dei dati man mano che vengono aggiunti alla raccolta.

Se si desidera controllare l'avanzamento, andare alla pagina Attività. Dal riquadro di navigazione, fare clic su Gestisci raccolte, quindi fare clic per aprire la raccolta.