Wer auf welcher Seite zuständig ist
InnerWeb ist ein Softwarehersteller und fertigt oder tauscht keine Zutrittsleser aus. Die Integration erfolgt mit dem bestehenden Zutrittssystem des Kunden, und die Integrationsspezifikation richtet sich an den Anbieter des Zutrittssystems. Das Werk und der Anbieter bereiten daher das Senden der Ereignisse vor, InnerWeb übernimmt deren Empfang und die Verknüpfung mit Qualifikationen, Berechtigungen, Anwesenheit und Zeiterfassung.
Diese Aufteilung bedeutet, dass im Integrationsprojekt keine Leser getauscht und keine Kartentechnik geändert werden. Es ändert sich nur, dass das Zutrittssystem neben der eigenen Durchgangssteuerung eine Kopie des Ereignisses an die angegebene Adresse sendet.
Kartenereignis: festzulegende Felder
Ein Kartenereignis enthält unter anderem Zeitpunkt, Ort, Vorname, Nachname, Firma, Nummer der aktiven Karte, Telefonnummer, E-Mail-Adresse und Sprache der Person. Vor dem Start legen das Werk und der Anbieter des Zutrittssystems fest, welche dieser Felder das Zutrittssystem senden kann und welche das Werk gemäß dem Grundsatz der Datenminimierung übermitteln möchte.
Sensible Felder wie Telefonnummer und E-Mail-Adresse werden nur übermittelt, wenn sie für eine Aufgabe benötigt werden, etwa für eine Benachrichtigung in der Sprache der Person. In allen anderen Fällen genügen Zeitpunkt, Ort und Kennung der Person.
Übereinstimmung der Kennungen
Die häufigste Ursache für ins Leere laufende Verbindungen ist eine abweichende Kennung: Die Kartennummer im Ereignis muss mit der Nummer der aktiven Karte im Register übereinstimmen. Deshalb sollten das Kartenregister und die Konten vor dem Start bereinigt sein, ohne doppelte Konten.
Aufteilung der Zuständigkeiten in der KD-Integration (Anzahl Aufgaben je Seite)
Webhook und Token: Sicherheit des Kanals
InnerWeb nimmt Kartenereignisse über einen Webhook entgegen, der mit einem Token mit begrenzter Gültigkeit von 12 Stunden gesichert ist. Das bedeutet, dass das Zutrittssystem das Token erneuern können muss und keinen einmal gespeicherten festen Schlüssel verwenden darf. Der Anbieter des Zutrittssystems bestätigt, dass sein System diesen Mechanismus unterstützt, oder benennt ein Zwischenelement, das ihn übernimmt.
Auf Seiten des Werks kommt der Netzwerkkanal hinzu: Firewall-Regeln, verschlüsselte Verbindung und Überwachung fehlgeschlagener Übermittlungen. Die IT-Abteilung legt fest, wohin nicht zugestellte Ereignisse gelangen und wer sie auswertet.
Test vor dem Produktivstart
Der Test besteht aus drei Durchgängen: Buchung mit einer aktiven Karte, Buchung mit einer gesperrten Karte und Buchung mit einer Gastkarte. Für jeden prüfen wir, ob das Ereignis angekommen ist, ob die Felder der Spezifikation entsprechen und ob es dem richtigen Konto zugeordnet wurde. Das Testergebnis wird mit Datum und den durchführenden Personen im Protokoll festgehalten.
Ein eigener Test betrifft den Ausfall: Was geschieht, wenn InnerWeb vorübergehend nicht erreichbar ist? Das Zutrittssystem darf den Durchgang am Drehkreuz wegen eines Fehlers beim Senden des Ereignisses nicht blockieren, und nicht zugestellte Ereignisse müssen sich erneut senden lassen.
Was das Werk nach dem Start gewinnt
Nach dem Start der Ereignisübermittlung werden Buchungen mit Qualifikationen, Berechtigungen, Anwesenheit und Zeiterfassung verknüpft. InnerWeb arbeitet als unabhängiges Ergänzungssystem zu Zutrittskontrolle, Zeiterfassung, Personalwesen und ERP des Kunden. Am Drehkreuz ist daher nicht nur sichtbar, dass eine Karte gültig ist, sondern auch, ob die Person die erforderliche Schulung hat.
Für die IT-Abteilung ergibt sich der Vorteil, dass die Integration die kryptografische Schicht der Karten und Schlüssel nicht berührt. Schlüssel und SAM-Module bleiben im Zutrittssystem des Werks, und InnerWeb empfängt ausschließlich Ereignisse.
Checkliste
Videomaterial
Häufig gestellte Fragen
Erfordert die Integration den Austausch der Leser?
Nein. InnerWeb wird an das bestehende Zutrittssystem des Kunden angebunden und tauscht keine Leser aus. Es ändert sich nur das Senden einer Kopie des Ereignisses aus dem Zutrittssystem.
Warum hat das Token eine begrenzte Gültigkeit?
Es begrenzt die Folgen eines Datenabflusses: Ein gestohlenes Token verliert nach 12 Stunden seine Gültigkeit. Das Zutrittssystem muss es daher erneuern können.
Gelangen Kartenschlüssel zu InnerWeb?
Nein. Schlüssel und SAM-Module bleiben im Zutrittssystem. InnerWeb empfängt ausschließlich Buchungsereignisse.
Wer schreibt die Spezifikation für den Anbieter des Zutrittssystems?
InnerWeb erstellt die Integrationsspezifikation für den Anbieter, und das Werk legt mit ihm den Umfang der Felder und den Zeitplan fest.
Bereiten wir die Spezifikation für Ihren Anbieter gemeinsam vor
Wir beschreiben die Ereignisfelder, das Token und die Testszenarien, damit die IT-Abteilung und der Anbieter eine fertige Aufgabenliste erhalten.
Sprechen wir