این صفحه به‌صورت ماشینی ترجمه شده است. مقاله اصلی انگلیسی را مشاهده کنید.

پرسش‌های متداول عیب‌یابی راه‌اندازی EKM

این مقاله روش رفع خطاهای راه‌اندازی EKM برای AWS، GCP، Azure و OCI Vault را توضیح می‌دهد.

به‌روزرسانی: 4 days ago

AWS

مجاز به انجام این عملیات نیست: sts:AssumeRole

کاربر arn:aws:sts::xxxxx:assumed-role/EnterpriseKeyManagement/OpenAI-EKM-Service مجاز به اجرای عملیات sts:AssumeRole روی منبع arn:aws:iam::xxxxx:role/xxxxxx نیست

principal و ExternalId را در trust policy خود بررسی کنید

مطمئن شوید این بخش از مستندات را دنبال کرده‌اید؛ هم شناسایی principal متعلق به OpenAI و هم پیکربندی sts:ExternalId

اگر قبلاً sts:ExternalId را وارد کرده‌اید، مطمئن شوید که همان شناسه سازمان OpenAI است که EKM را برای آن اعمال می‌کنید، نه سازمانی دیگر مثل یک سازمان شخصی.

ارتباط trust policy با role ARN را بررسی کنید

بررسی کنید که trust policy شما به‌درستی در role ARN ارائه‌شده ذخیره شده باشد

همچنین بررسی کنید که role ARN صحیح را وارد کرده‌اید. اگر ARN شما غلط املایی داشته باشد و وجود نداشته باشد، همان خطایی را دریافت می‌کنیم که در حالتی رخ می‌دهد که نقش وجود دارد اما مجوزها را رد می‌کند.

AWS IAM role details with Trust relationships tab open and the role ARN highlighted

مجاز به انجام این عملیات نیست: kms:Encrypt روی منبع

کاربر: xxxxx مجاز نیست این عملیات را انجام دهد: kms:Encrypt روی منبع

مطمئن شوید IAM policy شما kms:Encrypt و kms:Decrypt را به نقش OpenAI اعطا می‌کند.

اگر key policy هم اضافه کرده‌اید، مطمئن شوید آن نیز kms:Encrypt و kms:Decrypt را به نقش OpenAI اعطا می‌کند.

GCP

دریافت توکن GCP STS برای مخاطب ناموفق بود

دریافت توکن GCP STS برای مخاطب //iam.googleapis.com/projects/xxxxxxxxx/locations/global/workloadIdentityPools/xxxxxxx/providers/xxxxxxxxxx ناموفق بود: {'error': 'invalid_request', 'error_description': 'مقدار \"audience\" نامعتبر است. این مقدار باید نام کامل منبع Identity Provider باشد. برای فهرست قالب‌های ممکن، https://cloud.google.com/iam/docs/reference/sts/rest/v1/TopLevel/token را ببینید.

GCP انتظار دارد مخاطب با قالب زیر باشد:

iam.googleapis.com/projects/xxxxxxxxx/locations/global/workloadIdentityPools/xxxxxxx/providers/xxxxxxxxxx

مطمئن شوید هنگام ثبت کلید خود در OpenAI با استفاده از کلیدهای خارجی در Management API پارامترهای صحیح را وارد کرده‌اید

  • مطمئن شوید workload_identity_project_number شماره پروژه ۱۲رقمی GCP شماست

  • مطمئن شوید workload_identity_pool_id صحیح است

  • مطمئن شوید workload_identity_provider_id صحیح است

مخاطب در توکن شناسه با مخاطب مورد انتظار مطابقت ندارد

دریافت توکن GCP STS برای مخاطب //iam.googleapis.com/projects/xxxxxx/locations/global/workloadIdentityPools/xxxxxxx/providers/xxxxxxxx ناموفق بود: {'error': 'invalid_grant', 'error_description': 'مخاطب در ID Token [xxxxx] با مخاطب مورد انتظار xxxxxxx مطابقت ندارد.'}

مطمئن شوید فیلد audience که هنگام ثبت پیکربندی خود در OpenAI وارد می‌کنید (کلیدهای خارجی در API مدیریت) یکی از مخاطبان مجاز ارائه‌دهندهٔ هویت بار کاری شما باشد. توصیه می‌کنیم از شناسهٔ سازمان OpenAI خود استفاده کنید.

Azure

برنامه کلاینت فاقد service principal است

برنامه کلاینت xxxxx در tenant xxxxx فاقد service principal است. دستورالعمل‌ها را اینجا ببینید: https://go.microsoft.com/fwlink/?linkid=2225119

مطمئن شوید مراحل ایجاد service principal را دقیقاً مطابق دستورالعمل‌های یکپارچه‌سازی OpenAI / Azure EKM. دنبال کرده‌اید.

فراخواننده مجاز نیست عملی را روی منبع انجام دهد

فراخواننده مجاز نیست عملی را روی منبع انجام دهد. اگر role assignments، deny assignments یا role definitions اخیراً تغییر کرده‌اند، لطفاً زمان انتشار تغییرات را در نظر بگیرید.

این خطا ممکن است به دلایل مختلفی رخ دهد

  • نام کلید یا URI خزانه‌ای که وارد کرده‌اید اشتباه است یا وجود ندارد

  • نقشی با این عملیات داده ایجاد نکرده‌اید و آن نقش را نیز به سرویس پرینسیپال OpenAI اختصاص نداده‌اید

    • Microsoft.KeyVault/vaults/keys/encrypt/action

    • Microsoft.KeyVault/vaults/keys/decrypt/action

نام کلید با الگو مطابقت ندارد

«key_name» نامعتبر است: رشته با الگو مطابقت ندارد. باید رشته‌ای مطابق با الگوی «^org-[0-9a-zA-Z-]*--[0-9a-zA-Z-]*$» وارد شود.

لطفاً نام کلید Key Vault خود را با شناسه سازمان OpenAI خود شروع کنید.

این بهترین روشی است که تیم امنیت توصیه می‌کند تا از ثبت کلید Key Vault شما توسط کاربر دیگری جلوگیری شود. هنگام ثبت کلید و در هر درخواست به Key Vault شما، بررسی می‌کنیم که شناسه سازمان مطابقت داشته باشد.

OCI

پیکربندی نامعتبر است یا دسترسی رد شده است

بررسی کنید که مخزن فعال و کلید قابل استفاده باشد و region، vault_ocid و key_ocid همگی به یک پیکربندی در یک منطقه اشاره کنند. از OCIDهای کاملِ قلمرو تجاری و نام کامل منطقه، مانند us-ashburn-1، استفاده کنید. هم حساب ابری شما و هم حساب ابری OpenAI باید اشتراک منطقهٔ انتخاب‌شده را داشته باشند.

برچسب آزادِ openai_organization_id را به کلید اضافه کنید و مقدار آن را دقیقاً برابر با شناسهٔ سازمان خود در OpenAI قرار دهید. برچسب مخزن یا برچسب تعریف‌شده این الزام را برآورده نمی‌کند.

برای EKM، از AES-256 استفاده کنید و به هویت OpenAI در محیط عملیاتی، مجوز VAULT_READ برای مخزن و مجوزهای KEY_READ، KEY_ENCRYPT و KEY_DECRYPT برای کلید بدهید. دامنهٔ هر مجوز را به منبع موردنظر محدود کنید. key_version_ocid را وارد نکنید.

برای بازیابی PSP، از RSA-3072 و OCID دقیقِ یکی از نسخه‌های فعال آن کلید استفاده کنید. OpenAI به دسترسی خواندن فراداده و کلیدهای عمومی نیاز دارد، اما به مجوز رمزگشایی RSA نیازی ندارد. برای راه‌اندازی EKM، به پیکربندی OCI Vault برای مدیریت کلید سازمانی مراجعه کنید. برای مشاهدهٔ سیاست کلید بازیابی و نمونه‌های ثبت آن، به راه‌اندازی کلیدهای نامتقارن — OCI Vault مراجعه کنید.

پس از اصلاح پیکربندی، /organization/external_keys/{id}/validate را فراخوانی کنید. GET جزئیات ذخیره‌شدهٔ ثبت را برمی‌گرداند و دسترسی به OCI را دوباره بررسی نمی‌کند. هنگام تماس با پشتیبانی OpenAI، شناسهٔ درخواست و پاسخ خطا را پس از حذف اطلاعات حساس ارسال کنید. کلیدهای API یا اطلاعات کلید خصوصی را ارسال نکنید.

آیا این مقاله مفید بود؟