# Aplicación de página única en React

Añada el inicio de sesión a una aplicación React de navegador como cliente public, con react-oidc-context y el flujo Authorization Code con PKCE.

Esta guía añade el inicio de sesión OIDC a una aplicación React sin backend propio, con [`react-oidc-context`](https://www.npmjs.com/package/react-oidc-context) (construida sobre `oidc-client-ts`). Una aplicación de navegador es un cliente **public**: tiene un client ID pero ningún secreto, y se apoya en PKCE.

Registre primero la aplicación como cliente OIDC **public / de página única** y añada su redirect URI; consulte [Antes de empezar](https://dts-identity.com/es/docs/quickstarts.md#before-you-start). Para el protocolo subyacente, consulte [OpenID Connect (Authorization Code + PKCE)](https://dts-identity.com/es/docs/quickstarts/oidc-authorization-code.md).

## 1. Instalar

```bash
npm install react-oidc-context oidc-client-ts
```

## 2. Configurar el provider

Envuelva su aplicación en `AuthProvider`. La `authority` es el dominio de inicio de sesión de su instancia; la biblioteca descubre los endpoints y utiliza Authorization Code con PKCE de forma predeterminada.

```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>
);
```

No ponga ningún client secret en el código del navegador. Un cliente public no tiene ninguno.

## 3. Iniciar sesión y leer el usuario

Utilice el hook `useAuth` para lanzar el inicio de sesión y leer el resultado.

```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` contiene los claims del ID token (como `sub`, `name` o `email`). `auth.user.access_token` es el token que envía a sus propias APIs como `Authorization: Bearer <token>`.

## 4. Procesar la redirección

`react-oidc-context` procesa el callback automáticamente cuando la aplicación se carga en la `redirect_uri`, siempre que el `AuthProvider` envuelva el árbol de componentes. Apunte su redirect URI a una ruta que sirva su aplicación (por ejemplo, `/callback`) y asegúrese de que esa ruta renderiza la misma aplicación envuelta por el provider.

## Solución de problemas

- **La redirección entra en bucle o la URL conserva el parámetro `code`.** Añada el manejador `onSigninCallback` mostrado arriba para que los parámetros de un solo uso se limpien tras procesarlos.
- **La `redirect_uri` no coincide.** La `redirect_uri` debe coincidir exactamente con un valor registrado en la aplicación, incluida la ruta. Registre la URL de callback de la SPA que utilice.
- **Los tokens desaparecen al recargar.** De forma predeterminada, los tokens se guardan en memoria y se pierden en una recarga completa. Configure un almacén de usuario (por ejemplo, `WebStorageStateStore` con `localStorage`) si necesita que persistan, y sopese la contrapartida de seguridad de guardar tokens en el navegador.
- **`invalid_client`.** La aplicación debe estar registrada como cliente public (PKCE). Un cliente confidential espera un secreto que el navegador no puede aportar.

## Siguientes pasos

- [Backend Node / Express](https://dts-identity.com/es/docs/quickstarts/node-express.md), si añade un componente de servidor.
- [APIs](https://dts-identity.com/es/docs/integrations/apis.md), para proteger su propia API con el access token.
