Box-Authentifizierung

UiPath unterstützt die folgenden Authentifizierungstypen für Box. Weitere Informationen finden Sie in der Dokumentation zur Box-Authentifizierung.

Authentifizierungstyp	Beschreibung	Am besten geeignet für
Bringen Sie Ihre eigene OAuth 2.0-App mit	Verwendet Ihre eigene OAuth-App mit der Rückruf-URL von UiPath.	Kunden, die ihre eigene Box-App und Schlüssel verwalten.
Persönliches Zugriffstoken (PAT)	Verwendet einen privaten Box JWT-Schlüssel und Unternehmens-/Benutzer-ID.	Server-zu-Server-Integrationen auf Unternehmensebene, die nur App- oder unternehmensweiten Zugriff ohne Benutzerinteraktion erfordern.

Details zu den Authentifizierungstypen

Bringen Sie Ihre eigene OAuth 2.0-App mit

Feld	Beschreibung
OAuth-API-Schlüssel	Box-Client-ID.
OAuth-API-Geheimnis	Box: Geheimer Clientschlüssel.
Umfang	Vordefinierte oder benutzerdefinierte Feld-Scopes.

Wichtig:

Konfigurieren Sie diesen Umleitungs-URI in Ihrer Box-App: https://{yourDomain}/provisioning_/callback.

Persönliches Zugriffstoken (PAT)

Feld	Beschreibung
OAuth-API-Schlüssel	Box- Client-ID von der Box-Entwicklerkonsole.
OAuth-API-Geheimnis	Geheimer Box-Client von der Box Developer Console.
Umfang	In Box ausgewählte Scopes, die für die Automatisierung erforderlich sind.
JWT: Zielgruppe	Beispiel: https://api.box.com/oauth2/token
JWT: Base64-codierter Schlüssel	Ihr Box-App- Base64-codierter privater Schlüssel aus der JWT-App-Konfiguration
JWT: Aussteller	Die Client-ID der Box-App, die als JWT iss -Anforderung verwendet wird.
JWT: Untertyp	Muss ein Unternehmen oder ein Benutzer sein, der auf dem gewünschten Identitätswechselziel basiert.
JWT: Antragsteller	Die Unternehmens-ID (wenn Untertyp = Enterprise) oder Benutzer-ID (wenn Untertyp = User).

Erstellen einer Box-App

Bevor Sie UiPath mit Box verbinden, müssen Sie eine Anwendung in der Box-Entwicklerkonsole erstellen . Weitere Informationen finden Sie in der Box-Entwicklerdokumentation.

1. Öffnen Sie die Entwicklerkonsole
2. Wählen Sie Neue App erstellen
3. Wählen Sie abhängig vom vorgesehenen Authentifizierungstyp eine der folgenden Optionen aus:
   • OAuth 2.0 (Benutzerauthentifizierung) → Wird für BYO-OAuth verwendet
   • OAuth 2.0 mit JWT → Wird für PAT in UiPath IS verwendet

Erfassen Sie nach dem Erstellen der Box-App Folgendes:

• Client-ID
• Geheimer Clientschlüssel
• App-Scopes
• Privater Schlüssel (nur JWT-Apps)
• Unternehmens-/Benutzer-ID

Wichtig:

Fügen Sie für Bring Your Own OAuth 2.0 App die Rückruf-URL von UiPath zu Ihrer Box-App hinzu: https://{yourDomain}/provisioning_/callback.

Grundlegendes zu Box-Scopes

Box erfordert eine explizite Berechtigungsauswahl, die als „Scopes“ bezeichnet wird. In der folgenden Tabelle sind die allgemeinen vordefinierten Scopes für Box-Apps aufgeführt.

Umfang	Beschreibung
Root_Schreibgeschützt	Schreibgeschützter Zugriff auf alle Inhalte, auf die der Benutzer/das Konto zugreifen kann.
Root_Readwrite	Vollständiger Lese-/Schreibzugriff auf Dateien und Ordner.
verwalten_Gruppen	Verwalten Sie Feldgruppen.
verwalten_Enterprise_properties	Verwalten von Unternehmensmetadaten und -eigenschaften.
verwaltete_Datenaufbewahrung	Konfigurieren Sie Aufbewahrungsrichtlinien und Aufbewahrungsrichtlinien.
sign_requests.readwrite	Erstellen und verwalten Sie Box Sign-Anforderungen.
verwalten_App_Benutzer	Verwalten Sie Anwendungsbenutzer.
verwalten_verwaltete_Benutzer	Verwalten Sie von Enterprise verwaltete Benutzer.

Ihre Box Developer Console muss die gleichen Scopes widerspiegeln, die Sie beim Erstellen der Verbindung auswählen. Weitere Informationen zu Scopes finden Sie in der Dokumentation zu Scopes in Box.

So bereiten Sie den privaten Box-Schlüssel vor

Schritt 1 – Herunterladen des privaten Schlüssels

Laden Sie die Box-App-JSON-Datei herunter, die den verschlüsselten_privaten_schlüssel und die passphrase enthält.

Schritt 2 – Entschlüsseln mit Passphrase

Wenn der Schlüssel verschlüsselt ist, entschlüsseln Sie ihn:

openssl pkcs8 -inform PEM -in private_key.pem -out decrypted_key.pem -passin pass:YOUR_PASSPHRASE

Dadurch wird Folgendes erzeugt:

-----BEGIN PRIVATE KEY-----
...
-----END PRIVATE KEY-----

Schritt 3: Entfernen Sie PEM-Header/-Fußzeilen

Löschen Sie diese beiden Zeilen vollständig:

-----BEGIN PRIVATE KEY-----
-----END PRIVATE KEY-----

Schritt 4 – Entfernen aller neuen Zeilen und Leerzeichen

Erstellen Sie den Schlüssel in einer einzelnen kontinuierlichen Zeile, ohne Leerzeichen und keine Zeilenumbrüche.

Beispiel für das Ergebnis: MIIG/wIBADANBgkqhkiG9w0BAQEFAASCBK...

Schritt 5 – Base64-codiert den bereinigten Schlüssel

Codieren Sie den einzeiligen Schlüssel:

Linux/maOS: echo -n "CLEANED_KEY" | base64

PowerShell: [Convert]::ToBase64String([Text.Encoding]::UTF8.GetBytes("CLEANED_KEY"))

Fügen Sie die resultierende Base64-Ausgabe ein in: JWT Base64 Encodierter Schlüssel. Weitere Informationen finden Sie in der Dokumentation zur Box-Authentifizierung.

Die Box-Verbindung hinzufügen

1. Wählen Sie Integration Service in der linken Leiste.
2. Wählen Sie in der Liste Konnektoren die Option Box aus. Sie können auch die Suchleiste verwenden, um den Connector einzugrenzen.
3. Wählen Sie Mit Box verbinden aus.
4. Sie werden nun zur Verbindungsseite weitergeleitet.
5. Geben Sie die erforderlichen Anmeldeinformationen ein.
6. Select Connect.

Berechtigungen

Konten müssen aktiviert sein, um auf Box zuzugreifen oder eine Verbindung damit herzustellen. Wenn dies nicht der Fall ist, wenden Sie sich an Ihren Administrator und fordern Sie den erforderlichen Zugriff an.

Mit Zugriff auf Ihr Box-Konto kann UiPath for Box Folgendes tun:

• Alle in Box gespeicherten Dateien und Ordner lesen
• Alle in Box gespeicherten Dateien und Ordner lesen und schreiben
• Gruppen verwalten
• Verwalten von Unternehmenseigenschaften
• Aufbewahrungsrichtlinien verwalten
• Integrationen aktivieren
• Verwalten von Signaturanforderungen
• App-Benutzer verwalten
• Benutzer verwalten
• Generieren von abrechenbaren Box Sign-Anforderungen.

Weitere Informationen finden Sie in der Dokumentation zur Box-Authentifizierung.