SSO Miante

Descrição

sso_miante é uma biblioteca Django voltada à centralização da autenticação e da gestão de usuários entre múltiplas aplicações. Ela fornece uma base simples e reutilizável para implementação de Single Sign-On (SSO), permitindo o compartilhamento de usuários, sessões e regras de acesso.

O pacote reúne um aplicativo principal de autenticação e um aplicativo cliente para integração com sistemas consumidores, facilitando a adoção de login centralizado com mínima configuração. Inclui templates e arquivos estáticos embarcados, é compatível com versões modernas do Django e segue boas práticas de arquitetura modular.

Indicado para projetos que necessitam de login unificado, padronização de acessos e governança centralizada de usuários em ambientes Django.

• github: jhmiante/sso_miante

• pypi: PyPi sso-miante (last version)

Manual de Uso

Instalação

pip install sso-miante

Configuração Projeto Principal

O projeto principal será o qual está a configuração dos projetos que utilizarão o login por SSO, também será onde estará centralizado os usuários.

Após a instalação do sso_miante no projeto principal, no arquivo settings.py inclua a seguinte linha em INSTALLED_APPS:

INSTALLED_APPS = [ 
    ...,
    'sso_miante',
]

No arquivo url.py do projeto, inclua a url do sso_miante

from django.urls import path, include

urlpatterns = [
    ...,
    path("", include("sso_miante.urls")),
]

Agora Rode o migrate

python manage.py migrate

Inicie o Servidor (exemplo com 127.0.0.1:8001)

python manage.py runserver 127.0.0.1:8001

Acesse a página ADM do SSO Miante: http://127.0.0.1:8000/sso/
***Lembre de substituir o http://127.0.0.1:8000/ pela seu dominio

Siga os passos abaixo para cadastrar um novo APP

1. Clique em Novo
2. Digite o nome para o Aplicativo
3. Copie o ID APP e SECRETS APP e para um local seguro, você irá precisar dele quando for configurar o aplicativo que irá realizar o login
4. Digite os Servidores (HOST) que poderão realizar login (Se precisar mais de um, digite um por linha)

Pronto o projeto principal já está finalizado

Para adicionar novos aplicativos, siga os 3 passos acima, quantas vezes forem necessária

Configuração Projetos Adicionais

São os projetos que irão utilizar o login via SSO

Primeiro deve instalar o sso_miante (deverá ser instalado em todos os projetos)

pip install sso-miante

Após a instalação do sso_miante no projeto, no arquivo settings.py inclua a seguinte linha em INSTALLED_APPS:

INSTALLED_APPS = [ 
    ...,
    'sso_miante_client',
]

Também no arquivo settings.py inclua as variáveis

SSO_MIANTE_ID = 'APP_ID' # GERADO ANTERIORMENTE no Projeto (ID APP)
SSO_MIANTE_SECRETS = 'SECRETS' # GERADO ANTERIORMENTE no Projeto (SECRETS APP)
SSO_MIANTE_URL = 'http://127.0.0.1:8000/sso/userinfo/' #Lembre de substituir o http://127.0.0.1:8000/ pela seu dominio

LOGIN_URL = "sso_login"
LOGOUT_REDIRECT_URL = "sso_login"

No arquivo url.py do projeto, inclua a url do sso_miante

from django.urls import path, include

urlpatterns = [
    ...,
    path("", include("sso_miante_client.urls")),
]

Histórico de Versões

• 0.0.9 ou anterior => Versões Beta (testes) (Não utilizar)
• 1.0.0 => Versão Inicial Oficial