應用程式測試與審查
新的 Linked billing 應用程式如何結束測試階段並開放給您的客戶,以及當您變更已上線的應用程式時會發生什麼事。
透過 Linked billing,客戶會將其 Claude 組織連結到您的 OAuth 應用程式。新的 Linked billing 應用程式會從測試階段開始,此時只有您指定的「test users」(測試使用者)可以將其組織連結到該應用程式。若要將應用程式開放給您的客戶,您需要發布它,並由 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。該指南中的以客戶身分進行測試會引導您完成這些步驟,並說明如何確認連結已建立。
若要親自測試應用程式,請將您自己的電子郵件地址新增到清單中。擁有該應用程式的組織無法連結到它,因此請使用您自己的第二個 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。同時使用兩者的一種方式是將您的首頁放在涵蓋兩者的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 要求您證明網域時
只有在您變更了首頁或某個重新導向 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 時,請依照以下步驟操作:
- 在應用程式的 Appearance 分頁(名稱、標誌和首頁)或 Settings 分頁(重新導向 URI)上變更應用程式。
- 按一下 Save changes。標誌變更會在您選擇或移除標誌時儲存。
不會有對話方塊要求您確認,且變更不會改變應用程式的狀態。
當您儲存對首頁或重新導向 URI 的變更時,Console 只會在狀態為 In review 時檢查網域。處於測試階段的應用程式會在您發布時進行網域檢查。審查期間,變更後應用程式的首頁以及每個非本機的重新導向 URI 都必須位於您組織的已證明網域上。否則,Console 會拒絕變更,且不會要求您證明網域。若要移至尚未證明的網域,請等到審查結束。
發票計費
採用發票計費時,Anthropic 會就擁有您應用程式之組織的 API 用量開立發票給該組織,且該組織不購買預付額度。您的應用程式仍會從測試階段開始,且測試使用者和支出上限的規則仍然適用。在那之後,有三件事有所不同:
- 發布應用程式: 在應用程式的頁面上,按一下 Publish app。然後在對話方塊中按一下 Publish app 以確認。Anthropic 不會審查應用程式,因此應用程式在您發布後即立即上線。
- 首頁和網域: 您不需證明任何網域,因此對話方塊會略過 Prove your domain。您的應用程式無需首頁即可發布,且發布應用程式中的重新導向 URI 規則不適用。用戶端驗證仍必須先設定完成。
- 變更已上線的應用程式: 當您按一下 Save changes,或選擇或移除標誌時,Console 即會儲存變更。它不會要求您證明網域或確認,之後也不會進行審查。
這個頁面有幫助嗎?