Applicazione single-page React
Aggiungere l'accesso a un'app React nel browser come client public, utilizzando react-oidc-context e il flusso Authorization Code con PKCE.
Questa guida aggiunge l'accesso OIDC a un'app React priva di backend proprio, utilizzando react-oidc-context (costruito su oidc-client-ts). Un'applicazione browser è un client public: possiede un client ID ma nessun secret e si affida a PKCE.
Registrare prima l'applicazione come client OIDC public / single-page e aggiungere il proprio redirect URI; vedere Prima di iniziare. Per il protocollo sottostante, vedere OpenID Connect (Authorization Code + PKCE).
1. Installare
npm install react-oidc-context oidc-client-ts2. Configurare il provider
Racchiudere la propria app in AuthProvider. Il valore authority è il dominio di accesso della propria istanza; la libreria individua gli endpoint e utilizza Authorization Code con PKCE per impostazione predefinita.
// 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>
);Non inserire un client secret nel codice del browser. Un client public non ne ha.
3. Effettuare l'accesso e leggere l'utente
Utilizzare l'hook useAuth per avviare l'accesso e leggerne il risultato.
// 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 i claim dell'ID token (per esempio sub, name, email). auth.user.access_token è il token da inviare alle proprie API come Authorization: Bearer <token>.
4. Gestire il redirect
react-oidc-context elabora automaticamente il callback quando l'app viene caricata sul redirect_uri, purché AuthProvider racchiuda l'albero dei componenti. Far puntare il proprio redirect URI a una rotta servita dall'app (per esempio /callback) e assicurarsi che quella rotta renderizzi la stessa app racchiusa nel provider.
Risoluzione dei problemi
- Il redirect entra in ciclo oppure l'URL mantiene il parametro
code. Aggiungere il gestoreonSigninCallbackmostrato sopra, così che i parametri monouso vengano rimossi dopo l'elaborazione. redirect_urinon corrispondente. Ilredirect_urideve corrispondere esattamente a un valore registrato sull'applicazione, percorso compreso. Registrare l'URL di callback della SPA effettivamente utilizzato.- I token spariscono al refresh. Per impostazione predefinita i token vengono tenuti in memoria e si perdono a un ricaricamento completo. Se devono persistere, configurare un archivio utente (per esempio
WebStorageStateStoreconlocalStorage), valutando il compromesso di sicurezza che comporta conservare i token nel browser. invalid_client. L'applicazione deve essere registrata come client public (PKCE). Un client confidential si aspetta un secret che il browser non può fornire.
Passi successivi
- Backend Node / Express se si aggiunge una componente server.
- API per proteggere la propria API con l'access token.
Backend Python / Flask
Aggiungere l'accesso a un'app Python Flask utilizzando la libreria Authlib e il flusso Authorization Code con PKCE.
Client Financial-grade API (FAPI 2.0)
Adattare un client al FAPI 2.0 Security Profile: private key JWT, pushed authorization request e token sender-constrained con DPoP.