کار کردن با مرجع‌ها

درحال مشاهده اسناد Apigee Edge هستید.
به اسناد Apigee X بروید. اطلاعات

هنگام پیکربندی میزبان مجازی برای پشتیبانی از TLS، بااستفاده از مرجع، انبار کلید یا انبار اعتماد را مشخص می‌کنید. مرجع متغیری است که حاوی نام انبار کلید یا انبار اطمینان است، به‌جای اینکه نام انبار کلید یا انبار اطمینان را مستقیماً مشخص کنید، همان‌طور که در زیر نشان داده شده است:

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

مزیت استفاده از مرجع این است که می‌توانید مقدار مرجع را تغییر دهید تا انبار کلید استفاده‌شده توسط میزبان مجازی تغییر کند، معمولاً به این دلیل که گواهینامه در انبار کلید فعلی در آینده نزدیک منقضی می‌شود. تغییر مقدار مرجع نیازی به بازراه‌اندازی «مسیریاب لبه» ندارد.

فقط می‌توانید از مرجع برای keystore و truststore استفاده کنید؛ نمی‌توانید از مرجع برای نام مستعار استفاده کنید. وقتی مرجع را به انبار کلید تغییر می‌دهید، مطمئن شوید که نام مستعار گواهینامه با نام مستعار در انبار کلید قدیمی یکسان باشد.

محدودیت‌های استفاده از ارجاع به keystore و truststore

هنگام استفاده از ارجاع به keystore و truststore باید محدودیت زیر را درنظر بگیرید:

• فقط درصورتی می‌توانید از مرجع‌های keystore و truststore در میزبان‌های مجازی استفاده کنید که از SNI پشتیبانی کنید و SSL را در «مسیریاب‌های Apigee» خاتمه دهید.
• اگر در جلوی «مسیرهای Apigee» ترازکننده بار دارید و «امنیت لایه انتقال» را در ترازکننده بار خاتمه می‌دهید، نمی‌توانید از مراجع انبار کلید و انبار اعتماد در میزبان‌های مجازی استفاده کنید.

درحال ایجاد مرجع

برای ایجاد مرجع در «واسط کاربر Edge»:

1. در https://enterprise.apigee.com به سیستم واسط کاربر مدیریت Edge وارد شوید.
2. در منو «واسط کاربر مدیریت Edge»، نام سازمانتان را انتخاب کنید.
3. بسته به نسخه «میانای کاربر Edge» شما:
   1. اگر از واسط کاربر Classic Edge استفاده می‌کنید: APIs > Environment Configuration (میاناهای برنامه‌سازی کاربردی > پیکربندی محیط) را انتخاب کنید.
   2. اگر از واسط کاربر Edge جدید استفاده می‌کنید: سرپرست > محیط‌ها را انتخاب کنید.
4. «محیط» (معمولاً prod یا test) را انتخاب کنید
5. برگه مرجع‌ها را انتخاب کنید.
6. دکمه + مرجع را انتخاب کنید. بالاپری به‌صورت زیر ظاهر می‌شود:
   
7. این موارد را مشخص کنید:
   1. نام مرجع.
   2. نهادی که مرجع به آن اشاره می‌کند، یعنی نام انبار کلید یا انبار اعتماد.
   3. ذخیره کردن را انتخاب کنید.

یا از فراخوانی API Create Reference برای ایجاد مرجع با نام keystoreref استفاده کنید:

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

مرجع نام فروشگاه کلید و نوع آن را مشخص می‌کند. از همان فراخوانی API برای ایجاد مرجع به مخزن اعتماد استفاده کنید.

درحال اصلاح مرجع

برای تغییر مقدار مرجع در «میانای کاربری Edge»:

1. در https://enterprise.apigee.com به سیستم واسط کاربر مدیریت Edge وارد شوید.
2. در منو «واسط کاربر مدیریت Edge»، نام سازمانتان را انتخاب کنید.
3. بسته به نسخه «میانای کاربر Edge» شما:
   1. اگر از واسط کاربر Classic Edge استفاده می‌کنید: APIs > Environment Configuration (میاناهای برنامه‌سازی کاربردی > پیکربندی محیط) را انتخاب کنید.
   2. اگر از واسط کاربر Edge جدید استفاده می‌کنید: سرپرست > محیط‌ها را انتخاب کنید.
4. «محیط» (معمولاً prod یا test) را انتخاب کنید
5. برگه مرجع‌ها را انتخاب کنید.
6. در برگه مرجع، دکمه ویرایش را برای مرجع انتخاب کنید.
7. مرجع را به‌روز کنید تا فروشگاه کلید یا فروشگاه اطمینان جدید را مشخص کنید. احتیاط: مطمئن شوید نام مستعار در انبار کلید جدید با نام مستعار در انبار کلید قدیمی یکسان باشد.
8. ذخیره کردن را انتخاب کنید.

برای تغییر مرجع به‌طوری که به انبار کلید دیگری اشاره کند، با اطمینان از اینکه نام مستعار در انبار کلید جدید همان نام مستعار در انبار کلید قدیمی است، از API Update Reference (به‌روزرسانی مرجع) استفاده کنید:

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