O que é o Kodigos Identity?

O Kodigos Identity (ou Kodigos ID) é um serviço centralizado de autenticação que permite ao usuário acessar múltiplas aplicações da Kodigos com um único login. Além da autenticação, o Kodigos ID gerencia quem pode acessar o quê: por meio de perfis e claims, é possível definir com granularidade quais permissões cada usuário possui em cada aplicação.
Funciona de forma semelhante à conta Google: um único acesso para o Drive, Gmail e YouTube, sem a necessidade de senhas separadas para cada serviço.

Conceitos principais

1

Aplicação

Representa um sistema cadastrado no Kodigos ID. Cada aplicação possui suas próprias claims (permissões) definidas no código.
2

Chave (Claim)

Uma claim é uma permissão declarada no código da aplicação (por exemplo, compras:read ou compras:delete). Ela representa o que um usuário pode ou não fazer dentro de um módulo.
3

Perfil

Um perfil (ex: Administrador, Operador) é vinculado a uma aplicação e define quais claims estão ativas para os usuários que o possuem.
4

Usuário

Ao fazer login, o usuário recebe um access token JWT contendo as claims do perfil atribuído. A aplicação usa esse token para controlar o acesso a cada funcionalidade.

Como utilizar

Identity Provider

O Identity Provider é o endpoint do Kodigos ID para o qual sua aplicação aponta ao realizar autenticação. É ele quem valida as credenciais e emite o access token JWT.

Identificando a instância correta

O Kodigos ID pode ser implantado de forma independente em diferentes ambientes. Cada cliente possui sua própria instância com base de dados isolada. Isso significa que um Kodigos ID instalado no ambiente do cliente ABC não compartilha dados com o do cliente XYZ. Antes de configurar qualquer integração em produção, confirme com o time técnico qual é a URL do Identity Provider do ambiente em questão.
https://development.kodigos.com.br/identity
Apontar para a URL errada fará com que a autenticação falhe ou utilize uma base de usuários incorreta. Sempre confirme o endpoint antes de configurar uma integração em produção.