Vai al contenuto
Desktop e web
/
/Card

Namirial Sign API Service (2.0.0)

Namirial Sign: API Service

API Service è un servizio locale che espone un insieme di API utilizzate per la firma, l'autenticazione e il recupero delle informazioni di base sui certificati locali/di sistema, consentendo l'utilizzo di tali funzionalità da parte di applicazioni di terze parti.

Configurazione della porta

API Service si mette in ascolto su una porta configurabile nelle impostazioni di Namirial Sign. La porta predefinita è 11543. Una volta configurata la porta, qualsiasi applicazione di terze parti dovrà essere configurata per inviare richieste a tale porta.

Scarica la descrizione OpenAPI
apiservice.json
apiservice.yaml
Lingue
Server
Endpoint locale predefinito di API Service
https://127.0.0.1:11543

Service

Endpoint per stato e ciclo di vita del servizio

Operazioni

Card

Informazioni sulla smart card e sul titolare

Operazioni

Verifica la disponibilità di una smart card o di un lettore

Richiesta

Verifica la presenza di una smart card o di un lettore. Se sono presenti più lettori, viene considerato solamente il primo. Restituisce inoltre lo stato di validità del PIN e del PUK quando disponibile.

curl -i -X GET \
  https://127.0.0.1:11543/isValidCard

Risposte

Stato di rilevamento e validazione della smartcard.

Corpoapplication/json
cardstringobbligatorio
Enum"detected""undetected"
labelstringobbligatorio
certifiedbooleanobbligatorio
pin_statusstring or nullobbligatorio
Esempio: "pin_ok"
puk_statusstring or nullobbligatorio
Esempio: "puk_ok"
Risposta
application/json
{
  "card": "detected",
  "label": "DigitalDNA",
  "certified": true,
  "pin_status": "pin_ok",
  "puk_status": "puk_ok"
}

Ottieni i dati del titolare dalla smart card

Richiesta

Recupera i dati del titolare dalla smart card. Se sono presenti più smart card, viene considerata solamente la prima.

curl -i -X GET \
  https://127.0.0.1:11543/getCardholder

Risposte

Stringa del soggetto associato al titolare.

Corpoapplication/json
cardholderstringobbligatorio
Risposta
application/json
{
  "cardholder": "CN=example.com,OU=Example Unit,O=Example Organization,L=Rome,S=Italy,C=IT"
}

Certificates

Individuazione e reportistica dei certificati

Operazioni

Signing

Endpoint per firma di file remoti, upload e hash

Operazioni