Box

Explorer des documents stockés dans une source de données Box.

IBM Cloud Pak for Data IBM Software Hub

Ces informations s'appliquent uniquement aux déploiements installés. Pour plus d'informations sur la connexion à Box à partir d'un déploiement géré, voir Box.

Quels documents sont explorés

  • Seuls les documents pris en charge par Discovery dans vos dossiers Box sont explorés ; tous les autres sont ignorés. Pour plus d'informations, voir Types de fichier pris en charge.
  • La sécurité de niveau document est prise en charge uniquement pour les connecteurs configurés pour utiliser App + Enterprise Access comme niveau d'accès de l'application Box. Lorsque cette option est activée, vos utilisateurs peuvent explorer et interroger le même contenu auquel ils peuvent accéder lorsqu'ils sont connectés à Box. Pour plus d'informations, voir Prise en charge de la sécurité au niveau des documents.
  • Lorsqu'une source est réexplorée, les nouveaux documents sont ajoutés, les documents mis à jour sont modifiés dans leur version actuelle et les documents supprimés sont effacés de l'index de la collection.
  • Tous les connecteurs de source de données Discovery sont en lecture seule. Quels que soient les droits accordés au compte d'exploration, Discovery n'écrit, ne met à jour ou ne supprime jamais de contenu dans la source de données d'origine.
  • Les notes Box sont stockées au format JSON, donc Discovery ingère également toutes les notes Box dans les dossiers spécifiés.

Configuration requise pour les sources de données

Outre les exigences de source de données pour tous les déploiements installés, votre source de données Box doit répondre aux exigences suivantes:

  • Vous devez obtenir les licences de service requises pour la source de données à laquelle vous souhaitez vous connecter. Pour plus d'informations sur les licences, contactez l'administrateur système de la source de données.

Procédure prérequise

Si vous souhaitez activer la sécurité au niveau du document, vous devez effectuer certaines étapes pour la configurer. Pour plus d'informations, voir A propos de la sécurité de niveau document.

Vous devez créer une application personnalisée dans Box avant de pouvoir vous connecter à Box à partir de Discovery. N'importe qui peut créer l'application personnalisée, mais seul un administrateur Box peut l'autoriser.

Pour créer une application personnalisée, procédez comme suit :

  1. Assurez-vous d'avoir un compte Box. Au cours de ce processus, vous obtenez le fichier de configuration et l'ID client.

  2. Ensuite, créez une application personnalisée qui utilise Server Authentication with JWT comme méthode d'authentification.

    Pour les étapes détaillées, voir Setup with JWT dans la documentation du développeur Box.

    Suivez ces instructions lorsque vous créez l'application:

    1. Au cours de la procédure de configuration, choisissez d'utiliser la méthode Server Authentication with JWT pour vérifier l'identité de l'application avec une paire de clés.

    2. Choisissez le niveau d'accès approprié pour le contenu Box que vous souhaitez explorer:

      • Fichiers Box partagés avec des utilisateurs gérés: Accès à l'application plus accès à l'entreprise
      • Fichiers Box partagés avec le compte de service: Accès à l'application uniquement
      • Fichiers Box partagés avec le compte de service et ses utilisateurs d'application: Accès à l'application uniquement

      La prise en charge de la configuration de l'accès de niveau Box avec l'accès à l'application uniquement a été ajoutée avec l'édition 4.6.

    3. Configurez le niveau d'accès en suivant les étapes appropriées pour votre type de niveau d'accès d'application:

      • Accès à l'application plus accès à l'entreprise

        Choisissez les champs d'application suivants :

        • Lire tous les dossiers stockés dans la boîte
        • Écrire tous les dossiers stockés dans la boîte
        • Gérer les utilisateurs

        Activer la fonctionnalité avancée suivante :

        • Générer des jetons d'accès utilisateur

      • Accès à l'application uniquement

        Pour explorer des fichiers partagés uniquement avec le compte de service, procédez comme suit:

        1. Choisissez les champs d'application suivants :

          • Lire tous les dossiers stockés dans la boîte
          • Écrire tous les dossiers stockés dans la boîte

        2. Partagez les dossiers et fichiers Box cible avec le compte de service en procédant comme suit:

          1. Sur la page Paramètres généraux, copiez le courrier électronique correspondant à l'ID de compte de service.
          2. Lorsque vous êtes connecté en tant qu'utilisateur géré, partagez le dossier ou les fichiers que le connecteur doit pouvoir explorer.
          3. Ajoutez l'adresse électronique de l'ID de compte de service en tant que personne à inviter à partager les fichiers.

          Pour plus d'informations, voir la documentation Box.

        Pour explorer des fichiers qui sont partagés avec le compte de service et ses utilisateurs d'application, procédez comme suit:

        1. Choisissez les champs d'application suivants :

          • Lire tous les dossiers stockés dans la boîte
          • Écrire tous les dossiers stockés dans la boîte
          • Gérer les utilisateurs

        2. Activer la fonctionnalité avancée suivante :

          • Générer des jetons d'accès utilisateur

        3. Partagez les dossiers et fichiers Box cible avec les utilisateurs d'application appropriés.

          Pour plus d'informations, voir la documentation Box.

  3. Créez des clés pour l'authentification. Vérifiez que vous avez effectué les tâches suivantes :

    1. Dans la page Paramètres généraux, cliquez sur Ajouter une clé publique.
    2. Sauvegardez le fichier de configuration téléchargé qui est généré pour la clé privée.
    3. Cliquez sur Enregistrer les modifications.
    4. Dans la page Configuration, copiez la valeur ID client.

  4. Ensuite, vous devez demander à un administrateur Box d'autoriser l'application. Dans la console d'administration Box, exécutez les tâches suivantes :

    1. Dans la page Applications > Gestionnaire d'applications personnalisées, cliquez sur Ajouter une application.

    2. Saisissez l'identifiant client, puis cliquez sur Suivant.

      Pour plus d'informations, voir Approbation d'application personnalisée.

  5. Etape de l'administrateur Box: à partir de la console d'administration Box, vérifiez que les informations de l'application sont exactes, puis cliquez sur Autoriser.

Connexion à la source de données Box

À partir de votre projet d' Discovery, procédez comme suit :

  1. Dans le panneau de navigation, sélectionnez Gestion des collections.

  2. Cliquez sur Nouvelle collection.

  3. Cliquez sur Case, puis sur Suivant.

  4. Attribuez un nom à la collection.

  5. Si la langue des documents dans Box n'est pas l'anglais, sélectionnez la langue appropriée.

    Pour obtenir la liste des langues prises en charge, voir Langues prises en charge.

  6. Facultatif. Modifiez la planification de la synchronisation.

    Pour plus d'informations, voir Options de planification d'exploration.

  7. Dans la section Entrez vos données d'identification, cliquez sur Sélectionner un fichier, puis recherchez le fichier de configuration qui a été généré et téléchargé lorsque vous avez ajouté la clé publique dans le cadre des étapes prérequises.

    Vous pouvez télécharger à nouveau un fichier de configuration à partir de la page de configuration sur le site de Box Developer.

  8. Facultatif. Dans la section Specify what you want to crawl, choisissez le contenu d'un utilisateur spécifique ou un dossier spécifique avec le contenu que vous souhaitez explorer. Si vous ne spécifiez rien, le service explore tout le contenu disponible pour l'application personnalisée.

    • Pour explorer une entreprise entière, entrez box://app.box.com/.

    • Pour explorer un dossier spécifique, saisissez box://app.box.com/user/USER'S_ACCOUNT_ID/folder/FOLDER_ID/FolderName.

      Exemple: box://example.app.box.com/user/460250779/folder/158001591642/My Folder

    • Pour explorer un utilisateur spécifique, saisissez box://app.box.com/user/USER'S_ACCOUNT_ID/.

  9. Facultatif: si vous utilisez un serveur proxy pour accéder au serveur de source de données, dans la section Paramètres du proxy, définissez le commutateur Activer les paramètres du proxy sur On. Ajoutez des valeurs aux zones suivantes:

    Nom d'utilisateur
    Facultatif. Le nom d'utilisateur que vous utilisez pour vous authentifier, si le serveur proxy requiert une authentification. Si vous ne connaissez pas votre nom d'utilisateur, vous pouvez l'obtenir auprès de l'administrateur du serveur proxy.
    Mot de passe
    Facultatif. Le mot de passe que vous utilisez pour vous authentifier, si le serveur proxy requiert une authentification. Si vous ne connaissez pas votre mot de passe, vous pouvez l'obtenir auprès de l'administrateur du serveur proxy.
    Nom d'hôte ou adresse IP du serveur proxy
    Le nom d'hôte ou l'adresse IP du serveur proxy.
    Numéro de port du serveur proxy
    Le port réseau auquel vous souhaitez vous connecter sur le serveur proxy.

  10. Facultatif. Si vous souhaitez activer la sécurité au niveau du document, dans la section Sécurité, définissez le paramètre Activer la sécurité au niveau du document sur On.

    Lorsque cette option est activée, vos utilisateurs peuvent explorer et interroger le même contenu auquel ils peuvent accéder lorsqu'ils sont connectés à Box. Pour plus d'informations, voir Prise en charge de la sécurité au niveau des documents.

  11. Si vous souhaitez que le moteur d'exploration extrait du texte des images sur le site, développez Plus de paramètres de traitementet définissez Appliquer la reconnaissance optique des caractères (OCR) sur On.

    Lorsque la reconnaissance optique des caractères est activée et que vos documents contiennent des images, le traitement prend plus de temps. Pour plus d'informations, voir Reconnaissance optique des caractères.

  12. Cliquez sur Terminer.

La collection est créée rapidement. Le traitement des données à mesure qu'elles sont ajoutées à la collection prend plus de temps.

Si vous souhaitez vérifier la progression, accédez à la page Activité. Dans le panneau de navigation, cliquez sur Gérer les collections, puis cliquez pour ouvrir la collection.