App-Tests und Überprüfung
Wie eine neue Linked billing-App den Testbetrieb verlässt und sich für deine Kunden öffnet und was passiert, wenn du eine Live-App änderst.
Mit Linked billing verknüpft ein Kunde seine Claude-Organisation mit deiner OAuth-App. Eine neue Linked billing-App startet im Testbetrieb, in dem nur die von dir benannten „test users“ (Testbenutzer) ihre Organisationen mit ihr verknüpfen können. Um die App für deine Kunden zu öffnen, veröffentlichst du sie, und Anthropic überprüft sie.
Wenn deine Organisation per Rechnung abgerechnet wird, überprüft Anthropic deine App nicht. Siehe Abrechnung per Rechnung.
Eine App ist live, wenn Anthropic sie genehmigt hat oder wenn du sie mit Abrechnung per Rechnung veröffentlicht hast. Jeder berechtigte Kunde kann seine Organisation mit einer Live-App verknüpfen, und die Verknüpfungen, die ihre Testbenutzer hergestellt haben, bleiben bestehen. Auf der Seite „OAuth apps“ in der Claude Console lautet der Status einer Live-App Active.
Bis die App live ist, zeigt die Console einen dieser Status für sie an:
| Status | Bedeutung |
|---|---|
| Testing | Du hast die App nicht veröffentlicht. |
| In review | Anthropic überprüft die App oder eine Änderung, die du vorgenommen hast, während sie live war. |
| Not approved | Anthropic hat die App oder die Änderung überprüft und nicht genehmigt. |
Eine App, die nach einer Änderung zurück in die Überprüfung geht, ist erst wieder live, wenn Anthropic die Änderung genehmigt. Jede Linked billing-App hat ihren eigenen Status und ihre eigenen Testbenutzer. Siehe den Hinweis in Schritt 1: Die App erstellen im Linked billing-Leitfaden.
Bevor du beginnst
Schließe den Einrichtungsprozess im Linked billing-Leitfaden ab.
Testbenutzer verwalten
Testbenutzer hinzufügen
- Öffne die Seite der App über die Seite „OAuth apps“ in der Console.
- Gehe auf dem Tab Settings zur Liste Test users unter Who can link.
- Gib die E-Mail-Adresse des Claude-Kontos eines Testbenutzers ein und klicke auf Add. Wiederhole dies für jeden Testbenutzer.
- Klicke auf Save changes.
Nachdem du gespeichert hast, können die Personen auf der Liste ihre Organisationen mit deiner App verknüpfen. Bis deine App live ist, weist die Claude-Genehmigungsseite, auf der eine Person die Verknüpfung genehmigt, alle anderen ab. Was deine App dann erhält, erfährst du unter Deine Redirect-URI erhält error=access_denied im Linked billing-Leitfaden.
Who can link bleibt auf Test users only, solange die App nicht live ist, und du kannst das nicht ändern. Die Liste umfasst bis zu 10 Testbenutzer. Jede Adresse muss exakt mit der Adresse des Kontos übereinstimmen, Groß- und Kleinschreibung spielt jedoch keine Rolle. Eine Adresse mit einem Plus-Tag, etwa name+test@example.com, zählt als eine andere Adresse als name@example.com.
Die Organisation eines Testbenutzers verknüpfen
Ein Testbenutzer verknüpft seine Organisation über deine App und genehmigt die Verknüpfung auf der Seite, die auch deine Kunden verwenden. Er benötigt die Rolle Admin oder Billing in dieser Organisation. Es handelt sich um die Schritte 4 bis 8 des Linked billing-Leitfadens. Als Kunde testen in diesem Leitfaden führt dich durch sie und beschreibt, wie du prüfst, ob die Verknüpfung hergestellt wurde.
Um die App selbst zu testen, füge deine eigene E-Mail-Adresse zur Liste hinzu. Die Organisation, der die App gehört, kann sich nicht mit ihr verknüpfen, verwende also eine zweite Claude-Organisation von dir.
Nachdem ein Testbenutzer seine Organisation verknüpft hat, sende Anfragen, die du ihr in Rechnung stellst, um deine App auszuprobieren. Der Testbetrieb verwendet echtes Geld. Anthropic stellt der Organisation jedes Testbenutzers die Anfragen in Rechnung, die du ihr berechnest, so wie bei jedem Kunden.
Bis deine App live ist, benötigt jede neue Verknüpfung eine monatliche „spend cap“ (Ausgabenobergrenze) von höchstens 50 $ (USD). Die Regeln für die Obergrenze findest du unter Solange sich deine App im Test befindet im Leitfaden.
Einen Testbenutzer entfernen
Das Entfernen eines Testbenutzers wird sofort wirksam. Es beendet jede Verknüpfung mit deiner App, die die Person genehmigt hat. Nachdem eine Verknüpfung beendet ist, lehnt die Claude API die Anfragen ab, die du dieser Organisation in Rechnung stellst. Siehe Erwartete Fehler.
- Wenn der Tab Settings ungespeicherte Änderungen enthält, klicke auf Save changes oder Discard. Bis du das tust, lässt dich die Console keinen gespeicherten Testbenutzer entfernen.
- Entferne die Adresse des Testbenutzers aus der Liste Test users.
- Wenn die Console nachfragt, klicke zur Bestätigung auf Remove. Du musst nicht auf Save changes klicken.
Die App veröffentlichen
Beim Veröffentlichen wirst du möglicherweise aufgefordert nachzuweisen, dass du die Domain deiner App kontrollierst, indem du einen DNS-Eintrag hinzufügst. Anthropic überprüft die App dann. Eine DNS-Änderung braucht Zeit, beginne also, bevor Kunden sich verknüpfen sollen.
Prüfe vor dem Veröffentlichen Folgendes:
- Die Client-Authentifizierung ist eingerichtet. Solange das nicht der Fall ist, kannst du die App nicht veröffentlichen.
- Deine App hat eine Homepage, die du auf dem Tab Appearance festlegst.
- Du kannst die DNS-Einträge der Domain der Homepage ändern.
- Jede Redirect-URI befindet sich auf der Domain der Homepage oder einer ihrer Subdomains.
Was als Domain der Homepage zählt und welche Ausnahmen gelten, erfährst du unter Domain-Regeln.
Befolge diese Schritte, um die App zu veröffentlichen:
- Klicke auf der Seite der App in der Console auf Publish app. Ein Dialog öffnet sich.
- Wenn der Dialog Prove your domain anzeigt, füge den DNS-TXT-Eintrag, den er dir gibt, dort hinzu, wo du das DNS für deine Domain verwaltest. Andernfalls fahre mit Schritt 5 fort.
- Klicke auf Check. Wenn die Domain weiterhin Not proven yet anzeigt, siehe Wenn du die Domain nicht nachweisen kannst.
- Wenn die Domain Proven anzeigt, klicke auf Continue.
- Wenn der Dialog ein Kästchen zum Akzeptieren der Linked Billing Terms anzeigt, aktiviere es. Klicke dann im Dialog zur Bestätigung auf Publish app.
Während Anthropic die App überprüft, lautet ihr Status In review. Zu den Ergebnissen siehe Die Überprüfung.
Wenn du die Domain nicht nachweisen kannst
- Die Domain zeigt weiterhin Not proven yet an: Es kann bis zu 48 Stunden dauern, bis eine DNS-Änderung wirksam wird. Du kannst den Dialog schließen und später zurückkehren. Wenn du dabei warst, die App zu veröffentlichen, klicke erneut auf Publish app. Wenn du dabei warst, eine Live-App zu ändern, nimm dieselbe Änderung erneut vor, und die Console gibt dir denselben Eintrag, bis er abläuft.
- Check meldet, dass der Eintrag abgelaufen ist: Der DNS-Eintrag funktioniert 30 Tage ab dem Zeitpunkt, an dem die Console ihn zum ersten Mal anzeigt. Klicke danach auf Get a new record und füge den neuen Eintrag hinzu. Eine Domain, die Proven anzeigt, bleibt nachgewiesen.
- Der Dialog zeigt anstelle eines Eintrags eine Meldung an: Die Meldung kann zum Beispiel besagen, dass deine Organisation bereits 20 Domainnamen hat. Du kannst erst fortfahren, wenn das behoben ist. Wenn du Hilfe brauchst, kontaktiere den Support.
Domain-Regeln
Eine Domain ist ein Hostname ohne ein vorangestelltes www., und deine Domain ist die deiner Homepage. Die Domain einer Homepage unter https://www.example.com ist beispielsweise example.com. Eine nachgewiesene Domain deckt sich selbst und ihre Subdomains ab.
- Gemeinsam genutzte Domains: Die gemeinsam genutzte Domain eines Hosting-Dienstes ist nicht zulässig, verwende also eine eigene Domain.
- Lokale Redirect-URIs: Redirect-URIs auf
localhost,127.0.0.1oder[::1]müssen sich nicht auf der Domain der Homepage befinden. - Benachbarte Subdomains: Wenn deine Homepage auf
app.example.comliegt, ist deine Domain diese Subdomain, und sie deckt keine Redirect-URI aufauth.example.comab. Eine Möglichkeit, beide zu verwenden, besteht darin, deine Homepage aufexample.comzu legen, was beide abdeckt. - Eine Domain, die deine Organisation bereits nachgewiesen hat: Deine Organisation hat möglicherweise schon früher eine Domain nachgewiesen, zum Beispiel für eine andere App. Wenn sie deine Homepage und jede nicht lokale Redirect-URI abdeckt, überspringt der Dialog Prove your domain. Die Redirect-URIs müssen sich dann nicht auf der Domain der Homepage befinden. Wenn beispielsweise
example.comnachgewiesen ist, können sich die Homepage und eine Redirect-URI auf verschiedenen Subdomains davon befinden.
Die Überprüfung
Wenn die Überprüfung abgeschlossen ist, zeigt die Seite der App in der Console das Ergebnis an:
- Anthropic genehmigt die App: Die App ist live. Who can link zeigt dann Any Claude user an, ohne dass du etwas tun musst, und die Console blendet die Liste Test users aus.
- Anthropic genehmigt die App nicht: Der Status der App ändert sich zu Not approved.
Während der Überprüfung und nach einem Ergebnis Not approved behalten deine Testbenutzer ihre Verknüpfungen, und du kannst weiterhin Testbenutzer hinzufügen und entfernen.
Wenn die App nicht genehmigt wird
Du kannst die App nicht selbst erneut veröffentlichen. Um Fragen zur Entscheidung zu stellen, kontaktiere den Support. Du kannst die App weiterhin ändern, aber eine Änderung startet keine neue Überprüfung.
Eine Live-App ändern
Eine Änderung am Namen, Logo, an der Homepage oder an den Redirect-URIs einer Live-App schickt die App zurück in die Überprüfung. Bis Anthropic die Änderung genehmigt, können nur deine Testbenutzer ihre Organisationen mit der App verknüpfen. Siehe Bis Anthropic die Änderung genehmigt. Andere Änderungen, etwa an Berechtigungen oder der Client-Authentifizierung, schicken die App nicht zurück in die Überprüfung.
Befolge diese Schritte, um den Namen, die Homepage oder die Redirect-URIs zu ändern:
- Ändere die App auf ihrem Tab Appearance (Name und Homepage) oder ihrem Tab Settings (Redirect-URIs).
- Klicke auf Save changes. Ein Dialog öffnet sich, bevor etwas gespeichert wird.
- Wenn der Dialog Prove your domain anzeigt, weise jede Domain nach, die er nennt:
- Füge den DNS-TXT-Eintrag für die Domain hinzu. Klicke dann auf Check. Wenn die Domain weiterhin Not proven yet anzeigt, siehe Wenn du die Domain nicht nachweisen kannst.
- Wenn die Domain Proven anzeigt, klicke auf Next domain, falls noch eine weitere Domain übrig ist. Andernfalls klicke auf Continue.
- Klicke auf Save and send to review.
Die Console speichert dann die Änderung, und die Änderung wird wirksam, ohne auf die Überprüfung zu warten. Während Anthropic die Änderung überprüft, lautet der Status der App In review.
Um das Logo zu ändern, wähle es auf dem Tab Appearance aus oder entferne es. Der Dialog öffnet sich sofort. Klicke auf Send to review. Wenn du abbrichst, ändert sich das Logo nicht.
Um die App erneut zu ändern, solange ihr Status In review oder Not approved ist, siehe Eine App ändern, die nicht live ist.
Wenn die Console dich auffordert, eine Domain nachzuweisen
Die Console fragt nur, wenn du die Homepage oder eine Redirect-URI geändert hast. Sie prüft auch die Homepage und die Redirect-URIs, die du nicht geändert hast, sodass der Dialog auch deren Domains nennen kann. Er nennt nur Domains, die keine nachgewiesene Domain deiner Organisation abdeckt. Lokale Redirect-URIs prüft sie nicht, aber eine Änderung an einer davon schickt die App trotzdem zurück in die Überprüfung.
Nach einer Änderung können sich die Redirect-URIs auf anderen Domains als der der Homepage befinden, sofern deine Organisation jede davon nachweist.
Bis Anthropic die Änderung genehmigt
Diese Regeln gelten ab dem Zeitpunkt, an dem du die Änderung zur Überprüfung schickst:
- Kunden, die bereits verknüpft haben: Ihre Organisationen bleiben verknüpft, und die Anfragen, die du ihnen in Rechnung stellst, funktionieren weiterhin. Ein Kunde, der die Verknüpfung aufhebt, kann nicht erneut verknüpfen, es sei denn, die Person, die verknüpft, steht auf der Liste Test users.
- Neue Verknüpfungen: Die Einstellung Who can link wechselt zurück zu Test users only. Die Console zeigt die Liste Test users wieder an, mit den Personen, die zuvor darauf standen.
- Testbenutzer: Du kannst Personen auf der Liste hinzufügen und entfernen. Wenn du eine Person entfernst, wird auch eine Verknüpfung beendet, die sie mit der Organisation eines Kunden hergestellt hat, während die App live war. Siehe Einen Testbenutzer entfernen.
- Ausgabenobergrenzen verknüpfter Organisationen: Eine verknüpfte Organisation behält ihre aktuelle Einstellung der Ausgabenobergrenze, auch wenn ihre Obergrenze über 50 $ (USD) liegt oder sie keine Obergrenze hat. Eine Einstellung, die sie ändert, muss den Regeln unter Solange sich deine App im Test befindet folgen.
Wenn die Überprüfung der Änderung abgeschlossen ist
Die Überprüfung endet auf eine von zwei Arten:
- Anthropic genehmigt die Änderung: Die App ist wieder live. Jeder berechtigte Kunde kann verknüpfen, die Console blendet die Liste Test users aus, und die Obergrenzenregeln für eine App, die nicht live ist, gelten nicht mehr.
- Anthropic genehmigt die Änderung nicht: Der Status der App ändert sich zu Not approved. Die Änderung bleibt wirksam, und die Regeln unter Bis Anthropic die Änderung genehmigt gelten weiterhin. Siehe Wenn die App nicht genehmigt wird.
Eine App ändern, die nicht live ist
Befolge diese Schritte, solange der Status der App Testing, In review oder Not approved ist:
- Ändere die App auf ihrem Tab Appearance (Name, Logo und Homepage) oder ihrem Tab Settings (Redirect-URIs).
- Klicke auf Save changes. Eine Logo-Änderung wird gespeichert, wenn du das Logo auswählst oder entfernst.
Kein Dialog fordert dich zur Bestätigung auf, und die Änderung verändert den Status der App nicht.
Wenn du eine Änderung an der Homepage oder einer Redirect-URI speicherst, prüft die Console Domains nur, solange der Status In review ist. Eine App im Testbetrieb durchläuft die Domain-Prüfung beim Veröffentlichen. Während einer Überprüfung müssen sich die Homepage der geänderten App und jede nicht lokale Redirect-URI auf nachgewiesenen Domains deiner Organisation befinden. Andernfalls lehnt die Console die Änderung ab und fordert dich nicht auf, eine Domain nachzuweisen. Um zu einer nicht nachgewiesenen Domain zu wechseln, warte, bis die Überprüfung abgeschlossen ist.
Abrechnung per Rechnung
Bei der Abrechnung per Rechnung stellt Anthropic der Organisation, der deine App gehört, ihre API-Nutzung in Rechnung, und diese Organisation kauft keine Prepaid-Guthaben. Deine App startet trotzdem im Testbetrieb, und die Regeln für Testbenutzer und die Ausgabenobergrenze gelten weiterhin. Danach unterscheiden sich drei Dinge:
- Die App veröffentlichen: Klicke auf der Seite der App auf Publish app. Klicke dann im Dialog zur Bestätigung auf Publish app. Anthropic überprüft die App nicht, daher ist sie live, sobald du sie veröffentlichst.
- Homepage und Domain: Du weist keine Domain nach, daher überspringt der Dialog Prove your domain. Deine App benötigt zum Veröffentlichen keine Homepage, und die Regel für Redirect-URIs unter Die App veröffentlichen gilt nicht. Die Client-Authentifizierung muss trotzdem zuerst eingerichtet sein.
- Eine Live-App ändern: Die Console speichert eine Änderung, wenn du auf Save changes klickst oder wenn du ein Logo auswählst oder entfernst. Sie fordert dich weder auf, eine Domain nachzuweisen, noch zu bestätigen, und es folgt keine Überprüfung.
War diese Seite hilfreich?