Faire pivoter la clé de l'émetteur
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"
}Émetteurs
Faire pivoter la clé
Crée une clé de remplacement dans le même émetteur et environnement, et expire l’ancienne clé pour les nouvelles émissions. Les enregistrements stockés émis avant la date limite conservent le support de vérification à moins que la clé ne soit compromise ou révoquée. La génération gérée prend en charge Ed25519, ES256, ES384, RS256, RS512, PS256 et PS512.
POST
/
v1
/
issuers
/
keys
/
{kid}
/
rotate
Faire pivoter la clé de l'émetteur
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"
}Crée une clé de remplacement pour une clé active et expire atomiquement l’ancienne clé pour les nouvelles émissions. Le remplacement reste dans le même émetteur et environnement. Utilisez son
La génération gérée prend en charge Ed25519, ES256, ES384, RS256, RS512, PS256 et PS512. Pour l’importation de clés publiques, fournissez
kid renvoyé explicitement dans les demandes de frappe ultérieures ; les appelants ne sont pas silencieusement basculés vers une autre clé.
Générer un remplacement
{"provider": "KMS", "alg": "ES256"}
kid, alg et public_key_b64url avec SubjectPublicKeyInfo DER encodé en base64url non rembourré. Le matériel public importé seul ne peut pas créer de nouveaux enregistrements. Voir algorithmes de signature.
Enregistrements existants
La vérification utilise l’horodatage d’émission enregistré. Les enregistrements émis avant la date limite de l’ancienne clé peuvent toujours passer la vérification de signature avec leur charge utile d’origine. Une clé compromise ou révoquée est rejetée même pour les enregistrements plus anciens. Les horodatages de confiance manquants ne peuvent pas être remplacés par une date fournie par l’appelant. Le succès renvoie HTTP 201 avec la clé de remplacement etrotated_from. Une clé retirée ne peut plus être renouvelée. Les vérifications d’expiration, de révocation et de signature des enregistrements continuent de s’appliquer indépendamment.Corps
application/json
- Managed signing key
- Imported public verification key
Réponse
201 - application/json
Clé tournée

