BYOK
BYOK
BYOK یعنی «کلید ارائه‌دهندهٔ خودت»: به‌جای اعتبار مشترک دات‌هوش، درخواست با اعتبارنامهٔ خودتان روی حساب خودتان با ارائه‌دهنده اجرا می‌شود. این صفحه هم معنای BYOK را توضیح می‌دهد و هم — مهم‌تر — می‌گوید امروز از آن چه چیزی در دسترس است و چه چیزی نیست.
وضعیت امروز
ثبت اعتبارنامهٔ BYOK در محصول فعال نیست. نه در کنسول راهی برای افزودن اتصال وجود دارد و نه مسیر آن در gateway روشن است:
- سرویس BYOK در پلتفرم پیاده‌سازی شده است، اما سطح کنسول آن تا آماده‌شدن یک سرویس مدیریت کلید واقعی (KMS/HSM) باز نشده است؛ پیاده‌سازی فعلی رمزنگاری کلید فقط برای محیط توسعه است.
- در gateway، مسیردهی به BYOK به‌طور پیش‌فرض خاموش است. اگر مسیری به BYOK برسد، درخواست با byok_connection_disabled رد می‌شود و هرگز بی‌سروصدا روی اعتبار مشترک دات‌هوش اجرا نمی‌شود.
- نتیجهٔ عملی امروز: همهٔ درخواست‌ها روی اعتبار مشترک اجرا می‌شوند و لازم نیست کاری برای BYOK انجام دهید.
این صفحه رفتار مورد انتظار و محدودیت‌هایش را ثبت می‌کند تا وقتی ثبت اعتبارنامه باز شد، جای حدس‌زدن نباشد. تا آن زمان روی هیچ‌کدام از موارد زیر برنامه‌ریزی نکنید.
حالت‌های مسیردهی
هر اتصال BYOK یک حالت دارد که ترتیب استفاده از اعتبار شما و اعتبار مشترک را تعیین می‌کند:
| حالت | معنا |
|---|---|
| BYOK_ONLY | فقط با اعتبار شما؛ اگر آماده نباشد، نتیجه خطاست، نه سقوط به اعتبار مشترک |
| BYOK_THEN_POOLED | اول اعتبار شما، در صورت رد شدن اعتبار مشترک |
| POOLED_THEN_BYOK | اول اعتبار مشترک، در صورت رد شدن اعتبار شما |
| DISABLED | اتصال نگه داشته می‌شود ولی در مسیردهی استفاده نمی‌شود |
اعتبار معیوب یا غیرفعال در هیچ حالتی انتخاب نمی‌شود. حالت BYOK_ONLY هرگز بی‌صدا به اعتبار مشترک سقوط نمی‌کند: تفاوت آن با بقیه همین است.
هزینهٔ سرویس
استفاده از BYOK هزینهٔ سرویس دات‌هوش را حذف نمی‌کند؛ یک نرخ سرویس روی آن اعمال می‌شود که به‌صورت پیش‌فرض ۳٪ است و مدیر می‌تواند برای هر ارائه‌دهنده نرخ جداگانه بگذارد. محاسبه با اعداد صحیح تومان انجام می‌شود و هیچ گردکردن شناوری در مسیر پول وجود ندارد.
امنیت اعتبارنامه
آنچه در طراحی این بخش قطعی است:
- اعتبارنامهٔ شما با کلید داده‌ای مستقل برای هر اعتبارنامه رمز می‌شود و آن کلید با کلید رمزنگاری دیگری پوشش داده می‌شود؛ متن آشکار هرگز پس از ثبت ذخیره یا لاگ نمی‌شود.
- کنسول فقط فیلدهای ماسک‌شده را برمی‌گرداند: ارائه‌دهنده، برچسب، وضعیت و پیشوند/پسوند ماسک‌شده.
- هر ثبت، جایگزینی، فعال/غیرفعال‌سازی، حذف و چرخش اعتبارنامه یک رکورد ممیزی می‌سازد.
- حذف اعتباری که تنها مسیر فعال BYOK_ONLY است، با byok_delete_blocked_by_active_route مسدود می‌شود.
هیچ‌کدام از این‌ها جای این واقعیت را نمی‌گیرد که رمزنگاری کلید در نسخهٔ فعلی روی یک پیاده‌سازی محلی توسعه است، نه KMS/HSM؛ همین دلیلِ خاموش بودن این قابلیت است.
محدودیت‌هایی که توسعه‌دهنده باید بداند
- هویت ارائه‌دهنده آشکار می‌شود. وقتی از اعتبار خودتان استفاده می‌کنید، بدیهی است که درخواست روی حساب همان ارائه‌دهنده اجرا می‌شود؛ این یکی از تفاوت‌های BYOK با مسیر معمولی است که هویت ارائه‌دهنده را نشان نمی‌دهد (حریم خصوصی).
- مدل‌های در دسترس تغییر می‌کند. مدل‌های مجاز با BYOK با فهرست اعتبار مشترک یکی نیست؛ وقتی ثبت باز شد، فهرست همان key مرجع شماست.
- سهمیهٔ ارائه‌دهنده دیگر محدودیت شماست. رد شدن به‌دلیل سهمیه با byok_quota_exhausted و در دسترس نبودن ارائه‌دهنده با byok_provider_unavailable برمی‌گردد.
خطاهای BYOK
| کد | معنا |
|---|---|
| byok_connection_disabled | اتصال غیرفعال است (یا کل قابلیت خاموش است) |
| byok_credential_invalid / byok_credential_revoked | اعتبارنامهٔ ثبت‌شده معتبر یا فعال نیست |
| byok_permission_insufficient | مجوز اتصال برای این عملیات کافی نیست |
| byok_accessible_model_list_empty | اعتبار شما هیچ مدل قابل‌استفاده‌ای برنگرداند |
| byok_quota_exhausted | سهمیهٔ ارائه‌دهنده با اعتبار شما تمام شده است |
| byok_provider_unavailable | ارائه‌دهنده در دسترس نیست |
| byok_fallback_unavailable | مسیر جایگزین حالت ترکیبی در دسترس نیست |
| byok_test_timeout | آزمون اتصال به پایان زمان رسید |
| byok_delete_blocked_by_active_route | حذف اعتبار به‌دلیل مسیر فعال مسدود شد |
| byok_secret_decrypt_or_kms_failure | رمزگشایی اعتبارنامه ناموفق بود |
مطالب مرتبط
گام بعدی
این صفحه دقیقاً می‌گوید چه چیزی ذخیره می‌شود، چه چیزی نمی‌شود، و چه چیزی در کنترل دات‌هوش نیست. برای تصمیم‌های حساس، همین تفکیک مهم است.
هر خطا با پوشش بومی پروتکل برمی‌گردد تا مدیریت خطای SDK شما بدون تغییر کار کند. دات‌هوش روی پوشش OpenAI چند فیلد اضافه می‌گذارد که برای تصمیم‌گیری لازم‌اند.