Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ladesa-ro/autenticacao
Autenticação do Ladesa.
https://github.com/ladesa-ro/autenticacao
auth authentication identity-provider idp issuer jwt keycloak ladesa ladesa-ro login oauth2 oidc openid-connect single-sign-on sisgea sisgha sso
Last synced: about 1 month ago
JSON representation
Autenticação do Ladesa.
- Host: GitHub
- URL: https://github.com/ladesa-ro/autenticacao
- Owner: ladesa-ro
- Created: 2023-10-20T18:22:59.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-11-16T16:45:38.000Z (about 1 month ago)
- Last Synced: 2024-11-16T17:21:08.564Z (about 1 month ago)
- Topics: auth, authentication, identity-provider, idp, issuer, jwt, keycloak, ladesa, ladesa-ro, login, oauth2, oidc, openid-connect, single-sign-on, sisgea, sisgha, sso
- Language: TypeScript
- Homepage: https://sso.ladesa.com.br
- Size: 290 KB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
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);
- Identity Brokering and Social Login (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.
- [Acesso à Linha de Comando](https://docs.ladesa.com.br/developers/tutorials/os/command-line/);
- [Git](https://docs.ladesa.com.br/developers/tutorials/source-code/git/);
- [Docker](https://docs.ladesa.com.br/developers/tutorials/platforms/containers/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:
```sh
git clone https://github.com/ladesa-ro/autenticacao.git
cd autenticacao
```
### Serviços do [.devops/development/docker-compose.yml](./.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](./Makefile) que comporta scrips destinados ao desenvolvimento da aplicação.
```Makefile
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
```