Skip to Content

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-ts

2. 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 gestionnaire onSigninCallback montré ci-dessus, afin que les paramètres à usage unique soient effacés après traitement.
  • redirect_uri ne correspond pas. La redirect_uri doit 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 WebStorageStateStore avec localStorage) 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

Sur cette page