Define atores, pontos de entrada, estados, transições, caminhos de recuperação, mensagens e casos extremos para contas de serviço. Esta referência fixa o limite de adoção, comportamento em falhas e evidências observáveis, deixando os limites específicos do ambiente configuráveis.
Status do pacote: contexto de referência pronto para revisão humana. O contrato e os cenários de teste estão completos, mas não se afirma que uma implementação adotante os tenha aprovado.
Decisão
Para contas de serviço, adote um ciclo de vida de credencial e sessão do lado do servidor com garantia explícita. Defina uma jornada do usuário determinística com estado visível, escolhas reversíveis quando possível, entrada preservada e recuperação acessível. Este pacote é um contrato de referência: a equipe adotante deve escolher limites numéricos, provedores, jurisdições e responsáveis operacionais a partir de evidências em seu próprio ambiente.
Escopo
- Os atores, entradas, saídas, estados, versões de política ou esquema e resultados visíveis externamente descritos por este bloco de UX.
- Interfaces primárias e alternativas, trabalhos em segundo plano, caches, integrações, caminhos de suporte e evidências que podem exercer o mesmo limite.
- Configuração específica de adoção, implantação, recuperação e responsabilidades de verificação necessárias para aplicar a referência com segurança.
Fora deste bloco
- Escolher um fornecedor universal, framework, jurisdição, limite numérico, período de retenção ou objetivo de nível de serviço para todos os adotantes.
- Afirmar que os cenários empacotados foram executados contra uma implementação a jusante ou que esta referência concede certificação legal, de segurança ou acessibilidade.
Contrato
- Armazenar apenas material de credencial protegido, rotacionar segredos de assinatura e recuperação, e manter credenciais fora de URLs, logs, análises e visualizações de suporte.
- Vincular emissão, uso, expiração, revogação, recuperação e tratamento de repetição a um sujeito nomeado e ação pretendida.
- Retornar respostas públicas resistentes à enumeração enquanto retém dados internos suficientes de motivo e correlação para suporte e resposta a abusos.
- Reavaliar ações sensíveis após mudanças no sujeito, dispositivo, autenticador, risco ou estado da sessão em vez de confiar em um login antigo para sempre.
- Mostrar progresso apenas enquanto o trabalho estiver realmente pendente e evitar ativação duplicada sem ocultar a intenção comprometida do usuário.
- Usar mensagens simples e específicas para ação que distinguem validação, permissão, conectividade, conflito e falha terminal.
- Dar a cada identidade de carga de trabalho um único proprietário, propósito, escopo, ambiente, ciclo de vida da credencial e evidência de último uso; proibir uso humano compartilhado.
- A rotação suporta validade sobreposta e revogação, enquanto toda ação da API ainda autoriza o recurso alvo.
Orientações de implementação
- Prototipar os caminhos mais longos, vazios, lentos, offline, negados e com tecnologia assistiva antes de travar o layout do caminho feliz.
- Modelar entradas, saídas, atores, estados, invariantes, efeitos colaterais e evidências das contas de serviço antes de selecionar detalhes de framework ou fornecedor.
- Armazenar a versão aplicável do contrato ou política de contas de serviço com estado material para que migrações, repetições e decisões de suporte permaneçam atribuíveis.
- Introduzir o caminho por trás de implantação controlada, comparar resultados esperados e observados, e manter uma rota de recuperação testada até que a evidência de adoção esteja completa.
Tratamento de falhas e salvaguardas
- Evidências de autenticação ausentes, expiradas, repetidas ou contraditórias negam a ação e seguem um caminho de recuperação com limite de taxa.
- Estado inválido ou contraditório das contas de serviço é rejeitado ou colocado em quarentena; a implementação nunca supõe um valor que amplie autoridade ou duplique um efeito.
- Retentativas são limitadas e usam identidade durável; após esgotamento, o trabalho alcança um estado terminal inspecionável com um responsável contabilizável.
Verificação e operações
- Completar a jornada com teclado, toque, leitor de tela, viewport estreito, rede com atraso e erro recuperável do servidor.
- Monitorar sucesso, negação, falha de validação, falha de dependência, esgotamento de retentativas e recuperação das contas de serviço por versão de contrato sem dimensões sensíveis de carga útil.
- Reexecutar fixtures positivos e negativos pareados após mudanças de política, esquema, dependência, migração ou limite e preservar a evidência resultante.
Suposições de adoção
- Nomes e valores no exemplo são um fixture concreto, não padrões universais; adotantes os substituem por meio de evidência documentada e propriedade.
- O sistema adotante pode fornecer identidade autenticada, versões duráveis de operação ou registro, telemetria limitada e um caminho controlado para mudança.
Os exemplos com aparência executável neste pacote são fixtures e contratos de aceitação. Execute o validador da coleção para verificar estrutura e metadados, depois traduza e execute os cenários no repositório de destino antes de registrar evidências da implementação.
Referências
- NIST SP 800-63B-4, Authentication and Authenticator Management (aplica-se a partir de 2026-09-08)