Saltar para o conteúdo principal
Two-Factor Authentication & SSO

Erros do Two-Factor Authentication & SSO for Odoo: quando surge cada mensagem e o que fazer

As mensagens do Two-Factor Authentication & SSO for Odoo agrupam-se em cinco blocos: passkeys FIDO2, ligações OIDC, ligações SAML, mapeamentos e isenções, e o registo de eventos de autenticação, que não pode ser editado nem apagado. Várias indicam no próprio texto o que falta ou o que fazer, e aqui encontra cada mensagem literal com quando surge e como agir.

FlexigoTech · Responsável: Víctor Gómez · Atualizado em 4 de novembro de 2026

O essencial

Versões
Odoo 17, 18, 19 e 20
Verificado
no código do módulo, versão 20.0 · nas fontes indicadas no fim
Leitura
6 min

Como ler as mensagens do módulo

Várias mensagens têm um espaço {} ou %s onde o módulo coloca um dado concreto: o nome da ligação, o domínio, um URL ou o motivo da falha. Esse dado é a primeira coisa a ler, porque é o que distingue um caso do outro.

Se ainda está a configurar o módulo, o guia de arranque percorre as definições; aqui vamos mensagem a mensagem.

Passkeys FIDO2: registo e autenticação

MensagemQuando surgeO que fazer
Passkeys (FIDO2) need Odoo 18 or later: on this Odoo use "TOTP Only" or "Either".Quando pede passkeys num Odoo anterior ao 18Escolha TOTP Only ou Either, como indica a mensagem
A user can have at most 5 active FIDO2 credentials (FR-044). Please revoke an existing credential before registering a new one.Ao registar uma credencial nova com 5 já ativasRevogue uma credencial existente e registe a nova
py_webauthn is not installed. FIDO2 registration is unavailable.Ao tentar registar FIDO2 sem py_webauthnFale com quem administra o servidor Odoo sobre a falta de py_webauthn
py_webauthn is not installed.Versão curta do mesmo aviso, em mais de um ponto do fluxo FIDO2O mesmo que na linha anterior
Failed to generate FIDO2 registration options: {}Ao preparar o registo de uma credencialLeia o motivo que vem depois dos dois pontos
FIDO2 registration verification failed: {}Ao verificar o registoLeia o motivo e repita o registo
Failed to generate FIDO2 authentication options: {}Ao preparar a autenticação com FIDO2Leia o motivo que acompanha a mensagem
FIDO2 credential not found for this user.O módulo não encontra a credencial desse utilizadorConfirme que a credencial pertence a esse utilizador
FIDO2 credential was registered for domain "{}" but current domain is "{}". Credential is invalid for this domain (FR-043).O domínio atual não é o do registoEntre pelo domínio que a mensagem indica
FIDO2 authentication verification failed: {}Ao verificar a autenticaçãoLeia o motivo que a mensagem acrescenta

No Odoo 17 não há passkeys: a própria mensagem diz que precisam do Odoo 18 ou posterior e remete para TOTP Only ou Either.

Ligações OIDC: documento de descoberta e ID token

MensagemQuando surgeO que fazer
The connection "%s" already has its OIDC settings: edit them instead of adding others.Ao adicionar outra configuração OIDC a uma ligação que já a temEdite a configuração existente
Issuer URL is required to fetch the discovery document.Ao pedir o documento de descoberta sem Issuer URLIndique o Issuer URL
Failed to fetch OIDC discovery document from {}: {}Não foi possível obter o documento a partir desse URLVerifique o URL e o motivo que a mensagem mostra
JWKS URI is not configured. Fetch the discovery document first.Falta o JWKS URIObtenha primeiro o documento de descoberta
ID token validation failed: malformed token ({}).O ID token está mal formadoLeia o detalhe entre parênteses
ID token validation failed: algorithm {!r} is not accepted.O algoritmo do token não é aceiteVerifique com quem gere o IdP o algoritmo que a mensagem refere
ID token validation failed: JWKS not readable ({}).Não é possível ler as chaves JWKSLeia o detalhe entre parênteses
ID token validation failed: invalid signature.A assinatura do token não é válidaReveja-o com quem gere o IdP
ID token validation failed: missing claims.Faltam claims no tokenReveja-o com quem gere o IdP
ID token validation failed: issuer mismatch.O emissor não coincideCompare o emissor da ligação OIDC com o do IdP
ID token validation failed: audience mismatch.A audiência não coincideReveja a ligação OIDC com quem gere o IdP
ID token validation failed: token expired.O token expirouVolte a iniciar o acesso
ID token nonce mismatch: expected {} but got {}O nonce recebido não é o esperadoCompare os dois valores que a mensagem mostra

Todas as mensagens que começam por ID token validation failed surgem ao validar o token devolvido pelo fornecedor de identidade. A parte final indica que verificação falhou.

Lista de ligações IdP nas Definições do Odoo com dois registos, Google Workspace OIDC e Microsoft Entra ID SAML
A lista de ligações IdP, com colunas de protocolo, empresa, ativo, aprovisionamento JIT e modo de recurso

Ligações SAML e metadados do IdP

MensagemQuando surgeO que fazer
The connection "%s" already has its SAML settings: edit them instead of adding others.Ao adicionar outra configuração SAML a uma ligação que já a temEdite a configuração existente
Single Logout (SLO) is enabled but no IdP SLO URL is provided. Please enter the IdP SLO URL or disable SLO.SLO ativado sem URL de SLO do IdPEscreva o URL de SLO do IdP ou desative o SLO
xml.etree.ElementTree is not available.O módulo não encontra xml.etree.ElementTreeReveja-o com quem administra o servidor Odoo
Failed to parse IdP metadata XML: {}Não foi possível ler o XML de metadados do IdPVerifique o XML e o motivo que a mensagem acrescenta

Mapeamentos, isenções e registo de eventos

MensagemQuando surgeO que fazer
Attribute mapping cannot belong to both a SAML config and an OIDC config. Please link it to exactly one.O mapeamento de atributos está ligado a SAML e a OIDC ao mesmo tempoDeixe-o ligado a uma só configuração
Attribute mapping must be linked to either a SAML config or an OIDC config.O mapeamento de atributos não está ligado a nenhumaLigue-o a uma configuração SAML ou OIDC
Group mapping cannot belong to both a SAML config and an OIDC config.O mapeamento de grupos está ligado às duasDeixe-o numa só
Group mapping must be linked to either a SAML config or an OIDC config.O mapeamento de grupos não está ligado a nenhumaLigue-o a uma configuração SAML ou OIDC
Exemption expiry date must be today or in the future. Received: {}A data de expiração da isenção já passouUse a data de hoje ou uma futura
Editing not allowed: authentication event log records are append-only (tamper-evident audit trail).Ao tentar editar um registo de eventos de autenticaçãoNada: o módulo não permite editá-los
Deletion not allowed: authentication event log records are append-only (tamper-evident audit trail).Ao tentar apagar um registo de eventosNada: o módulo não permite apagá-los
Lista de políticas MFA nas Definições do Odoo com duas linhas, Admin MFA Enforcement e Regular User MFA
As políticas MFA, com empresa, tipos de fator aceites, período de tolerância e caixa Active

As duas mensagens do registo de eventos não indicam uma falha de configuração: o texto diz que esses registos só admitem acrescentar entradas (append-only). Se procura corrigir algo, não é aí.

Como a FlexigoTech o ajuda

Se uma mensagem não se esclarece com o próprio texto, podemos analisá-la consigo. A FlexigoTech implementa Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida. O módulo está publicado na Odoo Apps para 17, 18, 19 e 20, a 9 € sem IVA por versão do Odoo, pagamento único. Se tem dúvidas sobre se se adequa ao seu caso, veja o que cobre e em que versão, e os detalhes de compra estão na página do módulo.

Continue a ler

Como funciona por dentro o Two-Factor Authentication & SSO for Odoo: glossário de menus, tarefas e modelosMenus, ações agendadas e modelos do Two-Factor Authentication & SSO for Odoo explicados num glossário, com os nomes literais que vai ver no Odoo.Arranque de Two-Factor Authentication & SSO for Odoo, pergunta a perguntaQue campos preencher na configuração OIDC ou SAML, como mapear claims e grupos e o que rever na primeira semana com Two-Factor Authentication & SSO for Odoo.Two-Factor Authentication & SSO for Odoo: quando serve e o que ter antesO que cobre e o que não cobre o Two-Factor Authentication & SSO for Odoo segundo o README, o que precisa antes de o instalar e em que versões do Odoo está.
Verificado no código do módulo (versão 20.0) e nas fontes indicadas

Fontes