Box

Durchsuchen Sie Dokumente, die in einer Box-Datenquelle gespeichert sind.

IBM Cloud Pak for Data IBM Software Hub

Diese Informationen gelten nur für installierte Implementierungen. Weitere Informationen zum Herstellen einer Verbindung zu Box von einer verwalteten Implementierung aus finden Sie unter Box.

Durchsuchte Dokumente

  • Nur Dokumente, die von Discovery in Ihren Box-Ordnern unterstützt werden, werden durchsucht; alle anderen werden ignoriert. Weitere Informationen finden Sie unter Unterstützte Dateitypen.
  • Sicherheit auf Dokumentebene wird nur für Connectors unterstützt, die für die Verwendung von App + Unternehmenszugriff als App-Zugriffsebene der Box-Anwendung konfiguriert sind. Wenn diese Option aktiviert ist, können Ihre Benutzer dieselben Inhalte durchsuchen und abfragen, auf die sie zugreifen können, wenn sie bei Box angemeldet sind. Weitere Informationen finden Sie unter Sicherheit auf Dokumentebene unterstützen.
  • Wenn eine Quelle erneut durchsucht wird, werden neue Dokumente hinzugefügt, aktualisierte Dokumente werden auf die aktuelle Version geändert und gelöschte Dokumente werden aus dem Index der Sammlung gelöscht.
  • Alle Discovery-Datenquellenconnectors sind schreibgeschützt. Unabhängig von den Berechtigungen, die dem Konto für die Crawlersuche erteilt wurden, schreibt, aktualisiert oder löscht Discovery keinen Inhalt in der ursprünglichen Datenquelle.
  • Box-Notizen werden im JSON-Format gespeichert, sodass Discovery auch alle Box-Notizen in den angegebenen Ordnern aufnimmt.

Datenquellenvoraussetzungen

Neben den Datenquellenanforderungen für alle installierten Implementierungen muss Ihre Box-Datenquelle die folgenden Anforderungen erfüllen:

  • Sie müssen alle erforderlichen Servicelizenzen für die Datenquelle anfordern, zu der Sie eine Verbindung herstellen möchten. Wenden Sie sich für weitere Informationen zu Lizenzen an den Systemadministrator der Datenquelle.

Vorausgesetzte Schritte

Wenn Sie die Sicherheit auf Dokumentebene aktivieren möchten, müssen Sie einige Schritte ausführen, um sie einzurichten. Weitere Informationen finden Sie in Informationen zur Sicherheit auf Dokumentebene.

Sie müssen eine angepasste Anwendung in Box erstellen, bevor Sie über Discoveryeine Verbindung zu Box herstellen können. Jeder kann die angepasste App erstellen, aber nur ein Box-Administrator kann sie autorisieren.

Um eine benutzerdefinierte Anwendung zu erstellen, führen Sie die folgenden Schritte aus:

  1. Stellen Sie sicher, dass Sie ein Box-Konto haben. Während dieses Prozesses erhalten Sie die Konfigurationsdatei und die Client-ID.

  2. Erstellen Sie als Nächstes eine angepasste App, die Serverauthentifizierung mit JWT als Authentifizierungsmethode verwendet.

    Detaillierte Schritte finden Sie unter Einrichtung mit JWT in der Box Developer Documentation.

    Beachten Sie beim Erstellen der App die folgenden Richtlinien:

    1. Wählen Sie während der Setup-Prozedur die Methode Serverauthentifizierung mit JWT aus, um die Anwendungsidentität mit einem Schlüsselpaar zu überprüfen.

    2. Wählen Sie die entsprechende Zugriffsebene für den Box-Inhalt aus, den Sie durchsuchen wollen:

      • Box-Dateien, die mit verwalteten Benutzern geteilt werden: App-Zugriff plus Unternehmenszugriff
      • Box-Dateien, die mit dem Servicekonto geteilt werden: Nur App-Zugriff
      • Box-Dateien, die mit dem Servicekonto und seinen App-Benutzern geteilt werden: Nur App-Zugriff

      Unterstützung für die Konfiguration des Zugriffs auf Box-Ebene mit App-Zugriff wurde mit dem Release 4.6 hinzugefügt.

    3. Konfigurieren Sie die Zugriffsebene, indem Sie die entsprechenden Schritte für Ihren App-Zugriffsebenentyp ausführen:

      • App-Zugriff plus Unternehmenszugriff

        Wählen Sie die folgenden Anwendungsbereiche:

        • Alle in Box gespeicherten Ordner lesen
        • Alle in Box gespeicherten Ordner schreiben
        • Benutzer verwalten

        Aktivieren Sie die folgende erweiterte Funktion:

        • Erstellen Sie Benutzerzugriffstoken
      • Nur App-Zugriff

        Führen Sie die folgenden Schritte aus, um Dateien zu durchsuchen, die nur mit dem Servicekonto gemeinsam genutzt werden:

        1. Wählen Sie die folgenden Anwendungsbereiche:

          • Alle in Box gespeicherten Ordner lesen
          • Alle in Box gespeicherten Ordner schreiben
        2. Teilen Sie die Box-Zielordner und -dateien mit dem Service-Account, indem Sie die folgenden Schritte ausführen:

          1. Kopieren Sie auf der Seite 'Allgemeine Einstellungen' die E-Mail für die Servicekonto-ID.
          2. Wenn Sie als verwalteter Benutzer angemeldet sind, teilen Sie die Ordner oder Dateien, die der Connector durchsuchen können soll.
          3. Fügen Sie die Service-Account-ID-E-Mail als die Person hinzu, die zum Teilen der Dateien eingeladen werden soll.

          Weitere Informationen finden Sie in der Box-Dokumentation.

        Führen Sie die folgenden Schritte aus, um Dateien zu durchsuchen, die mit dem Servicekonto und seinen App-Benutzern gemeinsam genutzt werden:

        1. Wählen Sie die folgenden Anwendungsbereiche:

          • Alle in Box gespeicherten Ordner lesen
          • Alle in Box gespeicherten Ordner schreiben
          • Benutzer verwalten
        2. Aktivieren Sie die folgende erweiterte Funktion:

          • Erstellen Sie Benutzerzugriffstoken
        3. Teilen Sie die Box-Zielordner und -dateien mit den entsprechenden App-Benutzern.

          Weitere Informationen finden Sie in der Box-Dokumentation.

  3. Erstellen Sie Schlüssel für die Authentifizierung. Führen Sie dazu die folgenden Schritte aus:

    1. Klicken Sie auf der Seite Allgemeine Einstellungen auf Öffentlichen Schlüssel hinzufügen.
    2. Speichern Sie die heruntergeladene Konfigurationsdatei, die für den privaten Schlüssel generiert wird.
    3. Klicken Sie auf Änderungen speichern.
    4. Kopieren Sie auf der Seite Konfiguration den Wert für die Client-ID.
  4. Als Nächstes müssen Sie einen Box-Administrator bitten, die App zu autorisieren. Führen Sie in der Box-Administrationskonsole die folgenden Schritte aus:

    1. Klicken Sie auf der Seite Apps > Custom Apps Manager auf App hinzufügen.

    2. Geben Sie die Kunden-ID ein und klicken Sie dann auf "Weiter ".

      Weitere Informationen finden Sie unter Genehmigung angepasster Apps.

  5. Box-Administratorschritt: Überprüfen Sie in der Box-Administrationskonsole, ob die App-Informationen korrekt sind, und klicken Sie dann auf Autorisieren.

Verbindung zur Box-Datenquelle herstellen

Führen Sie die folgenden Schritte für Ihr Discovery-Projekt aus:

  1. Wählen Sie im Navigationsfenster Sammlungen verwalten aus.

  2. Klicken Sie auf "Neue Kollektion ".

  3. Klicken Sie auf "Box" und dann auf "Weiter ".

  4. Benennen Sie die Objektgruppe.

  5. Wenn die Sprache der Dokumente in Box nicht Englisch ist, wählen Sie die entsprechende Sprache aus.

    Eine Liste der unterstützten Sprachen finden Sie unter Sprachunterstützung.

  6. Optional. Ändern Sie den Synchronisationszeitplan.

    Weitere Informationen finden Sie unter Zeitplanoptionen für die Crawlersuche.

  7. Klicken Sie im Abschnitt Berechtigungsnachweise eingeben auf Datei auswählen und suchen Sie dann die Konfigurationsdatei, die generiert und heruntergeladen wurde, als Sie den öffentlichen Schlüssel als Teil der vorausgesetzten Schritte hinzugefügt hatten.

    Sie können eine Konfigurationsdatei erneut von der Konfigurationsseite auf der Box Developer-Siteherunterladen.

  8. Optional. Wählen Sie im Abschnitt Zu durchsuchende Elemente angeben den Inhalt eines bestimmten Benutzers oder einen bestimmten Ordner mit zu durchsuchenden Inhalten aus. Wenn Sie nichts angeben, durchsucht der Dienst den gesamten Inhalt, der für die angepasste App verfügbar ist.

    • Geben Sie für eine Crawlersuche im gesamten Unternehmen box://app.box.com/ ein.

    • Um einen bestimmten Ordner zu durchsuchen, geben Sie box://app.box.com/user/USER'S_ACCOUNT_ID/folder/FOLDER_ID/FolderName ein.

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

    • Um einen bestimmten Benutzer zu crawlen, geben Sie box://app.box.com/user/USER'S_ACCOUNT_ID/ ein.

  9. Optional: Wenn Sie einen Proxy-Server für den Zugriff auf den Datenquellenserver verwenden, setzen Sie im Abschnitt Proxyeinstellungen den Schalter Proxy-Einstellungen aktivieren auf On. Fügen Sie Werte zu den folgenden Feldern hinzu:

    Benutzername
    Optional. Der Benutzername, den Sie zur Authentifizierung verwenden, wenn der Proxy-Server eine Authentifizierung erfordert. Wenn Sie Ihren Benutzernamen nicht kennen, können Sie ihn vom Administrator des Proxy-Servers erhalten.
    Kennwort
    Optional. Das Passwort, das Sie zur Authentifizierung verwenden, falls der Proxy-Server eine Authentifizierung erfordert. Wenn Sie Ihr Kennwort nicht kennen, können Sie es vom Administrator des Proxy-Servers erhalten.
    Hostname oder IP-Adresse des Proxyservers
    Der Hostname oder die IP-Adresse des Proxy-Servers.
    Portnummer des Proxy-Servers
    Der Netzwerkport, mit dem Sie sich auf dem Proxy-Server verbinden möchten.
  10. Optional. Wenn Sie die Sicherheit auf Dokumentebene aktivieren wollen, setzen Sie im Abschnitt Sicherheit den Schalter Sicherheit auf Dokumentebene aktivieren auf On.

    Wenn diese Option aktiviert ist, können Ihre Benutzer dieselben Inhalte durchsuchen und abfragen, auf die sie zugreifen können, wenn sie bei Box angemeldet sind. Weitere Informationen finden Sie unter Sicherheit auf Dokumentebene unterstützen.

  11. Wenn der Crawler Text aus Bildern auf der Site extrahieren soll, erweitern Sie Weitere Verarbeitungseinstellungenund legen Sie Optische Zeichenerkennung anwenden auf On fest.

    Wenn OCR aktiviert ist und Ihre Dokumente Bilder enthalten, dauert die Verarbeitung länger. Weitere Informationen finden Sie unter Optische Zeichenerkennung.

  12. Klicken Sie auf Beenden.

Die Objektgruppe wird schnell erstellt. Es dauert länger, bis die Daten verarbeitet werden, wenn sie der Objektgruppe hinzugefügt werden.

Wenn Sie den Fortschritt überprüfen möchten, rufen Sie die Seite 'Aktivität' auf. Klicken Sie im Navigationsfenster auf Sammlungen verwalten und anschließend auf, um die Sammlung zu öffnen.