Login via app

Antes de começar

Você precisará de um appId e um endpoint para onde serão enviados os tokens de
autenticação para que o fluxo continue no servidor, garantindo a segurança dos dados dos usuários. Para
solicitar seu appId entre em contato com nosso time através do [email protected]

Exemplos

Criamos um Sample (Android/iOS) para exemplificar como adicionar esse fluxo de login em seu projeto!

📘

Exemplos disponíveis

Android: Kotlin
iOS: Swift e Objective C

Sequência de chamadas

No diagrama abaixo você pode conferir a sequência de chamadas nos sistemas envolvidos.

Layout do Botão

Como padrão do MeuID, disponibilizamos três tipos diferentes de layout para o botão (Figura 1), e colocamos também as guidelines recomendadas (Figura 2).

🚧

Cores utilizadas

#5500FF - Roxo MeuID
#FFFFFF - Branco

Figura 1

Figura 2

Ação do Botão

Ao seguir a documentação técnica de implementação (Android/iOS), você terá configurado a ação do botão Login com MeuID.

Ao clicar no botão, o usuário irá disparar um deeplink no seguinte formato

Deeplink

meuid://meuid?action=MEUID_AUTHENTICATION&applicationId={application_id}&parameters=eyJvcmlnaW4iOiJNT0JJTEVfQVBQIn0

No deeplink, o parâmetro applicationId é um id único por empresa cliente e é dessa forma que o MeuID identifica quem está solicitando as informações. Os demais parametros não devem ser alterados.

Esse deeplink o direcionará para a tela de Autorização dentro do app do MeuID (Figura 3).

Caso o usuário não tenha o aplicativo do MeuID instalado em seu device ele será automaticamente redirecionado para a loja de aplicativos, onde poderá fazer o download e instalação do MeuID.

Figura 3

Caso o usuário não esteja cadastrado no MeuID, ele será direcionado para a tela inicial onde poderá iniciar o fluxo de cadastro. Ao finalizar este fluxo, o usuário será automaticamente direcionado para a tela de Autorização (Figura 3). Neste caso, como o usuário ainda não possui nenhum dado validado no MeuID, será solicitado que ele adicione documentos para validação.

Após os documentos serem validados, ele poderá acessar novamente o app da empresa cliente e reiniciar o fluxo de Login com MeuID.

Ao clicar em Autorizar, o usuário estará concordando em enviar os dados solicitados, já validados pelo MeuID, para a empresa cliente.

Esse envio de dados do MeuID para a empresa cliente é feito por meio de deeplink contendo dois parâmetros code e code_verifier, conforme o exemplo abaixo

Deeplink

meuid-{meuid_application_id}://authorize?code={code}&code_verifier={code_verifier}

Esses parâmetros serão utilizados para acessar o a API do MeuID que retornará os dados que foram autorizados pelo usuário.

Links

Disponibilizamos os Samples nos links abaixo
Android
iOS