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:
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.
- 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.
- 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.
- 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?