ব্যবহারকারীর ব্যক্তিগত কী মোড়ানো। এটি একটি বিশেষাধিকারপ্রাপ্ত অপারেশন, এবং শুধুমাত্র অনুমোদিত কী অ্যাক্সেস কন্ট্রোল লিস্ট সার্ভিস (KACLS) প্রশাসকরা এটি সম্পাদন করতে পারেন। এই API ঐচ্ছিক। Google বা Gmail ক্লায়েন্ট কেউই এই API কল করে না। প্রদত্ত স্পেসিফিকেশনটি একটি সুপারিশ, কোনও প্রয়োজনীয়তা নয়।
HTTP অনুরোধ
POST https:// KACLS_URL /wrapprivatekey
KACLS_URL কী অ্যাক্সেস কন্ট্রোল লিস্ট সার্ভিস (KACLS) URL দিয়ে প্রতিস্থাপন করুন।
পথের পরামিতি
কোনোটিই নয়।
অনুরোধের মূল অংশ
অনুরোধের মূল অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:
| JSON উপস্থাপনা | |
|---|---|
{ "authentication": string, "perimeter_id": string, "private_key": string } | |
| ক্ষেত্র | |
|---|---|
authentication | পরিচয় প্রদানকারী (আইডিপি) কর্তৃক জারি করা একটি JWT যা ব্যবহারকারী কে তা নিশ্চিত করে। প্রমাণীকরণ টোকেন দেখুন। |
perimeter_id | কী দিয়ে এনক্রিপ্ট করার জন্য পেরিমিটার আইডি। |
private_key | বেস৬৪-এনকোডেড DEK। সর্বোচ্চ আকার: ১২৮ বাইট। |
প্রতিক্রিয়া মূল অংশ
সফল হলে, এই পদ্ধতিটি মোড়ানো ব্যক্তিগত কীটি ফেরত দেয়।
যদি অপারেশনটি ব্যর্থ হয়, তাহলে একটি কাঠামোগত ত্রুটির উত্তর ফেরত পাঠানো হবে।
| JSON উপস্থাপনা | |
|---|---|
{ "wrapped_private_key": string } | |
| ক্ষেত্র | |
|---|---|
wrapped_private_key | base64-এনকোডেড মোড়ানো প্রাইভেট কী। সর্বোচ্চ আকার: 8 KB। |
উদাহরণ
এই উদাহরণে wrapprivatekey পদ্ধতির জন্য একটি নমুনা অনুরোধ এবং প্রতিক্রিয়া প্রদান করা হয়েছে।
অনুরোধ
POST https://mykacls.example.org/v1/wrapprivatekey
{
"private_key": "-----BEGIN RSA PRIVATE KEY-----\\nMIIJ......\\n-----END RSA PRIVATE KEY-----",
"perimeter_id": ""
}
প্রতিক্রিয়া
{
"wrapped_private_key": "LpyCSy5ddy82PIp/87JKaMF4Jmt1KdrbfT1iqpB7uhVd3OwZiu+oq8kxIzB7Lr0iX4aOcxM6HiUyMrGP2PG8x0HkpykbUKQxBVcfm6SLdsqigT9ho5RYw20M6ZXNWVRetFSleKex4SRilTRny38e2ju/lUy0KDaCt1hDUT89nLZ1wsO3D1F3xk8J7clXv5fe7GPRd1ojo82Ny0iyVO7y7h1lh2PACHUFXOMzsdURYFCnxhKAsadccCxpCxKh5x8p78PdoenwY1tnT3/X4O/4LAGfT4fo98Frxy/xtI49WDRNZi6fsL6BQT4vS/WFkybBX9tXaenCqlRBDyZSFhatPQ==",
}