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
OAuth 2.0-Autorisierungscode	Benutzer meldet sich über Box an und gewährt API-Zugriff.	Zugriff einzelner Benutzer (Attended oder persönliche Automatisierung).
OAuth 2.0 Client-Anmeldeinformationen	Nicht interaktive Dienst-zu-Dienst-Authentifizierung.	Dienst-zu-Dienst-Zugriff innerhalb des Arbeitsbereichs des Benutzers.
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

OAuth 2.0-Autorisierungscode

Feld	Beschreibung
OAuth-API-Schlüssel	Box- Client-ID.
OAuth-API-Geheimnis	Box: Geheimer Clientschlüssel.
Umfang	Wählen Sie die in Ihrer Box-App konfigurierten Scopes aus.

OAuth 2.0 Client-Anmeldeinformationen

Feld	Beschreibung
OAuth-API-Schlüssel	Box-Client-ID.
OAuth-API-Geheimnis	Box: Geheimer Clientschlüssel.
Betrefftyp	"Enterprise" oder "User"
Unternehmens-ID/Benutzer-ID	Box Enterprise-ID oder Box-Benutzer-ID.
Umfang	Muss mit den in Box konfigurierten Scopes übereinstimmen.

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://{baseURL}/provisioning_/callback (z. B. https://cloud.uipath.com/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 Autorisierungscode und BYO-OAuth verwendet
   • OAuth 2.0 mit Client-Anmeldeinformationen → Wird für Client-Anmeldeinformationen-Flows 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ür Bring Your Own OAuth 2.0 App fügen Sie eine UiPath-Rückruf-URL zu Ihrer Box-App hinzu: https://{baseURL}/provisioning_/callback (z. B. https://cloud.uipath.com/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.