Janela TOTP: segundos restantes e índice

Esta calculadora de janela de tempo TOTP transforma a duração de um período e um timestamp Unix em dois valores práticos: o índice da janela ativa e a quantidade de segundos inteiros restantes antes do início da próxima. Ela é útil para desenvolver, testar ou diagnosticar sistemas de senha de uso único baseada em tempo, sobretudo quando um código parece expirar antes do esperado. O cálculo é determinístico, não usa chave secreta, não gera senha e nunca consulta o relógio do seu dispositivo; assim, a mesma entrada sempre produz o mesmo resultado.

Entenda o que uma janela de tempo TOTP representa

Um sistema TOTP divide o tempo Unix em janelas consecutivas de mesma duração. Trinta segundos é um período comum, mas o cálculo funciona com qualquer número inteiro positivo de segundos. O índice da janela é o timestamp Unix dividido pelo período e arredondado para baixo.

Todo timestamp que produz o mesmo quociente pertence à mesma janela, permitindo que um autenticador e um servidor selecionem de maneira independente o mesmo contador variável. Esta calculadora apresenta esse contador diretamente, sem solicitar um segredo compartilhado nem gerar um código de autenticação. Ela também informa quantos segundos inteiros restam antes do avanço do contador.

No primeiro segundo exato de uma janela, resta o período completo; no último, resta um segundo. Essa convenção de limite torna as contagens regressivas úteis e evita a exibição de zero enquanto a janela atual ainda está ativa.

Escolha as entradas e interprete o resultado

Defina period como a duração configurada de uma etapa TOTP, expressa como um número inteiro positivo de segundos. O índice começa em zero na época Unix e normalmente é um número inteiro grande para timestamps atuais. Ele não é um código e não deve ser comparado aos dígitos exibidos por um autenticador.

Em vez disso, compare os índices das janelas ao verificar se dois componentes concordam sobre o horário, ou use o valor restante para decidir quando um teste deve aguardar o próximo limite. A função não aplica tolerância ao desvio de relógio, aceitação de janelas adjacentes, correções de segundos intercalares nem atraso de rede. Essas são decisões de política do verificador.

O resultado descreve apenas a janela matematicamente ativa para o timestamp e o período fornecidos, mantendo os testes automatizados previsíveis e facilitando o isolamento de divergências.

Use a calculadora com segurança em testes e operações

Use esta capacidade quando precisar de informações de tempo sem expor uma semente TOTP. Em testes de integração, timestamps fixos permitem verificar o comportamento imediatamente antes, no momento e depois de um limite sem simular um relógio oculto dentro desta calculadora. Lembre-se de que uma janela correspondente não prova que uma senha de uso único enviada seja válida.

A verificação ainda exige o segredo compartilhado, as configurações acordadas de hash e quantidade de dígitos, proteção contra repetição e uma política explícita de tolerância. Evite registrar segredos junto com esses diagnósticos de tempo; o período, o timestamp, o índice e a contagem regressiva bastam para investigar a maioria dos problemas de sincronização.