Skip to content

ladesa-ro/autenticacao

Repository files navigation

Autenticação do Ladesa

Fornece recursos de login, recuperação de acesso e checagem de identidade de uma forma muito doce 💝.

Motivação

Os sistemas do Ladesa, assim como muitos aplicativos informáticos modernos, trabalham com a interação entre humanos e máquinas.

Diante disso, surge a demanda de identificar e representar as pessoas em ambientes virtuais para, dentre outras coisas, reconhecer as autorias de ações e delimitar quais operações cada perfil possa realizar em diferentes contextos.

Portanto, é necessário uma solução robusta e confiável que forneça os meios necessários para a correta identificação dos indivíduos, com a qual todo o ecossistema informático possa contar.

Propósito

Diante da necessidade de que os softwares que conectem às plataformas do Ladesa têm de iniciar e confiar nas sessões dos usuários, este projeto surge para cuidar do credenciamento e checagem de identidade a essas aplicações tecnológicas.

Objetivo Geral

Objetivos Específicos

  • Login unificado (Single-Sign On);
  • Fedração de Usuários (User Federation);
  • Integrador de Identidade e Login Social (Identity Brokering and Social Login);
  • Protocolos Padronizados (Standard Protocols).

Desenvolvimento Local

É muito bom saber que você quer realizar o desenvolvimento do Autenticação do Ladesa. Após checar os requisitos necessários, você será guiado para obter o código-fonte deste sistema e saber, dentre outras coisas, como iniciar o desenvolvimento, subir um servidor local e construir a imagem da aplicação.

Requisitos

Para o desenvolvimento local, é necessário preparar o seu ambiente de trabalho para mexer com este projeto. A seguir, estão listadas as tecnologias requisitadas.

Tip

Basta clicar nos links acima para ter acesso às nossas dicas e tutoriais :).

Obter o código-fonte do projeto

O primeiro passo para trabalhar com o serviço de Autenticação do Ladesa é obter uma cópia dos arquivos deste repositório.

Por meio dos comandos a seguir, você terá em sua máquina de desenvolvimento o acesso ao repositório deste projeto:

git clone https://github.com/ladesa-ro/autenticacao.git
cd autenticacao

Serviços do docker-compose.yml

Host Endereço Porta Alvo Descrição Plataforma Base
ladesa-ro-sso localhost:23032 (mapeamento direto); sso.ladesa.localhost (proxy reverso); 8080 Aplicação KeyCloak quay.io/keycloak/keycloak:25.0
ladesa-ro-sso-db 127.128.5.11:5432 5432 Banco de dados postgres docker.io/bitnami/postgresql:15

Scripts Make

O projeto conta com um arquivo make que comporta scrips destinados ao desenvolvimento da aplicação.

setup:
  # Configura o ambiente de deselvolvimento, como a criação da rede ladesa-net e os arquivos .env
up:
  # Inicia os containers docker
shell:
  # Inicia os containers docker e abre o bash na aplicação keycloak
down:
  # Para todos os containers
logs:
  # Mostra os registros dos containers