Support Hub/API & Integrations/Como Transferir uma Licença de API Entre Dispositivos Biométricos
Translated from the English article and reviewed by a person. Read the English original
Fix

Como Transferir uma Licença de API Entre Dispositivos Biométricos

Como Transferir uma Licença de API Entre Dispositivos Biométricos

Entendendo a Migração de Dispositivos na Plataforma Cams Biometrics

Ao trabalhar com infraestrutura biométrica, falhas de hardware são uma realidade inevitável. Entender como migrar corretamente sua licença de API de um dispositivo danificado para uma unidade de substituição é essencial para manter a continuidade dos negócios, garantindo ao mesmo tempo a conformidade com os requisitos técnicos da plataforma.

Pré-requisitos Técnicos para a Migração

Requisitos de Status do Dispositivo

A arquitetura da plataforma Cams Biometrics só oferece suporte à migração de licença quando o dispositivo de origem sofreu danos físicos ou falha de hardware. Essa não é apenas uma regra de negócio, mas um aspecto fundamental de como o sistema de licenciamento mantém a integridade across da rede de API distribuída.

Assim que um dispositivo é marcado como danificado no sistema, seu número de série é permanentemente retirado do conjunto de dispositivos ativos. Isso garante que:

  • Os tokens de licença não possam ser duplicados em vários endpoints ativos
  • A autenticação da API permaneça segura e sem ambiguidade
  • A sincronização com a nuvem mantenha o mapeamento preciso entre dispositivo e licença

Observação Importante: Para dispositivos que ainda estão em funcionamento, a migração tecnicamente não é suportada. A arquitetura do sistema exige que cada dispositivo funcional mantenha sua própria configuração de licença distinta.

Cenários de Migração: Detalhamento Técnico

Migração na Plataforma Nativa (Cams → Cams)

Ao migrar entre dispositivos Cams Biometric, o processo é simplificado porque ambos os endpoints operam na mesma camada de protocolo nativa.

Requisitos Técnicos:

Source Device: Marked as damaged (permanent deactivation)
Target Device: Fresh installation or factory reset
API Layer: Full activation required on new endpoint

Componentes de Ativação:

  • Configuração completa de ativação da API no dispositivo de destino
  • Registro do endpoint na nuvem e vinculação de certificado SSL
  • Geração de chave de autenticação do dispositivo

Cálculo da Licença: A licença anual funciona com base em um sistema de validade. Ao migrar, o tempo restante da licença de origem é creditado:

New License Duration = 12 months - Remaining Months from Source

Exemplo: O dispositivo de origem tem 5 meses restantes → O novo dispositivo recebe 7 meses cobrados para completar o ciclo anual.

Migração Entre Plataformas (ZKTeco/Terceiros → ZKTeco/Terceiros)

A migração entre dispositivos de terceiros envolve uma camada técnica adicional devido aos requisitos de tradução de protocolo.

Requisitos Técnicos:

Source Device: Marked as damaged (permanent deactivation)
Target Device: Compatible third-party hardware
Protocol Layer: Translation bridge required
API Layer: Full activation required on new endpoint

Componentes de Ativação:

  • Instalação de atualização de protocolo
  • Configuração de ativação da API no dispositivo de destino
  • Configuração de middleware para comandos específicos da marca
  • Registro e autenticação do endpoint na nuvem

Cálculo da Licença: O mesmo sistema proporcional aplicado às migrações nativas se aplica, mas com custos adicionais únicos de configuração de protocolo.

PS: O custo da Atualização de Protocolo envolve a transação financeira entre a Cams e o respectivo fabricante.

Fluxo de Migração: Passo a Passo

Fase 1: Desativação do Dispositivo de Origem

  1. Documente o número de série do dispositivo danificado e o status atual da licença
  2. Envie a verificação de dano pelo portal de suporte
  3. O sistema marca o número de série do dispositivo como permanentemente inativo
  4. Os endpoints na nuvem associados a esse número de série são desvinculados

Fase 2: Preparação do Dispositivo de Destino

  1. Obtenha o número de série do dispositivo de substituição
  2. Certifique-se de que o firmware do dispositivo esteja atualizado (essencial para a compatibilidade com a API)
  3. Execute a redefinição de fábrica caso o dispositivo tenha sido utilizado anteriormente

Fase 3: Migração da Licença

  1. Calcule as cobranças proporcionais com base na validade restante da licença de origem
  2. Processe as ativações necessárias:
    • Dispositivos Cams: Apenas ativação da API
    • Dispositivos de terceiros: Atualização de protocolo + ativação da API
  3. Conclua o processamento do pagamento da ativação e da licença proporcional

Fase 4: Ativação Técnica

  1. Atualização de protocolo implantada (somente dispositivos de terceiros)
  2. Ativação da API configurada no dispositivo de destino

Was this article helpful?