# 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`](https://www.npmjs.com/package/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](https://dts-identity.com/it/docs/quickstarts.md#before-you-start). Per il protocollo sottostante, vedere [OpenID Connect (Authorization Code + PKCE)](https://dts-identity.com/it/docs/quickstarts/oidc-authorization-code.md).

## 1. Installare

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

## 2. 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.

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

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.

```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 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 gestore `onSigninCallback` mostrato sopra, così che i parametri monouso vengano rimossi dopo l'elaborazione.
- **`redirect_uri` non corrispondente.** Il `redirect_uri` deve 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 `WebStorageStateStore` con `localStorage`), 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](https://dts-identity.com/it/docs/quickstarts/node-express.md) se si aggiunge una componente server.
- [API](https://dts-identity.com/it/docs/integrations/apis.md) per proteggere la propria API con l'access token.
