Verbindung zu Box herstellen

Online bearbeiten

Box ist eine sichere, cloudbasierte Plattform für die gemeinsame Nutzung von Dateien und die Zusammenarbeit, mit der Teams Dokumente in Echtzeit erstellen, bearbeiten und verwalten können – jederzeit, überall und auf jedem Gerät.

Um Box mit IBM watsonx Orchestrate zu integrieren, müssen Sie eine sichere Verbindung herstellen, die eine nahtlose Kommunikation zwischen beiden Systemen ermöglicht. Allgemeine Hinweise zur Verwaltung von Integrationen finden Sie unter „Apps für vorgefertigte Agenten verbinden “.

Wichtig:

Standardmäßig ist Single Sign-On (SSO) für Ihre App deaktiviert. Informationen zur Aktivierung finden Sie unter „Single Sign-On für Anwendungen konfigurieren “.

Schritte zum Verbinden

Befolgen Sie die folgenden Schritte, um Box mit watsonx Orchestrate zu verbinden:

Gehen Sie zu „Verwalten“ > „Verbindungen“ und suchen Sie nach der Box-Verbindungs-ID.
Klicken Sie neben der entsprechenden Verbindungs-ID auf „Bearbeiten“.
Wählen Sie die von Ihrer Organisation verwendete Authentifizierungsmethode aus ( OAuth2.0 oder Schlüssel-Wert-Paar ).
Geben Sie die boxspezifischen Felder ein. Allgemeine Informationen zum Verbindungsablauf finden Sie auf der Seite „Apps für vorgefertigte Agenten verbinden “.
Führen Sie die Schritte zum Entwurf und zur Live-Einrichtung durch.
Speichern Sie die Verbindung und testen Sie sie, um sicherzustellen, dass Box erfolgreich verbunden ist.

Unterstützte Authentifizierungsmethoden

Box unterstützt in „ watsonx Orchestrate “ die folgenden Authentifizierungsmethoden:

OAuth 2.0 (Autorisierungscode) : Empfohlen für Produktionsverbindungen
Schlüssel-Wert-Paar (KVP) : Unterstützt für API-Schlüssel-basierte und Legacy-Szenarien

Hinweis:

Für Agenten, die nach September 2025 erstellt wurden, ist „ OAuth “ ( 2.0 ) die einzige von Box unterstützte Authentifizierungsmethode.

Verbindungs-ID

Verwenden Sie die folgenden Verbindungs-IDs, wenn Sie Ihre Box-Verbindung auf der Seite „Verbindungseinstellungen“ suchen. Informationen zum Suchen einer Verbindungs-ID und zum Öffnen einer Verbindung zum Bearbeiten finden Sie unter Verbinden von Apps für vorgefertigte Agenten.


Authentifizierungstyp	Verbindungs-ID
OAuth2 Autorisierungscode	`box_ibm_184bdbd3`
Schlüssel/Wert-Paar	`box_key_value_ibm_184bdbd3`

OAuth 2.0 Verbindungsdetails

Wenn Ihr Unternehmen die Authentifizierung über „ OAuth “ verwendet, legen Sie den Authentifizierungstyp auf „ OAuth2 -Autorisierungscode“ fest und füllen Sie die folgenden Felder aus:


Feld	Beschreibung
`server_url`	Die Basis URL des Box-API-Servers
`authorization_url`	Die URL, auf die Benutzer weitergeleitet werden, um den Zugriff zu autorisieren. Beispiel:`https://account.box.com/api/oauth2/authorize`
`token_url`	Der Endpunkt, der zum Austausch des Autorisierungscodes gegen einen Zugriffstoken verwendet wird. Beispiel:`https://api.box.com/oauth2/token`
`client_id`	Die Client-ID Ihrer Box-Anwendung aus der Box-Entwicklerkonsole
`client_secret`	Das Client-Geheimnis Ihrer Box-Anwendung in der Box-Entwicklerkonsole

Diese Werte finden Sie in der Dokumentation zur Box-Autorisierungs-API.

Verbindungsdetails für Schlüsselwertpaare

Wenn Ihre Organisation API-Schlüssel oder eine Legacy-Konfiguration verwendet, setzen Sie den Authentifizierungstyp auf „Schlüssel-Wert-Paar“ und fügen Sie jedes der folgenden Felder mit „Neues Feld hinzufügen“ hinzu:


Schlüssel	Beschreibung
`base_url`	Basis- URL en zu Ihrem Box-API-Endpunkt.
`token_url`	URL wird verwendet, um das Token „ OAuth “ zu erhalten. Beispiel:`https://api.box.com/oauth2/token`
`client_id`	Die Client-ID Ihrer Box-Anwendung
`client_secret`	Das Client-Geheimnis Ihrer Box-Anwendung
`subject_id`	Die Box-Benutzer- oder Unternehmens-ID, in deren Namen die Anwendung agiert
`subject_type`	Art des Themas (z. B. Nutzer oder Unternehmen)

Hinweis : Bei Verwendung von Schlüssel-Wert-Paaren werden nur Team-Anmeldedaten unterstützt.

Diese Werte finden Sie in der Dokumentation zur Box-Autorisierungs-API.

Nächste Schritte

Nachdem die Verbindung zu Ihrer App nun hergestellt ist, können Sie sie in „ watsonx Orchestrate “ nutzen.

Starten Sie einen Agenten in Orchestrate Chat, um Aufgaben mithilfe natürlicher Sprache auszuführen.
Verwenden Sie geeignete Tools, um anwendungsspezifische Aktionen auszuführen.