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.
1. Solicite o espaço de trabalho da sua empresa
Seção intitulada “1. Solicite o espaço de trabalho da sua empresa”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.
2. Ative a conta do administrador
Seção intitulada “2. Ative a conta do administrador”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.
-
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.
-
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.
3. Siga as etapas do Início
Seção intitulada “3. Siga as etapas do Início”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.
Origens do site
Seção intitulada “Origens do site”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.
Domínio de coleta
Seção intitulada “Domínio de coleta”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.
Credencial de servidor
Seção intitulada “Credencial de servidor”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.
Estados da solicitação
Seção intitulada “Estados da solicitação”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.
4. Convide sua equipe
Seção intitulada “4. Convide sua equipe”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.
6. Receba os dados da integração
Seção intitulada “6. Receba os dados da integração”| 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.
7. Verifique e ative a aplicação
Seção intitulada “7. Verifique e ative a aplicação”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.