アプリのテストと審査
新しいLinked billingアプリが、テスト段階を終えて顧客に公開されるまでの流れと、公開中のアプリを変更したときに何が起こるかについて説明します。
Linked billingでは、顧客が自分のClaude組織をあなたのOAuthアプリにリンクします。新しいLinked billingアプリはテスト段階から始まり、この段階では、あなたが指定した「test user」(テストユーザー)のみが自分の組織をアプリにリンクできます。アプリを顧客に公開するには、アプリを公開し、Anthropicによる審査を受けます。
組織が請求書払いを利用している場合、Anthropicはアプリを審査しません。請求書払いを参照してください。
アプリは、Anthropicが承認したとき、または請求書払いの組織が公開したときに公開状態になります。対象となる顧客であれば誰でも公開中のアプリに自分の組織をリンクでき、テストユーザーが作成したリンクは維持されます。Claude ConsoleのOAuthアプリページでは、公開中のアプリのステータスは Active と表示されます。
アプリが公開されるまで、Consoleにはアプリのステータスとして次のいずれかが表示されます。
| ステータス | 意味 |
|---|---|
| Testing | アプリをまだ公開していません。 |
| In review | Anthropicが、アプリ、または公開中にあなたが行った変更を審査しています。 |
| Not approved | Anthropicがアプリまたは変更を審査し、承認しませんでした。 |
変更後に審査に戻ったアプリは、Anthropicが変更を承認するまで再び公開状態にはなりません。Linked billingアプリはそれぞれ独自のステータスと独自のテストユーザーを持ちます。Linked billingガイドのステップ1:アプリを作成するにある注記を参照してください。
始める前に
Linked billingガイドのセットアッププロセスを完了してください。
テストユーザーを管理する
テストユーザーを追加する
- ConsoleのOAuthアプリページからアプリのページを開きます。
- Settings タブで、Who can link の下にある Test users リストに移動します。
- テストユーザーのClaudeアカウントのメールアドレスを入力し、Add をクリックします。テストユーザーごとに繰り返します。
- Save changes をクリックします。
保存すると、リストに登録されたユーザーは自分の組織をあなたのアプリにリンクできるようになります。アプリが公開されるまで、ユーザーがリンクを承認するClaudeの承認ページは、それ以外のユーザーを拒否します。その場合にアプリが受け取る内容については、Linked billingガイドのリダイレクトURIがerror=access_deniedを受け取るを参照してください。
アプリが公開されていない間、Who can link は Test users only のままとなり、変更できません。リストには最大10人のテストユーザーを登録できます。各アドレスはアカウントのアドレスと完全に一致する必要がありますが、大文字と小文字は区別されません。name+test@example.com のようなプラスタグ付きのアドレスは、name@example.com とは別のアドレスとして扱われます。
テストユーザーの組織をリンクする
テストユーザーは、あなたのアプリから自分の組織をリンクし、顧客が使用するのと同じページでリンクを承認します。テストユーザーは、その組織で管理者または請求のロールを持っている必要があります。手順はLinked billingガイドのステップ4から8です。同ガイドの顧客としてテストするでは、これらの手順を順に説明し、リンクが作成されたことを確認する方法も記載しています。
自分でアプリをテストするには、自分のメールアドレスをリストに追加してください。アプリを所有する組織はそのアプリにリンクできないため、自分が持つ2つ目のClaude組織を使用してください。
テストユーザーが自分の組織をリンクしたら、その組織に請求するリクエストを送信して、アプリを試してください。テストでは実際の料金が発生します。Anthropicは、他の顧客と同様に、各テストユーザーの組織に対して、あなたがその組織に請求するリクエストの料金を課金します。
アプリが公開されるまで、新しいリンクにはそれぞれ50米ドル以下の月間「spend cap」(支出上限)が必要です。上限のルールについては、ガイドのアプリのテスト中を参照してください。
テストユーザーを削除する
テストユーザーの削除は即座に反映されます。削除されたユーザーが承認した、あなたのアプリへの各リンクは終了します。リンクが終了すると、Claude APIはあなたがその組織に請求するリクエストを拒否します。想定されるエラーを参照してください。
- Settings タブに未保存の変更がある場合は、Save changes または Discard をクリックします。そうするまで、Consoleでは保存済みのテストユーザーを削除できません。
- Test users リストからテストユーザーのアドレスを削除します。
- Consoleが確認を求めたら、Remove をクリックして確定します。Save changes をクリックする必要はありません。
アプリを公開する
公開時には、DNSレコードを追加して、アプリのドメインを管理していることの証明が求められる場合があります。その後、Anthropicがアプリを審査します。DNSの変更には時間がかかるため、顧客にリンクしてもらう必要が生じる前に始めてください。
公開する前に、次の点を確認してください。
- クライアント認証がセットアップされていること。セットアップされるまで、アプリを公開することはできません。
- Appearance タブで設定したホームページがアプリにあること。
- ホームページのドメインのDNSレコードを変更できること。
- 各リダイレクトURIが、ホームページのドメインまたはそのサブドメインのいずれかにあること。
ホームページのドメインとして扱われるものと例外については、ドメインのルールを参照してください。
アプリを公開するには、次の手順に従います。
- Consoleのアプリのページで、Publish app をクリックします。ダイアログが開きます。
- ダイアログに Prove your domain と表示された場合は、ドメインのDNSを管理している場所で、ダイアログから提供されるDNS TXTレコードを追加します。表示されない場合は、ステップ5に進みます。
- Check をクリックします。ドメインに引き続き Not proven yet と表示される場合は、ドメインを証明できない場合を参照してください。
- ドメインに Proven と表示されたら、Continue をクリックします。
- ダイアログにLinked Billing Termsに同意するためのチェックボックスが表示された場合は、それを選択します。その後、ダイアログで Publish app をクリックして確定します。
Anthropicがアプリを審査している間、アプリのステータスは In review になります。結果については、審査を参照してください。
ドメインを証明できない場合
- ドメインに引き続きNot proven yetと表示される: DNSの変更が反映されるまで最大48時間かかる場合があります。ダイアログを閉じて、後で戻ってくることができます。アプリの公開手続きの途中だった場合は、再び Publish app をクリックします。公開中のアプリを変更していた場合は、同じ編集を再度行ってください。Consoleはレコードの有効期限が切れるまで同じレコードを提供します。
- Checkでレコードの有効期限が切れたと表示される: DNSレコードは、Consoleが最初に表示した時点から30日間有効です。その後は、Get a new record をクリックして新しいレコードを追加します。Proven と表示されたドメインは証明済みのままです。
- ダイアログにレコードの代わりにメッセージが表示される: たとえば、組織がすでに20個のドメイン名を持っていることを示すメッセージです。それが解決されるまで先に進むことはできません。サポートが必要な場合は、サポートに連絡してください。
ドメインのルール
ドメインとは先頭の www. を除いたホスト名であり、あなたのドメインとはホームページのドメインです。たとえば、https://www.example.com にあるホームページのドメインは example.com です。証明済みのドメインは、そのドメイン自体とそのサブドメインをカバーします。
- 共有ドメイン: ホスティングサービスの共有ドメインは条件を満たさないため、独自のドメインを使用してください。
- ローカルのリダイレクトURI:
localhost、127.0.0.1、または[::1]上のリダイレクトURIは、ホームページのドメイン上にある必要はありません。 - 兄弟サブドメイン: ホームページが
app.example.comにある場合、あなたのドメインはそのサブドメインであり、auth.example.com上のリダイレクトURIはカバーされません。両方を使用する方法の1つは、その両方をカバーするexample.comにホームページを置くことです。 - 組織がすでに証明しているドメイン: 組織は、たとえば別のアプリのために、以前にドメインを証明している場合があります。そのドメインがホームページとローカルではないすべてのリダイレクトURIをカバーしている場合、ダイアログは Prove your domain をスキップします。その場合、リダイレクトURIはホームページのドメイン上にある必要はありません。たとえば、
example.comが証明済みであれば、ホームページとリダイレクトURIをその異なるサブドメインに置くことができます。
審査
審査が終了すると、Consoleのアプリのページに結果が表示されます。
- Anthropicがアプリを承認した場合: アプリは公開状態となります。その後、あなたが操作しなくても Who can link には Any Claude user と表示され、Consoleは Test users リストを非表示にします。
- Anthropicがアプリを承認しない場合: アプリのステータスが Not approved に変わります。
審査中および Not approved の結果が出た後も、テストユーザーのリンクは維持され、テストユーザーの追加と削除は引き続き行えます。
アプリが承認されなかった場合
アプリを自分で再度公開することはできません。決定について問い合わせるには、サポートに連絡してください。引き続きアプリを変更することはできますが、変更によって新しい審査が始まることはありません。
公開中のアプリを変更する
公開中のアプリの名前、ロゴ、ホームページ、またはリダイレクトURIを変更すると、アプリは審査に戻ります。Anthropicが変更を承認するまで、自分の組織をアプリにリンクできるのはテストユーザーのみです。Anthropicが変更を承認するまでを参照してください。権限やクライアント認証などのその他の変更では、アプリは審査に戻りません。
名前、ホームページ、またはリダイレクトURIを変更するには、次の手順に従います。
- アプリの Appearance タブ(名前とホームページ)または Settings タブ(リダイレクトURI)でアプリを変更します。
- Save changes をクリックします。何かが保存される前にダイアログが開きます。
- ダイアログに Prove your domain と表示された場合は、ダイアログが示す各ドメインを証明します。
- ドメインのDNS TXTレコードを追加します。その後、Check をクリックします。ドメインに引き続き Not proven yet と表示される場合は、ドメインを証明できない場合を参照してください。
- ドメインに Proven と表示されたら、別のドメインが残っている場合は Next domain をクリックします。残っていない場合は Continue をクリックします。
- Save and send to review をクリックします。
その後、Consoleは変更を保存し、変更は審査を待たずに反映されます。Anthropicが変更を審査している間、アプリのステータスは In review になります。
ロゴを変更するには、Appearance タブでロゴを選択または削除します。ダイアログがすぐに開きます。Send to review をクリックします。キャンセルした場合、ロゴは変更されません。
アプリのステータスが In review または Not approved の間にアプリを再度変更するには、公開されていないアプリを変更するを参照してください。
Consoleがドメインの証明を求める場合
Consoleがドメインの証明を求めるのは、ホームページまたはリダイレクトURIを変更した場合のみです。Consoleは変更していないホームページとリダイレクトURIもチェックするため、ダイアログにはそれらのドメインも表示されることがあります。表示されるのは、組織の証明済みドメインのいずれにもカバーされていないドメインのみです。ローカルのリダイレクトURIはチェックしませんが、それらのいずれかを変更した場合でもアプリは審査に戻ります。
変更後は、組織がそれぞれのドメインを証明すれば、リダイレクトURIをホームページのドメイン以外のドメインに置くことができます。
Anthropicが変更を承認するまで
変更を審査に送った時点から、次のルールが適用されます。
- すでにリンクしている顧客: その組織はリンクされたままで、あなたがそれらの組織に請求するリクエストは引き続き機能します。リンクを解除した顧客は、リンクする人が Test users リストに登録されていない限り、再度リンクすることはできません。
- 新しいリンク: Who can link の設定は Test users only に戻ります。Consoleに Test users リストが、以前登録されていたユーザーとともに再び表示されます。
- テストユーザー: リストのユーザーを追加および削除できます。ユーザーを削除すると、アプリの公開中にそのユーザーが顧客の組織に対して作成したリンクも終了します。テストユーザーを削除するを参照してください。
- リンクされた組織の支出上限: リンクされた組織は、上限が50米ドルを超えている場合や上限がない場合でも、現在の支出上限の設定を維持します。組織が設定を変更する場合は、アプリのテスト中のルールに従う必要があります。
変更の審査が終了したとき
審査は次の2つのいずれかで終了します。
- Anthropicが変更を承認した場合: アプリは再び公開状態になります。対象となる顧客であれば誰でもリンクでき、Consoleは Test users リストを非表示にし、公開されていないアプリ向けの上限のルールは適用されなくなります。
- Anthropicが変更を承認しない場合: アプリのステータスが Not approved に変わります。変更は有効なままで、Anthropicが変更を承認するまでのルールが引き続き適用されます。アプリが承認されなかった場合を参照してください。
公開されていないアプリを変更する
アプリのステータスが Testing、In review、または Not approved の間は、次の手順に従います。
- アプリの Appearance タブ(名前、ロゴ、ホームページ)または Settings タブ(リダイレクトURI)でアプリを変更します。
- Save changes をクリックします。ロゴの変更は、ロゴを選択または削除した時点で保存されます。
確認を求めるダイアログは表示されず、変更によってアプリのステータスが変わることもありません。
ホームページまたはリダイレクトURIの変更を保存すると、Consoleはステータスが In review の間のみドメインをチェックします。テスト段階のアプリは、公開時にドメインのチェックを受けます。審査中は、変更後のアプリのホームページと、ローカルではないすべてのリダイレクトURIが、組織の証明済みドメイン上にある必要があります。そうでない場合、Consoleは変更を拒否し、ドメインの証明は求めません。証明されていないドメインに移行するには、審査が終了するまで待ってください。
請求書払い
請求書払いでは、Anthropicはアプリを所有する組織に対してAPIの使用量の請求書を発行し、その組織はプリペイドクレジットを購入しません。この場合でも、アプリはテスト段階から始まり、テストユーザーと支出上限のルールは引き続き適用されます。その後、次の3点が異なります。
- アプリを公開する: アプリのページで Publish app をクリックします。その後、ダイアログで Publish app をクリックして確定します。Anthropicはアプリを審査しないため、アプリは公開した時点で公開状態になります。
- ホームページとドメイン: ドメインを証明しないため、ダイアログは Prove your domain をスキップします。公開にホームページは不要で、アプリを公開するにあるリダイレクトURIのルールは適用されません。ただし、クライアント認証は事前にセットアップしておく必要があります。
- 公開中のアプリを変更する: Save changes をクリックしたとき、またはロゴを選択または削除したときに、Consoleは変更を保存します。ドメインの証明や確認は求められず、審査も行われません。
このページは役に立ちましたか?