Go-live-Checkliste

Gehen Sie diese Checkliste durch, bevor Sie eine Partnerintegration für Einrichtungen in der Produktion aktivieren.

Einrichtung der Partner Console

• Ihr Partnerprofil ist vollständig.
• Logo-URL, Website, Kategorie und Beschreibung sind korrekt.
• Ihre Datenverknüpfungsmethode ist konfiguriert: Direct Link oder Linking Identifier.
• Die Verknüpfung mit Einrichtungen wurde mit mindestens einer echten Einrichtung getestet.
• Der richtige Schlüsseltyp wird verwendet:
  • Dryrun für zerstörungsfreie Schreibtests.
  • Read-only für die sichere Datennutzung.
  • Live erst, wenn Sie bereit sind, Produktionsdaten zu verändern.

Authentifizierung und Schlüsselverwaltung

• Geheime Schlüssel werden ausschließlich serverseitig gespeichert.
• Schlüssel sind nicht in clientseitige Anwendungen, mobile Apps, öffentliche Repositorys oder Support-Tickets eingebettet.
• Rotation und Widerruf von Schlüsseln wurden getestet.
• Ihr Team weiß, welcher Schlüssel in welcher Umgebung verwendet wird.

Datenvalidierung

• Für jeden aufgerufenen Endpunkt sind die erforderlichen Felder vorhanden.
• Die Einrichtungskennungen entsprechen Ihrer konfigurierten Verknüpfungsmethode.
• Die IDs aus Ihrem System sind stabil und ändern sich zwischen Synchronisierungen nicht.
• Große Importe werden in Batches innerhalb der dokumentierten Grenzen aufgeteilt.
• Fehlgeschlagene Batch-Elemente können identifiziert und erneut gesendet werden.

Endpunkttests

Testen Sie vor dem Launch jeden Endpunkt, von dem Ihre Integration abhängt:

• Organisationen und Einrichtungen können gelesen werden.
• Mitglieder können gespeichert und aktualisiert werden.
• Mitgliedschaftstarife, Zutrittszonen und Zutrittszeiten werden korrekt synchronisiert.
• Check-ins werden akzeptiert und können Ihrem System zugeordnet werden.
• Berichts-Snapshots verwenden den erwarteten Berichtszeitraum und die erwarteten Kennzahlen.
• Abläufe mit dem Door/Gate Controller werden, sofern zutreffend, mit echter Hardware getestet.

Bereitschaft für Access Time Windows

Wenn die Integration Access Time Windows liefert:

• Absolute und wöchentliche Beispiele bestehen die Zertifizierungscheckliste für Producer.
• Epoch-Werte sind ganzzahlige Unix-Sekunden ohne Anführungszeichen; exakte [from, to)-Grenzen wurden getestet.
• UTC-Standardwerte, die benutzerdefinierten IANA-Zeitzonen der Integration und relevante Sommerzeitumstellungen wurden überprüft.
• Ein einziger dauerhafter, monotoner Revisionsstrom pro Mitglied und Quelle koordiniert inkrementelle Aktualisierungen, Abgleiche und Wiederholungen.
• Die Betreiber verstehen das Verhalten bei weggelassenen Werten, vollständigem Ersatz, idempotenten, widersprüchlichen und veralteten Snapshots sowie bei explizitem [].
• Jeder scope_key, einschließlich default, hat eine genehmigte Zuordnung im Performance Hub; es wurde getestet, dass unbekannte Schlüssel zur Verweigerung führen (fail closed).
• Die erwartete Aktualisierungsfrequenz der Integration, das maximale Alter der Quelldaten, das Verhalten bei veralteten Quellen und Warnungen sind konfiguriert.
• Es wurde nachgewiesen, dass ein fehlgeschlagener Abruf aus der Quelle keinen leeren oder unvollständigen Snapshot erzeugt.
• Konvergenz des Stage-Stroms, Stornierung/Widerruf sowie Start- und Endgrenzen an der physischen Tür erfüllen die vereinbarten Ziele.
• Reguläre Regeln und dauerhafte Berechtigungen wurden als Fallback-Pfade überprüft, und Zeitfenster können weder die Deaktivierung von Benutzern, blockAllAccess, die Wartung noch das Geofencing umgehen.

Bereitschaft für die Zutrittskontrolle

Für Integrationen zur Zutrittskontrolle:

• Ihr System trifft die Zutrittsentscheidung, bevor es den Performance Hub aufruft.
• Die Integration verarbeitet device_offline, maintenance_mode_active und unlock_confirmation_timeout.
• Die Betreiber wissen, dass eine Zeitüberschreitung bedeutet, dass die Entriegelung nicht bestätigt wurde.
• Ihre Protokolle speichern die zurückgegebenen Werte event_id und command_id.
• Sie haben einen manuellen Ausweichprozess für das Personal der Einrichtung.

Fehlerbehandlung und Wiederholungen

• Antworten mit 400, 401, 403, 404, 409 und 422 werden den Betreibern oder Support-Teams angezeigt, statt ungeprüft wiederholt zu werden.
• Bei Antworten mit 429, 500, 502, 503 und 504 wird eine begrenzte Wiederholungslogik mit Backoff verwendet.
• Wiederholte Fehler lösen in Ihrem System eine Warnung aus.
• Die Integration verwirft fehlgeschlagene Datensätze niemals stillschweigend.

Beobachtbarkeit

• Ihre Protokolle enthalten Endpunkt, Zeitstempel, Einrichtungskennung, Quelldatensatz-ID, Ergebnis der Anfrage und Antworttext.
• Ihr Support-Team kann nach Mitglieds-ID, Einrichtungs-ID, Check-in-ID oder ID des Entriegelungsereignisses suchen.
• Sie haben eine Möglichkeit, fehlgeschlagene Synchronisierungen erneut auszuführen oder abzugleichen.

Produktionsstart

• Der Performance Hub hat Ihren Produktionszugang bestätigt.
• Mindestens eine Einrichtung in der Produktion hat Ihre Integration aktiviert.
• Ihr Produktionsschlüssel ist aktiv.
• Ihre betrieblichen und technischen Ansprechpartner sind aktuell.
• Ihr Support-Prozess ist für Kunden dokumentiert.

Nachdem diese Prüfungen abgeschlossen sind, erscheint Ihre konfigurierte Integration im Partnerverzeichnis des Performance Hub innerhalb der zentralen Performance Hub-Plattform.