配置網頁與 Direct Line 頻道安全

Web 和 Direct Line 管道安全性會控制用戶端是否必須提供 Direct Line 秘密或權杖,才能連線到您的 Copilot Studio Agent。 如果沒有安全存取,任何知道 Agent 識別碼的人都可以透過「示範網站」和「自訂網站」管道連線。

Note

在僅限 Teams 的體驗中,您無法產生秘密。 安全存取權杖是自動建立的,且已預設啟用安全存取。 有關授權要求,請參閱 Microsoft 產品條款。

開啟「需要安全存取」,要求用戶端出示秘密或權杖。 這些憑證授權存取 Direct Line 頻道;它們本身不會驗證最終使用者,也不會限制對特定網站的存取。 當使用者需要登入時,請另外設定 使用者驗證 。

您可以交換及重新產生秘密、重新整理權杖,或在不再需要時關閉安全存取。

Copilot Studio 使用 Bot Framework Direct Line channel 將你的網頁或應用程式連接到代理。

開啟或關閉 Web 通道安全性

您可以個別對每個 Agent 強制使用密碼和權杖。

當你開啟這個選項時,頻道需要客戶端通過 使用密鑰 或 使用密鑰生成的令牌來認證他們的請求,這些令牌是在運行時獲得的。

嘗試存取未提供此安全措施的代理程式無法運作。

  1. 到你的代理程式 設定 頁面,選擇 安全性,然後再選擇 網路通道安全。

    [設定] 飛出視窗上醒目提示的 Web 通道安全性螢幕擷取畫面。

  2. 開啟 「要求安全存取」。

Warning

當你開啟或關閉「需要安全存取」時,新的系統設定可能需要長達兩小時才會生效。 在那之前,先前的設定將生效。 您不需要發佈代理程式,此變更就會生效。

事先規劃,避免無意中暴露你的經紀人。

要關閉網路通道安全,請關閉 「要求安全存取」 並確認變更。 變更可能需要長達兩小時才能生效。

確認畫面截圖,顯示關閉安全存取後,示範網站和非安全 Direct Line 頻道可使用。

使用密鑰或權杖

若是服務對服務的應用程式,請在服務所發出要求的授權標頭中指定秘密。

如果您撰寫的應用程式中,用戶端是在網頁瀏覽器或行動應用程式中執行,或客戶可能看得到程式碼,您就必須以秘密交換權杖。 如果您不使用權杖,您的秘密可能會外洩。 當您要求在服務中取得權杖時,請在授權標頭中指定用戶端密碼。

權杖只適用於單一交談,且除非重新整理,否則會過期。

選擇與您的情況最相符的資訊安全模型。

Warning

不要在瀏覽器中執行的任何程式碼中暴露這個秘密,不論是硬編碼還是透過網路呼叫傳輸。

利用服務代碼中的秘密取得憑證,是保護 Copilot Studio 代理最安全的方式。

取得秘密

您需要取得秘密,以便在應用程式的授權標頭要求或類似項目中指定。

  1. 在導覽功能表的設定底下,選取安全性。 接著選取 Web 通道安全性圖標。

  2. 選取「複製」,將秘密 1 或秘密 2 複製到剪貼簿。 要顯示密鑰,請選擇可見圖示並查看警告提示。

交換秘密

如果你需要更改代理人使用的秘密,你可以在沒有任何停機或中斷的情況下更改。

Copilot Studio 提供兩個可以同時運作的秘密金鑰。 你可以將程式代理使用的密鑰替換為另一個密鑰。 當秘密交換完畢,且所有使用者都透過新秘密連線後,你可以重新生成秘密。

重新產生密鑰

若要重新產生祕密,請選取祕密旁邊的重新產生。

Warning

使用原始秘密或從該秘密取得的權杖進行連線的使用者設定檔,會中斷連線。

產生權杖

您可以產生權杖,以開始單一 Agent 交談。 此程序會在您的服務程式碼中,以 Direct Line 秘密交換交談權杖。 關於 Copilot Studio 令牌端點選項,請參考 Get Direct Line 令牌。

  1. 取得秘密。

  2. 在服務程式碼中,傳送「產生權杖要求範例」。 將 <DirectLineSecret> 取代為您複製的秘密。

產生權杖要求的範例

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 權杖。