Integração do portal com Aplicativos
- Luiz Leite
Para exibir o portal em um aplicativo pode variar bastante dependendo da tecnologia do seu app, mas essencialmente você precisa orientar o desenvolvedor a incluir o link em uma webview (componente web) em algum local da sua preferência.
Dica: Não esqueça de habilitar Javascript e DOM/Localstorage na configuração da sua webview em aplicativos. Exemplo para Android:
webView.settings.javaScriptEnabled = truewebView.settings.domStorageEnabled = truewebView.loadUrl("url do seu portal")
Já possuo usuário logado e quero manter a sessão
O portal da privacidade possui recurso para criação de novos usuários, autenticação, esqueci senha e gerenciamento dos dados. Contudo, muitas vezes você já estará com o seu usuário autenticado em algum aplicativo ou sistema e quer entregar o portal com a autenticação pronta. Para isso siga os passos a seguir.
Gerando um token de autenticação
O primeiro passo nesse caso é gerar um token de autenticação para esse usuário. A geração do token deve ser feita no server-side durante o processo de login do seu usuário ou a qualquer momento que desejar.
Na documentação disponível em API para Desenvolvedores você pode encontrar o endpoint para obter o token de autorização.
Method: POST
Base URL: dpo.privacytools.com.br/external_api_v2
Endpoint: /external_api_v2/consent/portal/auth/login
Header: Authorization
Parâmetros:
- document - Informe o CPF do titular
- email - Informe o email do titular
- name - Informe o nome do titular
- phoneNumber - Informe o telefone do titular
- encryptedId - [ignorar] |
O retorno dessa chamada será um token de autenticação que criará uma sessão para o usuário indicado.
Inserindo o portal autenticado
Durante a construção da sua webview e já em posse do token de autenticação conforme serviço anterior, envie o token por parâmetro após a URL do seu portal da privacidade, exemplo:
$url_do_portal?token=$token_autenticação |
Com essa informação na URL o portal já estará autenticado com os dados do usuário informado. Caso o e-mail desse usuário corresponda a um usuário já existente o portal já buscará as preferências anteriores desse usuário.