veil

Leggi le controfirme dei testimoni

Leggi l’ultima controfirma conservata di ogni testimone configurato.

GET/{log}/witnesses
Accesso
Accesso pubblico
Client
Fetch dal browser supportato

Parametri#

NomePosizioneSignificato
logObbligatorioPercorsoIl nome del registro indicato da /v1/log, come staging-1.

Esempi di richiesta#

cURL
curl -fsS 'https://log.veil.rip/staging-1/witnesses'

Risposta#

HTTP 200application/json

JSON con origin, quorum e witnesses. Testimoni diversi possono avere firmato dimensioni diverse dell’albero.

CampoTipoSignificato
originstringOrigine del registro.
quorumintegerNumero di testimoni richiesto.
witnessesarray<LogWitness>Informazioni sul checkpoint firmato da ciascun testimone. Verificale usando la policy e le note firmate.

Apri un oggetto annidato per leggerne i campi. I tipi con null ammettono un valore null; i campi optional possono essere assenti. Gli altri campi sono presenti nell’oggetto.

Testimone del registro LogWitness
CampoTipoSignificato
namestringNome della chiave del testimone.
vkeystringChiave di verifica della nota firmata.
urlstringURL del servizio del testimone.
sizeintegerDimensione dell’albero controfirmata più recente; i testimoni possono essere a dimensioni diverse.
checkpointstringCheckpoint firmato associato a questo testimone.
cosignaturestringControfirma del testimone. Controllala usando la policy.
seenstringData e ora in cui il registro ha osservato questa risposta del testimone.

Intestazioni della risposta#

IntestazioneValoreSignificato
Content-Typeapplication/jsonUsa il tipo dichiarato per scegliere come leggere il corpo.

Cosa verificare#

Verifica ogni controfirma con la chiave attesa del testimone e il checkpoint che ha firmato.

Errori#

Il registro usa un proprio protocollo testuale o binario. Le risorse mancanti possono restituire HTTP 404; non presumere l’involucro JSON della rubrica. Guida a risposte ed errori