Como integrar o UbID em um aplicativo da Web

1. Informações gerais

1.1 O que é uma identidade inquebrável?

A identidade digital autogerenciada garante uma identidade digital sólida, confiável, legítima e segura que não está sujeita a modificações não autorizadas. Ela tem um perfil de usuário associado a ela de forma segura e eficiente. Ela pode integrar uma prova forte de identidade para verificar a identidade do requerente. Fornece um processo seguro para autenticar usuários em aplicativos. O usuário autenticado delega segurança e permissões ao aplicativo cliente facilmente.

1.2 Benefícios da identidade digital inquebrável

A Identidade Inquebrável (UbID) graças ao provedor de identidade digital UbID.app facilita o registro e a comprovação de identidade, bem como a autenticação digital recorrente, para integrar-se facilmente com aplicativos de software usando o padrão OpenID Connect, com muitas outras vantagens e benefícios.

The administrator user is required to have created an application to integrate within the environment that UbID provides, as seen below there are two applications created by the administrator user.

2. Como integrar o UbID em um aplicativo da Web

O usuário administrador precisa ter criado um aplicativo para integrar ao ambiente fornecido pelo UbID, como visto abaixo, há dois aplicativos criados pelo usuário administrador.

2.1 Integração

Para iniciar a integração você deve selecionar o botão “Chaves” no aplicativo:

Se você ainda não gerou uma chave de conexão, você deve ir até o botão “Gerar nova chave” para que o sistema lhe atribua uma chave de integração. Siga os passos que o sistema lhe apresenta (você também pode consultar o guia passo a passo onde esse processo é detalhado).

Uma vez que o sistema tenha gerado a chave, você verá uma tela como a abaixo.

Depois, você tem que programar e incorporar o link que se vê na parte que diz “o botão que você implementar na sua aplicação e que acessa o IDP deve conter o seguinte”. Neste caso de exemplo temos:

No link você pode ver 3 partes (as chaves que você vê abaixo são um exemplo, você verá suas próprias chaves:

1. O domínio: https://idp.ubid.app
2. O projeto (realm): ?realm:ubid.app
3. A aplicação (cliente): ?client:c3da6d80-ce67-48a9-9a90-4eb5cd87eaf0

Adicionalmente, podemos adicionar a opção: ?session

A sessão (um ID único que identifica a sessão): Um UUID que identifica a transação e que deve ser incorporado no URI, conforme mostrado abaixo. Isso é opcional, mas é sugerido incorporá-lo para que, por meio das APIs fornecidas pelo UbID, você possa obter os dados do usuário e o token da pessoa que fez login.

You can also preview the login, getting an example of how it works, by pressing the “Preview” button:

O modelo que o UbID sugere é um modelo moderno e minimalista, como mostrado abaixo, o papel de parede é alterado na opção “Papel de parede”. O papel de parede mostrado é apenas um exemplo.

Na tela de login, você pode ver o seguinte:

1. Nome do projeto (exemplo: Ubid.app, ou o nome da sua empresa).
2. Nome do aplicativo (exemplo: Miamicity.app, ou o nome do seu aplicativo).
3. Dois botões: “Criar nova conta” e “Usar uma conta existente”.

Quando o usuário se conecta via UbID ao seu aplicativo, o sistema fornecerá um token de conexão.

Este token e o nome de usuário do usuário conectado podem ser capturados com a API sessiondata. (Requer como condição que a opção ?session tenha sido incorporada na URL no link detalhado acima)

Além disso, os dados básicos do usuário conectado podem ser capturados: Nomes, sobrenomes, e-mail, telefone, etc… com a API userdata. (Requer como condição que a opção ?session tenha sido incorporada na URL no link detalhado acima)

As APIs devem conter a chave de autorização no cabeçalho. Esta chave pode ser obtida na opção “Keys”, opção “Private key”.

As APIs e sua implementação são detalhadas na aba APIs, como você pode ver abaixo: