Pular para o conteúdo
No ar em produção, em modo shadow: o FingerTrackID recomenda, o seu sistema decide.Status →

Cadastro da sua empresa

Toda empresa segue o mesmo fluxo de cadastro, assistido por um operador. Sua empresa é dona da identidade do próprio produto, da configuração do site e das decisões de negócio; o FingerTrackID opera a plataforma de avaliação. Um espaço de trabalho pode ser cadastrado antes de existir qualquer dado ou tráfego de cliente.

O console está em português (pt-BR). Esta página cita os nomes de telas e botões exatamente como aparecem.

Entre em contato com o FingerTrackID e informe o nome da empresa, um identificador em letras minúsculas como your-company e o nome e o e-mail da pessoa que vai administrar a empresa. Um operador do FingerTrackID cria a empresa e o primeiro administrador dela no backoffice interno protegido.

Não existe formulário público de cadastro nem criação de empresa por autosserviço. Entrar no console exige uma conta que o FingerTrackID ou o administrador da sua empresa tenha solicitado; uma conta não pode criar a própria empresa.

Quando a conta é criada, o FingerTrackID envia um e-mail de convite (em português) para o endereço do administrador, com um botão Ativar acesso. O e-mail é enviado em regime de melhor esforço: se ele não chegar, a conta existe mesmo assim.

  1. Abra o convite e escolha Ativar acesso. Na página Ativação de acesso, preencha Nova senha e Repita a nova senha e escolha Ativar acesso. Isso define sua senha e confirma seu e-mail em uma só etapa. O link é pessoal e funciona só uma vez; abrir a página não o consome.

    Se o e-mail não chegou ou o link não funciona mais, peça ao FingerTrackID que reenvie o convite (um novo e-mail com um novo link, no máximo 3 vezes por hora), ou abra dash.fingertrackid.com, escolha Esqueceu sua senha? e informe o e-mail do administrador para receber um novo link.

  2. Entre com seu e-mail e sua senha. Verifique seu e-mail se for solicitado e, depois, cadastre seu app autenticador e entre com o código de seis dígitos.

A sequência completa e a política de senha estão em como entrar no console. O administrador agora tem o papel Administrador da empresa.

Abra o Início, no topo do menu. Ele lista as cinco etapas de que sua empresa precisa para começar a receber avaliações reais e mostra N de 5 etapas concluídas. A Visão geral continua sendo a tela de abertura; enquanto sua empresa não tem aplicação ativa, ela mostra um aviso que aponta para o Início. Depois que sua empresa recebe o primeiro acesso, o Início sai do topo do menu e continua disponível como Configuração inicial em Configurações, no fim do menu.

Cada uma das quatro primeiras etapas vira uma solicitação, normalmente aprovada no momento em que você a envia e registrada na trilha de auditoria, e depois aplicada pelo processo gerenciado do FingerTrackID; a quinta, Primeiro evento recebido, não precisa de solicitação e se conclui sozinha quando chega a primeira avaliação. Uma etapa aparece como Concluída só depois que o servidor confirma o efeito dela, nunca apenas porque a solicitação foi enviada. Use Recarregar o progresso para atualizar.

Etapa na tela O que você informa Concluída quando
Criar a aplicação Nome da aplicação, Identificador da aplicação (letras minúsculas, dígitos e hífen, como web-app) e Origens permitidas no navegador (uma origem HTTPS por linha, até 32) A aplicação está ativa
Configurar a coleta web Origem registrada da aplicação (uma das origens acima, usada para configurar a coleta) e Domínio-base de coleta da sua empresa (um domínio-base que pertence a você, como yourcompany.com). As outras origens da aplicação sob o mesmo domínio também coletam O domínio de coleta first-party está ativo
Credencial servidor a servidor Identificador do cliente de servidor (8–128 letras, dígitos, hífen ou sublinhado) e Permissões. Requisições por segundo é somente leitura e vem do nível gerenciado da aplicação: 5 por segundo com rajada de 10 no nível padrão (limites) Existe uma credencial vigente e a admissão de produção dela está ativa
Configuração do SDK Combinação de coleta qualificada, disponível só depois que o domínio de coleta estiver ativo. A etapa também mostra a Chave pública do navegador A coleta no navegador está configurada
Primeiro evento recebido Nada: a etapa lê a saúde da integração Pelo menos uma avaliação chegou nas últimas 24 horas

As etapas 2 a 5 só abrem depois que a aplicação está ativa. Os formulários só aparecem para os papéis que podem enviá-los: Administrador da empresa e Gestor de integração.

Uma origem tem HTTPS e não tem caminho, porta, query string nem barra final. https://app.yourcompany.com/login é a URL de uma página; a origem permitida é https://app.yourcompany.com. Não use origens com curinga nem o domínio de outra empresa.

O SDK coleta em toda origem permitida cujo host seja o domínio-base da sua coleta ou um dos subdomínios dele, como https://yourcompany.com e https://www.yourcompany.com. Depois da configuração, o administrador da empresa ou o gestor de integração edita a lista em Integração e saúde › Origens das páginas, sem solicitação: no máximo 10 origens e no mínimo uma; a origem usada na configuração da coleta fica marcada como Principal e não pode ser removida ali. Uma origem removida para de coletar imediatamente. A continuidade do dispositivo é por origem: o mesmo navegador em duas origens conta como duas instalações.

O hostname de coleta para o domínio-base yourcompany.com é collect.yourcompany.com; não informe o hostname do coletor como domínio-base. A origem que você escolher precisa ser o domínio-base ou um dos subdomínios dele. A coleta web padrão observa o navegador e recomenda monitorar (MONITOR); ela não bloqueia nada por conta própria e não alega detecção de fraude calibrada.

Depois do envio, a configuração roda sozinha. O progresso da configuração da aplicação no console lista cada etapa e quem a faz avançar:

Rótulo na tela Significado
Automático A plataforma avança a etapa sozinha: detecção, regras de avaliação, o certificado do domínio de coleta, roteamento e verificação, o preset de custódia de dados e a ativação final. A maioria das etapas leva alguns minutos; o domínio também espera a propagação do DNS
Depende de você Publique os registros DNS do domínio de coleta exatamente como aparecem e escolha Verificar agora, ou faça o que a etapa indicar (por exemplo, sua política CAA)
Pausado pelo suporte O suporte do FingerTrackID pausou o domínio de coleta; fale com o suporte para retomá-lo
Algo travou Uma etapa automática não avança há 30 minutos; fale com o suporte

Publique os registros DNS conforme descrito no fluxo do domínio de coleta; verificar os registros (também por Verificar agora), renovar a verificação, aplicar o preset de custódia de dados e ativar a coleta não exigem solicitação ao FingerTrackID.

Em Permissões, escolha Só avaliações ou Avaliações, ações e resultados se seu backend também for enviar feedback. As permissões de uma credencial existente não podem mudar; mudá-las exige uma nova solicitação. A taxa de requisições (nível padrão: 5 por segundo, rajada de 10) é um limite de admissão configurado, não uma garantia de vazão; Integração e saúde → Limite de requisições mostra o limite em vigor e o aumenta (limites).

Quando a credencial existe, a etapa mostra só o key_id público dela. Se a etapa disser que a credencial aguarda a aprovação de produção, as avaliações são recusadas até essa aprovação; criar outra credencial não adianta. Seu backend se autentica com o key_id, nunca com o identificador do cliente nem com a chave pública do navegador.

Depois que você escolhe Enviar solicitação, a etapa mostra Estado da solicitação com Recarregar o estado:

Estado na tela Significado
Aguardando aprovação Recebida e aguardando uma aprovação explícita do FingerTrackID (só quando a aprovação automática não está disponível); nada foi criado ainda
Aprovada Aprovada; o efeito operacional ainda está pendente
Em execução O FingerTrackID está aplicando a solicitação
Aguardando você receber o segredo O segredo da credencial de servidor aguarda que um administrador ou gestor de integração o receba uma única vez; ele ainda não pode ser usado
Aguardando revisão A configuração da coleta está rodando as etapas automáticas; o progresso da configuração diz se alguma etapa depende de você
Concluída Concluída; a etapa mostra o resultado
Rejeitada, Cancelada, Falhou Não concluída; leia o motivo antes de tentar de novo

Se a resposta se perder, use Repetir a mesma solicitação em vez de preparar uma nova. Enquanto uma solicitação estiver em Aguardando aprovação, Aprovada, Aguardando você receber o segredo ou Aguardando revisão, você pode marcar a confirmação e escolher Cancelar a solicitação pendente. O que já foi criado continua registrado; cancelar não é desfazer. O FingerTrackID também pode cancelar uma solicitação antes que o executor a pegue e, depois disso, suspender ou revogar um membro ou revogar ou rotacionar um cliente de integração; uma aplicação criada não é desfeita.

Enviar uma solicitação usa a sessão com que você entrou; ela não pede sua senha nem seu código de novo. A sessão termina após 30 minutos sem atividade ou 12 horas depois de você entrar.

O administrador convida pessoas em Membros da equipe, no Início, ou com Conceder acesso, em Usuários e acessos. Preencha E-mail, Nome de exibição e Papel na empresa. Cada convite é uma solicitação. Quando ela é concluída, a pessoa que ainda não tinha conta no console recebe o mesmo e-mail de convite, em regime de melhor esforço. A pessoa que já tem conta no console (por exemplo, em outra empresa) não recebe convite: ela sai e entra de novo para ver a nova empresa.

Se o convite não chegou ou o link não funciona mais, peça que ele seja enviado de novo: o administrador da empresa usa Reenviar convite em Usuários e acessos, e o FingerTrackID pode reenviar o convite do primeiro administrador. Um reenvio manda um novo e-mail com um novo link, no máximo 3 vezes por hora para cada pessoa, e só enquanto o convite estiver Pendente. A pessoa também pode usar Esqueceu sua senha? na tela de entrada.

Em Usuários e acessos, Gerenciar o acesso oferece Trocar o papel, Suspender o acesso, Restaurar o acesso e Revogar o acesso. A revogação é permanente. O último administrador ativo da empresa é protegido. Veja os limites de cada papel.

5. Receba o segredo HMAC uma única vez, no console

Seção intitulada “5. Receba o segredo HMAC uma única vez, no console”

A chave de assinatura tem 32 bytes criptograficamente aleatórios, representados como texto hexadecimal canônico de 64 caracteres. O assinador HMAC usa os bytes decodificados, não esse texto.

O FingerTrackID gera o segredo para você. Alguns minutos depois da solicitação da credencial, o cartão Segredo da credencial de servidor (no Início, na etapa da credencial, e em Integração e saúde) mostra Pronto para receber. Um administrador da empresa ou gestor de integração, com sessão iniciada usando o código do autenticador, clica em Receber segredo, lê o aviso e confirma. O console mostra o key_id e o segredo hexadecimal de 64 caracteres uma única vez, com um botão de copiar. Coloque o segredo direto no gerenciador de segredos do seu backend antes de sair da tela.

  • O segredo é mostrado uma única vez. O console não o armazena, não o envia por e-mail e não o mostra de novo; se ele se perder, escolha Trocar segredo em Integração e saúde quando a credencial estiver ativa: um novo segredo é gerado e entregue uma única vez.
  • Depois que você o recebe, o cartão mostra Entregue, ativando a credencial e a credencial passa a poder ser usada em poucos minutos, sem nenhuma outra ação.
  • Nunca cole o valor em chat, e-mail, chamado de suporte, formulário, argumento de comando, saída de terminal, arquivo local, repositório ou ambiente que uma IA possa ler.
Dado Onde você o usa
Origem da API https://api.fingertrackid.com, mostrada como Endereço da API de risco em Credencial servidor a servidor Configuração do backend, exatamente como está escrita, sem caminho nem barra final
ID da aplicação, chave pública do navegador e origens permitidas (Integração e saúde › Origens das páginas) Seleção da aplicação e configuração do navegador
Origem de coleta ativa exata e registros DNS emitidos Configuração do navegador, CSP e seu provedor de DNS
key_id, codificação e permissões da credencial Configuração de assinatura do backend; o valor fica sob custódia de segredos
Taxa e rajada aprovadas Novas tentativas limitadas no backend e configuração de capacidade
Arquivo privado aprovado do SDK, versão exata, SHA-256 e SHA-512 Seu processo de dependências do frontend; baixe o arquivo e veja os dois digests no console, em Início › Configuração do SDK
O perfil de requisição que você envia (v1.1 com suas próprias etiquetas, recomendado e aceito em produção; ou as jornadas v1, sem mudança) e as versões efetivas de política/release Validação das requisições e interpretação das respostas
Configuração de retenção e confirmação da ativação Seu registro de prontidão operacional

Os valores vêm da sua configuração real e da entrega verificada. Exemplos da documentação e configurações de outra empresa não são valores emitidos. O Web SDK é entregue como um arquivo privado aprovado; ele não tem pacote público no npm nem URL de CDN. O SDK de servidor para Node.js, opcional, é um pacote público no npm.

Antes de dados reais, o FingerTrackID confirma os testes de segurança, a prova independente de isolamento da autenticação, a retenção técnica aplicada e a qualificação operacional, incluindo a recuperação. Sua aplicação também precisa de verificação first-party vigente de titularidade/DNS/TLS/saúde, de uma credencial instalada, de admissão aprovada e de um release e uma política qualificados e ativos. Cadastrar uma empresa não os dispensa.

O FingerTrackID guarda os dados que registra por no mínimo 10 anos, até segunda ordem, e não apaga nenhum deles (retenção). A configuração gerenciada aplica por conta própria essa retenção permanente à sua empresa.

Prepare a coleta no navegador e a integração assinada do backend com a entrega da implementação. Valide requisições sintéticas, a autenticação normal e o comportamento em falha e, depois, conclua o checklist de integração. Habilite tráfego real só depois que o FingerTrackID confirmar a ativação da sua aplicação. Comece em SHADOW e mantenha as decisões que seu produto já toma. A ativação do SDK de navegador e a ativação da API assinada são confirmadas separadamente.