\r\n \r\n );\r\n}\r\n```\r\n\r\n## Utilisation avec Next.js\r\n\r\n### 1. Configuration dans _app.tsx\r\n\r\n```tsx\r\nimport { SSOProvider } from '@alfycore/sso-client';\r\nimport type { AppProps } from 'next/app';\r\n\r\nconst ssoConfig = {\r\n ssoServerUrl: process.env.NEXT_PUBLIC_SSO_SERVER_URL!,\r\n clientId: process.env.NEXT_PUBLIC_SSO_CLIENT_ID!,\r\n clientSecret: process.env.NEXT_PUBLIC_SSO_CLIENT_SECRET!,\r\n redirectUri: process.env.NEXT_PUBLIC_SSO_REDIRECT_URI!\r\n};\r\n\r\nexport default function App({ Component, pageProps }: AppProps) {\r\n return (\r\n \r\n \r\n \r\n );\r\n}\r\n```\r\n\r\n### 2. Page Protégée\r\n\r\n```tsx\r\nimport { useSSO, ProtectedRoute } from '@alfycore/sso-client';\r\n\r\nexport default function DashboardPage() {\r\n return (\r\n \r\n \r\n \r\n );\r\n}\r\n\r\nfunction Dashboard() {\r\n const { user, logout } = useSSO();\r\n \r\n return (\r\n
\r\n
Dashboard - {user?.name}
\r\n \r\n
\r\n );\r\n}\r\n```\r\n\r\n## Utilisation avec Express.js\r\n\r\n### 1. Configuration de base\r\n\r\n```javascript\r\nconst express = require('express');\r\nconst { ExpressSSOMiddleware } = require('@alfycore/sso-client');\r\n\r\nconst app = express();\r\n\r\nconst ssoMiddleware = new ExpressSSOMiddleware({\r\n ssoServerUrl: process.env.SSO_SERVER_URL,\r\n clientId: process.env.SSO_CLIENT_ID,\r\n clientSecret: process.env.SSO_CLIENT_SECRET,\r\n redirectUri: process.env.SSO_REDIRECT_URI,\r\n cookieSecure: process.env.NODE_ENV === 'production',\r\n loginPath: '/auth/login',\r\n callbackPath: '/auth/callback',\r\n logoutPath: '/auth/logout'\r\n});\r\n\r\n// Installer les routes d'authentification\r\napp.use(ssoMiddleware.routes());\r\n\r\n// Route publique\r\napp.get('/', (req, res) => {\r\n res.send('Page d\\'accueil');\r\n});\r\n\r\n// Route protégée\r\napp.get('/dashboard', ssoMiddleware.requireAuth(), (req, res) => {\r\n res.json({\r\n message: 'Tableau de bord',\r\n user: req.user\r\n });\r\n});\r\n\r\n// Route avec authentification optionnelle\r\napp.get('/profile', ssoMiddleware.optionalAuth(), (req, res) => {\r\n if (req.user) {\r\n res.json({ user: req.user });\r\n } else {\r\n res.json({ message: 'Non authentifié' });\r\n }\r\n});\r\n\r\napp.listen(3000, () => {\r\n console.log('Server running on port 3000');\r\n});\r\n```\r\n\r\n### 2. TypeScript avec Express\r\n\r\n```typescript\r\nimport express, { Request, Response } from 'express';\r\nimport { ExpressSSOMiddleware } from '@alfycore/sso-client';\r\n\r\nconst app = express();\r\n\r\nconst ssoMiddleware = new ExpressSSOMiddleware({\r\n ssoServerUrl: process.env.SSO_SERVER_URL!,\r\n clientId: process.env.SSO_CLIENT_ID!,\r\n clientSecret: process.env.SSO_CLIENT_SECRET!,\r\n redirectUri: process.env.SSO_REDIRECT_URI!\r\n});\r\n\r\napp.use(ssoMiddleware.routes());\r\n\r\napp.get('/api/me', ssoMiddleware.requireAuth(false), (req: Request, res: Response) => {\r\n res.json(req.user);\r\n});\r\n\r\napp.listen(3000);\r\n```\r\n\r\n## API Reference\r\n\r\n### SSOProvider (React/Next.js)\r\n\r\nProps:\r\n- `config`: Configuration SSO (obligatoire)\r\n- `onAuthSuccess`: Callback appelé après authentification réussie\r\n- `onAuthError`: Callback appelé en cas d'erreur\r\n- `storageKey`: Clé de stockage local (défaut: 'alfycore_sso_session')\r\n\r\n### useSSO Hook\r\n\r\nRetourne:\r\n- `user`: Utilisateur actuel ou null\r\n- `isAuthenticated`: Boolean indiquant si l'utilisateur est connecté\r\n- `isLoading`: Boolean indiquant le chargement\r\n- `login()`: Fonction pour initier la connexion\r\n- `logout()`: Fonction pour se déconnecter\r\n- `refreshSession()`: Fonction pour rafraîchir la session\r\n\r\n### ExpressSSOMiddleware\r\n\r\nMéthodes:\r\n- `routes()`: Middleware pour gérer les routes d'authentification\r\n- `requireAuth(redirectOnFail?)`: Middleware pour protéger les routes\r\n- `optionalAuth()`: Middleware avec authentification optionnelle\r\n- `getUser(req)`: Récupère l'utilisateur depuis la requête\r\n\r\nOptions:\r\n- `ssoServerUrl`: URL du serveur SSO\r\n- `clientId`: ID du client SSO\r\n- `clientSecret`: Secret du client SSO\r\n- `redirectUri`: URI de redirection\r\n- `cookieName`: Nom du cookie de session\r\n- `cookieMaxAge`: Durée de vie du cookie (ms)\r\n- `loginPath`: Chemin de la route de connexion\r\n- `callbackPath`: Chemin de la route de callback\r\n- `logoutPath`: Chemin de la route de déconnexion\r\n\r\n## Exemples Complets\r\n\r\nConsultez le dossier `examples/` pour des exemples complets d'utilisation avec :\r\n- React (Create React App)\r\n- Next.js\r\n- Express.js\r\n\r\n## Support\r\n\r\nPour toute question ou problème, créez une issue sur le dépôt GitHub.\r\n\r\n## Licence\r\n\r\nMIT\r\n","readmeFilename":"README.md","_rev":"1-b3c686e03db08e8e8a2ed993fc76715d"}