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.
- .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-efsi vous ne l'avez pas déjà
git clone https://github.com/adelmerad/ShopAuth.git
cd ShopAuth/SsoServerdotnet 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é.
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.
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).
dotnet runVérifiez que ça écoute bien sur http://localhost:5171 (ou votre IP).
cd ../ClientApiComme 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.
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.
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.
Créés automatiquement au premier démarrage de SsoServer (voir
Data/BootstrapSeeder.cs et Data/DevClientSeeder.cs) :
| 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 |
- Ouvrez
http://localhost:5173(sso-client), cliquez Se connecter → redirigé vers SsoServer → connectez-vous avecemploye@entreprise.com→ redirigé vers le tableau de bord de sso-client. - Ouvrez
http://localhost:5174/admin/(sso-admin), connectez-vous avecadmin@entreprise.com→ gérez les comptes, applications et rôles. - Dans sso-admin, onglet Comptes, assignez un rôle applicatif à
employe@entreprise.compour l'applicationmon-app-cliente, puis reconnectez-vous sur sso-client pour vérifier qu'il apparaît.
redirect_uri invalideen se connectant :Network:Host(SsoServer) etSso: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 pssi vous utilisez Docker) et que le mot de passe dansConnectionStrings:DefaultConnectioncorrespond. dotnet efintrouvable :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.