驗證參考 authentication-reference

IMPORTANT
所有AEM Sites Cloud Service客戶都可使用LLM應用程式來開發及管理自己的應用程式。 一旦計數開始,每個應用程式呼叫都會計入客戶的AEM Sites內容請求。 Adobe會在計量生效前宣告計量速率和開始日期。

您可以在此頁面查詢驗證欄位與合約。 如需安裝指示,請參閱使用您自己的身分識別提供者來驗證一般使用者。

驗證設定 authentication-settings

開啟​設定 > 驗證。 每個環境都會儲存自己的設定。 使用​ Workspace ​選取器來選取要編輯的環境;儲存設定不會影響其他環境。

欄位
必要
說明
Workspace
—
驗證設定的環境: 階段​或​生產
啟用驗證
—
主開關。 關閉時,無論驗證模式為何,所有動作均為公開
簽發者
是
您的身分提供者的簽發者URL和預期的iss宣告。 必須是HTTPS。 也作為此應用程式的授權伺服器發佈。 每個應用程式一個身分提供者
支援的領域
否
此應用程式動作可能需要的一組完整範圍。 作為應用程式支援的範圍發佈至LLM平台
JWKS URI
否
進階。 您的簽署金鑰組的HTTPS URL。 只有當它與授權伺服器的中繼資料通告內容不同時才需要

驗證規則

規則
效果
簽發者​是空的,而​ 啟用驗證 ​已開啟
已封鎖儲存
簽發者​或​ JWKS URI ​不是HTTPS URL
已封鎖儲存
動作需要​ 支援的領域 ​中缺少領域
儲存會遭到封鎖,直到您新增範圍或從動作中移除範圍為止
已從支援的​領域移除領域
它會從需要它的每個動作中立即移除,而不等待儲存
支援的領域​是空的
無法授與任何範圍,因此會移除動作中已有的任何範圍。 在此情況下不會顯示警告
offline_access已列在​ 支援的領域 ​或動作中
在部署應用程式時移除,無論大小寫或周圍的空白區域為何,因此設定頁面可顯示已部署應用程式沒有的範圍。 offline_access會向您的授權伺服器要求重新整理Token,而不是授與此應用程式的存取權,因此這不是此應用程式通告的範圍。 您不需要列出它 — LLM平台會直接從您的授權伺服器要求它

簽發者​的結尾斜線已標準化。 iss比較容許差異,所以來自一律包含尾隨斜線的提供者的Token仍會驗證。

驗證模式 auth-modes

在​ 每個動作組態 ​下設定每個動作。

模式
需要權杖
處理常式接收身分
在平台上廣告為
無
否
只有當呼叫者提供有效的權杖時
noauth
必要
是,包含每個列出的範圍
一律
oauth2
選擇性
否
當有效的權杖出現時
noauth 和 oauth2

必要​動作的處理常式,永遠不會在沒有有效、範圍正確的權杖的情況下執行。 Optional​動作的處理常式一律會執行,而且可能會要求使用extra.challengeAuth()登入本身。

因此,必要​是唯一拒絕未驗證來電者的模式。 應用程式只會在每個動作為​ 必要 ​時才拒絕所有匿名呼叫。 如果任何動作是​ 無 ​或​選擇性,應用程式會使用混合式驗證,因為至少有一個動作接受匿名呼叫。

只有在​ 啟用驗證 ​開啟時,驗證模式才會生效。 變更會在應用程式下一次部署時生效。

變更驗證交換器也會重寫每個動作的模式:

切換變更
對每次動作模式的影響
關閉至開啟
每個​ 無 ​動作會變成​必要。 動作已​ 必要 ​或​選用,請保留其模式
開啟至關閉
系統會為該環境清除每個動作的模式和範圍。 如果您再次開啟開關,則不會還原設定

切換​ Workspace ​絕不重寫模式。 選擇器會載入其他環境的已儲存設定,而不會變更它。

啟用​驗證,且每個動作都設為​無,應用程式不需要驗證,但仍會發佈其授權伺服器以供探索。 若要讓應用程式完全公開,請關閉開關。

應用程式可對個別動作使用不同的驗證模式。 請參閱LLM平台行為,瞭解每個平台如何套用這些行為。

權杖需求 token-requirements

您的身分提供者必須核發符合下列所有要求的存取權杖。 執行階段將未通過任何檢查的權杖視為不存在:呼叫者未驗證,且​ 必要 ​動作會要求呼叫者登入。

需求
詳細資料
格式
已簽署JWT。 不支援不透明權杖
簽署演演算法
RS256、RS384、RS512、ES256、ES384、ES512、PS256、PS384或PS512。 已拒絕HMAC演演算法(例如HS256)
iss
必須符合​簽發者
aud
必須包含應用程式的資源識別碼 — 該環境的MCP伺服器URL
exp
必須為未來
scope 或 scp
執行階段讀取以空格分隔的scope字串,或退回到scp中的字串陣列。 針對每個動作的需求,使用其中一個圖形來檢查範圍
sub
處理常式透過getAuthenticatedUser讀取的使用者識別碼
傳輸
Authorization: Bearer <token>請求標頭

您的提供者包含的任何其他一般宣告(例如tenant或email)都會傳遞給您的處理常式。 巢狀物件會被捨棄,長字串值會被截斷。

身分提供者探索 discovery

您的應用程式會發佈自己的RFC 9728受保護資源中繼資料,讓LLM平台可以找到您的授權伺服器。 您不需要建立、託管或設定受保護的資源中繼資料。

您的身分提供者必須提供下列探索資訊:

需求
詳細資料
授權伺服器中繼資料
您的授權伺服器必須發佈LLM使用者端的探索中繼資料。 除非設定​JWKS URI,否則此應用程式的執行階段會特別尋找RFC 8414 OAuth授權伺服器中繼資料來找到jwks_uri;它不會回溯至OIDC探索路徑
具有路徑的簽發者
知名區段會位於路徑之前,而非路徑之後。 位於https://auth.example.com/oauth2/default的簽發者在https://auth.example.com/.well-known/oauth-authorization-server/oauth2/default提供其中繼資料
直接簽署金鑰URL
當金鑰託管於其他位置或提供者僅公開OIDC探索時,請設定​JWKS URI。 這會略過執行階段金鑰的探索,而非LLM使用者端所需的探索

處理常式驗證API handler-auth-api

套件@adobe/llm-apps-runtime匯出下列協助程式。 每個協助程式都接受extra,這是您的處理常式接收的第二個引數。

協助程式
傳回
getAuthenticatedUser(extra)
登入使用者的sub宣告,或呼叫未驗證時的undefined
hasScope(extra, scope)
呼叫者的權杖攜帶scope時的true

extra.authInfo中有已驗證的Token資訊,對於未驗證的呼叫而言是undefined。

屬性
說明
authInfo.token
原始持有人權杖。 請勿將其記錄或傳回使用者端
authInfo.clientId
client_id或azp宣告,或unknown
authInfo.scopes
已授與範圍的陣列
authInfo.expiresAt
權杖到期,如exp宣告
authInfo.resource
權杖驗證所針對的應用程式資源識別碼
authInfo.extra
sub加上您的身分提供者包含的任何其他一般宣告

extra.challengeAuth(options)僅適用於​ 選擇性 ​動作。 從您的處理常式傳回結果,要求使用者登入而非傳回內容。

協助程式傳回ChatGPT的工具結果挑戰。 Claude需要傳輸層級HTTP挑戰。 執行階段提供會挑戰​ 必要 ​動作,但不透過選擇性處理常式協助程式進行。

選項
說明
error
RFC 6750持有者錯誤碼: invalid_token、insufficient_scope或invalid_request。 預設為insufficient_scope
errorDescription
向使用者顯示的訊息。 預設為一般登入提示
scope
要要求的以空格分隔的範圍。 省略此專案,讓平台回覆至應用程式支援的範圍
IMPORTANT
一律明確設定error。 對於沒有有效工作階段的呼叫者使用invalid_token,而只對語彙基元有效但缺少必要範圍的呼叫者使用insufficient_scope。 執行階段會將值傳給LLM平台,由平台選擇登入提示的措辭。 傳送準確描述條件的程式碼,而非具有您偏好提示的程式碼。

LLM平台行為 platform-behavior

兩種平台都支援相同應用程式中的公開和受保護動作,但其登入觸發程式不同。

行為
ChatGPT
Claude
混合驗證
公用動作以匿名方式運作;必要​動作要求登入
透過​需要時登入,公開動作會以匿名方式運作,且受保護的通話會開始登入
具有每個動作​必要的應用程式
設定OAuth驗證
使用前需要驗證
聯結器設定
針對公用應用程式使用​無驗證,當每個動作為​ 必要 ​時,使用​OAuth,否則使用​混合,其中會提供這些選項
檢閱偵測到的設定。 選擇​ 需要時登入 ​供混合式應用程式使用,或​ 立即登入 ​供預先登入使用
缺少身分或必要的範圍
執行階段傳回平台的驗證挑戰
執行階段會針對遺失/無效的身分傳回HTTP 401,或針對遺失必要範圍的有效權杖傳回範圍不足的HTTP 403
選擇性處理常式的extra.challengeAuth()
可以開始重新驗證
成功的HTTP工具結果回應不會開始登入。 針對可攜式登入閘道使用​ 必要 ​動作

檢視Claude延遲驗證和ChatGPT驗證目前的使用者端行為。 聯結器UI和原則可能會因帳戶和組織而異。

相關

recommendation-more-help
llm-apps-help-main-toc