Instructie
Moeilijkheidsgraad:
Beheer > Integraties > Box.com
Box.com-koppeling instellen: stappen aan de Box- en i-Reserve-kant
De Box.com-koppeling vereist configuratie aan twee kanten: eerst een JWT-app in de Box Developer Console (en autorisatie in de Box Admin Console), daarna de koppeling zelf in i-Reserve.
1. Aan de Box-kant
1.1 JWT-app aanmaken
- Open de Box Developer Console en maak een app met Server Authentication (with JWT).
- Genereer een key pair: download de private key (PEM) en noteer de public key-id en de passphrase.
- Noteer de client-id en het client-secret.
1.2 App autoriseren in de Admin Console
- Geef de app de benodigde scopes, onder andere: sign-verzoeken aanmaken/lezen, bestanden uploaden/lezen, mappen lezen en webhooks beheren (Box Sign-bundel).
- Autoriseer de app in de Box Admin Console (Apps → Custom Apps Manager → app autoriseren op het client-id).
- Noteer de Enterprise ID (Admin Console → Account & Billing).
De webhook op de Box-map wordt door i-Reserve automatisch aangemaakt bij een succesvolle verbinding.
2. Aan de i-Reserve-kant
Ga naar Beheer → Integraties en voeg een Box.com-koppeling toe.
2.1 Authenticatie-scherm
| Veld | Wat in te vullen |
|---|---|
| Client ID / Client secret | Van de JWT-app uit de Box Developer Console. |
| Public key-id | De id van het gegenereerde key pair. |
| Private key | De RSA private key in PEM-formaat (meerdere regels). |
| Passphrase | De passphrase die de private key beschermt. |
| Enterprise ID | De Box Enterprise ID. |
Klik op Authenticatie aanvragen: i-Reserve haalt een JWT-token op, toont de gekoppelde Box-gebruiker en maakt de i-Reserve-map + webhook aan.
2.2 Configuratie-scherm
| Veld | Wat in te vullen |
|---|---|
| As user | (Optioneel) De Box-gebruiker als wie de sign-verzoeken worden aangemaakt. |
| Mapnaam | De naam van de Box-map waarin sign-verzoeken/documenten worden bewaard. |
| Redirect-URL | (Optioneel) De URL waarnaar de klant na ondertekenen wordt teruggestuurd. |
| Eindkopie-ontvanger | (Optioneel) E-mailadres dat de getekende eindkopie ontvangt. |
| Ordersjablonen | De PDF-sjablonen die bij “handtekening aanvragen” worden gegenereerd en verstuurd. |
| Orderveld voor sign-request-id | Het orderveld waarin het Box sign-request-id wordt bewaard (cruciaal voor de webhook-koppeling). |
2.3 Activeren
Sla op en zet de koppeling op actief. Test door een order naar de status “handtekening aanvragen” te brengen en te controleren dat het sign-verzoek bij de klant aankomt en de webhook de status terugmeldt.
Zonder geselecteerde ordersjablonen wordt er bij "handtekening aanvragen" geen sign-verzoek aangemaakt (stille no-op). Selecteer dus minstens een PDF-sjabloon en stel het orderveld voor het sign-request-id in.
De private key moet exact als PEM (meerdere regels) worden geplakt en de app moet in de Box Admin Console zijn geautoriseerd; anders mislukt de JWT-authenticatie. De webhook-URL die Box terugbelt moet publiek bereikbaar zijn.
