Lista kontrolna uruchomienia produkcyjnego

Skorzystaj z tej listy kontrolnej przed włączeniem integracji partnera dla obiektów produkcyjnych.

Konfiguracja Partner Console

• Profil partnera jest kompletny.
• Adres URL logo, witryna, kategoria i opis są poprawne.
• Metoda łączenia danych jest skonfigurowana: Direct Link lub Linking Identifier.
• Łączenie obiektów zostało przetestowane na co najmniej jednym rzeczywistym obiekcie.
• Używany jest właściwy typ klucza:
  • Dryrun do nieniszczących testów zapisu.
  • Read-only do bezpiecznego pobierania danych.
  • Live tylko wtedy, gdy możesz już wpływać na dane produkcyjne.

Uwierzytelnianie i zarządzanie kluczami

• Tajne klucze są przechowywane wyłącznie po stronie serwera.
• Klucze nie są osadzone w aplikacjach po stronie klienta, aplikacjach mobilnych, publicznych repozytoriach ani zgłoszeniach do pomocy technicznej.
• Rotacja i unieważnianie kluczy zostały przetestowane.
• Twój zespół wie, który klucz jest używany w którym środowisku.

Walidacja danych

• Wymagane pola są obecne w każdym wywoływanym punkcie końcowym.
• Identyfikatory obiektów są zgodne ze skonfigurowaną metodą łączenia.
• Identyfikatory z Twojego systemu są stabilne i nie zmieniają się między synchronizacjami.
• Duże importy są dzielone na partie w granicach udokumentowanych limitów.
• Nieudane elementy partii można zidentyfikować i wysłać ponownie.

Testowanie punktów końcowych

Przed uruchomieniem przetestuj każdy punkt końcowy, od którego zależy Twoja integracja:

• Można odczytać organizacje i obiekty.
• Można zapisywać i aktualizować członków.
• Plany członkostwa, strefy dostępu i godziny dostępu synchronizują się poprawnie.
• Wejścia są akceptowane i można je powiązać z Twoim systemem.
• Migawki raportów używają oczekiwanego okresu raportowania i wskaźników.
• Procesy kontrolerów drzwi/bram zostały przetestowane na rzeczywistym sprzęcie, jeśli dotyczy.

Gotowość Access Time Windows

Jeśli integracja dostarcza Access Time Windows:

• Przykłady okien bezwzględnych i tygodniowych przechodzą listę kontrolną certyfikacji producenta.
• Wartości epoki są liczbami całkowitymi sekund Unix bez cudzysłowów; dokładne granice [from, to) zostały przetestowane.
• Zweryfikowano domyślne ustawienia UTC, niestandardowe strefy czasowe IANA integracji i odpowiednie zmiany czasu letniego.
• Jeden trwały, monotoniczny strumień wersji członka/źródła koordynuje aktualizacje przyrostowe, uzgadnianie i ponowienia.
• Operatorzy rozumieją działanie w przypadku pominięcia, pełnego zastąpienia, idempotencji, konfliktu, nieaktualności i jawnego [].
• Każdy scope_key, w tym default, ma zatwierdzone mapowanie w Performance Hub; przetestowano, że nieznane klucze powodują odmowę dostępu.
• Skonfigurowano oczekiwaną częstotliwość odświeżania integracji, maksymalny wiek danych źródłowych, zachowanie przy nieaktualnym źródle i alerty.
• Udowodniono, że błąd pobierania danych ze źródła nie powoduje wysłania pustej ani częściowej migawki.
• Zbieżność strumienia w środowisku staging, anulowanie/odwołanie oraz granice rozpoczęcia i zakończenia na fizycznych drzwiach spełniają uzgodnione cele.
• Zweryfikowano zwykłe reguły i stałe uprawnienia jako ścieżki zapasowe, a okna nie mogą obejść wyłączenia użytkownika, blockAllAccess, trybu serwisowego ani geofencingu.

Gotowość kontroli dostępu

W przypadku integracji kontroli dostępu:

• Twój system podejmuje decyzję o dostępie przed wywołaniem Performance Hub.
• Integracja obsługuje device_offline, maintenance_mode_active i unlock_confirmation_timeout.
• Operatorzy rozumieją, że przekroczenie limitu czasu oznacza, że otwarcie nie zostało potwierdzone.
• Twoje dzienniki zapisują zwracane wartości event_id i command_id.
• Masz ręczny proces awaryjny dla personelu obiektu.

Obsługa błędów i ponowień

• Odpowiedzi 400, 401, 403, 404, 409 i 422 są przekazywane operatorom lub zespołom wsparcia, a nie ponawiane bezrefleksyjnie.
• Odpowiedzi 429, 500, 502, 503 i 504 korzystają z ograniczonej logiki ponowień z wydłużaniem odstępów.
• Powtarzające się błędy generują alert w Twoim systemie.
• Integracja nigdy nie pomija po cichu nieudanych rekordów.

Obserwowalność

• Twoje dzienniki zawierają punkt końcowy, znacznik czasu, identyfikator obiektu, identyfikator rekordu źródłowego, wynik żądania i treść odpowiedzi.
• Twój zespół wsparcia może wyszukiwać według identyfikatora członka, identyfikatora obiektu, identyfikatora wejścia lub identyfikatora zdarzenia otwarcia.
• Masz sposób na ponowne odtworzenie lub uzgodnienie nieudanych synchronizacji.

Uruchomienie produkcyjne

• Performance Hub potwierdził Twój dostęp produkcyjny.
• Co najmniej jeden obiekt produkcyjny włączył Twoją integrację.
• Twój klucz produkcyjny jest aktywny.
• Twoje dane kontaktowe do spraw operacyjnych i technicznych są aktualne.
• Twój proces wsparcia jest udokumentowany dla klientów.

Po zakończeniu tych kontroli Twoja skonfigurowana integracja pojawi się w katalogu partnerów Performance Hub w ramach podstawowej platformy Performance Hub.