מפתחות API

צור, חשוף ובטל את שני סוגי המפתחות ש‑Syncanix מנפיק — מפתח סודי ל‑CLI ול‑MCP, ומפתח לפרסום עבור הווידג׳ט המוטמע.

מפתחות API מאפשרים לכלים שלך להגיע אל מרחב העבודה שלך. יש שני סוגים, וההבדל חשוב: האחד הוא סוד בצד השרת, והשני בטוח לשילוב בעמוד האינטרנט שלך.

שני סוגי המפתחות

מפתח סודי (gak_…): בעל יכולת מלאה ולצד שרת בלבד. ה‑CLI משתמש בו כדי להעלות את הקטלוג שלך, ושרת ה‑MCP משתמש בו לאימות. החזק אותו מחוץ לכל קוד צד‑לקוח.
מפתח לפרסום (pk_…): לשיחה בלבד וקשור למקור, ולכן בטוח להטמעה בקוד המקור של העמוד שלך — בדיוק מה שווידג׳ט הצ׳אט משתמש בו. הוא יכול להתחיל שיחה ותו לא.

gak_<env>_<32 base32 chars>   # secret — CLI / MCP, server-side only
pk_<test|live>_<32 base32 chars>  # publishable — embedded in your page

המפתחות מנוהלים תחת הגדרות ← מפתחות API בלוח הבקרה.

פתח מפתחות APIעבור אל הגדרות ← מפתחות API ובחר את הסביבה שעבורה אתה יוצר מפתח.
בחר את הסוגצור מפתח סודי ל‑CLI או ל‑MCP, או מפתח לפרסום עבור הווידג׳ט. תן לו שם שתזהה אחר כך.
העתק אותו עכשיוהמפתח המלא מוצג פעם אחת בלבד. העתק אותו ושמור במקום בטוח לפני סגירת החלון.

כל מפתח שייך לסביבה אחת. מפתח פיתוח אינו יכול לגעת בנתוני ייצור ולהפך, מה ששומר על הפרדה נקייה בין תעבורת הבדיקות לתעבורה החיה.

בטל מפתח מאותו עמוד והוא יפסיק לעבוד מיד. בטל מיד אם מפתח נחשף אי‑פעם, ואז צור חלופה. ביטול מפתח אחד לעולם אינו משפיע על אחר.

אחסן מפתחות סודיים במנהל סודות או במשתנה סביבה — לעולם לא בבקרת גרסאות או בקוד צד‑לקוח.
מפתחות לפרסום נועדו לקצה הקדמי — הם רק מתחילים שיחות וקשורים למקורות שאתה מתיר.
החלף מפתחות מעת לעת: צור את החדש, העבר אליו את הכלים שלך, ואז בטל את הישן.
יצירת כל מפתח וביטולו נרשמים ביומן הביקורת של מרחב העבודה שלך.