Ausstellerschlüssel rotieren
curl --request POST \
--url https://api.truthlocks.com/v1/issuers/keys/{kid}/rotate \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"provider": "KMS",
"kid": "<string>",
"public_key_b64url": "<string>"
}
'const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({provider: 'KMS', kid: '<string>', public_key_b64url: '<string>'})
};
fetch('https://api.truthlocks.com/v1/issuers/keys/{kid}/rotate', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.truthlocks.com/v1/issuers/keys/{kid}/rotate"
payload = {
"provider": "KMS",
"kid": "<string>",
"public_key_b64url": "<string>"
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.truthlocks.com/v1/issuers/keys/{kid}/rotate"
payload := strings.NewReader("{\n \"provider\": \"KMS\",\n \"kid\": \"<string>\",\n \"public_key_b64url\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"kid": "<string>",
"issuer_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"algorithm": "Ed25519",
"public_key": "<string>",
"status": "ACTIVE",
"not_before": "2023-11-07T05:31:56Z",
"expires_at": "2023-11-07T05:31:56Z"
}Aussteller
Schlüssel rotieren
Erstellt einen Ersatzschlüssel im selben Aussteller und in derselben Umgebung und lässt den alten Schlüssel für neue Ausstellungen ablaufen. Vor dem Stichtag ausgestellte gespeicherte Aufzeichnungen behalten die Verifizierungsunterstützung, es sei denn, der Schlüssel ist kompromittiert oder widerrufen. Die verwaltete Generierung unterstützt Ed25519, ES256, ES384, RS256, RS512, PS256 und PS512.
POST
/
v1
/
issuers
/
keys
/
{kid}
/
rotate
Ausstellerschlüssel rotieren
curl --request POST \
--url https://api.truthlocks.com/v1/issuers/keys/{kid}/rotate \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"provider": "KMS",
"kid": "<string>",
"public_key_b64url": "<string>"
}
'const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({provider: 'KMS', kid: '<string>', public_key_b64url: '<string>'})
};
fetch('https://api.truthlocks.com/v1/issuers/keys/{kid}/rotate', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.truthlocks.com/v1/issuers/keys/{kid}/rotate"
payload = {
"provider": "KMS",
"kid": "<string>",
"public_key_b64url": "<string>"
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.truthlocks.com/v1/issuers/keys/{kid}/rotate"
payload := strings.NewReader("{\n \"provider\": \"KMS\",\n \"kid\": \"<string>\",\n \"public_key_b64url\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"kid": "<string>",
"issuer_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"algorithm": "Ed25519",
"public_key": "<string>",
"status": "ACTIVE",
"not_before": "2023-11-07T05:31:56Z",
"expires_at": "2023-11-07T05:31:56Z"
}Erstellt einen Ersatzschlüssel für einen aktiven Schlüssel und lässt den alten Schlüssel für neue Ausstellungen atomar ablaufen. Der Ersatz bleibt im selben Aussteller und in derselben Umgebung. Verwenden Sie seine zurückgegebene
Die verwaltete Generierung unterstützt Ed25519, ES256, ES384, RS256, RS512, PS256 und PS512. Für den Import öffentlicher Schlüssel geben Sie
kid explizit in nachfolgenden Prägeanfragen; Aufrufer werden nicht stillschweigend auf einen anderen Schlüssel umgestellt.
Einen Ersatz generieren
{"provider": "KMS", "alg": "ES256"}
kid, alg und public_key_b64url mit DER SubjectPublicKeyInfo an, die als unpadded base64url kodiert sind. Importiertes öffentliches Material allein kann keine neuen Datensätze prägen. Siehe Signaturalgorithmen.
Bestehende Aufzeichnungen
Die Verifizierung verwendet den registrierten Ausstellungszeitstempel. Datensätze, die vor dem Stichtag des alten Schlüssels ausgestellt wurden, können die Signaturverifizierung weiterhin mit ihrer ursprünglichen Nutzlast bestehen. Ein kompromittierter oder widerrufener Schlüssel wird auch für ältere Datensätze abgelehnt. Fehlende vertrauenswürdige Zeitstempel können nicht durch ein vom Aufrufer bereitgestelltes Datum ersetzt werden. Bei Erfolg wird HTTP 201 mit dem Ersatzschlüssel undrotated_from zurückgegeben. Ein ausgemusterter Schlüssel kann nicht erneut rotiert werden. Ablauf-, Widerrufs- und Signaturprüfungen gelten weiterhin unabhängig voneinander.Autorisierungen
Body
application/json
- Managed signing key
- Imported public verification key
Antwort
201 - application/json
Schlüssel rotiert

