Support Hub/API & Integrations/Übertragung einer API-Lizenz zwischen biometrischen Geräten
Translated from the English article and reviewed by a person. Read the English original
Fix

Übertragung einer API-Lizenz zwischen biometrischen Geräten

Übertragung einer API-Lizenz zwischen biometrischen Geräten

Grundlagen der Gerätemigration in der Cams Biometrics Plattform

Beim Betrieb biometrischer Infrastruktur sind Hardwareausfälle eine unvermeidbare Realität. Das richtige Vorgehen beim Migrieren Ihrer API-Lizenz von einem beschädigten Gerät auf ein Ersatzgerät ist entscheidend, um den Geschäftsbetrieb aufrechtzuerhalten und gleichzeitig die technischen Anforderungen der Plattform einzuhalten.

Technische Voraussetzungen für die Migration

Anforderungen an den Gerätestatus

Die Architektur der Cams Biometrics Plattform unterstützt eine Lizenzmigration nur dann, wenn das Quellgerät einen physischen Schaden oder einen Hardwareausfall erlitten hat. Dies ist nicht nur eine geschäftliche Regel, sondern ein grundlegender Bestandteil der Funktionsweise des Lizenzsystems, um die Integrität im verteilten API-Netzwerk zu gewährleisten.

Sobald ein Gerät im System als beschädigt markiert ist, wird diese Seriennummer dauerhaft aus dem aktiven Gerätepool entfernt. Dadurch wird sichergestellt, dass:

  • Lizenz-Token nicht auf mehrere aktive Endpunkte dupliziert werden können
  • die API-Authentifizierung sicher und eindeutig bleibt
  • die Cloud-Synchronisierung eine korrekte Zuordnung von Gerät zu Lizenz beibehält

Wichtiger Hinweis: Für Geräte, die noch betriebsbereit sind, wird eine Migration technisch nicht unterstützt. Die Systemarchitektur erfordert, dass jedes funktionierende Gerät seine eigene, eindeutige Lizenzkonfiguration beibehält.

Migrationsszenarien: technische Übersicht

Native Plattformmigration (Cams → Cams)

Bei der Migration zwischen Cams Biometric Geräten ist der Prozess vereinfacht, da beide Endpunkte auf derselben nativen Protokollebene arbeiten.

Technische Anforderungen:

Quellgerät: Als beschädigt markiert (dauerhafte Deaktivierung)
Zielgerät: Neuinstallation oder Werksreset
API-Ebene: Vollständige Aktivierung am neuen Endpunkt erforderlich

Aktivierungskomponenten:

  • Vollständige API-Aktivierungseinrichtung auf dem Zielgerät
  • Registrierung des Cloud-Endpunkts und Bindung des SSL-Zertifikats
  • Erzeugung des Geräte-Authentifizierungsschlüssels

Lizenzberechnung: Die Jahreslizenz basiert auf einem Gültigkeitszeitraum. Bei der Migration wird die verbleibende Laufzeit der Quelllizenz angerechnet:

Neue Lizenzlaufzeit = 12 Monate - verbleibende Monate der Quelllizenz

Beispiel: Das Quellgerät hat noch 5 Monate Laufzeit → Das neue Gerät erhält 7 Monate berechnet, um den Jahreszyklus zu vervollständigen.

Plattformübergreifende Migration (ZKTeco/Drittanbieter → ZKTeco/Drittanbieter)

Die Migration zwischen Drittanbietergeräten erfordert aufgrund der notwendigen Protokollübersetzung eine zusätzliche technische Ebene.

Technische Anforderungen:

Quellgerät: Als beschädigt markiert (dauerhafte Deaktivierung)
Zielgerät: Kompatible Hardware eines Drittanbieters
Protokollebene: Übersetzungsbrücke erforderlich
API-Ebene: Vollständige Aktivierung am neuen Endpunkt erforderlich

Aktivierungskomponenten:

  • Installation des Protokoll-Updates
  • API-Aktivierungseinrichtung auf dem Zielgerät
  • Middleware-Konfiguration für herstellerspezifische Befehle
  • Registrierung und Authentifizierung des Cloud-Endpunkts

Lizenzberechnung: Es gilt dasselbe anteilige System wie bei nativen Migrationen, jedoch zuzüglich einmaliger Kosten für die Protokolleinrichtung.

PS: Die Kosten für das Protokoll-Update ergeben sich aus der finanziellen Transaktion zwischen Cams und dem jeweiligen Hersteller.

Migrationsablauf: Schritt für Schritt

Phase 1: Deaktivierung des Quellgeräts

  1. Dokumentieren Sie die Seriennummer und den aktuellen Lizenzstatus des beschädigten Geräts
  2. Reichen Sie die Schadensprüfung über das Support-Portal ein
  3. Das System markiert die Gerätenummer dauerhaft als inaktiv
  4. Die Cloud-Endpunkte, die dieser Seriennummer zugeordnet sind, werden getrennt

Phase 2: Vorbereitung des Zielgeräts

  1. Ermitteln Sie die Seriennummer des Ersatzgeräts
  2. Stellen Sie sicher, dass die Geräte-Firmware auf dem neuesten Stand ist (entscheidend für die API-Kompatibilität)
  3. Führen Sie einen Werksreset durch, falls das Gerät zuvor verwendet wurde

Phase 3: Lizenzmigration

  1. Berechnen Sie die anteiligen Gebühren auf Basis der verbleibenden Gültigkeit der Quelllizenz
  2. Führen Sie die erforderlichen Aktivierungen durch:
    • Cams-Geräte: nur API-Aktivierung
    • Drittanbietergeräte: Protokoll-Update + API-Aktivierung
  3. Schließen Sie die Zahlungsabwicklung für die Aktivierung und die anteilige Lizenz ab

Phase 4: Technische Aktivierung

  1. Protokoll-Update bereitstellen (nur bei Drittanbietergeräten)
  2. API-Aktivierung auf dem Zielgerät konfigurieren

Was this article helpful?