পদ্ধতি: ব্যক্তিগত কী সাইন

একটি র‍্যাপ করা প্রাইভেট কী আনর‍্যাপ করে এবং তারপর ক্লায়েন্ট কর্তৃক প্রদত্ত ডাইজেস্টটিতে স্বাক্ষর করে।

HTTP অনুরোধ

POST https:// KACLS_URL /privatekeysign

KACLS_URL Key Access Control List Service (KACLS) URL দিয়ে প্রতিস্থাপন করুন।

পথের পরামিতি

কিছুই না।

অনুরোধকারী শরীর

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

JSON উপস্থাপনা
{
  "authentication": string,
  "authorization": string,
  "algorithm": string,
  "digest": string,
  "rsa_pss_salt_length": integer,
  "reason": string,
  "wrapped_private_key": string
}
ক্ষেত্র
authentication

string

ব্যবহারকারীর পরিচয় নিশ্চিত করার জন্য আইডেন্টিটি প্রোভাইডার (IdP) দ্বারা ইস্যুকৃত একটি JWT। অথেনটিকেশন টোকেন দেখুন।

authorization

string

একটি JWT যা নিশ্চিত করে যে ব্যবহারকারীকে resource_name এর জন্য একটি কী আনর‍্যাপ করার অনুমতি দেওয়া হয়েছে। অনুমোদন টোকেন দেখুন।

algorithm

string

এনভেলপ এনক্রিপশনে ডেটা এনক্রিপশন কী (DEK) এনক্রিপ্ট করতে যে অ্যালগরিদমটি ব্যবহার করা হয়েছিল।

digest

string

Base64-এনকোডেড মেসেজ ডাইজেস্ট। এটি DER-এনকোডেড SignedAttributes এর ডাইজেস্ট। এই মানটি আনপ্যাডেড। সর্বোচ্চ আকার: ১২৮ বাইট।

rsa_pss_salt_length

integer

(ঐচ্ছিক) সিগনেচার অ্যালগরিদম RSASSA-PSS হলে, ব্যবহার করার জন্য সল্ট লেংথ। সিগনেচার অ্যালগরিদম RSASSA-PSS না হলে, এই ফিল্ডটি উপেক্ষা করা হবে।

reason

string (UTF-8)

অপারেশনটি সম্পর্কে অতিরিক্ত তথ্য প্রদানকারী একটি পাসথ্রু JSON স্ট্রিং। প্রদর্শনের পূর্বে প্রদত্ত JSON-টি পরিমার্জন করা উচিত। সর্বোচ্চ আকার: ১ কিলোবাইট।

wrapped_private_key

string

বেস৬৪-এনকোডেড র‍্যাপড প্রাইভেট কী। সর্বোচ্চ আকার: ৮ কিলোবাইট।

প্রাইভেট কী বা র‍্যাপড প্রাইভেট কী-এর ফরম্যাটটি কী অ্যাক্সেস কন্ট্রোল লিস্ট সার্ভিস (KACLS) ইমপ্লিমেন্টেশনের উপর নির্ভর করে। ক্লায়েন্ট এবং জিমেইল উভয় দিকেই, এটিকে একটি ওপেক ব্লব হিসেবে গণ্য করা হয়।

প্রতিক্রিয়া সংস্থা

সফল হলে, এই মেথডটি একটি বেস৬৪-এনকোডেড সিগনেচার রিটার্ন করে।

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

JSON উপস্থাপনা
{
  "signature": string
}
ক্ষেত্র
signature

string

একটি বেস৬৪-এনকোডেড স্বাক্ষর।

উদাহরণ

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