রেফারেন্স নিয়ে কাজ করা

আপনি Apigee Edge-এর ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশন .info- তে যান।

TLS সমর্থন করার জন্য একটি ভার্চুয়াল হোস্ট কনফিগার করার সময়, আপনি একটি রেফারেন্স ব্যবহার করে কীস্টোর বা ট্রাস্টস্টোর নির্দিষ্ট করেন। রেফারেন্স হলো একটি ভেরিয়েবল যা কীস্টোর বা ট্রাস্টস্টোরের নাম ধারণ করে, সরাসরি কীস্টোর বা ট্রাস্টস্টোরের নাম উল্লেখ করার পরিবর্তে, যেমনটি নিচে দেখানো হয়েছে:

    <SSLInfo> 
        <Enabled>true</Enabled> 
        <ClientAuthEnabled>false</ClientAuthEnabled> 
        <KeyStore>ref://myTestKeystoreRef</KeyStore> 
        <KeyAlias>myKeyAlias</KeyAlias> 
    </SSLInfo>

রেফারেন্স ব্যবহারের সুবিধা হলো, আপনি রেফারেন্সের মান পরিবর্তন করে ভার্চুয়াল হোস্ট দ্বারা ব্যবহৃত কীস্টোর পরিবর্তন করতে পারেন, যা সাধারণত বর্তমান কীস্টোরের সার্টিফিকেটটির মেয়াদ শীঘ্রই শেষ হয়ে যাওয়ার কারণে করা হয়। রেফারেন্সের মান পরিবর্তন করার জন্য এজ রাউটার রিস্টার্ট করার প্রয়োজন হয় না।

আপনি শুধুমাত্র কীস্টোর এবং ট্রাস্টস্টোরের রেফারেন্স ব্যবহার করতে পারবেন; অ্যালিয়াসের রেফারেন্স ব্যবহার করতে পারবেন না। যখন আপনি কোনো কীস্টোরের রেফারেন্স পরিবর্তন করবেন, তখন নিশ্চিত করুন যে সার্টিফিকেটের অ্যালিয়াস নামটি পুরোনো কীস্টোরের অ্যালিয়াস নামের মতোই আছে।

কীস্টোর এবং ট্রাস্টস্টোরের রেফারেন্স ব্যবহারে সীমাবদ্ধতা

কীস্টোর এবং ট্রাস্টস্টোরের রেফারেন্স ব্যবহার করার সময় আপনাকে নিম্নলিখিত সীমাবদ্ধতাটি অবশ্যই বিবেচনায় রাখতে হবে:

• আপনি ভার্চুয়াল হোস্টে কীস্টোর এবং ট্রাস্টস্টোর রেফারেন্স শুধুমাত্র তখনই ব্যবহার করতে পারবেন, যদি আপনি SNI সমর্থন করেন এবং Apigee রাউটারগুলিতে SSL টার্মিনেট করেন।
• যদি আপনার Apigee রাউটারগুলোর সামনে একটি লোড ব্যালেন্সার থাকে এবং আপনি সেই লোড ব্যালেন্সারে TLS টার্মিনেট করেন, তাহলে আপনি ভার্চুয়াল হোস্টগুলোতে কীস্টোর এবং ট্রাস্টস্টোর রেফারেন্স ব্যবহার করতে পারবেন না।

একটি রেফারেন্স তৈরি করা

Edge UI-তে একটি রেফারেন্স তৈরি করতে:

1. https://enterprise.apigee.com -এ Edge ম্যানেজমেন্ট UI-তে লগইন করুন।
2. Edge ম্যানেজমেন্ট UI মেনুতে, আপনার প্রতিষ্ঠানের নামটি নির্বাচন করুন।
3. আপনার Edge UI-এর সংস্করণের উপর নির্ভর করে:
   1. আপনি যদি ক্লাসিক এজ UI ব্যবহার করেন: API > এনভায়রনমেন্ট কনফিগারেশন নির্বাচন করুন।
   2. আপনি যদি নতুন Edge UI ব্যবহার করেন : Admin > Environments নির্বাচন করুন।
4. পরিবেশ নির্বাচন করুন (সাধারণত prod বা test )
5. রেফারেন্স ট্যাবটি নির্বাচন করুন।
6. + রেফারেন্স বাটনটি নির্বাচন করুন। নিম্নলিখিত পপ-আপটি প্রদর্শিত হবে:
   
7. নির্দিষ্ট করুন:
   1. তথ্যসূত্রের নাম ।
   2. রেফারেন্স দ্বারা উল্লিখিত সত্তা, অর্থাৎ কীস্টোর বা ট্রাস্টস্টোরের নাম।
   3. সংরক্ষণ নির্বাচন করুন।

বিকল্পভাবে, keystoreref নামের রেফারেন্সটি তৈরি করতে Create Reference API কলটি ব্যবহার করুন:

curl -X POST  -H "Content-Type:application/xml" https://api.enterprise.apigee.com/v1/o/{org_name}/e/{env_name}/references \
-d '<ResourceReference name="keystoreref">
    <Refers>myTestKeystore</Refers>
    <ResourceType>KeyStore</ResourceType>
</ResourceReference>' -u orgAdminEmail:password

রেফারেন্সটি কীস্টোরের নাম এবং এর ধরন নির্দিষ্ট করে। একটি ট্রাস্টস্টোরের রেফারেন্স তৈরি করতে একই এপিআই কল ব্যবহার করুন।

একটি রেফারেন্স পরিবর্তন করা

Edge UI-তে কোনো রেফারেন্সের মান পরিবর্তন করতে:

1. https://enterprise.apigee.com -এ Edge ম্যানেজমেন্ট UI-তে লগইন করুন।
2. Edge ম্যানেজমেন্ট UI মেনুতে, আপনার প্রতিষ্ঠানের নামটি নির্বাচন করুন।
3. আপনার Edge UI-এর সংস্করণের উপর নির্ভর করে:
   1. আপনি যদি ক্লাসিক এজ UI ব্যবহার করেন: API > এনভায়রনমেন্ট কনফিগারেশন নির্বাচন করুন।
   2. আপনি যদি নতুন Edge UI ব্যবহার করেন : Admin > Environments নির্বাচন করুন।
4. পরিবেশ নির্বাচন করুন (সাধারণত prod বা test )
5. রেফারেন্স ট্যাবটি নির্বাচন করুন।
6. রেফারেন্স ট্যাবে, রেফারেন্সটির জন্য এডিট বাটনটি নির্বাচন করুন।
7. নতুন কীস্টোর বা ট্রাস্টস্টোর নির্দিষ্ট করতে রেফারেন্সটি আপডেট করুন। সতর্কতা : নিশ্চিত করুন যে নতুন কীস্টোরের অ্যালিয়াসটি পুরানো কীস্টোরের অ্যালিয়াসের নামের মতোই।
8. সংরক্ষণ নির্বাচন করুন।

রেফারেন্স পরিবর্তন করে অন্য কোনো কীস্টোরে নির্দেশ করতে এবং নতুন কীস্টোরের অ্যালিয়াসটি যেন পুরোনো কীস্টোরের অ্যালিয়াসের নামের সাথে একই থাকে তা নিশ্চিত করতে, আপডেট রেফারেন্স এপিআই (Update Reference API) ব্যবহার করুন:

curl -X PUT -H "Content-Type:application/xml" https://api.enterprise.apigee.com/v1/o/{org_name}/e/{env_name}/references/keystoreref \
-d '<ResourceReference name="keystoreref">
    <Refers>myNewKeystore</Refers>
    <ResourceType>KeyStore</ResourceType>
</ResourceReference>' -u orgAdminEmail:password