Application monopage React
Ajoutez la connexion à une application React de navigateur en tant que client public, avec react-oidc-context et le flux Authorization Code avec PKCE.
Ce guide ajoute la connexion OIDC à une application React sans backend propre, à l'aide de react-oidc-context (construit sur oidc-client-ts). Une application de navigateur est un client public : elle possède un client ID mais aucun secret, et s'appuie sur PKCE.
Enregistrez d'abord l'application comme client OIDC public / monopage et ajoutez votre redirect URI ; voir Avant de commencer. Pour le protocole sous-jacent, voir OpenID Connect (Authorization Code + PKCE).
1. Installer
npm install react-oidc-context oidc-client-ts2. Configurer le provider
Enveloppez votre application dans AuthProvider. L'authority est le domaine de connexion de votre instance ; la bibliothèque découvre les endpoints et utilise par défaut Authorization Code avec PKCE.
// main.jsx
import { createRoot } from 'react-dom/client';
import { AuthProvider } from 'react-oidc-context';
import App from './App';
const oidcConfig = {
authority: 'https://<your-domain>',
client_id: '<your-client-id>',
redirect_uri: 'https://app.example.com/callback',
post_logout_redirect_uri: 'https://app.example.com/',
scope: 'openid profile email',
// Clean the code/state params out of the URL after the redirect back.
onSigninCallback: () =>
window.history.replaceState({}, document.title, window.location.pathname),
};
createRoot(document.getElementById('root')).render(
<AuthProvider {...oidcConfig}>
<App />
</AuthProvider>
);Ne placez pas de client secret dans le code du navigateur. Un client public n'en a pas.
3. Se connecter et lire l'utilisateur
Utilisez le hook useAuth pour déclencher la connexion et lire le résultat.
// App.jsx
import { useAuth } from 'react-oidc-context';
export default function App() {
const auth = useAuth();
if (auth.isLoading) return <p>Loading...</p>;
if (auth.error) return <p>Sign-in error: {auth.error.message}</p>;
if (auth.isAuthenticated) {
return (
<div>
<p>Signed in as {auth.user?.profile.email}</p>
<button onClick={() => auth.signoutRedirect()}>Log out</button>
</div>
);
}
return <button onClick={() => auth.signinRedirect()}>Log in</button>;
}auth.user.profile contient les claims de l'ID token (tels que sub, name, email). auth.user.access_token est le token que vous envoyez à vos propres API sous la forme Authorization: Bearer <token>.
4. Traiter la redirection
react-oidc-context traite le callback automatiquement lorsque l'application se charge sur la redirect_uri, tant que l'AuthProvider enveloppe l'arbre de composants. Faites pointer votre redirect URI vers une route servie par votre application (par exemple /callback) et assurez-vous que cette route rend la même application enveloppée par le provider.
Dépannage
- La redirection boucle ou l'URL conserve le paramètre
code. Ajoutez le gestionnaireonSigninCallbackmontré ci-dessus, afin que les paramètres à usage unique soient effacés après traitement. redirect_urine correspond pas. Laredirect_uridoit correspondre exactement à une valeur enregistrée sur l'application, chemin compris. Enregistrez l'URL de callback qu'utilise votre SPA.- Les tokens disparaissent au rechargement. Par défaut, les tokens sont conservés en mémoire et sont perdus lors d'un rechargement complet. Configurez un magasin utilisateur (par exemple
WebStorageStateStoreaveclocalStorage) s'ils doivent persister, et pesez le compromis de sécurité que représente le stockage de tokens dans le navigateur. invalid_client. L'application doit être enregistrée comme client public (PKCE). Un client confidentiel attend un secret que le navigateur ne peut pas fournir.
Étapes suivantes
- Backend Node / Express si vous ajoutez un composant serveur.
- API pour protéger votre propre API avec l'access token.
Backend Python / Flask
Ajoutez la connexion à une application Python Flask à l'aide de la bibliothèque Authlib et du flux Authorization Code avec PKCE.
Client Financial-grade API (FAPI 2.0)
Adaptez un client au FAPI 2.0 Security Profile : private key JWT, pushed authorization requests et tokens sender-constrained via DPoP.