Rediriger vers la page de consentement

Il existe plusieurs façons d’amener le signataire à ouvrir la page de consentement. La signature s’inscrit généralement dans des services plus larges fournis par votre application ; nous supposons donc ici que, avant la signature, le signataire est déjà connecté à l’application demandeuse via son navigateur web.

Redirection HTTP

Supposons que le signataire soumette un formulaire dans l’application demandeuse avant de signer les documents :

<form action="https://my-company.com/sign" method="post" target="_top">
  <button>Signer les documents</button>
</form>

L’application demandeuse traite le formulaire en gérant la requête HTTP POST /sign, en provisionnant une demande de signature dans le Request Manager, puis renvoie une réponse de redirection HTTP :

HTTP/1.1 303 See Other
Location: https://evidence-manager.lex-persona.com/?requestToken=eyJhbGciOiJIUzI1NiJ9.eyJjbGllbnRJZCI6IjAxIiwiY29uc2VudFZlcnNpb24iOiJWMiIsInNhbHQiOiJKOXNVWlI2RiIsInJtVmVyc2lvbiI6InNncy1ybS13ZWJhcHA6MS4yMS4wLXRlc3QtY2ktMSIsInJlcXVlc3RIYXNoIjoiZThHbnduZ2RYTzl6WGV6OTlpTHJmK3JuVGZUTVdXcnlseXZHOVY0cUcvND0iLCJleHAiOjE3ODc2NjgwNzksImhhc09wdGltaXplZERUQlMiOnRydWV9.sQAnttEEE0iGaKjG_z23roMUZlFHm0N-AKc0ZRtVhxU#requestId=req_01_6V3nZjiXXcMkrtUwZy4Ljj2K

En conséquence, le signataire est redirigé vers la page de consentement immédiatement après avoir soumis le formulaire.

Redirection JavaScript

Si vous développez une application monopage (SPA), vous voudrez probablement utiliser AJAX pour provisionner la demande de signature et JavaScript pour effectuer la redirection. Voici un exemple de code pour ce faire :

<button onclick="sign()">Signer les documents</button>
<script>
  function sign() {
    var xhr = new XMLHttpRequest();
    xhr.open('POST', 'https://my-company.com/sign');
    xhr.send(...);
    // L'application demandeuse traite la requête HTTP `POST /sign`
    // en provisionnant la demande de signature, et renvoie l'URL
    // de la page de consentement dans le corps de la réponse HTTP
    xhr.onload = function () {
      if (xhr.status === 200) {
        // Effectuer la redirection
        window.location = xhr.responseText;
      }
    };
  }
</script>