تدوير مفتاح المصدر
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"
}المصدرون
تدوير المفتاح
ينشئ مفتاحًا بديلاً في نفس المصدر والبيئة، وينتهي صلاحية المفتاح القديم للإصدار الجديد. تحتفظ السجلات المخزنة الصادرة قبل تاريخ القطع بدعم التحقق ما لم يتم اختراق المفتاح أو إلغاؤه. يدعم التوليد المُدار Ed25519 و ES256 و ES384 و RS256 و RS512 و PS256 و PS512.
POST
/
v1
/
issuers
/
keys
/
{kid}
/
rotate
تدوير مفتاح المصدر
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"
}ينشئ مفتاحًا بديلاً لمفتاح نشط وينتهي صلاحية المفتاح القديم تلقائيًا للإصدار الجديد. يبقى البديل في نفس المصدر والبيئة. استخدم
يدعم التوليد المدار Ed25519 و ES256 و ES384 و RS256 و RS512 و PS256 و PS512. لاستيراد المفتاح العام، قم بتوفير
kid الذي تم إرجاعه صراحةً في طلبات السك اللاحقة؛ لا يتم تحويل المتصلين بصمت إلى مفتاح آخر.
إنشاء بديل
{"provider": "KMS", "alg": "ES256"}
kid و alg و public_key_b64url مع SubjectPublicKeyInfo المشفرة بـ DER كـ base64url غير مبطن. المواد العامة المستوردة وحدها لا يمكنها سك سجلات جديدة. راجع خوارزميات التوقيع.
السجلات الموجودة
يستخدم التحقق الطابع الزمني للإصدار المسجل. يمكن للسجلات الصادرة قبل تاريخ انتهاء صلاحية المفتاح القديم أن تجتاز التحقق من التوقيع بحمولتها الأصلية. يتم رفض المفتاح المخترق أو الملغى حتى للسجلات القديمة. لا يمكن استبدال الطوابع الزمنية الموثوقة المفقودة بتاريخ يوفره المتصل. يعيد النجاح HTTP 201 مع المفتاح البديل وrotated_from. لا يمكن تدوير المفتاح المتقاعد مرة أخرى. تستمر فحوصات انتهاء الصلاحية والإلغاء والتوقيع في التطبيق بشكل مستقل.الجسم
application/json
- Managed signing key
- Imported public verification key
الاستجابة
201 - application/json
تم تدوير المفتاح

