אימות API

העמוד "אימות API ב-Zentor ללא מפתח API" עוסק בתחום הפונקציונלי המצוין בכתובת ה-URL. התוכן הקיים משולב בתיאור התהליך בפועל, בתנאים המקדימים ובמגבלות הידועות. ל-Zentor אין מערכת מפתחות API למפתחים. לדשבורד משתמשים ב-JWTs של סשן עם תוקף של 12 שעות ובטוקני רענון (Refresh Tokens) עם תוקף של 7 ימים; TOTP ו-SSO הם אופציונליים. טוקני הטמעה (Embed Tokens) של וידג'טים מוצגים פעם אחת בלבד בטקסט גלוי (Plain Text) וקשורים ל-Origin מאושר.

ל-Zentor אין מערכת מפתחות API כללית למפתחים. לדשבורד משתמשים ב-JWTs של סשן עם תוקף של 12 שעות ובטוקני רענון עם תוקף של 7 ימים. TOTP ו-SSO זמינים כאופציה.

הוידג'ט משתמש בטוקן הטמעה (Embed Token) המוצג פעם אחת בלבד בטקסט גלוי. בנוסף, נערכת בדיקת ה-Origin. טוקן ואישור הדומיין מהווים יחידה אחת; טוקן תקף מ-Origin שאינו מאושר אינו מספיק.

אסור ש-JWTs של סשן וטוקני וידג'טים יגיעו למאגרי קוד מקור (Repositories), ליומנים ציבוריים או לדוגמאות בתיעוד. לאחר פקיעת התוקף או ביטול הטוקן, על היישום להשתמש בתהליך החידוש או ההתחברות המתאים באופן מחייב.

מסלולי הדשבורד הפנימיים ומסלולי ה-Master Admin אינם חלק מ-API ציבורי למפתחים. התחברות מוצלחת מעניקה הרשאות רק בהתאם לתפקיד (Role) ולטננט (Tenant) הפעיל. אינטגרציות אינן צריכות לטפל בנקודות קצה (Endpoints) פנימיות כממשק ציבורי יציב.

לעמוד "אימות API ב-Zentor ללא מפתח API" חל העיקרון הבא: הטקסט הקצר הקיים מוקדם יותר מורחב להדרכה אמינה, ללא הבטחה על תכונות מוצר שאינן חלק מהגרסה המאומתת של המוצר. מקורות העובדות המאומתים והאחריות הנראית לעין בין הטננט ל-Zentor נשארים קובעים. במקרה של חריגות, יש לציין תמיד את כתובת ה-URL המדויקת, את הטננט המושפע ואת השלב שנצפה.

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