Rotar clave de emisor
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"
}Emisores
Rotar clave
Crea una clave de reemplazo en el mismo emisor y entorno, y expira la clave antigua para una nueva emisión. Los registros almacenados emitidos antes del corte conservan el soporte de verificación a menos que la clave se vea comprometida o revocada. La generación gestionada admite Ed25519, ES256, ES384, RS256, RS512, PS256 y PS512.
POST
/
v1
/
issuers
/
keys
/
{kid}
/
rotate
Rotar clave de emisor
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"
}Crea una clave de reemplazo para una clave activa y expira atómicamente la clave antigua para una nueva emisión. El reemplazo permanece en el mismo emisor y entorno. Utilice su
La generación gestionada admite Ed25519, ES256, ES384, RS256, RS512, PS256 y PS512. Para la importación de claves públicas, proporcione
kid devuelto explícitamente en las solicitudes de acuñación posteriores; los llamadores no se cambian silenciosamente a otra clave.
Generar un reemplazo
{"provider": "KMS", "alg": "ES256"}
kid, alg y public_key_b64url con SubjectPublicKeyInfo DER codificado como base64url sin relleno. El material público importado por sí solo no puede acuñar nuevos registros. Consulte algoritmos de firma.
Registros existentes
La verificación utiliza la marca de tiempo de emisión registrada. Los registros emitidos antes del corte de la clave antigua aún pueden pasar la verificación de firma con su carga útil original. Una clave comprometida o revocada se rechaza incluso para registros más antiguos. Las marcas de tiempo confiables faltantes no pueden reemplazarse con una fecha proporcionada por el llamante. El éxito devuelve HTTP 201 con la clave de reemplazo yrotated_from. Una clave retirada no se puede rotar de nuevo. Las comprobaciones de caducidad, revocación y firma de registros continúan aplicándose de forma independiente.Cuerpo
application/json
- Managed signing key
- Imported public verification key
Respuesta
201 - application/json
Clave rotada

