Box-Verbindung

Angepasste App in Box erstellen

Vor der Erstellung einer Verbindung zu Box müssen Sie eine angepasste App in Box Developer Console erstellen. Sie können eine App für Zugriff auf Anwendungsebene erstellen, die Benutzer für gemeinsame Dateinutzung verwenden können, oder Sie können eine App für unternehmensweiten Zugriff auf alle Benutzerkonten erstellen. Bei unternehmensweitem Zugriff brauchen Benutzer Dateien und Ordner nicht mit der Anwendung gemeinsam nutzen.

1. Rufen Sie die Box Developer Consoleauf und folgen Sie dem Assistenten, um eine angepasste Appzu erstellen. Wählen Sie für Authentication Method die Option OAuth 2.0 with JWT (Server Authentication) aus.
2. Nehmen Sie auf der Seite Configuration folgende Auswahl vor. Behalten Sie andernfalls die Standardeinstellungen bei.
   1. 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.
        
   2. Klicken Sie unter Add and Manage Public Keys auf Generate a Public/Private Keypair. Bei dieser Auswahl muss für das Box-Konto Zwei-Faktor-Authentifizierung aktiviert sein, die Sie nach dem Abschluss dieses Vorgangs inaktivieren können. 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.
3. 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
4. Ü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 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 die folgenden 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.

1. Führen Sie einen REST-Aufruf für die Verbindung durch, um die App-E-Mail-Adresse 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]"
   }
   

2. 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.