کلیدهای مدیر به مالکان و مدیران مجاز فضای کاری امکان می‌دهند ابزارها و سرویس‌ها را به APIهای مدیریتی پشتیبانی‌شدهٔ ChatGPT و Codex متصل کنند. بسته به فضای کاری و مجوزهای انتخابی، یک کلید می‌تواند از تحلیل‌ها، مدیریت کاربران و گروه‌ها، دعوت‌نامه‌ها، محدودیت‌های استفاده، انطباق و گزارش‌های فعالیت یا مدیریت حساب سرویس پشتیبانی کند.
هر کلید مدیر فقط برای یک فضای کاری ChatGPT کاربرد دارد. این کلید دسترسی به فضاهای کاری دیگر، مدیریت کل مستأجر، سازمان‌های پلتفرم API، حساب‌های تبلیغاتی، مدل‌ها یا استنتاج مدل را اعطا نمی‌کند.
برای راهنمای انتخاب مستأجر یا فضای کاری، مراجعه کنید به: مدیریت مستأجر در کنسول مدیریت.
بررسی دسترس‌پذیری و دسترسی فضای کاری
کلیدهای مدیر برای فضاهای کاری مدیریت‌شده و واجد شرایط ChatGPT، ازجمله فضاهای کاری ChatGPT Enterprise، ChatGPT Edu و ChatGPT ویژهٔ سازمان‌ها و متخصصان حوزهٔ سلامت در دسترس‌اند. در فضای کاری مشخصی که می‌خواهید مدیریت کنید، باید نقش مالک یا مدیر داشته باشید.
دسترسی به نقش مالک یا مدیر اختصاص‌یافته در فضای کاری انتخاب‌شدهٔ ChatGPT بستگی دارد. مدیر سراسری، مالک سازمان در پلتفرم API یا کاربری با نقش سفارشی فضای کاری بودن، به‌تنهایی دسترسی به کلید مدیر را اعطا نمی‌کند.
برای جزئیات نقش‌های داخلی فضای کاری، مراجعه کنید به: مدیریت اعضا، نقش‌های فضای کاری و جایگاه‌ها.
آشنایی با دسترسی بر اساس نقش
مالکان فضای کاری می‌توانند کلیدهایی با مجوزهای همه، فقط خواندن یا سفارشی ایجاد کنند. آن‌ها می‌توانند هر کلید مدیر را در فضای کاری خود ویرایش یا لغو کنند.
مدیران فضای کاری با انتخاب سطح دسترسی موجود برای هر دستهٔ مجوز، کلیدهایی با دامنهٔ سفارشی ایجاد می‌کنند. کلید ایجادشده با برچسب سفارشی مشخص می‌شود. آن‌ها فقط می‌توانند کلیدهایی را که خودشان ایجاد کرده‌اند ویرایش یا لغو کنند، آن هم فقط وقتی مجوزهای کلید برای نقش فعلی آن‌ها در دسترس باشد.
مدیران سراسری که در فضای کاری انتخاب‌شده نقش مالک یا مدیر ندارند، نمی‌توانند کلیدهای مدیر آن فضای کاری را ایجاد یا مدیریت کنند.
انتخاب مجوزهای کلید مدیر
تنظیمات ازپیش‌تعیین‌شدهٔ مجوز برای مالکان
مالکان فضای کاری می‌توانند یکی از این تنظیمات مجوز را انتخاب کنند:
گزینهٔ همه تمام مجوزهای مدیریتی موجود برای فضای کاری انتخاب‌شده را اعطا می‌کند؛ ازجمله مجوزهای ویژهٔ مالک، در صورت وجود.
گزینهٔ فقط خواندن مجوزهای فقط‌خواندنی موجود برای فضای کاری انتخاب‌شده را اعطا می‌کند.
گزینهٔ سفارشی به شما امکان می‌دهد سطح دسترسی موجود را برای هر دستهٔ مجوز انتخاب کنید.
مجوزهای مدیریتی بر اساس دسته
مدیران فضای کاری انتخابگر تنظیمات همه، فقط خواندن یا سفارشی را نمی‌بینند. آن‌ها در بخش مجوزها، برای هر دستهٔ موجود گزینهٔ هیچ‌کدام، خواندن یا نوشتن را انتخاب می‌کنند. کلید ایجادشده با برچسب سفارشی مشخص می‌شود.
بسته به فضای کاری شما، دسته‌های موجود ممکن است شامل برنامه‌ها، محدودیت‌های استفاده، مدیریت گروه، کاربران، دعوت‌نامه‌ها، API تحلیل‌های Codex، API تحلیل‌های سازمانی، تحلیل‌های فضای کاری، هزینه‌ها و حساب‌های سرویس باشد. برخی دسته‌ها فقط از خواندن یا نوشتن پشتیبانی می‌کنند و بعضی فقط زمانی نمایش داده می‌شوند که قابلیت مرتبط در دسترس باشد.
نگاشت‌های رایج مجوز عبارت‌اند از:
API تحلیل‌های Codex > خواندن:
codex.enterprise.analytics.read.محدودیت‌های استفاده > خواندن:
chatgpt.enterprise.usage_limit.read.محدودیت‌های استفاده > نوشتن:
chatgpt.enterprise.usage_limit.writeوchatgpt.enterprise.usage_limit.read.کاربران > خواندن:
chatgpt.enterprise.user.read، در صورت وجود.
مجوزهای گستردهٔ انطباق، پیام‌های مکالمه و نقش‌ها و مجوزها، در صورت پشتیبانی، فقط در اختیار مالکان فضای کاری قرار دارند. مدیران فضای کاری ممکن است همچنان بتوانند دسته‌های جداگانهٔ گزارش فعالیت، مانند گزارش‌های ممیزی یا احراز هویت، را انتخاب کنند.
مجوزهای مدیریت گروه
برای ایجاد، به‌روزرسانی یا حذف گروه‌ها با API مدیریت گروه‌ها در یک فضای کاری واجد شرایط ChatGPT، از کلید مدیر همان فضای کاری استفاده کنید.
هنگام انتخاب مجوزهای کلید، مدیریت گروه را بررسی و مجوزهای موردنیاز نقطه پایان را اعطا کنید. کلید فقط‌خواندنی اجازهٔ تغییر گروه‌ها را نمی‌دهد.
صرفاً داشتن عنوان مدیر گروه، مجوز ایجاد کلیدهای مدیر یا استفاده از API مدیریت گروه‌ها را اعطا نمی‌کند. فقط مالکان و مدیران فضای کاری می‌توانند کلید مدیر ایجاد کنند؛ درخواست‌های API به کلیدی با مجوزهای لازم نیاز دارند.
برای مدیریت تفویض‌شدهٔ گروه، مراجعه کنید به: مدیریت گروه‌ها و مدیران گروه.
برای مسیرهای نقطه پایان، عملیات پشتیبانی‌شده، فیلدهای درخواست و دامنه‌های دسترسی لازم، به مرجع API مدیریت مراجعه کنید. گروه‌های همگام‌سازی‌شده را ازطریق گردش‌کار SCIM ارائه‌دهندهٔ هویت خود مدیریت کنید. برای راهنمای همگام‌سازی، مراجعه کنید به: تأمین و مدیریت SCIM.
ایجاد کلید مدیر
وارد کنسول مدیریت شوید.
در صورت نیاز، مستأجر خود را انتخاب کنید و سپس فضای کاری ChatGPT را که در آن نقش مالک یا مدیر دارید انتخاب کنید.
بخش اعتبارنامه‌ها را باز کنید و سپس کلیدهای مدیر را انتخاب کنید.
گزینهٔ ایجاد کلید مدیر جدید را انتخاب و نامی گویا وارد کنید.
زمان انقضا را انتخاب کنید: هرگز، ۳۰ روز، ۶۰ روز، ۹۰ روز یا سفارشی. زمان انقضای سفارشی می‌تواند بین ۱ تا ۳۶۵ روز باشد.
مجوزهای موردنیاز یکپارچه‌سازی خود را انتخاب کنید. مالکان فضای کاری می‌توانند همه، فقط خواندن یا سفارشی را انتخاب کنند؛ مدیران فضای کاری مجوز موجود را برای هر دسته انتخاب می‌کنند.
ارسال را انتخاب کنید، سپس مقدار محرمانه را کپی کرده و در مکانی امن نگه دارید. دیگر نمی‌توانید مقدار محرمانه را مشاهده کنید.
مجوز پیش‌فرض کلیدهای مالکان فضای کاری ممکن است همه و زمان انقضای پیش‌فرض آن‌ها هرگز باشد. پیش از ایجاد کلید، هر دو تنظیم را بررسی کنید.
بررسی، ویرایش یا لغو کلید مدیر
فضای کاری ChatGPT را در کنسول مدیریت باز کنید، سپس به اعتبارنامه‌ها > کلیدهای مدیر بروید. نام، وضعیت، شناسهٔ رهگیری، مقدار محرمانهٔ پوشانده‌شده، سازنده، مجوزها، تاریخ آخرین استفاده و انقضای هر کلید را بررسی کنید.
برای تغییر نام یا مجوزهای کلید، منوی گزینه‌های بیشتر آن (•••) را باز کنید، ویرایش را انتخاب کنید، تغییرات را انجام دهید و ذخیرهٔ تغییرات را انتخاب کنید.
برای توقف استفاده از کلید، منوی گزینه‌های بیشتر آن (•••) را باز کنید، لغو را انتخاب کنید و با لغو کلید مدیر تأیید کنید.
مالکان فضای کاری می‌توانند هر کلید فضای کاری انتخاب‌شده را ویرایش یا لغو کنند. مدیران فضای کاری فقط می‌توانند کلیدهایی را که خودشان ایجاد کرده‌اند ویرایش یا لغو کنند، آن هم فقط وقتی مجوزهای کلید برای نقش فعلی آن‌ها در دسترس باشد. برای مدیریت کلیدهای دارای مجوزهای ویژهٔ مالک، از مالک فضای کاری کمک بخواهید. تاریخ انقضای موجود را نمی‌توان تغییر داد.
کلیدهای لغوشده پس از اعمال تغییر از کار می‌افتند. پیش از لغو کلیدی که هنوز استفاده می‌شود، کلید جایگزینی ایجاد و یکپارچه‌سازی‌های متأثر را به‌روزرسانی کنید.
آشنایی با انطباق و داده‌های حساس
برخی مجوزهای کلید مدیر می‌توانند فعالیت یا محتوای حساس فضای کاری را در معرض دسترسی قرار دهند. فقط مالکان فضای کاری می‌توانند دسترسی گستردهٔ انطباق یا دسترسی به پیام‌های مکالمه را اعطا کنند.
مدیران فضای کاری ممکن است بتوانند به دسته‌های جداگانهٔ گزارشِ پشتیبانی‌شده، ازجمله گزارش‌های ممیزی، احراز هویت یا برنامه‌ها، دسترسی بدهند. هر دسته را با دقت بررسی کنید؛ گزارش‌های جداگانه همچنان ممکن است حاوی اطلاعات حساس باشند.
برای اطلاعات مربوط به APIهای انطباق و دسترسی به داده‌ها، مراجعه کنید به: پلتفرم انطباق OpenAI برای مشتریان Enterprise و Edu.
درخواست‌های API مدیریت فضای کاری ChatGPT از https://api.chatgpt.com/v1 استفاده می‌کنند. برای مثال، برای فهرست‌کردن اعضای فعلی فضای کاری از /manage/workspaces/{workspace_id}/users استفاده کنید. نقطه‌های پایان زیر /v1/organization/ سازمان‌های پلتفرم API را مدیریت می‌کنند و به کلید مدیر سازمان پلتفرم API نیاز دارند.
برای مسیرهای نقطه پایان، طرح‌واره‌های درخواست و پاسخ و دامنه‌های دسترسی لازم، به مرجع API مدیریت مراجعه کنید.
تمایز کلیدهای مدیر از سایر اعتبارنامه‌ها
کلیدهای مدیر فضای کاری، درخواست‌های APIهای مدیریتی پشتیبانی‌شدهٔ ChatGPT و Codex را برای یک فضای کاری ChatGPT احراز هویت می‌کنند. این کلیدها دسترسی به استنتاج مدل را اعطا نمی‌کنند.
توکن‌های دسترسی حساب سرویس Codex، هویت غیرانسانی فضای کاری را برای خودکارسازی Codex احراز هویت می‌کنند. این توکن‌ها درخواست‌های API مدیریت را احراز هویت نمی‌کنند. برای راهنمای راه‌اندازی، مراجعه کنید به: ایجاد و مدیریت حساب‌های سرویس Codex.
کلیدهای مدیر سازمان پلتفرم API به‌طور جداگانه در پلتفرم API مدیریت می‌شوند و فضاهای کاری ChatGPT را مدیریت نمی‌کنند.
اگر برای یک سازمان پلتفرم API به کلید نیاز دارید، کلیدهای مدیر سازمان پلتفرم API را باز کنید. نقطه‌های پایان API مدیریت ChatGPT مختص فضای کاری را با کلید مدیر فضای کاری استفاده کنید؛ نقطه‌های پایان سازمان پلتفرم API به اعتبارنامه‌های جداگانه نیاز دارند.
رفع مشکلات دسترسی و مجوزهای موجودنبودن
مطمئن شوید با حساب درست OpenAI وارد شده‌اید و مستأجر و فضای کاری ChatGPT موردنظر را انتخاب کرده‌اید.
بررسی کنید عضویت شما در فضای کاری فعال و نقش شما مالک یا مدیر باشد.
مطمئن شوید فضای کاری ChatGPT شما واجد شرایط استفاده از کلیدهای مدیر است. دسترس‌پذیری ممکن است بسته به طرح و روند عرضه متفاوت باشد.
اگر دسته‌ای از مجوزها وجود ندارد، مطمئن شوید قابلیت مربوطه در فضای کاری انتخاب‌شده در دسترس است و نقش شما اجازهٔ دسترسی می‌دهد. اگر دستهٔ لازم همچنان در دسترس نیست، به‌جای انتخاب مجوزی نامرتبط با پشتیبانی OpenAI تماس بگیرید.
اگر نمی‌توانید کلیدی را ویرایش یا لغو کنید، مطمئن شوید آن را خودتان ایجاد کرده‌اید و مجوزهایش برای نقش فعلی شما در دسترس‌اند. برای مدیریت کلیدهای دارای مجوزهای ویژهٔ مالک، از مالک فضای کاری کمک بخواهید.
اگر کلیدی که قبلاً کار می‌کرد از کار افتاده است، وضعیت و انقضای آن را بررسی کنید، مطمئن شوید منقضی یا لغو نشده است و سازندهٔ آن همچنان نقشی فعال با مجوزهای لازم در فضای کاری دارد.
اگر مشکل ادامه داشت، با پشتیبانی OpenAI تماس بگیرید. در صورت درخواست، شناسهٔ مستأجر، نام یا شناسهٔ فضای کاری و یک نماگرفت را ارائه دهید، اما هرگز مقدار محرمانهٔ کلید مدیر را به اشتراک نگذارید.
محافظت از کلیدهای مدیر
مجوزهای سفارشی را انتخاب کنید و فقط دسترسی موردنیاز یکپارچه‌سازی خود را اعطا کنید.
در صورت امکان، زمان انقضا تعیین کنید. هرگز یعنی کلید زمان انقضای برنامه‌ریزی‌شده ندارد. اگر کلید لغو شود، سازندهٔ آن دسترسی لازم به فضای کاری را از دست بدهد یا حساب سازنده غیرفعال شود، ممکن است کلید همچنان از کار بیفتد.
برای یکپارچه‌سازی‌ها یا گردش‌کارهای مختلف از کلیدهای جداگانه استفاده کنید.
مقادیر محرمانه را در یک مدیر امن اسرار نگه دارید. هرگز آن‌ها را ازطریق ایمیل، چت یا درخواست پشتیبانی ارسال نکنید.
میزان استفاده و زمان انقضا را مرتب بررسی و کلیدهای غیرضروری را لغو کنید.