Claude Platform Docs
AmministrazioneClaude Platform OAuth

Claude Platform OAuth

Consenti ai tuoi clienti di pagare l’utilizzo di Claude nel tuo prodotto dalla propria organizzazione Claude.

Claude Platform OAuth consente ai tuoi utenti di addebitare alla propria organizzazione Claude l’utilizzo all’interno della tua app.

Cosa puoi creare

Consenti ai clienti di pagare il proprio utilizzo di Claude

Quando il tuo prodotto chiama Claude, l’utilizzo può essere addebitato all’organizzazione Claude dei tuoi clienti stessi. I tuoi utenti fanno clic su un pulsante Link your Claude organization, accedono a Claude e approvano la tua app. Per Linked billing, l’utente deve avere il ruolo Amministratore o Fatturazione nella propria organizzazione Claude.

Dopodiché:

  • Scegli per ogni richiesta all’API di Claude se paga il cliente o se paghi tu.
  • Se una richiesta che contrassegni come a carico del cliente non può essere addebitata a quest’ultimo, l’API di Claude la rifiuta anziché addebitarla a te.
  • Il cliente può scollegare la tua app in qualsiasi momento.
  • Puoi addebitare a un cliente solo le richieste che ti chiede di effettuare, mai il tuo utilizzo.

Sei tu a fornire supporto ai tuoi clienti: Anthropic mette a disposizione la pagina di approvazione e la pagina della Claude Console in cui impostano un tetto di spesa o scollegano la tua app, mentre tutte le altre domande sulla tua app vengono rivolte a te.

Linked billing funziona per i clienti la cui organizzazione Claude paga direttamente Anthropic per il proprio utilizzo dell’API. Non funziona per le organizzazioni fatturate tramite un marketplace cloud. Consulta Linked billing.

Come funziona

Linked billing segue un breve percorso di andata e ritorno. La persona lascia il tuo prodotto una sola volta per la pagina di approvazione di Claude, approva lì la tua app e torna indietro:

Browser
Il tuo back end
auth.claude.com
Fai clic su “Link your Claude organization”
Invia la persona alla pagina di approvazione di Claude
Accedi a Claude e approva la tua app
Rimanda la persona al tuo prodotto con un codice monouso
Consegna il codice
Scambia il codice
Un ID di connessione

La pagina di approvazione mostra il nome della tua app e ciò che la tua app sta richiedendo, così la persona sa cosa sta approvando.

Configurazione una tantum dell’app OAuth

Linked billing inizia con questi passaggi di configurazione una tantum nella Claude Console. La guida Linked billing ti accompagna in questi passaggi.

  1. Crea l’app. Un membro della tua organizzazione Claude con il ruolo Admin crea un’app OAuth nella Claude Console e ne copia il “client ID” (identificativo client). L’app contiene il nome che le persone vedono nella pagina di approvazione e l’indirizzo nel tuo prodotto a cui ritornano.
  2. Configura l’autenticazione del client. Invece di un “client secret” (segreto client), il tuo back end dimostra che una richiesta proviene dalla tua app con un token di breve durata emesso dal tuo “identity provider” (provider di identità), come AWS, Google Cloud, Microsoft Entra ID o Kubernetes. Seleziona l’identity provider, e quali dei suoi token accettare, nella scheda Client authentication dell’app.
  3. Configura l’identità del tuo back end. Crea un “service account” (account di servizio) e una seconda regola di federazione con Workload Identity Federation, e seleziona l’account di servizio come account di servizio operatore dell’app.

Passaggi successivi

La guida Linked billing ti accompagna nella configurazione e fino al tuo primo cliente collegato.

Consenti ai tuoi clienti di pagare l’utilizzo di Claude nel tuo prodotto dalla propria organizzazione Claude

Endpoint, parametri, risposte dei token, durate ed errori

Questa pagina ti è stata utile?