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

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.

• Acesso à Linha de Comando;
• Git;
• Docker;
• GNU Make (documentação inexistente).

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/auth.git
cd auth

Serviços do .devops/development/docker-compose.yml

Host	Endereço	Porta Alvo	Descrição	Plataforma Base
ladesa-ro-auth	localhost:23032 (mapeamento direto); sso.ladesa.localhost (proxy reverso);	8080	Aplicação KeyCloak	quay.io/keycloak/keycloak:25.0
ladesa-ro-auth-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