Sie können ein Verbindungsasset für den Zugriff auf Ihre Daten in Box erstellen.
Die Box-Plattform ist ein Cloud-Content-Management- und File-Sharing-Service.
Voraussetzungen
Angepasste App in Box erstellen
Bevor Sie eine Verbindung zu Box herstellen, erstellen Sie eine angepasste App in der Box Developer Console. Sie können eine App für den Zugriff auf Anwendungsebene erstellen, die Benutzer zum Freigeben von Dateien verwenden können, oder Sie können eine App für den unternehmensweiten Zugriff auf alle Benutzerkonten erstellen. Mit einem unternehmensweiten Zugriff müssen Benutzer keine Dateien und Ordner mit der Anwendung gemeinsam nutzen.
- Rufen Sie die Box Developer Consoleauf und folgen Sie dem Assistenten, um eine angepasste Appzu erstellen. Wählen Sie als Authentifizierungsmethode
OAuth 2.0 with JWT (Server Authentication)
aus. - Nehmen Sie auf der Seite Configuration folgende Auswahl vor. Behalten Sie anderenfalls die Standardeinstellungen bei.
- Wählen Sie eine der beiden Auswahlmöglichkeiten für App Access Level aus:
- Behalten Sie die Standardauswahl für App Access Only bei, um Zugriff auf von Benutzern gemeinsam genutzte Dateien zu ermöglichen.
- Wählen Sie App + Enterprise Access aus, um eine App mit unternehmensweitem Zugriff auf alle Benutzerkonten zu erstellen.
- Behalten Sie die Standardauswahl für App Access Only bei, um Zugriff auf von Benutzern gemeinsam genutzte Dateien zu ermöglichen.
- Klicken Sie unter Add and Manage Public Keys auf Generate a Public/Private Keypair. Für diese Auswahl ist es erforderlich, dass die Zwei-Faktor-Authentifizierung auf dem Box-Konto aktiviert ist, aber Sie können sie anschließend inaktivieren. Das generierte Schlüsselpaar erstellt eine Konfigurationsdatei (
*_config.json
), die Sie herunterladen können. Sie benötigen die Informationen in dieser Datei, um die Verbindung in Ihrem Projekt zu erstellen.
- Wählen Sie eine der beiden Auswahlmöglichkeiten für App Access Level aus:
- Wenn Sie App + Enterprise Access unter Advanced Features ausgewählt haben, wählen Sie die folgenden beiden Kontrollkästchen aus:
- Make API calls using the as-user header
- Benutzerzugriffstoken generieren
- Übergeben Sie die App-Client-ID zur Genehmigung an den Box-Unternehmensadministrator: Rufen Sie Ihre Anwendung in der Box Developer Console auf und wählen Sie in der linken Seitenleiste Ihrer Anwendung den Link Allgemein aus. Blättern Sie abwärts zum Abschnitt App Authorization.
Entschlüsseln eines privaten Schlüssels
Um einen privaten Schlüssel mit dem zugehörigen Kennwort zu entschlüsseln, führen Sie den folgenden Befehl aus. Bei diesem Prozess wird mit dem Befehl " openssl pkcs8
eine unverschlüsselte Version des privaten Schlüssels erzeugt.
openssl pkcs8 -in private_key.pem -passin file:pass.txt -out private_key_unencrypted.pem
Die verwendeten Parameter sind:
- private_key.pem
- Der verschlüsselte private Schlüssel, der von Box generiert und Ihnen zur Verfügung gestellt wurde.
- pass.txt
- Diese Datei enthält das Kennwort, das mit dem privaten Schlüssel verknüpft ist, der generiert und Ihnen von Box zur Verfügung gestellt wurde.
- private_key_unencrypted.pem
- Dies ist die Ausgabedatei, die nach Ausführung des Befehls den unverschlüsselten privaten Schlüssel enthält.
Je nach Position auf der Plattform geeignete Methode zum Erstellen einer Verbindung auswählen
- In einem Projekt
- Klicken Sie auf Assets > Neues Asset > Verbindung zu einer Datenquelle herstellen. Weitere Informationen finden Sie unter Verbindung zu einem Projekt hinzufügen.
- In einem Katalog
- Klicken Sie auf Zu Katalog hinzufügen > Verbindung. Weitere Informationen finden Sie unter Verbindungsasset zu einem Katalog hinzufügen.
- In einem Bereitstellungsbereich
- Klicken Sie auf Assets importieren > Datenzugriff > Verbindung. Siehe Datenassets zu einem Bereitstellungsbereich hinzufügen.
- Im Katalog der Plattformressourcen
- Klicken Sie auf Neue Verbindung. Weitere Informationen finden Sie unter Hinzufügen von Plattformverbindungen.
Box-Verbindung erstellen
Geben Sie die Werte aus der heruntergeladenen Konfigurationsdatei für diese Einstellungen ein:
- Client-ID
- Geheimer Clientschlüssel
- Unternehmens-ID
- Privater Schlüssel (ersetzen Sie jedes Vorkommen von
\n
durch einen Zeilenumbruch) - Kennwort für privaten Schlüssel (Wert von
passphrase
in der Konfigurationsdatei) - Öffentlicher Schlüssel (Wert von
publicKeyID
in der Konfigurationsdatei)
Unternehmensweite App
Wenn Sie eine App für unternehmensweiten Zugriff konfiguriert haben, geben Sie den Benutzernamen des Box-Benutzerkontos in das Feld Benutzername ein.
App auf Anwendungsebene
Benutzer müssen ihre Dateien explizit mit der E-Mail-Adresse der App teilen, damit die App auf die Dateien zugreifen kann.
Erstellen Sie einen REST-Aufruf an die Verbindung, um die E-Mail-Adresse der App zu ermitteln. Beispiel:
PUT https://api.dataplatform.cloud.ibm.com/v2/connections/{connection_id}/actions/get_user_info?project_id={project_id}
Anforderungshauptteil:
{}
Gibt Folgendes zurück:
{ "login_name": "[email protected]" }
Geben Sie die Dateien und Ordner in Box, auf die Sie von watsonx.ai Studio aus zugreifen möchten, mit dem Anmeldenamen frei, der vom REST-Aufruf zurückgegeben wurde.
Nächster Schritt: Fügen Sie Datenassets aus der Verbindung hinzu
Weitere Informationen finden Sie unter Daten aus einer Verbindung in einem Projekt hinzufügen.
Weitere Informationen finden Sie unter Daten aus einer Verbindung in einem Katalog hinzufügen.
Wo Sie diese Verbindung verwenden können
Sie können die Box-Verbindung in den folgenden Arbeitsbereichen und Tools verwenden:
Projekte
- Data Refinerywatsonx.ai Studio oder IBM Knowledge Catalog)
- DataStage (DataStage -Service) Siehe Verbindung zu einer Datenquelle in DataStage.
- Anreicherung von MetadatenIBM Knowledge Catalog)
- Metadata import (IBM Knowledge Catalog)
Kataloge
Platform assets catalog
Andere KatalogeIBM Knowledge Catalog)
Einschränkung
Wenn Sie Tausende von Dateien in einem Box-Ordner haben, ist die Verbindung möglicherweise nicht in der Lage, die Dateien vor einer Zeitlimitüberschreitung abzurufen. Jobs oder Profilermittlung, die die Box-Dateien verwenden, funktionieren möglicherweise nicht.
Problemumgehung: Reorganisieren Sie die Dateihierarchie in Box so, dass weniger Dateien in demselben Ordner vorhanden sind.
Unterstützte Dateitypen
Die Box-Verbindung unterstützt die folgenden Dateitypen: Avro, CSV, Text mit Trennzeichen, Excel, JSON, ORC, Parquet, SAS, SAV, SHP und XML.
Weitere Informationen
Verwaltung benutzerdefinierter Anwendungen
Übergeordnetes Thema: Unterstützte Verbindungen