Skip to content
adelmeradPublic

About

Serveur SSO OAuth2/OpenID Connect avec panneau d'administration – stage Mobilis.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

39 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SSO Platform

Serveur SSO commun du projet. Réalisé par Adel Merad et Abdelhadi Deffous pendant leur stage chez Mobilis.

L'application ShopWebApp se connecte à ce serveur. L'ancienne version de ShopAuth reste disponible avec le tag ancienne-version.

Système d'authentification unique (SSO) basé sur OAuth2/OIDC, composé de quatre projets :

Projet Rôle Port par défaut
SsoServer Serveur d'identité (OpenIddict + ASP.NET Identity) 5171
ClientApi BFF (Backend For Frontend) OAuth2 5200
sso-client Application de démonstration (React) 5173
sso-admin Interface d'administration (React) 5174 (dev) ou servie par SsoServer sous /admin/

Flow : sso-client → ClientApi (garde le client_secret et les jetons) → SsoServer (authentification, émission des jetons). PKCE obligatoire, rotation des refresh tokens, rôles globaux + rôles par application.


1. Prérequis

  • .NET SDK 8.0
  • Node.js 18+ (et npm)
  • SQL Server accessible (une des options suivantes) :
    • SQL Server Express / Developer déjà installé localement, ou
    • Docker : docker run -e "ACCEPT_EULA=Y" -e "MSSQL_SA_PASSWORD=<mot-de-passe-sql>" -p 1433:1433 -d mcr.microsoft.com/mssql/server:2022-latest
  • dotnet-ef (outil CLI) : dotnet tool install --global dotnet-ef si vous ne l'avez pas déjà

2. Cloner et configurer SsoServer

git clone https://github.com/adelmerad/ShopAuth.git
cd ShopAuth/SsoServer

2.1 Secrets (jamais commités, à définir localement)

dotnet user-secrets set "ConnectionStrings:DefaultConnection" "Server=localhost,1433;Database=SsoServerDb;User Id=sa;Password=<mot-de-passe-sql>;TrustServerCertificate=True"
dotnet user-secrets set "Bootstrap:AdminPassword" "<choisissez-un-mot-de-passe-fort>"

Remplacez <mot-de-passe-sql> par celui de votre instance SQL Server, et <choisissez-un-mot-de-passe-fort> par un mot de passe que vous seul connaissez — ce sera celui du premier compte administrateur, créé automatiquement au démarrage avec l'email défini dans appsettings.Development.json (admin@entreprise.com par défaut). Ces deux valeurs vivent dans le magasin user-secrets de votre machine, jamais dans un fichier commité.

2.2 Adapter l'hôte réseau

Par défaut (rien à faire), tout tourne sur localhost. Pour tester avec un binôme sur le même réseau local, définissez votre IP via user-secrets :

dotnet user-secrets set "Network:Host" "<votre-ip-locale>"
dotnet user-secrets set "Network:BinomeHost" "<ip-du-binome>"

<votre-ip-locale> s'obtient avec ipconfig (adresse IPv4, ex. 192.168.1.72). Network:BinomeHost est optionnel : renseignez-le si vous voulez qu'un troisième client OAuth (app-binome) soit créé automatiquement pour la machine de l'autre personne.

Cette valeur sert à préconfigurer les redirect_uri des applications OAuth de démonstration (voir Data/DevClientSeeder.cs) — si elle ne correspond pas à l'adresse réellement utilisée dans le navigateur, la connexion échouera avec une erreur redirect_uri invalide.

2.3 Créer la base de données

dotnet ef database update

Ça crée le schéma (Identity + OpenIddict). Au premier démarrage, le serveur amorce aussi automatiquement le rôle Admin, le compte administrateur, les clients OAuth de démonstration et deux comptes de test (voir section 6).

2.4 Lancer

dotnet run

Vérifiez que ça écoute bien sur http://localhost:5171 (ou votre IP).


3. Configurer et lancer ClientApi

cd ../ClientApi

Comme pour SsoServer, ces valeurs se définissent en local via user-secrets, jamais dans appsettings.json (qui reste vide dans le dépôt). Avec les valeurs par défaut du seeder de développement, sur la même machine que SsoServer :

dotnet user-secrets set "Sso:Authority" "http://localhost:5171"
dotnet user-secrets set "Sso:ClientId" "mon-app-cliente"
dotnet user-secrets set "Sso:ClientSecret" "dev-only-demo-client"
dotnet user-secrets set "Sso:RedirectUri" "http://localhost:5200/auth/callback"
dotnet user-secrets set "Frontend:Url" "http://localhost:5173"

Remplacez localhost par l'IP choisie à l'étape 2.2 si vous testez avec un binôme sur le réseau local. Puis :

dotnet run

Écoute sur http://localhost:5200.


4. Configurer et lancer sso-client

cd ../sso-client
npm install
cp .env.example .env

.env pointe déjà vers http://localhost:5200 par défaut — à adapter uniquement si vous avez changé le port de ClientApi.

npm run dev

Écoute sur http://localhost:5173.


5. Configurer et lancer sso-admin

cd ../sso-admin
npm install
npm run dev

Écoute sur http://localhost:5174/admin/, avec un proxy Vite qui redirige vers http://localhost:5171 (SsoServer). Aucune configuration supplémentaire nécessaire si SsoServer tourne en local sur le port par défaut.

Pour un accès depuis une autre machine du réseau, relancez avec npm run dev -- --host et utilisez l'adresse réseau affichée dans la console.


6. Comptes de test

Créés automatiquement au premier démarrage de SsoServer (voir Data/BootstrapSeeder.cs et Data/DevClientSeeder.cs) :

Email Mot de passe Rôle
admin@entreprise.com celui défini via Bootstrap:AdminPassword (étape 2.1) Admin
employe@entreprise.com MotDePasse123! Employe
salim3@entreprise.com MotDePasse123! Employe

7. Tester le scénario complet

  1. Ouvrez http://localhost:5173 (sso-client), cliquez Se connecter → redirigé vers SsoServer → connectez-vous avec employe@entreprise.com → redirigé vers le tableau de bord de sso-client.
  2. Ouvrez http://localhost:5174/admin/ (sso-admin), connectez-vous avec admin@entreprise.com → gérez les comptes, applications et rôles.
  3. Dans sso-admin, onglet Comptes, assignez un rôle applicatif à employe@entreprise.com pour l'application mon-app-cliente, puis reconnectez-vous sur sso-client pour vérifier qu'il apparaît.

8. Dépannage courant

  • redirect_uri invalide en se connectant : Network:Host (SsoServer) et Sso:RedirectUri/Sso:Authority (ClientApi) doivent pointer vers la même adresse que celle tapée dans le navigateur.
  • Erreur de connexion SQL Server : vérifiez que le service tourne (docker ps si vous utilisez Docker) et que le mot de passe dans ConnectionStrings:DefaultConnection correspond.
  • dotnet ef introuvable : dotnet tool install --global dotnet-ef, puis relancez un nouveau terminal.
  • Page blanche sur /admin/ : assurez-vous d'accéder à l'URL avec le /admin/ final, pas juste la racine.

About

Serveur SSO OAuth2/OpenID Connect avec panneau d'administration – stage Mobilis.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages