API e UI

Oltre alle API di "base" con le quali si può richiedere un certificato e gestirne il ciclo di vita, la Certification Authority fornisce anche una API e una UI per poter effettuare contestualmente l'identificazione e il rilascio di in certificato ad un titolare.

Metodo di innesco

Per avviare la sessione di identificazione e stacco occorre utilizzare il servizio:

Identificazione e stacco

Il servizio può essere invocato solo con un token TSID di tipo API: operando quindi all'interno di un determinato cliente.

I dati da passare sono del tipo:

{
  "profileName": "IE-SPID",
  "rao": {
    "certificatePin": "PinEsempio11",
    "alias": "RAOCST00A00A002A"
  },
  "owner": {
    "firstName": "Gaio Giulio",
    "lastName": "Cesare",
    "email": "a.mariano@teamsystem.com",
    "phoneNumber": "123456487",
    "fiscalCode": "CSRGGL44L13H501E"
  },
  "webhook": {
    "url": "{{webhookUrl}}"
  }
}

dove:

profileName è il nome del profilo da utilizzare per l'identificazione e l'enroll rao.alias è il RAO che autorizza l'emissione del certificato rao.certificateAlias è l'alias del certificato del RAO da utilizzare. Non è obbligatorio ed ha senso solo nel caso in cui il RAO avesse più di un certificato rao.certificatePin è il pin del certificato da utilizzare owner sono i dati di base del titolare. Sono tutti obbligatori ad eccezione del codice fiscale webhook.url è l'url cui il servizio comunicherà gli esiti dell'operazione. Il webhook verrà inviato:

in PUT in caso di esito positivo in DELETE in caso di esito negativo webhook.auth.header serve a definire l'header dove inserire un'eventuale authorization webhook.auth.value è il valore di un'eventuale authorization

La risposta sarà semplicemente un json con il valore della sessione appena avviata.

In background il sistema invierà una mail all'indirizzo fornito in input per procedere con l'identificazione.

Validazione campi in input

I dati relativi al titolare devono rispettare le reg exp che si possono scaricare da qui:

Validazione

Completamento operazione

Il titolare dovrò cliccare sul link ricevuto e seguire le operazioni richieste per identificarsi e procedere allo stacco del certificato.

Il sistema notificherà l'integratore tramite il webhook^^^