---
title: Test e revisione dell'app
url: https://platform.claude.com/docs/it/manage-claude/oauth-apps/app-review
description: Come una nuova app Linked billing esce dalla fase di test e si apre ai tuoi clienti, e cosa succede quando modifichi un'app attiva.
---

<Warning>
  Claude Platform OAuth è un Beta Service: software in anteprima fornito ai sensi del tuo accordo con Anthropic, come i [Termini di servizio commerciali](https://www.anthropic.com/legal/commercial-terms), e i [Termini specifici del servizio](https://www.anthropic.com/legal/service-specific-terms). Endpoint, parametri e comportamento possono cambiare durante la beta. Potrebbe non essere adatto all’uso in produzione.
</Warning>

Con [Linked billing](https://platform.claude.com/docs/it/manage-claude/oauth-apps/organization-billing-connections), un cliente collega la propria organizzazione Claude alla tua app OAuth. Una nuova app Linked billing inizia in fase di test, durante la quale solo i “test users” (utenti di test) che indichi possono collegarvi le proprie organizzazioni. Per aprire l’app ai tuoi clienti, la pubblichi e Anthropic la revisiona.

Se la tua organizzazione paga su fattura, Anthropic non revisiona la tua app. Consulta [Pagamento su fattura](https://platform.claude.com/docs/it/manage-claude/oauth-apps/app-review#invoiced-billing).

Un’app è attiva quando Anthropic l’ha approvata o quando l’hai pubblicata con il pagamento su fattura. Qualsiasi [cliente idoneo](https://platform.claude.com/docs/it/manage-claude/oauth-apps/organization-billing-connections#eligible-customers-and-endpoints) può collegare la propria organizzazione a un’app attiva e i collegamenti effettuati dai suoi utenti di test rimangono. Nella pagina delle app OAuth nella Claude Console, lo stato di un’app attiva è **Active**.

Finché l’app non è attiva, la Console mostra per essa uno di questi stati:

| Stato            | Cosa significa                                                                       |
| ---------------- | ------------------------------------------------------------------------------------ |
| **Testing**      | Non hai pubblicato l’app.                                                            |
| **In review**    | Anthropic sta revisionando l’app o una modifica che hai apportato mentre era attiva. |
| **Not approved** | Anthropic ha revisionato l’app o la modifica e non l’ha approvata.                   |

Un’app che torna in revisione dopo una modifica non è di nuovo attiva finché Anthropic non approva la modifica. Ogni app Linked billing ha il proprio stato e i propri utenti di test. Consulta la nota in [Passaggio 1: Crea l’app](https://platform.claude.com/docs/it/manage-claude/oauth-apps/organization-billing-connections#step-1-create-the-app) nella guida a Linked billing.

## Prima di iniziare

Completa il [Processo di configurazione](https://platform.claude.com/docs/it/manage-claude/oauth-apps/organization-billing-connections#setup-process) nella guida a Linked billing.

## Gestire gli utenti di test

### Aggiungere utenti di test

1. Apri la pagina dell’app dalla [pagina delle app OAuth](https://platform.claude.com/settings/oauth-apps) nella Console.
2. Nella scheda **Settings**, vai all’elenco **Test users** sotto **Who can link**.
3. Inserisci l’indirizzo email dell’account Claude di un utente di test e fai clic su **Add**. Ripeti per ciascun utente di test.
4. Fai clic su **Save changes**.

Dopo il salvataggio, le persone nell’elenco possono collegare le proprie organizzazioni alla tua app. Finché la tua app non è attiva, la pagina di approvazione di Claude, dove una persona approva il collegamento, respinge chiunque altro. Per sapere cosa riceve poi la tua app, consulta [Il tuo redirect URI riceve `error=access_denied`](https://platform.claude.com/docs/it/manage-claude/oauth-apps/organization-billing-connections#access-denied) nella guida a Linked billing.

**Who can link** rimane impostato su **Test users only** finché l’app non è attiva e non puoi modificarlo. L’elenco può contenere fino a 10 utenti di test. Ogni indirizzo deve corrispondere esattamente all’indirizzo dell’account, ma maiuscole e minuscole non contano. Un indirizzo con un tag plus, come `name+test@example.com`, è considerato un indirizzo diverso da `name@example.com`.

### Collegare l’organizzazione di un utente di test

Un utente di test collega la propria organizzazione dalla tua app e approva il collegamento nella pagina usata dai tuoi clienti. Deve avere il ruolo Amministratore o Fatturazione in quell’organizzazione. I passaggi sono i Passaggi da 4 a 8 della guida a Linked billing. [Esegui test come cliente](https://platform.claude.com/docs/it/manage-claude/oauth-apps/organization-billing-connections#test-as-a-customer) in quella guida ti accompagna attraverso di essi e indica come verificare che il collegamento sia stato effettuato.

Per testare l’app tu stesso, aggiungi il tuo indirizzo email all’elenco. L’organizzazione proprietaria dell’app non può collegarsi a essa, quindi usa una tua seconda organizzazione Claude.

Dopo che un utente di test ha collegato la propria organizzazione, [invia richieste che fatturi a essa](https://platform.claude.com/docs/it/manage-claude/oauth-apps/organization-billing-connections#step-3-update-calls-to-claude) per provare la tua app. La fase di test utilizza denaro reale. Anthropic addebita all’organizzazione di ciascun utente di test le richieste che le fatturi, come fa per qualsiasi cliente.

Finché la tua app non è attiva, ogni nuovo collegamento richiede uno “spend cap” (tetto di spesa) mensile di $50 USD o inferiore. Per le regole del tetto, consulta [Mentre la tua app è in fase di test](https://platform.claude.com/docs/it/manage-claude/oauth-apps/organization-billing-connections#while-your-app-is-in-testing) nella guida.

### Rimuovere un utente di test

La rimozione di un utente di test ha effetto immediato. Termina ogni collegamento alla tua app approvato da quella persona. Dopo la fine di un collegamento, la Claude API rifiuta le richieste che fatturi a quell’organizzazione. Consulta [Errori previsti](https://platform.claude.com/docs/it/manage-claude/oauth-apps/organization-billing-connections#expected-errors).

1. Se la scheda **Settings** ha modifiche non salvate, fai clic su **Save changes** o **Discard**. Finché non lo fai, la Console non ti consente di rimuovere un utente di test salvato.
2. Rimuovi l’indirizzo dell’utente di test dall’elenco **Test users**.
3. Quando la Console lo chiede, fai clic su **Remove** per confermare. Non è necessario fare clic su **Save changes**.

## Pubblicare l’app

La pubblicazione può chiederti di dimostrare di controllare il dominio della tua app, aggiungendo un record DNS. Anthropic quindi revisiona l’app. Una modifica DNS richiede tempo, quindi inizia prima di aver bisogno che i clienti si colleghino.

Prima di pubblicare, verifica quanto segue:

* L’autenticazione del client è configurata. Non puoi pubblicare l’app finché non lo è.
* La tua app ha una homepage, che imposti nella scheda **Appearance**.
* Puoi modificare i record DNS del dominio della homepage.
* Ogni “redirect URI” (URI di reindirizzamento) si trova sul dominio della homepage o su uno dei suoi sottodomini.

Per sapere cosa conta come dominio della homepage e per le eccezioni, consulta [Regole sui domini](https://platform.claude.com/docs/it/manage-claude/oauth-apps/app-review#domain-rules).

Segui questi passaggi per pubblicare l’app:

1. Nella pagina dell’app nella Console, fai clic su **Publish app**. Si apre una finestra di dialogo.
2. Se la finestra di dialogo mostra **Prove your domain**, aggiungi il record DNS TXT che ti fornisce nel punto in cui gestisci il DNS del tuo dominio. Altrimenti, vai al passaggio 5.
3. Fai clic su **Check**. Se il dominio mostra ancora **Not proven yet**, consulta [Se non riesci a dimostrare il dominio](https://platform.claude.com/docs/it/manage-claude/oauth-apps/app-review#if-you-cant-prove-the-domain).
4. Quando il dominio mostra **Proven**, fai clic su **Continue**.
5. Se la finestra di dialogo mostra una casella per accettare i Linked Billing Terms, selezionala. Quindi fai clic su **Publish app** nella finestra di dialogo per confermare.

Mentre Anthropic revisiona l’app, il suo stato è **In review**. Per i possibili esiti, consulta [La revisione](https://platform.claude.com/docs/it/manage-claude/oauth-apps/app-review#the-review).

### Se non riesci a dimostrare il dominio

* **Il dominio mostra ancora Not proven yet:** Una modifica DNS può richiedere fino a 48 ore per avere effetto. Puoi chiudere la finestra di dialogo e tornare più tardi. Se stavi pubblicando, fai di nuovo clic su **Publish app**. Se stavi modificando un’app attiva, apporta di nuovo la stessa modifica e la Console ti fornisce lo stesso record finché non scade.
* **Check indica che il record è scaduto:** Il record DNS funziona per 30 giorni dal momento in cui la Console lo mostra per la prima volta. Dopodiché, fai clic su **Get a new record** e aggiungi il nuovo record. Un dominio che mostra **Proven** rimane dimostrato.
* **La finestra di dialogo mostra un messaggio al posto di un record:** Ad esempio, il messaggio può indicare che la tua organizzazione ha già 20 nomi di dominio. Non puoi proseguire finché il problema non viene risolto. Se hai bisogno di aiuto, [contatta l’assistenza](https://support.claude.com/en/articles/9015913-how-to-get-support).

### Regole sui domini

Un dominio è un hostname senza un `www.` iniziale e il tuo dominio è quello della tua homepage. Ad esempio, il dominio di una homepage su `https://www.example.com` è `example.com`. Un dominio dimostrato copre sé stesso e i propri sottodomini.

* **Domini condivisi:** Il dominio condiviso di un servizio di hosting non è valido, quindi usa un dominio tuo.
* **Redirect URI locali:** I redirect URI su `localhost`, `127.0.0.1` o `[::1]` non devono necessariamente trovarsi sul dominio della homepage.
* **Sottodomini fratelli:** Se la tua homepage è su `app.example.com`, il tuo dominio è quel sottodominio e non copre un redirect URI su `auth.example.com`. Un modo per usarli entrambi è mettere la tua homepage su `example.com`, che li copre.
* **Un dominio di cui la tua organizzazione ha già dimostrato la proprietà:** La tua organizzazione potrebbe aver dimostrato la proprietà di un dominio in precedenza, ad esempio per un’altra app. Se quel dominio copre la tua homepage e ogni redirect URI non locale, la finestra di dialogo salta **Prove your domain**. I redirect URI non devono quindi necessariamente trovarsi sul dominio della homepage. Ad esempio, con `example.com` dimostrato, la homepage e un redirect URI possono trovarsi su sottodomini diversi di esso.

## La revisione

Al termine della revisione, la pagina dell’app nella Console mostra il risultato:

* **Anthropic approva l’app:** L’app è attiva. **Who can link** mostra quindi **Any Claude user** senza alcun intervento da parte tua e la Console nasconde l’elenco **Test users**.
* **Anthropic non approva l’app:** Lo stato dell’app cambia in **Not approved**.

Durante la revisione e dopo un esito **Not approved**, i tuoi utenti di test mantengono i propri collegamenti e puoi comunque aggiungere e rimuovere utenti di test.

### Se l’app non viene approvata

Non puoi pubblicare di nuovo l’app da solo. Per chiedere informazioni sulla decisione, [contatta l’assistenza](https://support.claude.com/en/articles/9015913-how-to-get-support). Puoi comunque [modificare l’app](https://platform.claude.com/docs/it/manage-claude/oauth-apps/app-review#change-an-app-that-isnt-live), ma una modifica non avvia una nuova revisione.

## Modificare un’app attiva

Una modifica al nome, al logo, alla homepage o ai redirect URI di un’app attiva rimanda l’app in revisione. Finché Anthropic non approva la modifica, solo i tuoi utenti di test possono collegare le proprie organizzazioni all’app. Consulta [Finché Anthropic non approva la modifica](https://platform.claude.com/docs/it/manage-claude/oauth-apps/app-review#until-anthropic-approves-the-change). Altre modifiche, come le autorizzazioni o l’autenticazione del client, non rimandano l’app in revisione.

Segui questi passaggi per modificare il nome, la homepage o i redirect URI:

1. Modifica l’app nella scheda **Appearance** (nome e homepage) o nella scheda **Settings** (redirect URI).

2. Fai clic su **Save changes**. Si apre una finestra di dialogo prima che venga salvato qualcosa.

3. Se la finestra di dialogo mostra **Prove your domain**, dimostra la proprietà di ciascun dominio che indica:

   1. Aggiungi il record DNS TXT per il dominio. Quindi fai clic su **Check**. Se il dominio mostra ancora **Not proven yet**, consulta [Se non riesci a dimostrare il dominio](https://platform.claude.com/docs/it/manage-claude/oauth-apps/app-review#if-you-cant-prove-the-domain).
   2. Quando il dominio mostra **Proven**, fai clic su **Next domain** se rimane un altro dominio. Altrimenti, fai clic su **Continue**.

4. Fai clic su **Save and send to review**.

La Console salva quindi la modifica, che ha effetto senza attendere la revisione. Mentre Anthropic revisiona la modifica, lo stato dell’app è **In review**.

Per modificare il logo, sceglilo o rimuovilo nella scheda **Appearance**. La finestra di dialogo si apre immediatamente. Fai clic su **Send to review**. Se annulli, il logo non cambia.

Per modificare di nuovo l’app mentre il suo stato è **In review** o **Not approved**, consulta [Modificare un’app non attiva](https://platform.claude.com/docs/it/manage-claude/oauth-apps/app-review#change-an-app-that-isnt-live).

### Quando la Console ti chiede di dimostrare un dominio

La Console lo chiede solo se hai modificato la homepage o un redirect URI. Controlla anche la homepage e i redirect URI che non hai modificato, quindi la finestra di dialogo può indicare anche i loro domini. Indica solo i domini non coperti da alcun dominio dimostrato della tua organizzazione. Non controlla i redirect URI locali, ma una modifica a uno di essi rimanda comunque l’app in revisione.

Dopo una modifica, i redirect URI possono trovarsi su domini diversi da quello della homepage, se la tua organizzazione dimostra la proprietà di ciascuno.

### Finché Anthropic non approva la modifica

Queste regole si applicano dal momento in cui invii la modifica in revisione:

* **Clienti che hanno già effettuato il collegamento:** Le loro organizzazioni rimangono collegate e le richieste che fatturi loro continuano a funzionare. Un cliente che si scollega non può ricollegarsi, a meno che la persona che effettua il collegamento non sia nell’elenco **Test users**.
* **Nuovi collegamenti:** L’impostazione **Who can link** torna a **Test users only**. La Console mostra di nuovo l’elenco **Test users**, con le persone che vi erano prima.
* **Utenti di test:** Puoi aggiungere e rimuovere persone dall’elenco. Rimuovere una persona termina anche un collegamento che ha effettuato all’organizzazione di un cliente mentre l’app era attiva. Consulta [Rimuovere un utente di test](https://platform.claude.com/docs/it/manage-claude/oauth-apps/app-review#remove-a-test-user).
* **Tetti di spesa delle organizzazioni collegate:** Un’organizzazione collegata mantiene la sua attuale impostazione del [tetto di spesa](https://platform.claude.com/docs/it/manage-claude/oauth-apps/organization-billing-connections#spend-caps) anche se il suo tetto è superiore a $50 USD o non ha alcun tetto. Un’impostazione che modifica deve seguire le regole in [Mentre la tua app è in fase di test](https://platform.claude.com/docs/it/manage-claude/oauth-apps/organization-billing-connections#while-your-app-is-in-testing).

### Al termine della revisione della modifica

La revisione termina in uno di due modi:

* **Anthropic approva la modifica:** L’app è di nuovo attiva. Qualsiasi cliente idoneo può collegarsi, la Console nasconde l’elenco **Test users** e le regole sul tetto per un’app non attiva non si applicano più.
* **Anthropic non approva la modifica:** Lo stato dell’app cambia in **Not approved**. La modifica rimane in vigore e le regole in [Finché Anthropic non approva la modifica](https://platform.claude.com/docs/it/manage-claude/oauth-apps/app-review#until-anthropic-approves-the-change) si applicano ancora. Consulta [Se l’app non viene approvata](https://platform.claude.com/docs/it/manage-claude/oauth-apps/app-review#if-the-app-isnt-approved).

## Modificare un’app non attiva

Segui questi passaggi mentre lo stato dell’app è **Testing**, **In review** o **Not approved**:

1. Modifica l’app nella scheda **Appearance** (nome, logo e homepage) o nella scheda **Settings** (redirect URI).
2. Fai clic su **Save changes**. Una modifica al logo viene salvata quando scegli o rimuovi il logo.

Nessuna finestra di dialogo ti chiede di confermare e la modifica non altera lo stato dell’app.

Quando salvi una modifica alla homepage o a un redirect URI, la Console controlla i domini solo mentre lo stato è **In review**. Un’app in fase di test è sottoposta al controllo sul dominio quando la pubblichi. Durante una revisione, la homepage dell’app modificata e ogni redirect URI non locale devono trovarsi su domini dimostrati della tua organizzazione. In caso contrario, la Console rifiuta la modifica e non ti chiede di dimostrare un dominio. Per passare a un dominio non dimostrato, attendi il termine della revisione.

## Pagamento su fattura

Con il pagamento su fattura, Anthropic emette fattura all’organizzazione proprietaria della tua app per il suo utilizzo dell’API e quell’organizzazione non acquista crediti prepagati. La tua app inizia comunque in fase di test e le regole per gli utenti di test e per il tetto di spesa si applicano comunque. Dopodiché, tre aspetti sono diversi:

* **[Pubblicare l’app](https://platform.claude.com/docs/it/manage-claude/oauth-apps/app-review#publish-the-app):** Nella pagina dell’app, fai clic su **Publish app**. Quindi fai clic su **Publish app** nella finestra di dialogo per confermare. Anthropic non revisiona l’app, quindi è attiva non appena la pubblichi.
* **Homepage e dominio:** Non dimostri alcun dominio, quindi la finestra di dialogo salta **Prove your domain**. La tua app non ha bisogno di una homepage per essere pubblicata e la regola sui redirect URI in [Pubblicare l’app](https://platform.claude.com/docs/it/manage-claude/oauth-apps/app-review#publish-the-app) non si applica. L’autenticazione del client deve comunque essere configurata prima.
* **[Modificare un’app attiva](https://platform.claude.com/docs/it/manage-claude/oauth-apps/app-review#change-a-live-app):** La Console salva una modifica quando fai clic su **Save changes** o quando scegli o rimuovi un logo. Non ti chiede di dimostrare un dominio né di confermare e non segue alcuna revisione.
