FrejaEIDSignStatusValve

Checks the status of a sign request. Typically used with the sign API module.  Because of this, the data used is expected to come from the request. Not an item.

The valve will create an item if none is present.

For more detailed information see https://frejaeid.com/rest-api/Signature%20Service.html

Properties

Name Description Default value Mandatory Supports property expansion
keystoreID The id of the keystore in configuration Yes No
mode Decides the target endpoint to send teh request to. Allowed values are 'test_personal_sign,production_organisation_sign,production_personal_sign,test_organisation_sign,test_personal_sign'. Only one value is allowed. Yes No
customer Used for event logging to add differentiator if desired. No No

Example Configuration 

{
      "name" : "FrejaEIDSignStatusValve",
      "config" : {
        "keystoreID" : "93f5e7e1-c3f4-436b-9bbc-0b94d454a352",
        "mode" : "production_personal_sign"
      }
    }

In the example above {{item.uid}} will be fetched from the request.
This value will be set on the property user_data (as configured in the example above).

Requirements

  • The server trusts the Freja e-ID backend TLS certificate.
  • A client certificate & private key (keystore) thsat is issued by Freja e-ID is present in the configuration.

The incoming request must contain the following parameters:

  • signRef - The identifier of a sign request

Example request

{
   "signRef":"112233445566778899"
}

Response

Status and signRef is always returned. 

If approved,  ssn, givenName, sn, mail, organisationIdIdentifier is returned. Depending on the initiating request some attributes may be empty.

In addition the entire response is found in attribute fullResponse, Base64 encoded.