OAuth 2.0-Authentifizierung für Box einrichten

Die OAuth 2.0-Authentifizierung (OAUTH2) authentifiziert sich als Box-App im Namen eines bestimmten Benutzers mithilfe des OAuth 2.0 (3LO) -Flows. Der Connector crawlt die Inhalte, auf die der Benutzer zugreifen kann. Die OAuth 2.0-Authentifizierung ist benutzerspezifisch und unterstützt keine Zugriffskontrolle auf Dokumentebene (ACLs). Verwenden Sie sie nur, wenn die Authentifizierung mit Client Credentials Grant nicht möglich ist. Der Benutzer muss sich manuell anmelden, um Token zu generieren.

Wichtig

Um die Abfrageergebnisse nach Benutzerberechtigungen zu filtern, verwenden Sie stattdessen die Client Credentials Grant-Authentifizierung. Siehe Kundenanmeldedaten einrichten Authentifizierung für Box gewähren.

Schritt 1: Erstellen Sie die OAuth-App

1. Navigieren Sie zur Box Developer Console.

2. Wählen Sie Neue App erstellen.

3. Wählen Sie Benutzerauthentifizierung (OAuth 2.0) — App-Typ: Benutzer.

4. Benennen Sie die App und wählen Sie Erstellen.

Schritt 2: Konfigurieren Sie die Umleitungs-URI

Geben Sie unter OAuth 2.0-Weiterleitungs-URIs die Umleitungs-URL ein. Wenn Sie bereits über einen Weiterleitungsendpunkt verfügen, verwenden Sie ihn. Verwenden Sie andernfalls den folgenden Testendpunkt:

https://httpbin.org/anything

Wichtig

httpbin.orgist ein Test-Umleitungsendpunkt, der sich gut für die Generierung von Anmeldeinformationen eignet. Verwenden Sie es nicht in der Produktion.

Schritt 3: Inhaltsaktionen konfigurieren

Aktivieren Sie die beiden folgenden Inhaltsaktionen:

• Alle Dateien und Ordner lesen

• Alle Dateien und Ordner schreiben

Aktivieren Sie keine administrativen Aktionen oder den As-User-Header für OAuth 2.0. Es sind keine weiteren Einstellungen erforderlich.

Schritt 4: Generieren Sie das Zugriffstoken

1. Melden Sie sich beim Box-Konto des Benutzers an, den Sie crawlen möchten (in Ihrem Browser).

2. Navigieren Sie zur Autorisierungs-URL und your-client-id ersetzen Sie sie durch Ihre App-Client-ID und random-string durch einen beliebigen Wert:

   https://account.box.com/api/oauth2/authorize?response_type=code&client_id=your-client-id&state=random-string

3. Nach der Autorisierung werden Sie zu httpbin weitergeleitet. Kopieren Sie den code Wert aus der URL:

   https://httpbin.org/anything?state=your-state&code=auth-code

4. Führen Sie den folgenden Befehl aus, um den Code gegen Token auszutauschen:

   curl -i -X POST "https://api.box.com/oauth2/token" \
     -H "content-type: application/x-www-form-urlencoded" \
     -d "client_id=your-client-id" \
     -d "client_secret=your-client-secret" \
     -d "code=code-from-above" \
     -d "grant_type=authorization_code"

5. Die Antwort enthält access_token undrefresh_token. Kopiere beide.

Schritt 5: Erstellen Sie das Secrets Manager Manager-Geheimnis

Speichern Sie die Anmeldeinformationen in einem AWS Secrets Manager geheimen Ordner mit den folgenden Schlüssel-Wert-Paaren:

{
    "clientId": "your-client-id",
    "clientSecret": "your-client-secret",
    "accessToken": "your-access-token",
    "refreshToken": "your-refresh-token"
}

Erstellen Sie das Geheimnis mit dem: AWS Command Line Interface

aws secretsmanager create-secret \
  --name bedrock-box-oauth2-creds \
  --secret-string file://secret.json

Notieren Sie den geheimen ARN aus der Antwort. Sie verwenden es als DatenquellesecretArn.

Nächste Schritte

Nachdem Sie das Geheimnis gespeichert haben, erstellen Sie die Datenquelle mit der authType Einstellung aufOAUTH2. Siehe Eine Box-Datenquelle Connect.