代理程式群是一組在共享雲端執行環境中運行的代理程式。 例如,一個允許團隊或客戶自行部署代理程式的平台,會將每個新代理程式都託管在同一個運算與程式碼庫上。 艦隊中的每個代理都有自己的 代理身份,因此其登入、權限與稽核紀錄與其他代理保持獨立。
執行環境持有單一 代理身份藍圖 憑證,並利用它取得從該藍圖建立的任何代理身份的權杖。 執行時會選擇在每次令牌請求中使用哪個代理身份。
在單一代理或代理群之間選擇
| 考慮事項 | 單一代理人 | 代理程式群組 |
|---|---|---|
| 每次部署的代理程式數量 | One | 許多項目可在執行階段新增或移除 |
| 當代理程式身份建立時 | 在開發人員或管理員部署代理程式之前 | 當每個代理程式由執行環境或 Agent 365 部署時 |
| 代理身份識別碼的來源 | Configuration | 對每個請求進行查詢 |
| 如何授予存取權 | 在部署代理程式之前,對代理程式身分識別 | 在佈建代理程式時,對每個代理身分識別 |
| Guidance | 使用 ASP.NET Core 建置雲端代理程式或Auth SDK sidecar | 本文及其後續的車隊相關文章 |
fleet 執行階段會為每項操作選擇代理程式的身分識別。 在此過程中請遵循 fleet 範例:雲端代理程式教學使用單一設定的身分識別,省略 fleet 所需的每個請求皆需選擇的身分識別。
Components
| Component | Purpose | Cardinality |
|---|---|---|
| 代理身份藍圖 | 定義艦隊的權限、入站範圍及應用程式角色。 建立與刪除代理身分。 | 每個車隊一個,或每個代理類型一個 |
| 藍圖憑證 | 將執行環境驗證為藍圖。 在正式環境中使用受管理身份聯合憑證。 | 每個藍圖各一個 |
| 代理人身份 | 代表一個代理程式。 接收用於呼叫 API 的存取權杖。 | 每位代理人各一個 |
| 代理人的使用者帳號 | 為代理程式提供一個用於 Microsoft 365 工作負載(如信箱或 Teams 成員資格)的使用者物件。 | 可選,每個代理身份最多一個 |
| 代理人目錄 | 執行環境的儲存庫,將每個代理程式對應至其代理程式身份及代理程式的使用者帳戶。 | 每個 fleet 一個 |
| 配置服務 | 當代理程式部署與退役時,建立並刪除身分識別。 | 每個車隊一個 |
| 權杖 broker | 取得指定代理身份的權杖。 Microsoft.Identity.Web 在執行階段程序中,或 Auth SDK 的 sidecar。 | 每個執行階段有一個或多個 |
代理程式生命週期
- 部署。 使用者或管線會將新的代理程式部署到執行環境。
- 供應。 配置服務會從藍圖中建立代理身分。 如果代理程式需要 Microsoft 365 使用者功能,它也會建立代理程式的使用者帳戶。 它會將兩個 ID 記錄在代理程式目錄中,並授予代理程式所需的存取權限。
- 快跑。 對於每一個操作,執行時會在代理程式目錄中查詢代理程式的身分,並將其傳遞給權杖仲介程式。
- 停用。 配置服務會刪除客服人員的使用者帳戶,然後刪除客服人員身分,並移除客服人員目錄項目。
選擇客服人員的佈建方式
| Option | 運作原理 | 在下列情況下使用 |
|---|---|---|
| 執行階段會佈建身分識別 | 配置服務以藍圖身份進行驗證,並呼叫 Microsoft Graph 以建立及刪除代理程式身份及代理程式的使用者帳戶。 | 執行階段控制代理程式的部署。 |
| Agent 365 佈建身分識別 | 代理程式 365 會在佈建代理程式時建立代理程式身分識別。 執行環境會監聽代理程式配置事件,其中包含代理程式身份 ID,並將其記錄在代理程式目錄中。 | 代理程式是透過 Microsoft 365 使用體驗建立。 詳細資訊請參閱 Agent 365 開發者文件。 |
兩種選項都會產生相同的代理程式目錄項目。 其餘艦隊指引適用於任一選項。
在每個請求中選擇代理身份
藍圖憑證可以為每個從藍圖建立的代理身份取得代幣。 因此,選擇代理身份的執行時程式碼即為安全邊界。
- 使用執行時控制的金鑰(例如執行環境自身的代理 ID)從代理程式目錄解析代理程式身份。
- 請勿接受來自請求、提示或工具輸出的代理程式身份、用戶端 ID 或代理程式使用者帳戶 ID。
- 在請求目標代理的令牌之前,請確認呼叫者被允許使用該目標代理。
規劃信任邊界
- 請將憑證與代理程式代碼保持距離。 將藍圖憑證保留在執行階段環境或 sidecar 中,絕不可放在由代理程式作者或模型控制的程式碼中。
- 隔離權杖代理程式。 如果代理執行的是不受信任或客戶提供的程式碼,不要讓這些程式碼直接呼叫權杖代理程式。 能夠連線到中介者的程序可以為整個部署中的任何代理程式申請權杖。
- 將配置與代幣取得分開。 配置服務使用藍圖令牌,可建立與刪除身份。 用它自己的存取路徑執行它,這樣代理程式就無法請求那些令牌。
- 將影響範圍降到最低。 當代理程式群組在不同信任區或屬於不同客戶時,請使用多個藍圖。
限制規劃
藍圖主體最多只能建立 250 個代理人身份。 對於較大的代理程式群組,建立更多藍圖,並在佈建時將每個代理分配到藍圖。 將藍圖記錄在代理程式目錄項目中。 詳細資訊請參閱 代理程式識別藍圖主體身分。
接下來的實作文章則在每個執行階段組態中各使用一個藍圖。 若將藍圖擴展至多個藍圖,也須解析每個代理程式的藍圖配置與憑證;僅僅選擇代理人 ID 並不代表選擇不同的藍圖。 範例目錄記錄需要為該設計擴充。
授予每個代理程式存取權限
只賦予每個代理程式身分其代理程式所需的存取權限。 將應用程式權限、委派權限、Azure 角色指派及其他資源存取權直接授予代理程式身份,無論是在配置過程中或之後。 每個代理的授權讓每位代理的存取權限獨立,因此你可以檢視、變更或撤銷某位代理的存取權限,而不會影響整個艦隊的其他成員。 有關授予存取的方式,請參閱「授予應用程式權限」及「授予委派權限」。
對於整個叢集中每個代理程式都需要的權限,您可以方便地使用 可繼承權限。 管理員會在藍圖主體上授予這些權限一次,而每個由藍圖建立的代理身份都會透過其令牌接收這些權限。 繼承權限不會顯示在代理程式識別上,因此每個代理程式的授權更容易被稽核。
將使用者請求導向代理程式
使用者會使用藍圖的 access_agent 範圍存取權杖呼叫車隊代理。 fleet 中的每個代理都共享這個受眾,因此令牌證明使用者身份,但不識別代理。 執行時必須:
- 從請求中判斷目標代理程式,例如從路由區段判斷。
- 確認使用者被允許使用該代理。 藍圖上的應用程式角色適用於整個代理程式群組,因此在執行時強制執行每個代理程式的存取權限。
- 使用目標代理程式的身份來執行任何 On-Behalf-Of(OBO)令牌請求。