পদ্ধতি: মোড়ানো

এনক্রিপ্ট করা ডেটা এনক্রিপশন কী (DEK) এবং সংশ্লিষ্ট ডেটা ফেরত দেয়।

আরও বিস্তারিত জানার জন্য, ডেটা এনক্রিপ্ট এবং ডিক্রিপ্ট দেখুন।

HTTP অনুরোধ

POST https:// KACLS_URL /wrap

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

পথের পরামিতি

কোনোটিই নয়।

অনুরোধের মূল অংশ

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

JSON উপস্থাপনা
{ "authentication": string, "authorization": string, "key": string, "reason": string }

ক্ষেত্র
authentication	string ব্যবহারকারী কে তা নিশ্চিত করে আইডিপি কর্তৃক জারি করা একটি JWT। প্রমাণীকরণ টোকেন দেখুন।
authorization	string একটি JWT দাবি করছে যে ব্যবহারকারীকে resource_name এর জন্য একটি কী মোড়ানোর অনুমতি দেওয়া হয়েছে। অনুমোদন টোকেন দেখুন।
key	string বেস৬৪-এনকোডেড DEK। সর্বোচ্চ আকার: ১২৮ বাইট।
reason	string (UTF-8) একটি পাসথ্রু JSON স্ট্রিং যা অপারেশন সম্পর্কে অতিরিক্ত প্রসঙ্গ প্রদান করে। প্রদত্ত JSON প্রদর্শনের আগে স্যানিটাইজ করা উচিত। সর্বোচ্চ আকার: ১ KB।

প্রতিক্রিয়া মূল অংশ

যদি সফল হয়, তাহলে এই পদ্ধতিটি একটি অস্বচ্ছ বাইনারি অবজেক্ট ফেরত পাঠাবে যা Google Workspace এনক্রিপ্ট করা অবজেক্টের সাথে সংরক্ষণ করবে এবং পরবর্তী যেকোনো কী আনর্যাপিং অপারেশনে যেমন আছে তেমনই পাঠানো হবে।

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

বাইনারি অবজেক্টে এনক্রিপ্ট করা DEK-এর একমাত্র কপি থাকা উচিত, বাস্তবায়ন-নির্দিষ্ট ডেটা এতে সংরক্ষণ করা যেতে পারে।

DEK কে Key Access Control List Service (KACLS) সিস্টেমে সংরক্ষণ করবেন না, বরং এটিকে এনক্রিপ্ট করুন এবং wrapped_key অবজেক্টে ফেরত দিন। এটি ডকুমেন্ট এবং এর কীগুলির মধ্যে আজীবন অসঙ্গতি রোধ করে। উদাহরণস্বরূপ, ব্যবহারকারীর অনুরোধের সময় তার ডেটা সম্পূর্ণরূপে মুছে ফেলা হয়েছে কিনা তা নিশ্চিত করা, অথবা ব্যাকআপ থেকে পুনরুদ্ধার করা পূর্ববর্তী সংস্করণগুলি ডিক্রিপ্টেবল কিনা তা নিশ্চিত করা।

দ্রষ্টব্য: বস্তু মুছে ফেলা হলে Google KACLS-এ মুছে ফেলার অনুরোধ পাঠায় না।

JSON উপস্থাপনা
{ "wrapped_key": string }

ক্ষেত্র
wrapped_key	string বেস৬৪-এনকোডেড বাইনারি অবজেক্ট। সর্বোচ্চ আকার: ১ কিলোবাইট।

উদাহরণ

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

অনুরোধ

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

{
   "key":"wHrlNOTI9mU6PBdqiq7EQA==",
   "authorization": "eyJhbGciOi…"
   "authentication": "eyJhbGciOi…"
   "reason": "{client:'drive' op:'update'}"
}

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

{
    "wrapped_key": "3qTh6Mp+svPwYPlnZMyuj8WHTrM59wl/UI50jo61Qt/QubZ9tfsUc1sD62xdg3zgxC9quV4r+y7AkbfIDhbmxGqP64pWbZgFzOkP0JcSn+1xm/CB2E5IknKsAbwbYREGpiHM3nzZu+eLnvlfbzvTnJuJwBpLoPYQcnPvcgm+5gU1j1BjUaNKS/uDn7VbVm7hjbKA3wkniORC2TU2MiHElutnfrEVZ8wQfrCEpuWkOXs98H8QxUK4pBM2ea1xxGj7vREAZZg1x/Ci/E77gHxymnZ/ekhUIih6Pwu75jf+dvKcMnpmdLpwAVlE1G4dNginhFVyV/199llf9jmHasQQuaMFzQ9UMWGjA1Hg2KsaD9e3EL74A5fLkKc2EEmBD5v/aP+1RRZ3ISbTOXvxqYIFCdSFSCfPbUhkc9I2nHS0obEH7Q7KiuagoDqV0cTNXWfCGJ1DtIlGQ9IA6mPDAjX8Lg=="
}