Documentação para Desenvolvedores | API & Guia de Integração - Visão Geral

Visão geral

Bem-vindo à documentação para desenvolvedores da Go.cam.

Esta secção fornece uma visão completa do serviço Go.cam, incluindo detalhes sobre como funciona e um guia passo a passo para a sua integração na sua plataforma.

Primeiros passos

Antes de iniciar o processo de implementação, será necessário criar uma conta Go.cam. Uma conta ativa concede acesso como parceiro e permite configurar as definições necessárias para a integração. A ativação da conta normalmente demora menos de 24 horas.

Métodos de verificação

A Go.cam disponibiliza quatro métodos de verificação concebidos para garantir que os utilizadores não são menores de idade:

• Validação por cartão de crédito
• Deteção de idade por selfie
• Extração de idade a partir de documento de identificação
• Verificação por email

Os utilizadores finais podem concluir a verificação utilizando qualquer um dos métodos disponíveis.

Fluxo de verificação

O processo de verificação da Go.cam pode ser visto a partir de duas perspetivas: experiência do utilizador final e lógica de integração do parceiro.

1. Fluxo do utilizador final

Fig: Diagrama do fluxo de verificação do utilizador

Etapas da verificação do utilizador (ver diagrama):

• 1. O utilizador visita um site parceiro protegido pelo sistema de verificação de idade da Go.cam.
• 2. O utilizador inicia a verificação clicando no botão "Verificar idade".
• 3. Dependendo da integração do parceiro, o utilizador irá:
• Ser redirecionado para uma página de verificação alojada pela Go.cam, ou
• Interagir com um iframe que carrega o fluxo de verificação da Go.cam.
• 4. O utilizador seleciona um dos métodos de verificação disponíveis:
• Validação por cartão de crédito
• Deteção de idade por selfie
• Extração de idade a partir de documento de identificação
• Verificação por email
• 5. O utilizador fornece as informações necessárias (por exemplo, dados do cartão de crédito, acesso à webcam, imagem do documento ou endereço de email).
• 6. Após a conclusão, a Go.cam apresenta o resultado:
• Página de sucesso: inclui um botão para regressar ao site parceiro.
• Página de falha: inclui uma opção "Tentar novamente" e um código QR para continuar a verificação num dispositivo móvel. Se for bem-sucedido, a sessão original será validada.
• 7. Após uma verificação bem-sucedida, o utilizador é redirecionado para o link de retorno configurado, desbloqueando o acesso ao site parceiro.

2. Integração do parceiro com lógica de redirecionamento

Fig: Diagrama de lógica de redirecionamento

Fluxo de redirecionamento (ver diagrama):

• 1. O utilizador acede ao site parceiro e inicia a verificação de idade.
• 2. O parceiro gera uma URL de verificação Go.cam utilizando o SDK, fornecendo:
• Cipher key e HMAC key
• Metadados do utilizador (por exemplo, userId)
• 3. O utilizador é redirecionado para a Go.cam para completar o processo de verificação.
• 4. O utilizador seleciona e conclui um dos métodos de verificação.
• 5. A Go.cam apresenta uma página de sucesso ou falha.
• 6. Os resultados são processados da seguinte forma:
• Os resultados da verificação são armazenados na Go.cam.
• A Go.cam envia os resultados para a URL de callback configurada, juntamente com os dados do utilizador fornecidos (por exemplo, userId).
• É criado um cookie na Go.cam com uma versão encriptada dos dados de verificação, que pode ser desencriptada posteriormente utilizando as chaves do parceiro.
• 7. Em caso de sucesso, o utilizador é redirecionado para o link de retorno, desbloqueando o acesso ao site parceiro.

3. Integração do parceiro com lógica de iframe

Fig: Diagrama de lógica de iframe

Fluxo com iframe (ver diagrama):

• 1. O utilizador acede ao site parceiro e inicia a verificação de idade.
• 2. O parceiro gera uma URL de verificação Go.cam utilizando o SDK, fornecendo:
• Cipher key e HMAC key
• Metadados do utilizador (por exemplo, userId)
• 3. Utilizando o SDK frontend, o parceiro ativa o overlay iframe para carregar a instância de verificação Go.cam.
• 4. Após o carregamento do iframe:
• Um evento confirma a inicialização.
• Se já existir um cookie de verificação Go.cam, um evento separado notifica o parceiro (a integridade do cookie deve ser validada).
• 5. O utilizador seleciona e conclui um dos métodos de verificação.
• 6. A Go.cam apresenta uma página de sucesso ou falha:
• Página de sucesso: fecha o iframe.
• Página de falha: permite tentar novamente.
• 7. Os resultados são processados da seguinte forma:
• Os resultados da verificação são armazenados na Go.cam.
• A Go.cam envia os resultados para a URL de callback configurada, juntamente com os dados do utilizador fornecidos (por exemplo, userId).
• É criado um cookie na Go.cam com dados de verificação encriptados, que podem ser desencriptados utilizando as chaves do parceiro.
• Um evento JavaScript anuncia o sucesso da verificação, permitindo ao parceiro validar o cookie armazenado.
• 8. Em caso de sucesso, o iframe é removido, desbloqueando o acesso ao site parceiro.

---

Terminologia

• Partner: Você, o integrador que implementa a Go.cam na sua plataforma.
• Cipher key / HMAC key: Chaves disponíveis na sua conta Go.cam, utilizadas para encriptar e validar dados de verificação.
• Verification result callback URL: Endpoint definido na sua conta Go.cam onde os resultados da verificação são enviados.
• Link back URL: URL definida através do SDK da Go.cam para redirecionar os utilizadores após uma verificação bem-sucedida.

---

Tipos de verificação

A Go.cam fornece múltiplos métodos de verificação para garantir que os utilizadores cumprem os requisitos de idade. Cada método é concebido tendo em conta a privacidade, segurança e conformidade.

1. Verificação por cartão de crédito

• O utilizador é temporariamente redirecionado para um ambiente seguro, onde é solicitado a introduzir o número do cartão de crédito e a data de validade.
• Não são efetuadas cobranças. Apenas a validade e a integridade do cartão são verificadas.
• Este é o único método de verificação que envia dados para o backend. O processamento ocorre num ambiente compatível com PCI DSS.
• A Go.cam não armazena nem transmite os dados do cartão a terceiros.

2. Verificação de idade por selfie

• Requer acesso à webcam para capturar o rosto do utilizador em tempo real.
• Um modelo de machine learning é executado localmente no dispositivo; nenhuma imagem é enviada ou armazenada.
• O processo:
• 1. O utilizador alinha o rosto no centro do ecrã.
• 2. São capturadas várias imagens. Valores atípicos são descartados e é calculada uma idade média prevista.
• 3. Verificações de consistência facial garantem que a mesma pessoa permanece à frente da câmara.
• 4. Uma medida de liveness também está presente, solicitando ao utilizador ações específicas.
• Se o utilizador for identificado como menor, o processo transita automaticamente para a verificação por documento de identificação:
• As imagens faciais são comparadas com a fotografia do documento.
• Se a correspondência for bem-sucedida, a data de nascimento é extraída para confirmar a idade.
• Se o utilizador for verificado como adulto, o processo é concluído com sucesso. Caso contrário, pode tentar novamente dentro de uma janela de sessão de 10 minutos antes de expirar.

Certificação

• A Go.cam é certificada Challenge 25: indivíduos com mais de 18 anos que aparentem menos de 25 podem ser obrigados a fornecer identificação.
• Certificada por:
• Association of Sites Advocating Child Protection
• The leading global provider of high-performance web hosting solutions in Cloud, VPS, and Dedicated hosting infrastructures.
• Central Authority for the Supervision and Protection of Minors on the Internet in Germany
• Age Check Certification Scheme
• A verificação de idade é baseada num modelo open-source de reconhecimento facial. [Saber mais aqui].

3. Verificação por documento de identificação

• O utilizador seleciona o país e o tipo de documento (cartão de identidade, passaporte ou carta de condução).
• Regiões suportadas: todos os países europeus e os Estados Unidos.
• A verificação pode ser realizada através de:
• Uma fotografia via webcam, ou
• Uma imagem carregada localmente.
• As imagens são processadas localmente no dispositivo; nada é enviado para os servidores da Go.cam.
• Se não tiver sido realizada verificação por selfie anteriormente, apenas a data de nascimento é extraída. A idade atual é então calculada e verificada de acordo com a maioria legal do país.
• A extração de texto do documento utiliza um modelo OCR open-source. [Saber mais aqui].

4. Verificação por email

• Verifica a idade do utilizador com base na atividade histórica do email.
• O sistema verifica se o endereço de email fornecido apareceu numa violação de dados há pelo menos 13 anos.
• Hipótese: se o email existia há 13 anos, o utilizador deve ter pelo menos 20 anos (idade mínima de 7 anos para criar email + 13 anos).
• Para confirmar a propriedade, é enviado um código de validação para o email, que o utilizador deve introduzir.