পদ্ধতি: privilegedunwrap

Google থেকে রপ্তানি করা ডেটা ডিক্রিপ্ট করে বিশেষ সুবিধাপ্রাপ্ত প্রসঙ্গে। পূর্বে TakeoutUnwrap নামে পরিচিত। ডেটা এনক্রিপশন কী (DEK) ফেরত দেয় যা মূল নথি বা ফাইল অ্যাক্সেস কন্ট্রোল লিস্ট (ACL) চেক না করে wrap ব্যবহার করে মোড়ানো হয়েছিল। একটি উদাহরণ ব্যবহারের ক্ষেত্রে, দেখুন: Google Takeout ।

HTTP অনুরোধ

POST https:// KACLS_URL /privilegedunwrap

KACLS_URL কে কী অ্যাক্সেস কন্ট্রোল লিস্ট সার্ভিস (KACLS) URL দিয়ে প্রতিস্থাপন করুন।

পাথ প্যারামিটার

কোনোটিই নয়।

শরীরের অনুরোধ

অনুরোধের অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:

JSON প্রতিনিধিত্ব
{ "authentication": string, "reason": string, "resource_name": string, "wrapped_key": string }

ক্ষেত্র
authentication	string আইডিপি দ্বারা জারি করা একটি JWT নিশ্চিত করে যে ব্যবহারকারী কে। প্রমাণীকরণ টোকেন দেখুন।
reason	string (UTF-8) একটি পাসথ্রু JSON স্ট্রিং অপারেশন সম্পর্কে অতিরিক্ত প্রসঙ্গ প্রদান করে। প্রদত্ত JSON প্রদর্শিত হওয়ার আগে স্যানিটাইজ করা উচিত। সর্বোচ্চ আকার: 1 KB।
resource_name	string (UTF-8) DEK দ্বারা এনক্রিপ্ট করা বস্তুর জন্য একটি শনাক্তকারী। এই মানটি অবশ্যই কী মোড়ানোর জন্য ব্যবহৃত resource_name এর সাথে মেলে। সর্বোচ্চ আকার: 128 বাইট।
wrapped_key	string বেস64 বাইনারি অবজেক্টটি wrap মাধ্যমে ফিরে আসে।

প্রতিক্রিয়া শরীর

সফল হলে, এই পদ্ধতিটি নথির এনক্রিপশন কী ফেরত দেয়।

অপারেশন ব্যর্থ হলে, একটি কাঠামোগত ত্রুটি উত্তর ফেরত দেওয়া উচিত.

JSON প্রতিনিধিত্ব
{ "key": string }

ক্ষেত্র
key	string বেস64-এনকোডেড DEK।

উদাহরণ

এই উদাহরণটি privilegedunwrap পদ্ধতির জন্য একটি নমুনা অনুরোধ এবং প্রতিক্রিয়া প্রদান করে।

অনুরোধ

POST https://mykacls.example.com/v1/takeout_unwrap

{
   "wrapped_key": "7qTh6Mp+svVwYPlnZMyuj8WHTrM59wl/UI50jo61Qt/QubZ9tfsUc1sD62xdg3zgxC9quV4r+y7AkbfIDhbmxGqP64pWbZgFzOkP0JcSn+1xm/CB2E5IknKsAbwbYREGpiHM3nzZu+eLnvlfbzvTnJuJwBpLoPYQcnPvcgm+5gU1j1BjUaNKS/uDn7VbVm7hjbKA3wkniORC2TU2MiHElutnfrEVZ8wQfrCEpuWkOXs98H8QxUK4pBM2ea1xxGj7vREAZZg1x/Ci/E77gHxymnZ/ekhUIih6Pwu75jf+dvKcMnpmdLpwAVlE1G4dNginhFVyV/199llf9jmHasQQuaMFzQ9UMWGjA1Hg2KsaD9e3EL74A5fLkKc2EEmBD5v/aP+1RRZ3ISbTOXvxqYIFCdSFSCfPbUhkc9I2nHS0obEH7Q7KiuagoDqV0cTNXWfCGJ1DtIlGQ9IA6mPDAjX8Lg==",
   "authentication": "eyJhbGciOi…"
   "reason": "{client:'takeout' op:'read'}"
   "resource_name": "item123"
}

প্রতিক্রিয়া

{
    "key": "0saNxttLMQULfXuTbRFJzi/QJokN1jW16u0yaNvvLdQ="
}