מפתחות ניהול מאפשרים לבעלי workspace ולמנהלים מורשים לחבר כלים ושירותים לממשקי API נתמכים לניהול ChatGPT ו-Codex. בהתאם ל-workspace ולהרשאות שתבחרו, מפתח יכול לתמוך בניתוח נתונים, בניהול משתמשים וקבוצות, בהזמנות, במגבלות שימוש, ביומני תאימות ופעילות או בניהול חשבונות שירות.
כל מפתח ניהול חל על workspace אחד ב-ChatGPT. הוא אינו מעניק גישה לסביבות workspace אחרות, לניהול ברמת הדייר כולו, לארגונים בפלטפורמת API, לחשבונות פרסום, למודלים או להרצת הסקה באמצעות מודלים.
לעזרה בבחירת הדייר או ה-workspace שלכם, ראו: ניהול הדייר שלכם במסוף הניהול.
בדיקת זמינות וגישה ב-workspace
מפתחות ניהול זמינים בסביבות workspace מנוהלות וזכאיות של ChatGPT, כולל סביבות workspace של ChatGPT Enterprise, ChatGPT Edu ו-ChatGPT for Healthcare. עליכם להיות בעלי תפקיד בעלים או מנהל ב-workspace הספציפי שברצונכם לנהל.
הגישה תלויה בתפקיד בעלים או מנהל שהוקצה לכם ב-workspace שנבחר ב-ChatGPT. תפקיד של מנהל גלובלי, בעלים של ארגון בפלטפורמת API או משתמש בעל תפקיד מותאם אישית ב-workspace אינו מעניק כשלעצמו גישה למפתחות ניהול.
לפרטים על התפקידים המובנים ב-workspace, ראו: ניהול חברים, תפקידים ב-workspace ורישיונות משתמש.
הבנת הגישה לפי תפקיד
בעלי workspace יכולים ליצור מפתחות עם הרשאות הכול, קריאה בלבד או התאמה אישית. הם יכולים לערוך או לבטל כל מפתח ניהול ב-workspace שלהם.
מנהלי workspace יוצרים מפתחות עם היקפי הרשאה מותאמים אישית באמצעות בחירת רמת הגישה הזמינה לכל קטגוריית הרשאות. המפתח שנוצר מסומן בתווית התאמה אישית. הם יכולים לערוך או לבטל רק מפתחות שהם יצרו, ורק כאשר הרשאות המפתח זמינות לתפקידם הנוכחי.
מנהלים גלובליים שאין להם תפקיד בעלים או מנהל ב-workspace שנבחר אינם יכולים ליצור או לנהל את מפתחות הניהול שלו.
בחירת הרשאות למפתח ניהול
ערכות הרשאות מוגדרות מראש לבעלים
בעלי workspace יכולים לבחור אחת מערכות ההרשאות המוגדרות מראש:
הכול מעניקה את הרשאות הניהול הזמינות עבור ה-workspace שנבחר, כולל הרשאות לבעלים בלבד, אם הן זמינות.
קריאה בלבד מעניקה את הרשאות הקריאה בלבד הזמינות עבור ה-workspace שנבחר.
התאמה אישית מאפשרת לבחור את רמת הגישה הזמינה לכל קטגוריית הרשאות.
הרשאות מנהל לפי קטגוריה
מנהלי workspace אינם רואים את בורר ערכות ההרשאות הכול, קריאה בלבד או התאמה אישית. תחת הרשאות, הם בוחרים ללא, קריאה או כתיבה לכל קטגוריה זמינה. המפתח שנוצר מסומן בתווית התאמה אישית.
בהתאם ל-workspace שלכם, הקטגוריות הזמינות עשויות לכלול אפליקציות, מגבלות שימוש, ניהול קבוצות, משתמשים, הזמנות, API לניתוח נתוני Codex, API לניתוח נתונים ארגוניים, ניתוח נתוני workspace, עלויות וחשבונות שירות. חלק מהקטגוריות תומכות רק בקריאה או בכתיבה, וחלקן מופיעות רק כשהתכונה הקשורה אליהן זמינה.
מיפויי הרשאות נפוצים כוללים:
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, אם ההרשאה זמינה.
הרשאות נרחבות לצורכי תאימות, הודעות בשיחות ותפקידים והרשאות זמינות רק לבעלי workspace, כאשר קיימת תמיכה בהן. ייתכן שמנהלי workspace עדיין יוכלו לבחור קטגוריות ספציפיות של יומני פעילות, כגון יומני ביקורת או אימות.
הרשאות לניהול קבוצות
כדי ליצור, לעדכן או למחוק קבוצות באמצעות ה-API לניהול קבוצות ב-workspace זכאי של ChatGPT, השתמשו במפתח ניהול של אותו workspace.
בעת בחירת הרשאות המפתח, עיינו בניהול קבוצות והעניקו את ההרשאות שה-endpoint דורש. מפתח לקריאה בלבד אינו מאפשר לבצע שינויים בקבוצות.
מינוי למנהל קבוצה כשלעצמו אינו מעניק הרשאה ליצור מפתחות ניהול או להשתמש ב-API לניהול קבוצות. רק בעלי workspace ומנהליו יכולים ליצור מפתחות ניהול; בקשות API מחייבות מפתח בעל ההרשאות הנדרשות.
למידע על האצלת סמכויות לניהול קבוצות, ראו: ניהול קבוצות ומנהלי קבוצות.
למידע על נתיבי endpoint, פעולות נתמכות, שדות בקשה והיקפי הרשאה נדרשים, עיינו בתיעוד ה-API לניהול. נהלו קבוצות מסונכרנות באמצעות תהליך העבודה של SCIM אצל ספק הזהויות שלכם. להנחיות בנושא סנכרון, ראו: הקצאה וניהול באמצעות SCIM.
יצירת מפתח ניהול
היכנסו למסוף הניהול.
בחרו את הדייר שלכם במידת הצורך, ואז בחרו את ה-workspace ב-ChatGPT שבו יש לכם תפקיד בעלים או מנהל.
פתחו את פרטי הזדהות, ואז בחרו מפתחות ניהול.
בחרו יצירת מפתח ניהול חדש והזינו שם תיאורי.
בחרו מועד תפוגה: לעולם לא, 30 יום, 60 יום, 90 יום או התאמה אישית. אפשר להגדיר תפוגה מותאמת אישית בטווח של יום אחד עד 365 ימים.
בחרו את ההרשאות שהאינטגרציה שלכם זקוקה להן. בעלי workspace יכולים לבחור הכול, קריאה בלבד או התאמה אישית; מנהלי workspace בוחרים את ההרשאה הזמינה לכל קטגוריה.
בחרו שליחה, ואז העתיקו את הערך הסודי ושמרו אותו באופן מאובטח. לא תוכלו לצפות שוב בערך הסודי.
במפתחות של בעלי workspace, ברירת המחדל להרשאות עשויה להיות הכול, וברירת המחדל לתפוגה עשויה להיות לעולם לא. בדקו את שתי ההגדרות לפני יצירת מפתח.
בדיקה, עריכה או ביטול של מפתח ניהול
פתחו את ה-workspace של ChatGPT במסוף הניהול, ואז עברו אל פרטי הזדהות > מפתחות ניהול. בדקו לכל מפתח את השם, הסטטוס, מזהה המעקב, הערך הסודי המוסתר חלקית, היוצר, ההרשאות, תאריך השימוש האחרון ומועד התפוגה.
כדי לשנות את השם או ההרשאות של מפתח, פתחו את תפריט האפשרויות הנוספות שלו (•••), בחרו עריכה, בצעו את השינויים ובחרו שמירת שינויים.
כדי להפסיק להשתמש במפתח, פתחו את תפריט האפשרויות הנוספות שלו (•••), בחרו ביטול ואשרו באמצעות ביטול מפתח ניהול.
בעלי workspace יכולים לערוך או לבטל כל מפתח של ה-workspace שנבחר. מנהלי workspace יכולים לערוך או לבטל רק מפתחות שהם יצרו, ורק כאשר הרשאות המפתח זמינות לתפקידם הנוכחי. בקשו מבעלים של ה-workspace לנהל מפתחות עם הרשאות המיועדות לבעלים בלבד. לא ניתן לשנות מועדי תפוגה קיימים.
מפתחות שבוטלו מפסיקים לפעול לאחר שהשינוי נכנס לתוקף. לפני ביטול מפתח שעדיין נמצא בשימוש, צרו מפתח חלופי ועדכנו את כל האינטגרציות המושפעות.
הבנת היבטי תאימות ונתונים רגישים
חלק מההרשאות של מפתחות ניהול עלולות לחשוף פעילות או תוכן רגישים ב-workspace. רק בעלי workspace יכולים להעניק גישה נרחבת לצורכי תאימות או גישה להודעות בשיחות.
ייתכן שמנהלי workspace יוכלו להעניק גישה לקטגוריות ספציפיות ונתמכות של יומנים, כולל יומני ביקורת, אימות או אפליקציות. בדקו כל קטגוריה בקפידה; גם יומנים ספציפיים עשויים להכיל מידע רגיש.
למידע על ממשקי API לצורכי תאימות ועל גישה לנתונים, ראו: OpenAI Compliance Platform ללקוחות Enterprise ו-Edu.
בקשות ל-API לניהול workspace ב-ChatGPT משתמשות בכתובת https://api.chatgpt.com/v1. לדוגמה, השתמשו ב-/manage/workspaces/{workspace_id}/users כדי לקבל רשימה של החברים הנוכחיים ב-workspace. ממשקי endpoint תחת /v1/organization/ מנהלים ארגונים בפלטפורמת API ודורשים מפתח ניהול של ארגון בפלטפורמת API.
למידע על נתיבי endpoint, סכמות בקשה ותגובה והיקפי הרשאה נדרשים, עיינו בתיעוד ה-API לניהול.
ההבדל בין מפתחות ניהול לפרטי הזדהות אחרים
מפתחות ניהול של workspace משמשים לאימות מול ממשקי API נתמכים לניהול ChatGPT ו-Codex עבור workspace אחד ב-ChatGPT. הם אינם מעניקים גישה להרצת הסקה באמצעות מודלים.
אסימוני גישה של חשבונות שירות ב-Codex מאמתים זהות שאינה אנושית ב-workspace לצורך אוטומציה של Codex. הם אינם משמשים לאימות בקשות ל-API לניהול. להנחיות הגדרה, ראו: יצירה וניהול של חשבונות שירות ב-Codex.
מפתחות ניהול של ארגונים בפלטפורמת API מנוהלים בנפרד בפלטפורמת API ואינם משמשים לניהול סביבות workspace ב-ChatGPT.
אם אתם זקוקים למפתח עבור ארגון בפלטפורמת API, פתחו את מפתחות ניהול של ארגון בפלטפורמת API. השתמשו בממשקי endpoint של ה-API לניהול ChatGPT המיועדים ל-workspace מסוים עם מפתח ניהול של אותו workspace; ממשקי endpoint של ארגונים בפלטפורמת API דורשים פרטי הזדהות נפרדים.
פתרון בעיות גישה והרשאות חסרות
ודאו שנכנסתם באמצעות חשבון OpenAI הנכון ובחרתם את הדייר ואת ה-workspace הרצויים ב-ChatGPT.
בדקו שהחברות שלכם ב-workspace פעילה ושתפקידכם בו הוא בעלים או מנהל.
ודאו שה-workspace שלכם ב-ChatGPT זכאי לשימוש במפתחות ניהול. הזמינות עשויה להשתנות בהתאם לתוכנית ולשלב ההשקה.
אם חסרה קטגוריית הרשאות, ודאו שהתכונה זמינה ב-workspace שנבחר ושהתפקיד שלכם מאפשר גישה אליה. אם הקטגוריה הנדרשת עדיין אינה זמינה, פנו לתמיכה של OpenAI במקום לבחור הרשאה שאינה קשורה.
אם אינכם יכולים לערוך מפתח או לבטל אותו, ודאו שאתם יצרתם אותו ושהרשאותיו זמינות לתפקידכם הנוכחי. בקשו מבעלים של ה-workspace לנהל מפתחות עם הרשאות המיועדות לבעלים בלבד.
אם מפתח שפעל בעבר מפסיק לפעול, בדקו את הסטטוס ואת התפוגה שלו, ודאו שתוקפו לא פג ושהוא לא בוטל, ובדקו שליוצר המפתח עדיין יש תפקיד פעיל ב-workspace עם ההרשאות הנדרשות.
אם הבעיה נמשכת, פנו לתמיכה של OpenAI. צרפו את מזהה הדייר, את השם או המזהה של ה-workspace וצילום מסך אם תתבקשו, אך לעולם אל תשתפו את הערך הסודי של מפתח ניהול.
הגנה על מפתחות הניהול שלכם
בחרו הרשאות בהתאמה אישית והעניקו רק את הגישה שהאינטגרציה שלכם זקוקה לה.
הגדירו מועד תפוגה במידת האפשר. האפשרות לעולם לא פירושה שלא נקבע למפתח מועד תפוגה. מפתח עדיין עשוי להפסיק לפעול אם הוא מבוטל, אם יוצרו מאבד את הגישה הנדרשת ל-workspace או אם החשבון של יוצרו מושבת.
השתמשו במפתחות נפרדים לאינטגרציות או לתהליכי עבודה שונים.
אחסנו ערכים סודיים בכלי מאובטח לניהול סודות. לעולם אל תשלחו אותם בדוא״ל, בצ'אט או בפנייה לתמיכה.
בדקו באופן קבוע את השימוש ואת מועדי התפוגה, ובטלו מפתחות שאינכם זקוקים להם עוד.
