Erros comuns nos testes

• Access Denied: usuário cadastrado no diretório de produção, mas sem associação aos perfis necessários (PFVPC e Certification Manager).

Solução: solicitar ao suporte da Raidiam a validação do cadastro e a inclusão do e-mail no perfil Certification Manager.

Open

• Failed to fetch: timeout de sessão após inatividade prolongada ou troca de abas. Solução: acionar "Close" e recarregar a página para restabelecer a sessão.

Open

• Error: um ou mais campos obrigatórios não preenchidos na configuração do plano.

Solução: verificar e completar todos os campos obrigatórios.

Open

• HTTP Error 403: pode ocorrer durante o redirecionamento, sem impacto funcional.

Solução: clicar em "Close" e prosseguir; se não retomar, recarregar a página.

Mensagens frequentes nos logs, com o motivo e a solução recomendada.

40x no DCR — "Client already present for this Software Statement on Server"

Problema: o servidor não aceita novo DCR porque já existe um client_id para esse Software Statement. O client foi criado em um módulo anterior e a solicitação de exclusão foi recusada pelo servidor.

Solução: verifique o plano e confirme se a solicitação DELETE falhou em algum módulo. Se sim, corrija a causa e exclua manualmente o client usando o SoftwareStatementID. Se não, o problema ocorreu em teste anterior; exclua manualmente o client e aguarde a próxima execução.

"Test was unable to call the Consents API on test"

Problema: no teste consents-bad-logged, não foi possível chamar a API POST Consents porque o URI da API de Consentimento não foi fornecido no plano.

Solução: verifique no diretório se o Authorisation Server está registrado com uma API de Consentimentos válida para a Fase 3 e/ou Fase 2. Consulte o Guia Operacional do Diretório para registrar a API de Consentimentos no servidor.

"DCR is not being accepted because of missing optional fields on the request"

Problema: o servidor recusa o DCR porque um campo opcional não foi incluído no corpo da solicitação.

Solução: o servidor deve aplicar um padrão suportado para todos os campos opcionais, garantindo o processamento da solicitação.

"Routine was unable to confirm within the well-known endpoint the supported token authentication methods"

Causas potenciais: Well-Known com certificados SSL inválidos; response_body sem private_key_jwt ou tls_client_auth em token_endpoint_auth_methods_supported; servidor negou acesso da FVP ao verificar o Well-Known.

Solução: use certificado SSL EV válido de CA ou ICP-Brasil; garanta conformidade com o RFC8414; verifique se o payload JSON contém os métodos de autenticação de token esperados.

"Server claims the authorization token is invalid or expired"

Problema: o servidor não está aceitando tokens de acesso válidos (problema de sincronização no cache de tokens entre instâncias do authorisation server).

Solução: implementar estratégia de fallback para consultar o token no banco de dados quando não encontrado no cache.

"Failure when calling the directory endpoints - Token or Assertion"

Problema: o diretório retornou erro 50x devido ao alto uso da plataforma durante o teste.

Solução: nenhuma mudança é necessária; ignore os resultados e aguarde nova execução.

"Server returned that the client presented invalid certificates"

Problema: em todas as solicitações de DCR, o servidor retorna as credenciais do client como inválidas.

Solução: certifique-se de que o API Gateway confia no certificado e na CA emissora.

"State was passed in request, but is missing from response"

Problema: ocorre no redirecionamento de volta à FVP quando o usuário não está logado no navegador padrão do dispositivo móvel — as informações da URL de redirecionamento se perdem, pois o link é único.

Solução: em execuções via QR Code, autentique-se previamente no navegador móvel que será utilizado, antes de iniciar o teste, para garantir a transmissão correta dos parâmetros.

Caso a instituição tenha dúvidas ou apontamentos de irregularidades, aconselhamos que realizem a abertura de um ticket de Solicitação de Informações via Service Desk: Solicitação de Serviço → Solicitação de Informações → Conformidade → Ferramenta de Validação em Produção (FVP).