驗證參考 authentication-reference
您可以在此頁面查詢驗證欄位與合約。 如需安裝指示,請參閱使用您自己的身分識別提供者來驗證一般使用者。
驗證設定 authentication-settings
開啟設定 > 驗證。 每個環境都會儲存自己的設定。 使用 Workspace 選取器來選取要編輯的環境;儲存設定不會影響其他環境。
iss宣告。 必須是HTTPS。 也作為此應用程式的授權伺服器發佈。 每個應用程式一個身分提供者驗證規則
offline_access已列在 支援的領域 或動作中offline_access會向您的授權伺服器要求重新整理Token,而不是授與此應用程式的存取權,因此這不是此應用程式通告的範圍。 您不需要列出它 — LLM平台會直接從您的授權伺服器要求它簽發者的結尾斜線已標準化。 iss比較容許差異,所以來自一律包含尾隨斜線的提供者的Token仍會驗證。
驗證模式 auth-modes
在 每個動作組態 下設定每個動作。
noauthoauth2noauth 和 oauth2必要動作的處理常式,永遠不會在沒有有效、範圍正確的權杖的情況下執行。 Optional動作的處理常式一律會執行,而且可能會要求使用extra.challengeAuth()登入本身。
因此,必要是唯一拒絕未驗證來電者的模式。 應用程式只會在每個動作為 必要 時才拒絕所有匿名呼叫。 如果任何動作是 無 或選擇性,應用程式會使用混合式驗證,因為至少有一個動作接受匿名呼叫。
只有在 啟用驗證 開啟時,驗證模式才會生效。 變更會在應用程式下一次部署時生效。
變更驗證交換器也會重寫每個動作的模式:
切換 Workspace 絕不重寫模式。 選擇器會載入其他環境的已儲存設定,而不會變更它。
啟用驗證,且每個動作都設為無,應用程式不需要驗證,但仍會發佈其授權伺服器以供探索。 若要讓應用程式完全公開,請關閉開關。
應用程式可對個別動作使用不同的驗證模式。 請參閱LLM平台行為,瞭解每個平台如何套用這些行為。
權杖需求 token-requirements
您的身分提供者必須核發符合下列所有要求的存取權杖。 執行階段將未通過任何檢查的權杖視為不存在:呼叫者未驗證,且 必要 動作會要求呼叫者登入。
RS256、RS384、RS512、ES256、ES384、ES512、PS256、PS384或PS512。 已拒絕HMAC演演算法(例如HS256)issaudexpscope 或 scpscope字串,或退回到scp中的字串陣列。 針對每個動作的需求,使用其中一個圖形來檢查範圍subgetAuthenticatedUser讀取的使用者識別碼Authorization: Bearer <token>請求標頭您的提供者包含的任何其他一般宣告(例如tenant或email)都會傳遞給您的處理常式。 巢狀物件會被捨棄,長字串值會被截斷。
身分提供者探索 discovery
您的應用程式會發佈自己的RFC 9728受保護資源中繼資料,讓LLM平台可以找到您的授權伺服器。 您不需要建立、託管或設定受保護的資源中繼資料。
您的身分提供者必須提供下列探索資訊:
jwks_uri;它不會回溯至OIDC探索路徑https://auth.example.com/oauth2/default的簽發者在https://auth.example.com/.well-known/oauth-authorization-server/oauth2/default提供其中繼資料處理常式驗證API handler-auth-api
套件@adobe/llm-apps-runtime匯出下列協助程式。 每個協助程式都接受extra,這是您的處理常式接收的第二個引數。
getAuthenticatedUser(extra)sub宣告,或呼叫未驗證時的undefinedhasScope(extra, scope)scope時的trueextra.authInfo中有已驗證的Token資訊,對於未驗證的呼叫而言是undefined。
authInfo.tokenauthInfo.clientIdclient_id或azp宣告,或unknownauthInfo.scopesauthInfo.expiresAtexp宣告authInfo.resourceauthInfo.extrasub加上您的身分提供者包含的任何其他一般宣告extra.challengeAuth(options)僅適用於 選擇性 動作。 從您的處理常式傳回結果,要求使用者登入而非傳回內容。
協助程式傳回ChatGPT的工具結果挑戰。 Claude需要傳輸層級HTTP挑戰。 執行階段提供會挑戰 必要 動作,但不透過選擇性處理常式協助程式進行。
errorerrorDescriptionscopeerror。 對於沒有有效工作階段的呼叫者使用invalid_token,而只對語彙基元有效但缺少必要範圍的呼叫者使用insufficient_scope。 執行階段會將值傳給LLM平台,由平台選擇登入提示的措辭。 傳送準確描述條件的程式碼,而非具有您偏好提示的程式碼。LLM平台行為 platform-behavior
兩種平台都支援相同應用程式中的公開和受保護動作,但其登入觸發程式不同。
extra.challengeAuth()檢視Claude延遲驗證和ChatGPT驗證目前的使用者端行為。 聯結器UI和原則可能會因帳戶和組織而異。