Campos da Conta Scrive eID Hub no Scrive Connector: o que significa cada um

A ficha abre-se a partir do menu Scrive › Configuração › Contas eID Hub (Scrive › Configuration › eID Hub Accounts). A secção Configuração pede a permissão Gestor (Manager) e a secção Scrive pede Utilizador (User): se lhe faltar uma, não vê essa secção. O módulo está publicado no Odoo Apps para 17.0, 18.0, 19.0 e 20.0.

Antes de abrir a ficha

• Tenha à mão o token de API do eID Hub que a Scrive emite ao abrigo do seu acordo de eID Hub. As credenciais da Scrive eSign (Document API) não são aceites na ficha.

• Descubra para que ambiente foi emitido esse token. A Scrive emite em separado os tokens de testbed e os de produção, e o ambiente da ficha tem de coincidir com o do token.

• Verifique que o seu utilizador chega ao menu: precisa de ver as secções Scrive e Configuração.

• Lembre-se de que o módulo funciona com a subscrição do FlexigoTech Cloud (plano Conector: 49 €/mês ou 490 €/ano sem IVA, até 3 contas da plataforma). A ligação passa por esse serviço. O pagamento único do módulo é à parte e o seu preço por versão do Odoo está na ficha do Odoo Apps.

Grupo Ligação

Este grupo (Ligação, Connection) é o dos dados com que a conta chama a Scrive.

• Ambiente (Environment). Escolha o host do eID Hub a que a conta chama. As opções são Produção (eid.scrive.com) e Testbed (testbed-eid.scrive.com); o valor por defeito é produção. Segundo a ajuda, o testbed está ligado aos sistemas de teste dos fornecedores de eID e só aceita as respetivas identidades de teste. Com um token de testbed, escolha testbed; com um de produção, produção. Também o vê na lista de contas.

• Token Bearer da API (API Bearer Token). Cole aqui o token do eID Hub. Só o veem os utilizadores com permissões de administração do Odoo; se não aparecer na sua ficha, peça a um administrador que o preencha. A ajuda diz que quem o guarda é o FlexigoTech Cloud, não o Odoo.

Grupo Predefinições

Aqui (Predefinições, Defaults) decide-se o que vê a pessoa que verifica a sua identidade.

• Fornecedor eID (eID Provider). É o sistema de eID que se oferece aos utilizadores finais nesta conta. A ajuda acrescenta que o frontend alojado da Scrive gere o fluxo próprio de cada fornecedor. Já vem com um escolhido por defeito; também aparece na lista de contas. Deste campo depende quais dos outros campos deste grupo são mostrados.

• Idioma de Interface Predefinido (Default UI Language). É o idioma do ecrã de verificação alojado na Scrive quando o contacto não tem idioma definido. Se o tiver, recebe esse idioma se a Scrive o oferecer (o norueguês bokmål e o nynorsk recebem norueguês; o catalão, o basco e o galego recebem espanhol) e, se não, inglês. Dois fornecedores têm listas mais curtas: o MitID dinamarquês mostra-se em dinamarquês quando esse é o idioma escolhido e em inglês no caso contrário; o Onfido fala inglês, espanhol, alemão, francês, italiano, português e neerlandês, e para qualquer outro idioma segue o navegador da pessoa. O valor por defeito é inglês.

Se escolher Onfido

Com o valor por defeito de Fornecedor eID estes três campos não se veem: aparecem quando o fornecedor é o Onfido.

• Onfido: concluir no telemóvel (Onfido: Finish on a Phone). Vem ativado: a pessoa passa para o telemóvel para fotografar o documento de identidade, mesmo que tenha começado num computador. Desative-o para oferecer também o ecrã de carregamento no computador, que segundo a ajuda é a única via para quem não tenha smartphone.

• Verificação Onfido (Onfido Check). Escolha que verificação é pedida: a de documento lê o documento de identidade; a comparação facial compara ainda uma selfie com a foto do documento. Por defeito é a de documento. A Onfido fatura-as em separado, por isso decida com a fatura à mão.

• Verificação de Nome Onfido (Onfido Name Check). Vem desativado. Se o ativar, envia-se também o nome do contacto à Onfido, que o compara com o documento e rejeita a verificação se não coincidirem. O nome divide-se no primeiro espaço: «Jan Erik Janssens» é enviado como nome «Jan» e apelido «Erik Janssens», pelo que um documento com nomes próprios «Jan Erik» pode ser rejeitado, e uma verificação rejeitada é faturada na mesma. Ative-o apenas se os nomes dos seus contactos estiverem registados exatamente como nos respetivos documentos. Sem ele, Corresponder Identidade ao Contacto continua a comparar, com mais tolerância, o nome que a Onfido leu no documento.

Se escolher MitID dinamarquês

• Pedir CPR Dinamarquês (Request Danish CPR). Só se vê quando o fornecedor é o MitID dinamarquês. Vem desativado. Pede ao MitID o número CPR da pessoa, que segundo a ajuda é o único identificador que liga uma verificação do MitID a uma pessoa concreta e é um dado pessoal sensível: ative-o apenas se tiver base jurídica para o guardar. Sem ele, para a comparação com o contacto só está disponível o nome verificado.

Grupo Identidade, Retenção e Segurança

O grupo Identidade, Retenção e Segurança (Identity, Retention & Safety) reúne os campos de identidade, retenção e bloqueio da conta.

• Corresponder Identidade ao Contacto (Match Identity to Contact). Vem ativado. Com a caixa marcada, o acesso aos documentos de um contacto do Odoo só se abre se a identidade que o fornecedor devolve for a desse contacto, o mesmo para o qual foi iniciada a verificação. Se a desmarcar, basta uma verificação correta de qualquer pessoa para abrir esses documentos. A ajuda dá uma exceção: os fornecedores que não devolvem nenhuma identidade (palavra-passe de utilização única por SMS) nunca podem cumprir a comparação, por isso desative-a se usar algum deles. Também aparece na lista de contas.

• Interruptor de Emergência (Kill Switch). Bloqueia toda a chamada de saída à API do eID Hub a partir desta conta. Deixe-o desmarcado enquanto quiser que a conta chame o eID Hub e tenha localizado onde está: vê-se na ficha e na lista de contas.

• Retenção de Dados (dias) (Data Retention (days)). Os dados de identidade verificada (nome, número pessoal, payload em bruto) capturados em cada verificação são purgados passados estes dias. A ajuda diz que reflete a retenção de dados de 30 dias do eID Hub da Scrive, e que o valor vai entre 1 e 3650 dias. Traz um valor por defeito; ajuste-o ao que quiser conservar no seu Odoo.

Grupo Webhook de conclusão (opcional)

• Enviar webhook de conclusão (Send Completion Webhook). Vem desativado e, segundo a ajuda, deixá-lo assim é seguro: o resultado é sempre consultado de novo na Scrive quando a pessoa regressa da verificação. Só o veem os utilizadores com a permissão de gestor da Scrive. Se o ativar, a Scrive envia ainda por POST uma notificação para o URL de callback a que a ajuda se refere. A Scrive só aceita URLs incluídos na lista branca do seu cliente de eID Hub: peça PRIMEIRO que o incluam, porque enquanto não estiver incluído, a Scrive rejeita cada verificação com um HTTP 400.

Depois de guardar

• Repare no campo Aviso do Fornecedor (Provider Warning). Vai sem etiqueta e só aparece quando tem conteúdo; quem o escreve é o código do módulo, não você. Segundo a sua ajuda, preenche-se quando a Scrive rejeita o fornecedor de eID configurado para esse token e apaga-se assim que uma verificação é aceite.

• Reveja a lista de contas: aí veem-se Ambiente, Fornecedor eID, Interruptor de Emergência e Corresponder Identidade ao Contacto, útil para detetar de relance uma conta a apontar para o ambiente errado.

Se quiser ajuda

A FlexigoTech implementa Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida. Se preferir que alguém deixe a conta do eID Hub configurada consigo, ou precisar de outro fornecedor ou fluxo, escreva-nos a partir da página do módulo. Sem subscrição, ou com o serviço suspenso, pára o que a subscrição proporciona; os dados ficam no seu Odoo.

Continue a ler

Verificado no código do conector (versão 20.0) e nas fontes indicadas

Fontes

• Código do módulo: flexigobe_scrive_connector 20.0 (442af8bf): models/scrive_eid_account.py
• apps.odoo.com/apps/modules/20.0/flexigobe_scrive_connector
• flexigotech.com/en/services.html
• flexigotech.com/precios.html