Web 和 Direct Line 管道安全性會控制用戶端是否必須提供 Direct Line 秘密或權杖,才能連線到您的 Copilot Studio Agent。 如果沒有安全存取,任何知道 Agent 識別碼的人都可以透過「示範網站」和「自訂網站」管道連線。
Note
在僅限 Teams 的體驗中,您無法產生秘密。 安全存取權杖是自動建立的,且已預設啟用安全存取。 有關授權要求,請參閱 Microsoft 產品條款。
開啟「需要安全存取」,要求用戶端出示秘密或權杖。 這些憑證授權存取 Direct Line 頻道;它們本身不會驗證最終使用者,也不會限制對特定網站的存取。 當使用者需要登入時,請另外設定 使用者驗證 。
您可以交換及重新產生秘密、重新整理權杖,或在不再需要時關閉安全存取。
Copilot Studio 使用 Bot Framework Direct Line channel 將你的網頁或應用程式連接到代理。
開啟或關閉 Web 通道安全性
您可以個別對每個 Agent 強制使用密碼和權杖。
當你開啟這個選項時,頻道需要客戶端通過 使用密鑰 或 使用密鑰生成的令牌來認證他們的請求,這些令牌是在運行時獲得的。
嘗試存取未提供此安全措施的代理程式無法運作。
到你的代理程式 設定 頁面,選擇 安全性,然後再選擇 網路通道安全。
開啟 「要求安全存取」。
Warning
當你開啟或關閉「需要安全存取」時,新的系統設定可能需要長達兩小時才會生效。 在那之前,先前的設定將生效。 您不需要發佈代理程式,此變更就會生效。
事先規劃,避免無意中暴露你的經紀人。
要關閉網路通道安全,請關閉 「要求安全存取」 並確認變更。 變更可能需要長達兩小時才能生效。
使用密鑰或權杖
若是服務對服務的應用程式,請在服務所發出要求的授權標頭中指定秘密。
如果您撰寫的應用程式中,用戶端是在網頁瀏覽器或行動應用程式中執行,或客戶可能看得到程式碼,您就必須以秘密交換權杖。 如果您不使用權杖,您的秘密可能會外洩。 當您要求在服務中取得權杖時,請在授權標頭中指定用戶端密碼。
權杖只適用於單一交談,且除非重新整理,否則會過期。
選擇與您的情況最相符的資訊安全模型。
Warning
不要在瀏覽器中執行的任何程式碼中暴露這個秘密,不論是硬編碼還是透過網路呼叫傳輸。
利用服務代碼中的秘密取得憑證,是保護 Copilot Studio 代理最安全的方式。
取得秘密
您需要取得秘密,以便在應用程式的授權標頭要求或類似項目中指定。
在導覽功能表的設定底下,選取安全性。 接著選取 Web 通道安全性圖標。
選取「複製」,將秘密 1 或秘密 2 複製到剪貼簿。 要顯示密鑰,請選擇可見圖示並查看警告提示。
交換秘密
如果你需要更改代理人使用的秘密,你可以在沒有任何停機或中斷的情況下更改。
Copilot Studio 提供兩個可以同時運作的秘密金鑰。 你可以將程式代理使用的密鑰替換為另一個密鑰。 當秘密交換完畢,且所有使用者都透過新秘密連線後,你可以重新生成秘密。
重新產生密鑰
若要重新產生祕密,請選取祕密旁邊的重新產生。
Warning
使用原始秘密或從該秘密取得的權杖進行連線的使用者設定檔,會中斷連線。
產生權杖
您可以產生權杖,以開始單一 Agent 交談。 此程序會在您的服務程式碼中,以 Direct Line 秘密交換交談權杖。 關於 Copilot Studio 令牌端點選項,請參考 Get Direct Line 令牌。
產生權杖要求的範例
POST https://directline.botframework.com/v3/directline/tokens/generate
Authorization: Bearer <DirectLineSecret>
產生權杖回應範例
HTTP/1.1 200 OK
[other headers]
{
"conversationId": "abc123",
"token": "<DirectLineToken>",
"expires_in": 1800
}
如果要求成功,回應將包含對一個交談有效的權杖,以及 expires_in 的值,表示權杖到期之前的秒數。
為了讓代幣繼續有用,你必須在代幣到期前 刷新 它。
重新整理權杖
你可以無限次刷新代幣,只要它還沒過期。
過期的代幣無法刷新。
傳送「重新整理要求範例」。 將 <DirectLineToken> 取代為您要重新整理且尚未過期的權杖。 請使用交談權杖,而不是 Direct Line 秘密。
重新整理要求範例
POST https://directline.botframework.com/v3/directline/tokens/refresh
Authorization: Bearer <DirectLineToken>
重新整理回應範例
如果要求成功,回應將包含一個新權杖,如先前權杖一般對相同交談有效,以及 expires_in 的值,表示新權杖到期之前的秒數。
為了讓新代幣保持使用,請在代幣到期前再次刷新。
HTTP/1.1 200 OK
[other headers]
{
"conversationId": "abc123",
"token": "<DirectLineToken>",
"expires_in": 1800
}
如需詳細資訊,請參閱 重新整理 Direct Line 權杖。