Box.com-Verbindung einrichten: Schritte auf der Box- und der i-Reserve-Seite
Die Box.com-Verbindung erfordert eine Konfiguration auf zwei Seiten: zunächst eine JWT-App in der Box Developer Console (und die Autorisierung in der Box Admin Console), anschließend die Verbindung selbst in i-Reserve.
1. Auf der Box-Seite
1.1 JWT-App erstellen
- Öffnen Sie die Box Developer Console und erstellen Sie eine App mit Server Authentication (with JWT).
- Generieren Sie ein Key Pair: laden Sie den Private Key (PEM) herunter und notieren Sie die Public-Key-ID und die Passphrase.
- Notieren Sie die Client-ID und das Client-Secret.
1.2 App in der Admin Console autorisieren
- Geben Sie der App die erforderlichen Scopes, unter anderem: Sign-Anforderungen erstellen/lesen, Dateien hochladen/lesen, Ordner lesen und Webhooks verwalten (Box Sign-Bundle).
- Autorisieren Sie die App in der Box Admin Console (Apps → Custom Apps Manager → App über die Client-ID autorisieren).
- Notieren Sie die Enterprise ID (Admin Console → Account & Billing).
Der Webhook auf dem Box-Ordner wird von i-Reserve bei einer erfolgreichen Verbindung automatisch erstellt.
2. Auf der i-Reserve-Seite
Gehen Sie zu Verwaltung → Integrationen und fügen Sie eine Box.com-Verbindung hinzu.
2.1 Authentifizierungs-Bildschirm
| Feld | Was einzutragen ist |
|---|---|
| Client ID / Client secret | Von der JWT-App aus der Box Developer Console. |
| Public-Key-ID | Die ID des generierten Key Pairs. |
| Private Key | Der RSA Private Key im PEM-Format (mehrere Zeilen). |
| Passphrase | Die Passphrase, die den Private Key schützt. |
| Enterprise ID | Die Box Enterprise ID. |
Klicken Sie auf Authentifizierung anfordern: i-Reserve holt einen JWT-Token ab, zeigt den verbundenen Box-Benutzer an und erstellt den i-Reserve-Ordner + Webhook.
2.2 Konfigurations-Bildschirm
| Feld | Was einzutragen ist |
|---|---|
| As user | (Optional) Der Box-Benutzer, als der die Sign-Anforderungen erstellt werden. |
| Ordnername | Der Name des Box-Ordners, in dem Sign-Anforderungen/Dokumente aufbewahrt werden. |
| Redirect-URL | (Optional) Die URL, an die der Kunde nach dem Unterschreiben zurückgesendet wird. |
| Endkopie-Empfänger | (Optional) E-Mail-Adresse, die die unterschriebene Endkopie erhält. |
| Auftragsvorlagen | Die PDF-Vorlagen, die bei “Unterschrift anfordern” generiert und versendet werden. |
| Auftragsfeld für Sign-Request-ID | Das Auftragsfeld, in dem die Box Sign-Request-ID aufbewahrt wird (entscheidend für die Webhook-Verbindung). |
2.3 Aktivieren
Speichern Sie und setzen Sie die Verbindung auf aktiv. Testen Sie, indem Sie einen Auftrag in den Status “Unterschrift anfordern” bringen und überprüfen, dass die Sign-Anforderung beim Kunden ankommt und der Webhook den Status zurückmeldet.
