רשימת בדיקה לעלייה לאוויר

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

הגדרת ה-Partner Console

פרופיל השותף שלכם מלא.
כתובת ה-URL של הלוגו, האתר, הקטגוריה והתיאור מדויקים.
שיטת קישור הנתונים שלכם מוגדרת: Direct Link או Linking Identifier.
הקישור למתקנים נבדק עם מתקן אמיתי אחד לפחות.
נעשה שימוש בסוג המפתח הנכון:
- Dryrun לבדיקות כתיבה שאינן הרסניות.
- Read-only לצריכת נתונים בטוחה.
- Live רק כשאתם מוכנים להשפיע על נתוני הייצור.

אימות וניהול מפתחות

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

אימות נתונים

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

בדיקת נקודות קצה

לפני ההשקה, בדקו כל נקודת קצה שהאינטגרציה שלכם תלויה בה:

אפשר לקרוא ארגונים ומתקנים.
אפשר לשמור ולעדכן חברים.
תוכניות חברות, אזורי גישה ושעות גישה מסתנכרנים כראוי.
צ׳ק-אינים מתקבלים ואפשר להצליב אותם חזרה מול המערכת שלכם.
תמונות מצב של דוחות משתמשות בתקופת הדיווח ובמדדים הצפויים.
תהליכי Door/Gate Controller נבדקו על חומרה אמיתית, במקרים הרלוונטיים.

מוכנות ל-Access Time Windows

אם האינטגרציה מספקת Access Time Windows:

דוגמאות מוחלטות ושבועיות עוברות את רשימת הבדיקה להסמכת יצרנים.
ערכי epoch הם מספרים שלמים של שניות Unix ללא מירכאות; גבולות [from, to) מדויקים נבדקו.
ברירות המחדל של UTC, אזורי הזמן המותאמים אישית של IANA שבהם האינטגרציה משתמשת ומעברי שעון קיץ רלוונטיים אומתו.
זרם גרסאות עמיד ומונוטוני אחד לכל חבר/מקור מתאם עדכונים מצטברים, התאמות וניסיונות חוזרים.
המפעילים מבינים את ההתנהגות במקרים של השמטה, החלפה מלאה, אידמפוטנטיות, התנגשות, נתונים ישנים ו-[] מפורש.
לכל scope_key, כולל default, יש מיפוי מאושר ב-Performance Hub; נבדק שמפתחות לא מוכרים גורמים לסירוב גישה.
קצב הרענון הצפוי של האינטגרציה, הגיל המרבי של נתוני המקור, ההתנהגות כשהמקור אינו עדכני וההתראות מוגדרים.
הוכח שכשל בשליפה ממערכת המקור אינו שולח תמונת מצב ריקה או חלקית.
התכנסות זרם ה-stage, ביטול/שלילה וגבולות ההתחלה והסיום בדלת הפיזית עומדים ביעדים שסוכמו.
כללים רגילים והרשאות קבועות אומתו כנתיבי גיבוי, וחלונות אינם יכולים לעקוף השבתת משתמש, blockAllAccess, תחזוקה או גידור גאוגרפי.

מוכנות לבקרת גישה

באינטגרציות של בקרת גישה:

המערכת שלכם מקבלת את החלטת הגישה לפני הקריאה ל-Performance Hub.
האינטגרציה מטפלת ב-device_offline, ב-maintenance_mode_active וב-unlock_confirmation_timeout.
המפעילים מבינים שזמן קצוב שפג פירושו שהפתיחה לא אושרה.
היומנים שלכם שומרים את ה-event_id וה-command_id שהוחזרו.
יש לכם תהליך גיבוי ידני לצוות המתקן.

טיפול בשגיאות וניסיונות חוזרים

תגובות 400, 401, 403, 404, 409 ו-422 מוצגות למפעילים או לצוותי התמיכה, במקום לנסות אותן שוב באופן עיוור.
תגובות 429, 500, 502, 503 ו-504 משתמשות בלוגיקת ניסיון חוזר מוגבלת עם השהיה.
כשלים חוזרים יוצרים התראה במערכת שלכם.
האינטגרציה לעולם אינה משמיטה רשומות שנכשלו בשקט.

יכולת מעקב

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

השקה בסביבת הייצור

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

לאחר שבדיקות אלה הושלמו, האינטגרציה שהגדרתם תופיע במדריך השותפים של Performance Hub בתוך פלטפורמת הליבה של Performance Hub.