Skip to Content

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 (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. Para el protocolo subyacente, consulte OpenID Connect (Authorization Code + PKCE).

1. Instalar

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.

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

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

En esta página