পদ্ধতি: ব্যক্তিগত কী ডিক্রিপ্ট

একটি মোড়ানো প্রাইভেট কী খুলে দেয় এবং তারপর পাবলিক কীতে এনক্রিপ্ট করা কন্টেন্ট এনক্রিপশন কীটি ডিক্রিপ্ট করে।

HTTP অনুরোধ

POST https:// KACLS_URL /privatekeydecrypt

KACLS_URL কী অ্যাক্সেস কন্ট্রোল লিস্ট সার্ভিস (KACLS) 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 যা ব্যবহারকারী কে তা নিশ্চিত করে। প্রমাণীকরণ টোকেন দেখুন।
authorization	string একটি JWT দাবি করছে যে ব্যবহারকারীকে resource_name এর জন্য একটি কী খুলতে অনুমতি দেওয়া হয়েছে। অনুমোদন টোকেন দেখুন।
algorithm	string এনভেলপ এনক্রিপশনে ডেটা এনক্রিপশন কী (DEK) এনক্রিপ্ট করার জন্য যে অ্যালগরিদম ব্যবহার করা হয়েছিল।
encrypted_data_encryption_key	string (UTF-8) Base64-এনকোডেড এনক্রিপ্টেড কন্টেন্ট এনক্রিপশন কী, যা প্রাইভেট কী-এর সাথে যুক্ত পাবলিক কী দিয়ে এনক্রিপ্ট করা হয়। সর্বোচ্চ আকার: 1 KB।
rsa_oaep_label	string যদি অ্যালগরিদমটি RSAES-OAEP হয়, তাহলে Base64-এনকোডেড লেবেল L। যদি অ্যালগরিদমটি RSAES-OAEP না হয়, তাহলে এই ক্ষেত্রটি উপেক্ষা করা হবে।
reason	string (UTF-8) একটি পাসথ্রু JSON স্ট্রিং যা অপারেশন সম্পর্কে অতিরিক্ত প্রসঙ্গ প্রদান করে। প্রদত্ত JSON প্রদর্শনের আগে স্যানিটাইজ করা উচিত। সর্বোচ্চ আকার: ১ KB।
wrapped_private_key	string base64-এনকোডেড মোড়ানো প্রাইভেট কী। সর্বোচ্চ আকার: 8 KB। প্রাইভেট কী বা র‍্যাপড প্রাইভেট কী-এর ফর্ম্যাট কী অ্যাক্সেস কন্ট্রোল লিস্ট সার্ভিস (KACLS) বাস্তবায়নের উপর নির্ভর করে। ক্লায়েন্ট এবং জিমেইল উভয় পক্ষের ক্ষেত্রে এটি একটি অস্বচ্ছ ব্লব হিসেবে বিবেচিত হয়।

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

সফল হলে, এই পদ্ধতিটি একটি base64 ডেটা এনক্রিপশন কী প্রদান করে।

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

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

ক্ষেত্র
data_encryption_key	string একটি base64-এনকোডেড ডেটা এনক্রিপশন কী।

উদাহরণ

এই উদাহরণে 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="
}