ניהול, יצירה מחדש וביטול של אסימוני API
מצא את אסימוני ה-API שלך, צור מחדש מפתח סודי (פעם אחת, עם חפיפה אופציונלית של 24 שעות), בטל אסימון, הבן את תוקף האסימונים ורשימות היתרים (Allowlist) של כתובות IP, וראה מדוע אסימון הפסיק לעבוד.
הכרטיסייה אסימונים מציגה את אסימוני ה-API שלך יחד עם הגישה, המגבלות והשימוש האחרון שלהם. משם תוכל ליצור מחדש מפתח סודי של אסימון, לבטל אסימון ולראות מדוע אסימון הפסיק לעבוד.
היכן למצוא את האסימונים שלך
פתח את תפריט סביבת העבודה ובחר ב-AI agents & API. הכרטיסייה אסימונים היא הכרטיסייה הראשונה; כל כרטיסייה מציגה את מספר הפריטים שבה.
מי רואה אילו אסימונים:
| התפקיד שלך | אתה רואה | אתה יכול |
|---|---|---|
| בעלים או מנהל | "כל אסימון בסביבת עבודה זו. חברים רואים את האסימונים שלהם בלבד." סנן לפי אדם בעזרת תפריט הבעלים (כולם מציג את הכל). | לבטל כל אסימון. ליצור מחדש רק את האסימונים שלך. |
| עורך או יוצר תוכן | "האסימונים שלך. סוכנים המשתמשים בהם פועלים בשמך." | לבטל וליצור מחדש את האסימונים שלך. |
כל שורה מציגה את ה-שם (עם התווים האחרונים של המפתח הסודי, כמו clv_agent_…k7Qe), ה-בעלים, ה-גישה (ההרשאות שלו), ה-אתרים שהוא מכסה, ה-נוצר, ה-שימוש אחרון ו-פג תוקף ב-. הכותרת התחתונה סופרת את האסימונים הפעילים בסביבת העבודה אל מול המגבלה שלה. תגים בשורה:
| תג | משמעות |
|---|---|
| מנצל קרדיטים | לאסימון יש credits:spend. הצבע עליו כדי לראות את המגבלות שלו: למשימה, ליום, לחודש ("ללא מגבלה" כאשר ריק) ו-"מאושר אוטומטית מתחת ל-n קרדיטים" או "אדם מאשר כל התחלה בתשלום". |
| מוגבל ב-IP | לאסימון יש רשימת היתרים (Allowlist) של כתובות IP והוא עובד רק מכתובות אלו. |
| חורג מהתפקיד | "תפקיד הבעלים השתנה. קריאות הזקוקות ליכולות שנמחקו מסורבות." |
| בוטל / פג תוקף | האסימון אינו עובד יותר. הסיבה מוצגת לצדו (ראה מדוע אסימון הפסיק לעבוד). |
אסימונים שבוטלו או שפג תוקפם מוסתרים כברירת מחדל. לחץ על הצג אסימונים שבוטלו ושפג תוקפם (count) כדי להציג אותם; הם יישארו ברשימה למשך 30 יום.
שינוי הגישה של אסימון
לא ניתן לערוך הרשאות, אתרים, תוקף, מגבלות ניצול ורשימת היתרים (Allowlist) של כתובות IP של אסימון לאחר יצירתו. כדי לשנות אחד מהם, צור אסימון חדש עם ההגדרות החדשות, העבר את הסוכן שלך אליו, ולאחר מכן בטל את הישן.
יצירה מחדש של מפתח סודי של אסימון
צור מחדש כאשר קיים חשש לדליפת מפתח סודי, או כדי לרענן אותו לפי לוח זמנים. למפתח הסודי החדש יהיו אותו שם, גישה, אתרים, רשימת היתרים (Allowlist) של כתובות IP, מגבלות ניצול ותאריך תפוגה.
פתח את תפריט האסימון
בכרטיסייה אסימונים, פתח את תפריט ה-⋯ בשורת האסימון ובחר ב-צור מחדש מפתח סודי.
בחר מתי המפתח הסודי הישן יפסיק לעבוד
תיבת הדו-שיח שואלת "ליצור מחדש את “name”?": "תקבל מפתח סודי חדש עם אותה גישה. הישן יפסיק לעבוד." סמן את שמור על המפתח הסודי הישן פעיל למשך 24 שעות אם סוכנים עדיין משתמשים בו ואתה זקוק לזמן כדי להעביר אותם. השאר זאת ללא סימון כדי להפסיק את המפתח הישן באופן מיידי.
העתק את המפתח הסודי החדש
לחץ על צור מחדש. תיבת הדו-שיח האסימון נוצר מציגה את המפתח הסודי החדש פעם אחת. העתק אותו, עדכן את הסוכן או את כספת המפתחות שלך, ולאחר מכן לחץ על שמרתי את זה.
כללים ליצירה מחדש:
- רק האדם שיצר את האסימון יכול ליצור אותו מחדש. בעלים או מנהל שלא יצרו אותו יראו "רק האדם שיצר אסימון זה יכול ליצור אותו מחדש. באפשרותך לבטל אותו."
- ניתן ליצור מפתח סודי מחדש פעם אחת. לאחר מכן, השורה הישנה תציג "הוחלף על ידי מפתח סודי שנוצר מחדש" ולא תהיה בה אפשרות צור מחדש מפתח סודי; צור מחדש את האסימון החדש במקום. ניסיון חוזר על המפתח הישן יחזיר "אסימון זה כבר נוצר מחדש, בוטל או שפג תוקפו; השתמש בתחליף שלו או צור חדש."
- תאריך התפוגה אינו משתנה. אסימון שנוצר ל-90 יום עדיין יפוג בתאריך המקורי שלו. אם 24 השעות של המפתח הישן יחלפו מעבר לתאריך זה, הוא יפסיק לעבוד בתאריך התפוגה.
- ניתן ליצור מחדש גם כאשר סביבת העבודה נמצאת במגבלת האסימונים הפעילים שלה. במהלך חפיפת 24 השעות, שני המפתחות עובדים ושניהם נספרים כאסימונים פעילים.
- יצירה מחדש דורשת שסביבת העבודה תהיה בתוכנית Pro ומעלה; אחרת צור מחדש מפתח סודי יפתח את תיבת הדו-שיח לשדרוג.
ביטול אסימון
- פתח את תפריט ה-⋯ בשורת האסימון ובחר ב-ביטול.
- אשר בעזרת ביטול אסימון: "סוכנים המשתמשים באסימון זה יאבדו גישה באופן מיידי. לא ניתן לבטל פעולה זו."
אסימון שבוטל מפנה את מקומו במגבלת האסימונים הפעילים של סביבת העבודה באופן מיידי.
תוקף
לכל אסימון יש תוקף. אתה בוחר את משך החיים בעת היצירה: 7 ימים, 30 יום, 90 יום (ברירת המחדל) או שנה אחת. אין אפשרות של "ללא תוקף", כך שאסימון שנשכח לא יכול להישאר תקף לנצח. העמודה פג תוקף ב- מציגה את התאריך.
לאחר תאריך התפוגה, כל קריאה תחזיר "אסימון זה פג תוקף. צור חדש תחת Integrations → AI agents & API." לא ניתן לחדש או ליצור מחדש אסימון שפג תוקפו; צור חדש.
רשימת היתרים (Allowlist) של כתובות IP
ניתן להגביל אסימון לכתובות שמהן הסוכן שלך פועל (למשל, מריץ CI או שרת). אתה מגדיר זאת בשלב ה-מגבלות של אשף היצירה תחת מתקדם → רשימת היתרים (Allowlist) של כתובות IP: "אופציונלי. כתובת אחת או טווח אחד בכל שורה; קריאות מכל מקום אחר יסורבו."
- הזן כתובות IPv4 או IPv6 (
203.0.113.7) או טווחים בפורמט CIDR (198.51.100.0/24), עד 20 ערכים. - השאר ריק כדי לאפשר כל כתובת. שלב הסקירה יציג אז כל כתובת.
- קריאה מכתובת אחרת תחזיר "לא ניתן להשתמש באסימון זה מכתובת IP זו."
- ערך שאינו כתובת או טווח יסורב: "value אינו כתובת IP או טווח."
מדוע אסימון הפסיק לעבוד
| מוצג על האסימון | מה קרה | מה לעשות |
|---|---|---|
| פג תוקף | משך החיים שלו הסתיים. | צור אסימון חדש. |
| "בוטל על ידי הבעלים שלו" | האדם שיצר אותו ביטל אותו. | צור אסימון חדש אם הוא עדיין נחוץ. |
| "בוטל על ידי מנהל" | בעלי סביבת העבודה או מנהל ביטלו אותו. | שאל אותם מדוע לפני יצירת חדש. |
| "בוטל: הבעלים עזב את סביבת העבודה" | האדם שיצר אותו הוסר מסביבת העבודה. כל האסימונים שלו בוטלו. | מישהו שעדיין נמצא בסביבת העבודה ייצור אסימון חדש. |
| "בוטל: חשבון הבעלים נמחק" | הבעלים מחק את חשבון ה-Clevera שלו. | צור אסימון חדש. |
| "הוחלף על ידי מפתח סודי שנוצר מחדש" | המפתח הסודי נוצר מחדש. | השתמש במפתח הסודי החדש. |
| "בוטל: נמצא במאגר ציבורי" | האסימון נמצא במאגר GitHub ציבורי ובוטל אוטומטית. | הסר אותו מהיסטוריית המאגר, ולאחר מכן צור אסימון חדש ושמור אותו בכספת מפתחות. |
| "בוטל: פעילות חריגה" | הוא ביצע בקשות מסורבות רבות תוך דקות ספורות (יותר מ-50 ב-10 דקות). | בדוק את ה-פעילות כדי לראות מה הוא ניסה לעשות, תקן את הסוכן, ולאחר מכן צור אסימון חדש. |
| "בוטל: זוהה שימוש חוזר באסימון" / "בוטל: האפליקציה התנתקה" | אלו חלים על אפליקציות מחוברות, לא על אסימוני API. | חבר את האפליקציה מחדש. |
| כל קריאה מחזירה "ה-API של הסוכן אינו כלול בתוכנית של סביבת עבודה זו. הוא כלול ב-Pro ומעלה." | סביבת העבודה עברה מתוכנית Pro, Business או Custom. | שדרג ל-Pro. ראה אם סביבת העבודה עוזבת את Pro. |
פעילות חריגה
Clevera עוקבת אחר כל אסימון עבור התפרצויות פעילות ומודיעה לבעלי סביבת העבודה עם התראה "פעילות חריגה ב-token ":
- בקשות מסורבות רבות תוך דקות ספורות: האסימון מבוטל. "הוא ביצע בקשות מסורבות רבות תוך דקות ספורות."
- מספר חריג של שינויים תוך דקות ספורות (יותר מ-200 כתיבות או 20 מחיקות דפים ב-10 דקות): הכתיבות שלו מושהות ל-10 דקות. קריאות יחזירו "כתיבות מאסימון זה מושהות לאחר התפרצות חריגה של שינויים. בעלי סביבת העבודה קיבלו הודעה." קריאות עדיין עובדות.
- קרדיטים נוצלו מהר באופן חריג: האסימון לא יכול להתחיל עבודה בתשלום למשך 24 שעות. "הוא ניצל מספר חריג של קרדיטים תוך דקות ספורות, לכן הוא לא יכול להתחיל עבודה בתשלום כרגע."
אם סביבת העבודה עוזבת את Pro
AI agents & API כלולים בתוכניות Pro, Business ו-Custom. אם סביבת העבודה עוברת ל-Starter או Free, הדף מציג "AI agents & API כלולים ב-Pro": "שדרג כדי לאפשר ל-Claude, ChatGPT והסקריפטים שלך לעבוד בסביבת עבודה זו. אסימונים ואפליקציות קיימים יפסיקו לעבוד עד אז; עדיין תוכל לבטל אותם כאן."
- אסימונים נשארים ברשימה וניתן לבטל אותם, אך כל קריאה מסורבת עם
plan_locked. - צור מחדש מפתח סודי פותח את תיבת הדו-שיח לשדרוג במקום.
- שדרוג חזרה ל-Pro גורם לאסימונים לעבוד שוב. שום דבר לא נמחק; אסימונים עדיין פגים בתאריכים שלהם.