Kundenanmeldedaten einrichten Authentifizierung für Box gewähren

Die Client Credentials Grant (CCG) -Authentifizierung ist die empfohlene Authentifizierungsmethode für eine Box-Datenquelle. Der Connector authentifiziert sich mithilfe des Client Credentials Grant (2LO) -Flow als Box-App mit einem Dienstkonto (kein Benutzer), das alle Unternehmensinhalte crawlt, und ohne interaktive Anmeldung. Dies ist die einzige Authentifizierungsmethode, die die Zugriffskontrolle auf Dokumentebene (ACLs) unterstützt. Verwenden Sie es für die meisten Bereitstellungen.

Schritt 1: Erstellen Sie die Box-App

1. Navigieren Sie zur Box Developer Console.

2. Wählen Sie Neue App erstellen.

3. Wählen Sie unter Authentifizierungsmethode die Option Serverauthentifizierung aus.

4. Wählen Sie Client Credentials Grant aus (von Box als empfohlen markiert).

5. Geben Sie der App einen Namen und wählen Sie Erstellen. Sie werden zur Konfigurationsseite weitergeleitet.

Schritt 2: App-Berechtigungen konfigurieren

Zugriffsebene — Wählen Sie unter App-Zugriffsebene die Option App + Enterprise Access aus.

Wichtig

Ohne App + Enterprise-Zugriff kann das Dienstkonto nicht alle Unternehmensdaten anzeigen und der Connector kann nicht gecrawlt werden.

Inhaltsaktionen (erforderlich) — Aktivieren Sie die beiden folgenden Optionen:

• Alle Dateien und Ordner lesen

• Alle Dateien und Ordner schreiben

Wichtig

Box behandelt Downloads als Schreibinteraktion, sodass Write auch für Nur-Lese-Crawling erforderlich ist.

Administrative Aktionen — Aktivieren Sie die beiden folgenden Optionen:

• Verwalten von Benutzern

• Gruppen verwalten

Anmerkung

Für die Unterstützung der Zugriffskontrolle auf Dokumentenebene (ACL) sind administrative Maßnahmen erforderlich. Wenn Sie keine ACLs benötigen, können Sie sie weglassen. Box bietet nur den vollständigen Verwaltungsberechtigungssatz — es gibt keine schreibgeschützte Option.

Zusätzliche Konfiguration — Aktivieren Sie die Option API-Aufrufe über den As-User-Header tätigen. Auf diese Weise kann der Connector als einzelne Benutzer delegieren und Inhalte pro Benutzer crawlen. Lassen Sie die Option Benutzerzugriffstoken generieren deaktiviert.

Schritt 3: Anmeldeinformationen speichern und sammeln

1. Wählen Sie Speichern. Sie sehen eine Bestätigung, dass die App-Einstellungen erfolgreich gespeichert wurden.

2. Kopieren Sie im rechten Bereich (App-Details > Zugriff) die Client-ID.

3. Wählen Sie „Geheimes Konto abrufen“, um das Kundengeheimnis aufzudecken, und kopieren Sie es anschließend.

   Anmerkung

   Das Client-Geheimnis wird nach der Erstellung nicht automatisch angezeigt. Sie müssen Fetch Secret wählen, um es zu enthüllen. Tun Sie dies unmittelbar nach dem Speichern, bevor Sie die Seite verlassen.

4. Scrollen Sie im rechten Bereich nach unten zu Eigenschaften und sammeln Sie die Benutzer-ID (ccgUserId) und die Unternehmens-ID (enterpriseId).

Schritt 4: Autorisieren Sie die App

Nach dem Speichern wird im Statusbereich auf der rechten Seite Autorisierung: Nicht eingereicht mit der Schaltfläche Autorisieren angezeigt.

1. Wählen Sie Autorisieren aus, um das Dokument zur Überprüfung durch den Administrator einzureichen.

2. Ein Unternehmensadministrator muss die App genehmigen, bevor sie verwendet werden kann.

Wichtig

Die App funktioniert erst, wenn die Administratorautorisierung erteilt wurde. Nicht übermittelt bedeutet, dass die App zur Laufzeit fehlschlägt.

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",
    "enterpriseId": "your-enterprise-id",
    "ccgUserId": "your-user-id"
}

Geheime CCG-Felder

Feld	Description
clientId	App-Client-ID aus dem Bereich Access (rechter Bereich).
clientSecret	Wird angezeigt, wenn Sie nach dem Speichern der App Fetch Secret wählen.
enterpriseId	Aus dem Eigenschaftenbereich. Identifiziert die Box Enterprise-Instanz, die gecrawlt werden soll.
ccgUserId	Aus dem Eigenschaftenbereich. Überprüft, ob die Anmeldeinformationen als Benutzer delegiert werden können.

Erstellen Sie das Geheimnis mit dem: AWS Command Line Interface

aws secretsmanager create-secret \
  --name bedrock-box-ccg-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 aufCCG. Siehe Eine Box-Datenquelle Connect. Informationen zum Filtern von Abfrageergebnissen nach Benutzerberechtigungen finden Sie unterDocument-level Zugriffskontrollen.