Konfigurowanie zabezpieczeń sieci Web i kanału Direct Line

Bezpieczeństwo kanałów Web i Direct Line decyduje, czy klienci muszą podać sekret Direct Line lub token, aby połączyć się z agentem Copilot Studio. Bez zabezpieczonego dostępu każdy, kto zna identyfikator agenta, może nawiązać połączenie za pośrednictwem kanałów strona demonstracyjna oraz strona niestandardowa.

Note

W środowisku tylko w Teams nie możesz generować sekretów. Tokeny bezpiecznego dostępu są tworzone automatycznie, a dostęp zabezpieczony jest domyślnie włączony. W przypadku wymagań licencyjnych zapoznaj się z Microsoft Product Terms.

Włącz opcję Wymagaj dostępu zabezpieczonego , aby wymagać od klientów przedstawienia sekretu lub tokena. Te poświadczenia upoważniają do dostępu do kanału Direct Line; same w sobie nie uwierzytelniają użytkownika końcowego ani nie ograniczają dostępu do konkretnej strony internetowej. Konfiguruj uwierzytelnianie użytkownika osobno, gdy użytkownicy muszą się zalogować.

Możesz wymieniać i regenerować klucze tajne, odświeżać tokeny lub wyłączyć zabezpieczony dostęp, gdy nie jest już potrzebny.

Program Copilot Studio używa kanału Bot Framework Direct Line, aby połączyć stronę internetową lub aplikację z agentem.

Włącz lub wyłącz zabezpieczenia kanału internetowego

Istnieje możliwość wymuszania korzystania z sekretów i tokenów w poszczególnych agentach.

Gdy włączysz tę opcję, kanały będą wymagać, aby klient uwierzytelniał swoje żądania albo używając wpisu tajnego, albo za pomocą tokenu wygenerowanego przy użyciu wpisu tajnego uzyskanego w środowisku uruchomieniowym.

Próby uzyskania dostępu do agenta, który nie zapewnia tej miary zabezpieczeń, nie działają.

  1. Przejdź do strony Ustawienia agenta, wybierz pozycję Zabezpieczenia, a następnie wybierz pozycję Zabezpieczenia kanału internetowego.

    Zrzut ekranu przedstawiający zabezpieczenia kanału internetowego podświetlone w menu wysuwanym Ustawienia.

  2. Włącz opcję Wymagaj zabezpieczonego dostępu.

Warning

Gdy włączasz lub wyłączasz opcję Wymagaj zabezpieczonego dostępu, nowe ustawienia systemu mogą zacząć obowiązywać dopiero po upływie maksymalnie dwóch godzin. Do tego czasu poprzednie ustawienie jest w mocy. Nie musisz publikować agenta, aby ta zmiana weszła w życie.

Zaplanuj z wyprzedzeniem, aby uniknąć przypadkowego ujawnienia agenta.

Aby wyłączyć bezpieczeństwo kanału internetowego, wyłącz opcję Wymagaj dostępu zabezpieczonego i potwierdź zmianę. Wprowadzenie zmiany może zająć do dwóch godzin, zanim zacznie obowiązywać.

Zrzut ekranu potwierdza, że wyłączenie zabezpieczonego dostępu udostępnia stronę demo oraz niezabezpieczone kanały Direct Line.

Korzystanie z wpisów tajnych i tokenów

W przypadku aplikacji typu „usługa–usługa” należy podać klucz tajny w nagłówku autoryzacji żądań wysyłanych z Twojej usługi.

Jeśli piszesz aplikację, w której klient działa w przeglądarce internetowej lub aplikacji mobilnej, albo w innym przypadku kod może być widoczny dla klientów, musisz wymienić swój sekret na token. Jeśli nie użyjesz tokena, Twój tajny wpis może zostać naruszony. Po otrzymaniu przez użytkownika żądania pobrania tokenu usługi należy określić wpis tajny w nagłówku autoryzacji.

Tokeny działają tylko dla pojedynczej rozmowy i wygasną, o ile nie zostaną odświeżone.

Wybierz model zabezpieczeń, który najlepiej pasuje do danej sytuacji.

Warning

Nie ujawniaj tajemnicy w żadnym kodzie, który działa w przeglądarce, niezależnie od tego, czy jest zakodowany, czy przesyłany przez wywołanie sieciowe.

Uzyskiwanie tokenu przy użyciu tajnego klucza w kodzie usługi jest najbezpieczniejszym sposobem zapewnienia bezpieczeństwa agenta Copilot Studio.

Uzyskiwanie tajnych wpisów

Jeśli wpis tajny jest potrzebny, można określić go w żądaniach nagłówka autoryzacji aplikacji lub w podobny sposób.

  1. W menu nawigacji, w sekcji Ustawienia wybierz Zabezpieczenia. Następnie wybierz kafelek Zabezpieczenia kanału internetowego.

  2. Wybierz Kopiuj dla Tajny wpis 1 lub Tajny wpis 2, aby skopiować do schowka. Aby ujawnić sekret, wybierz ikonę widoczności i sprawdź prompt ostrzegawczy.

Zamiana tajnych wpisów

Jeśli musisz zmienić sekret używany przez agenta, możesz to zrobić bez przerw w działaniu.

Program Copilot Studio dostarcza dwie tajemnice, które działają jednocześnie. Możesz wymienić sekret używany przez agenta na inny. Po zamianie wpisów tajnych i połączeniu wszystkich użytkowników przy użyciu nowego wpisu tajnego można ponownie wygenerować wpis tajny.

Wygeneruj ponownie wpis tajny

Aby ponownie wygenerować wygenerowanie danych, należy wybrać opcjęRegenerowanie obok wpisu tajnego.

Warning

Profil użytkownika, który nawiązuje połączenie przy użyciu oryginalnej tajemnicy lub tokenu uzyskanego z tej tajemnicy, jest odłączony.

Generowanie tokenu

Możesz wygenerować token, aby rozpocząć rozmowę obsługiwaną przez jednego agenta. Ta procedura wymienia sekret Direct Line na token konwersacyjny w kodzie Twojej usługi. W przypadku opcji punktu końcowego tokenu Copilot Studio dowiedz się więcej w artykule Get Direct Line token.

  1. Uzyskiwanie wpisu tajnego.

  2. W kodzie serwisowym wyślij przykładowe żądanie generowania tokena. Zamień <DirectLineSecret> na sekret, który skopiowałeś.

Przykładowe żądanie wygenerowania tokenu

POST https://directline.botframework.com/v3/directline/tokens/generate
Authorization: Bearer <DirectLineSecret>

Przykłady generowania odpowiedzi tokenu

HTTP/1.1 200 OK
[other headers]
{
  "conversationId": "abc123",
  "token": "<DirectLineToken>",
  "expires_in": 1800
}

Jeśli żądanie zakończy się pomyślnie, odpowiedź zawiera token ważny dla jednej konwersacji, a wartość expires_in wskazuje liczbę sekund do wygaśnięcia tokenu.

Aby token był przydatny, należy odświeżyć token przed jego wygaśnięciem.

Odśwież token

Token można odświeżyć nieograniczoną liczbę razy, o ile nie wygasł.

Nie można odświeżyć wygasłego tokenu.

Wyślij żądanie odświeżenia próbki. Zastąp <DirectLineToken> nieprzeterminowanym tokenem, który chcesz odświeżyć. Użyj tokena rozmowy, nie sekretu Direct Line.

Przykładowe żądanie odświeżania

POST https://directline.botframework.com/v3/directline/tokens/refresh
Authorization: Bearer <DirectLineToken>

Przykładowa odpowiedź odświeżania

Jeśli żądanie zakończy się pomyślnie, odpowiedź zawiera token ważny dla tej samej rozmowy co poprzedni token, a wartość expires_in wskazuje liczbę sekund do wygaśnięcia nowego tokenu.

Aby zachować przydatny nowy token, odśwież token ponownie przed jego wygaśnięciem.

HTTP/1.1 200 OK
[other headers]
{
  "conversationId": "abc123",
  "token": "<DirectLineToken>",
  "expires_in": 1800
}

Dowiedz się więcej w Refresh a Direct Line token.