Zertifikate ​

Ein DAT-Zertifikat stellt Zeitraum, Algorithmen und Schlüssel für die Ausstellung und Prüfung von Tokens in einer einzigen Zeichenfolge dar.

cid
uint64
.
start
uint64
.
duration
uint64
.
ttl
uint64
.
sig-alg
name
.
crypto-alg
name
.
sig-key
Base64Url
.
crypto-key
Base64Url
Auch ein Zertifikat besteht aus durch Punkte getrennten ASCII-Feldern in fester Reihenfolge.
text
cid.start.duration.ttl.sig-alg.crypto-alg.sig-key.crypto-key

Zeitraum ​

  • Das Zertifikat kann von start bis start + duration DAT ausstellen. Beide Zeitpunkte sind eingeschlossen.
  • Ein ausgestellter DAT ist ab seiner Ausstellung für ttl gültig.
  • Das Zertifikat wird bis start + duration + ttl zur Prüfung benötigt. Auch genau zu diesem Zeitpunkt ist eine Prüfung möglich.

Wird ein Zertifikat unmittelbar nach Ende des Ausstellungszeitraums gelöscht, können bereits ausgestellte DAT nicht mehr geprüft werden. Manager und CMS behandeln Ausstellungsfähigkeit und Prüffähigkeit getrennt.

Zertifikat-ID und Schlüsselwechsel ​

cid ist der öffentliche Vertrag zur Identifikation von Schlüsseln und Zeitraum. Überschreiben Sie eine vorhandene cid niemals mit anderen Schlüsseln. Erstellen Sie für einen Schlüsselwechsel ein neues Zertifikat mit einer neuen cid. Dienste synchronisieren das neue Zertifikat vorab und entfernen das vorherige erst, wenn alle damit ausgestellten DAT abgelaufen sind.

Signaturalgorithmen ​

NameVerwendungZertifikat nur zur Prüfung
HMAC-SHA256-MFSHMAC SHA-256Nicht unterstützt
HMAC-SHA384-MFSHMAC SHA-384Nicht unterstützt
HMAC-SHA512-MFSHMAC SHA-512Nicht unterstützt
ECDSA-P256ECDSA P-256Unterstützt
ECDSA-P384ECDSA P-384Unterstützt
ECDSA-P521ECDSA P-521Unterstützt

HMAC verwendet denselben Schlüssel zum Signieren und Prüfen. Erhält ein Prüfdienst den Schlüssel, kann er deshalb ebenfalls Tokens ausstellen. Verwenden Sie in Umgebungen mit getrennter Ausstellungsberechtigung ECDSA und Zertifikate nur zur Prüfung.

Verschlüsselungsalgorithmen ​

NameSchlüssel
IV-AES128-GCMAES-128
IV-AES256-GCMAES-256

Die Algorithmusnamen sind Teil des wire-Vertrags. Sie werden nicht durch die in JWT verwendeten Aliasse ersetzt.

Vollständige Zertifikate und Zertifikate nur zur Prüfung ​

Ein vollständiges ECDSA-Zertifikat enthält den privaten Schlüssel zum Signieren. Ein Zertifikat nur zur Prüfung behält lediglich den öffentlichen ECDSA-Schlüssel, enthält aber weiterhin den AES-Schlüssel zur Entschlüsselung von secure. Ein reiner Prüfdienst kann DAT daher prüfen und entschlüsseln, aber keine neuen DAT ausstellen.