שיטה: פענוח מפתח פרטי

פתיחת האריזה של מפתח פרטי עטוף ואז מפענחת את המפתח להצפנת התוכן שמוצפן למפתח הציבורי.

בקשת HTTP

POST https://BASE_URL/privatekeydecrypt

מחליפים את BASE_URL בכתובת ה-URL הבסיסית.

פרמטרים של נתיב

ללא.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "authentication": string,
  "authorization": string,
  "algorithm": string,
  "encrypted_data_encryption_key": string,
  "rsa_oaep_label": string,
  "reason": string,
  "wrapped_private_key": string
}
שדות
authentication

string

JWT שהונפק על ידי ספק הזהויות (IdP) שמציין מי המשתמש. מידע נוסף זמין בקטע אסימונים לאימות.
authorization

string

JWT שטוען שהמשתמש מורשה לפתוח אריזה של מפתח עבור resource_name. למידע על אסימוני הרשאה
algorithm

string

האלגוריתם ששימש להצפנת מפתח הצפנת הנתונים (DEK) בהצפנת מעטפת.
encrypted_data_encryption_key

string (UTF-8)

מפתח להצפנת תוכן מוצפן בקידוד Base64, שמוצפן באמצעות המפתח הציבורי שמשויך למפתח הפרטי. גודל מקסימלי: 1KB.
rsa_oaep_label

string

תווית בקידוד Base64 L, אם האלגוריתם הוא RSAES-OAEP. אם האלגוריתם לא RSAES-OAEP, המערכת תתעלם מהשדה הזה.
reason

string (UTF-8)

מחרוזת JSON של העברה שמספקת הקשר נוסף לגבי הפעולה. יש למלא את קובץ ה-JSON שסופק לפני שהוא מוצג. גודל מקסימלי: 1KB.
wrapped_private_key

string

מפתח פרטי ארוז בקידוד base64. גודל מקסימלי: 8KB.

הפורמט של המפתח הפרטי או של המפתח הפרטי הארוז שלאחר מכן תלוי בהטמעה של שירות רשימת בקרת הגישה למפתחות (KACLS). בלקוח ובצד של Gmail, מדובר ב-blob אטום.

גוף התשובה

אם הפעולה מצליחה, השיטה הזו מחזירה מפתח להצפנת נתונים ב-base64.

אם הפעולה תיכשל, תוחזר תשובה על שגיאה מובנית.

ייצוג JSON 
{
  "data_encryption_key": string
}
שדות
data_encryption_key

string

מפתח להצפנת נתונים בקידוד base64.

דוגמה

בדוגמה הזו מופיעה בקשה ותגובה לדוגמה ל-method privatekeydecrypt.

בקשה

POST https://mykacls.example.org/v1/privatekeydecrypt

{
  "wrapped_private_key": "wHrlNOTI9mU6PBdqiq7EQA...",
  "encrypted_data_encryption_key": "dGVzdCB3cmFwcGVkIGRlaw...",
  "authorization": "eyJhbGciOi...",
  "authentication": "eyJhbGciOi...",
  "algorithm": "RSA/ECB/PKCS1Padding",
  "reason": "decrypt"
}

תשובה

{
  "data_encryption_key": "akRQtv3nr+jUhcFL6JmKzB+WzUxbkkMyW5kQsqGUAFc="
}