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-ts2. 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 manejadoronSigninCallbackmostrado arriba para que los parámetros de un solo uso se limpien tras procesarlos. - La
redirect_urino coincide. Laredirect_uridebe 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,
WebStorageStateStoreconlocalStorage) 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, si añade un componente de servidor.
- APIs, para proteger su propia API con el access token.
Backend Python / Flask
Añada el inicio de sesión a una aplicación Flask de Python con la biblioteca Authlib y el flujo Authorization Code con PKCE.
Cliente Financial-grade API (FAPI 2.0)
Adapte un cliente al FAPI 2.0 Security Profile: private key JWT, pushed authorization requests y tokens sender-constrained con DPoP.