# 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`](https://www.npmjs.com/package/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](https://dts-identity.com/fr/docs/quickstarts.md#before-you-start). Pour le protocole sous-jacent, voir [OpenID Connect (Authorization Code + PKCE)](https://dts-identity.com/fr/docs/quickstarts/oidc-authorization-code.md).

## 1. Installer

```bash
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.

```jsx
// 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.

```jsx
// 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

- [Backend Node / Express](https://dts-identity.com/fr/docs/quickstarts/node-express.md) si vous ajoutez un composant serveur.
- [API](https://dts-identity.com/fr/docs/integrations/apis.md) pour protéger votre propre API avec l'access token.
