שיטה: Privatekeysign

פותח את האריזה של מפתח פרטי ארוז ולאחר מכן חותם על התקציר שסופק על ידי הלקוח.

בקשת HTTP

POST https://BASE_URL/privatekeysign

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

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

ללא.

גוף הבקשה

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

ייצוג JSON 
{
  "authentication": string,
  "authorization": string,
  "algorithm": string,
  "digest": string,
  "rsa_pss_salt_length": integer,
  "reason": string,
  "wrapped_private_key": string
}
שדות
authentication

string

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

string

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

string

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

string

תקציר הודעות בקידוד Base64. התקציר של SignedAttributes בקידוד DER. לא בוצעה הוספה של ערך זה. גודל מקסימלי: 128B
rsa_pss_salt_length

integer

(אופציונלי) אורך ה-salt לשימוש, אם אלגוריתם החתימה הוא RSASSA-PSS. אם אלגוריתם החתימה אינו RSASSA-PSS, המערכת תתעלם מהשדה הזה.
reason

string (UTF-8)

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

string

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

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

גוף התשובה

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

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

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

string

חתימה בקידוד base64.

דוגמה

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

בקשה

{
  "wrapped_private_key": "wHrlNOTI9mU6PBdqiq7EQA...",
  "digest": "EOBc7nc+7JdIDeb0DVTHriBAbo/dfHFZJgeUhOyo67o=",
  "authorization": "eyJhbGciOi...",
  "authentication": "eyJhbGciOi...",
  "algorithm": "SHA256withRSA",
  "reason": "sign"
}

תשובה

{
  "signature": "LpyCSy5ddy82PIp/87JKaMF4Jmt1KdrbfT1iqpB7uhVd3OwZiu+oq8kxIzB7Lr0iX4aOcxM6HiUyMrGP2PG8x0HkpykbUKQxBVcfm6SLdsqigT9ho5RYw20M6ZXNWVRetFSleKex4SRilTRny38e2ju/lUy0KDaCt1hDUT89nLZ1wsO3D1F3xk8J7clXv5fe7GPRd1ojo82Ny0iyVO7y7h1lh2PACHUFXOMzsdURYFCnxhKAsadccCxpCxKh5x8p78PdoenwY1tnT3/X4O/4LAGfT4fo98Frxy/xtI49WDRNZi6fsL6BQT4vS/WFkybBX9tXaenCqlRBDyZSFhatPQ=="
}