Claude Platform Docs
管理Claude Platform OAuth

應用程式測試與審查

新的 Linked billing 應用程式如何結束測試階段並開放給您的客戶,以及當您變更已上線的應用程式時會發生什麼事。

透過 Linked billing,客戶會將其 Claude 組織連結到您的 OAuth 應用程式。新的 Linked billing 應用程式會從測試階段開始,此時只有您指定的「test users」(測試使用者)可以將其組織連結到該應用程式。若要將應用程式開放給您的客戶,您需要發布它,並由 Anthropic 進行審查。

如果您的組織採用發票計費,Anthropic 不會審查您的應用程式。請參閱發票計費。

當 Anthropic 核准應用程式,或您在採用發票計費的情況下發布應用程式時,應用程式即正式上線。任何符合資格的客戶都可以將其組織連結到已上線的應用程式,且其測試使用者所建立的連結會保留。在 Claude Console 的 OAuth 應用程式頁面上,已上線應用程式的狀態會顯示為 Active。

在應用程式上線之前,Console 會為其顯示以下其中一種狀態:

狀態意義
Testing您尚未發布應用程式。
In reviewAnthropic 正在審查應用程式,或審查您在應用程式上線期間所做的變更。
Not approvedAnthropic 已審查應用程式或變更,但未核准。

變更後重新進入審查的應用程式,在 Anthropic 核准該變更之前不會再次上線。每個 Linked billing 應用程式都有自己的狀態和自己的測試使用者。請參閱 Linked billing 指南中步驟 1:建立應用程式的附註。

開始之前

完成 Linked billing 指南中的設定流程。

管理測試使用者

新增測試使用者

  1. 從 Console 的 OAuth 應用程式頁面開啟應用程式的頁面。
  2. 在 Settings 分頁上,前往 Who can link 下方的 Test users 清單。
  3. 輸入測試使用者 Claude 帳戶的電子郵件地址,然後按一下 Add。針對每位測試使用者重複此步驟。
  4. 按一下 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。該指南中的以客戶身分進行測試會引導您完成這些步驟,並說明如何確認連結已建立。

若要親自測試應用程式,請將您自己的電子郵件地址新增到清單中。擁有該應用程式的組織無法連結到它,因此請使用您自己的第二個 Claude 組織。

測試使用者連結其組織後,請傳送您計費給該組織的請求來試用您的應用程式。測試使用的是真實金額。Anthropic 會就您計費給每位測試使用者組織的請求向該組織收費,就如同對任何客戶一樣。

在您的應用程式上線之前,每個新連結都需要 50 美元以下的每月「spend cap」(支出上限)。關於上限的規則,請參閱指南中的當您的應用程式處於測試階段時。

移除測試使用者

移除測試使用者會立即生效。它會終止被移除者所核准的每個與您應用程式的連結。連結終止後,Claude API 會拒絕您計費給該組織的請求。請參閱預期的錯誤。

  1. 如果 Settings 分頁有未儲存的變更,請按一下 Save changes 或 Discard。在您這麼做之前,Console 不允許您移除已儲存的測試使用者。
  2. 從 Test users 清單中移除該測試使用者的地址。
  3. 當 Console 要求時,按一下 Remove 以確認。您不需要按 Save changes。

發布應用程式

發布時可能會要求您透過新增 DNS 記錄來證明您控制應用程式的網域。接著 Anthropic 會審查應用程式。DNS 變更需要時間,因此請在您需要客戶連結之前就開始。

在發布之前,請確認以下事項:

  • 用戶端驗證已設定完成。在設定完成之前,您無法發布應用程式。
  • 您的應用程式有一個首頁,您可以在 Appearance 分頁上設定。
  • 您可以變更首頁網域的 DNS 記錄。
  • 每個重新導向 URI 都位於首頁的網域或其子網域之一上。

關於什麼算是首頁的網域以及例外情況,請參閱網域規則。

請依照以下步驟發布應用程式:

  1. 在 Console 中應用程式的頁面上,按一下 Publish app。對話方塊隨即開啟。
  2. 如果對話方塊顯示 Prove your domain,請在管理網域 DNS 的地方新增對話方塊提供給您的 DNS TXT 記錄。否則,請前往步驟 5。
  3. 按一下 Check。如果網域仍顯示 Not proven yet,請參閱如果您無法證明網域。
  4. 當網域顯示 Proven 時,按一下 Continue。
  5. 如果對話方塊顯示接受 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。同時使用兩者的一種方式是將您的首頁放在涵蓋兩者的 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:

  1. 在應用程式的 Appearance 分頁(名稱和首頁)或 Settings 分頁(重新導向 URI)上變更應用程式。
  2. 按一下 Save changes。在儲存任何內容之前,對話方塊會先開啟。
  3. 如果對話方塊顯示 Prove your domain,請證明它所列出的每個網域:
    1. 為該網域新增 DNS TXT 記錄。然後按一下 Check。如果網域仍顯示 Not proven yet,請參閱如果您無法證明網域。
    2. 當網域顯示 Proven 時,如果還有其他網域,請按一下 Next domain。否則,請按一下 Continue。
  4. 按一下 Save and send to review。

接著 Console 會儲存變更,且變更無需等待審查即會生效。Anthropic 審查變更期間,應用程式的狀態為 In review。

若要變更標誌,請在 Appearance 分頁上選擇或移除它。對話方塊會立即開啟。按一下 Send to review。如果您取消,標誌不會變更。

若要在應用程式狀態為 In review 或 Not approved 時再次變更它,請參閱變更尚未上線的應用程式。

當 Console 要求您證明網域時

只有在您變更了首頁或某個重新導向 URI 時,Console 才會要求。它也會檢查您未變更的首頁和重新導向 URI,因此對話方塊也可能列出它們的網域。它只會列出您組織的已證明網域都未涵蓋的網域。它不會檢查本機重新導向 URI,但變更其中任一個仍會使應用程式重新進入審查。

變更後,只要您的組織證明了每個網域,重新導向 URI 就可以位於首頁網域以外的網域上。

在 Anthropic 核准變更之前

從您將變更送交審查時起,適用以下規則:

  • 已連結的客戶: 他們的組織會保持連結,且您計費給他們的請求會持續運作。取消連結的客戶無法再次連結,除非進行連結的人員在 Test users 清單上。
  • 新的連結: Who can link 設定會回到 Test users only。Console 會再次顯示 Test users 清單,其中包含先前在清單上的人員。
  • 測試使用者: 您可以新增和移除清單上的人員。移除某人也會終止其在應用程式上線期間對客戶組織所建立的連結。請參閱移除測試使用者。
  • 已連結組織的支出上限: 已連結的組織會保留其目前的支出上限設定,即使其上限高於 50 美元或完全沒有上限。它所變更的設定必須遵循當您的應用程式處於測試階段時中的規則。

變更的審查結束時

審查會以下列兩種方式之一結束:

  • Anthropic 核准變更: 應用程式再次上線。任何符合資格的客戶都可以連結,Console 會隱藏 Test users 清單,且尚未上線應用程式的上限規則不再適用。
  • Anthropic 未核准變更: 應用程式的狀態會變更為 Not approved。變更仍然有效,且在 Anthropic 核准變更之前中的規則仍然適用。請參閱如果應用程式未獲核准。

變更尚未上線的應用程式

當應用程式的狀態為 Testing、In review 或 Not approved 時,請依照以下步驟操作:

  1. 在應用程式的 Appearance 分頁(名稱、標誌和首頁)或 Settings 分頁(重新導向 URI)上變更應用程式。
  2. 按一下 Save changes。標誌變更會在您選擇或移除標誌時儲存。

不會有對話方塊要求您確認,且變更不會改變應用程式的狀態。

當您儲存對首頁或重新導向 URI 的變更時,Console 只會在狀態為 In review 時檢查網域。處於測試階段的應用程式會在您發布時進行網域檢查。審查期間,變更後應用程式的首頁以及每個非本機的重新導向 URI 都必須位於您組織的已證明網域上。否則,Console 會拒絕變更,且不會要求您證明網域。若要移至尚未證明的網域,請等到審查結束。

發票計費

採用發票計費時,Anthropic 會就擁有您應用程式之組織的 API 用量開立發票給該組織,且該組織不購買預付額度。您的應用程式仍會從測試階段開始,且測試使用者和支出上限的規則仍然適用。在那之後,有三件事有所不同:

  • 發布應用程式: 在應用程式的頁面上,按一下 Publish app。然後在對話方塊中按一下 Publish app 以確認。Anthropic 不會審查應用程式,因此應用程式在您發布後即立即上線。
  • 首頁和網域: 您不需證明任何網域,因此對話方塊會略過 Prove your domain。您的應用程式無需首頁即可發布,且發布應用程式中的重新導向 URI 規則不適用。用戶端驗證仍必須先設定完成。
  • 變更已上線的應用程式: 當您按一下 Save changes,或選擇或移除標誌時,Console 即會儲存變更。它不會要求您證明網域或確認,之後也不會進行審查。

這個頁面有幫助嗎?