Konfigurowanie zabezpieczeń kanału internetowego i kanału Direct Line

Ważne

Możliwości i funkcje Power Virtual Agents są teraz częścią Microsoft Copilot Studio w wyniku znacznych inwestycji w generatywną AI i poprawioną integracje z Microsoft Copilot.

Niektóre artykuły i zrzuty ekranów mogą odwoływać się do Power Virtual Agents podczas aktualizowania dokumentacji i zawartości szkoleniowej.

Po utworzeniu pomocnika Microsoft Copilot Studio jest on natychmiast dostępny w kanałach witryny demonstracyjnej i witryny niestandardowej dla każdego, kto zna identyfikator pomocnika. Te kanały są dostępne domyślnie i nie jest wymagana żadna konfiguracja.

Dla aplikacji Microsoft Teams aplikacji możesz skonfigurować zaawansowane opcje zabezpieczeń kanału internetowego.

Uwaga

W przypadku posiadania licencji tylko Teams, nie możesz tworzyć wpisów tajnych, aby umożliwić dostęp bezpieczny. Tokeny bezpiecznego dostępu są tworzone automatycznie dla użytkownika, a bezpieczny dostęp jest domyślnie włączony.

Użytkownicy mogą znaleźć identyfikator pomocnika bezpośrednio w Microsoft Copilot Studio lub otrzymują go od innego użytkownika. Jednak w zależności od możliwości i ważność to może być niepożądane.

Dzięki zabezpieczeniom opartym na Direct Line możesz umożliwić dostęp tylko do lokalizacji, które kontrolujesz, włączając bezpieczny dostęp za pomocą wpisów tajnych lub tokenów Direct Line.

Możesz także wymieniać i regenerować wpisy tajne i odświeżać tokeny, a także łatwo wyłączyć bezpieczny dostęp, jeśli nie chcesz już go używać.

Uwaga

Aplikacja Microsoft Copilot Studio używa kanału Bot Framework Direct Line w celu połączenia strony sieci Web lub aplikacji użytkownika z pomocnikiem.

Włączanie lub wyłączanie zabezpieczeń kanału internetowego

Można wymuszać korzystanie z tajnego wpisu i tokenu dla każdego pomocnika.

Po włączeniu tej opcji kanały muszą 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.

Dostęp do pomocnika, który nie zapewnia środków zabezpieczeń, nie będzie działał.

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

   

2. Włącz przełącznik Wymagaj bezpiecznego dostępu na Włączone.

   

Ostrzeżenie

Po włączeniu lub wyłączeniu opcji „Wymagaj bezpiecznego dostępu” rozpowszechnienie ustawień i ich zastosowanie może zająć systemowi do dwóch godzin. Do tego momentu poprzednie ustawienie będzie aktywne. Nie trzeba publikować pomocnika, aby ta zmiana zaczęła obowiązywać.

Należy planować z wyprzedzeniem, aby uniknąć niezamierzonego narażenia pomocnika.

Jeśli chcesz wyłączyć opcję zabezpieczeń kanału internetowego, możesz to zrobić, przełączając Wymagaj bezpiecznego dostępu na Wyłączony. Wyłączanie bezpiecznego dostępu może potrwać maksymalnie dwie godziny do propagowania.

Korzystanie z wpisów tajnych i tokenów

Tworząc aplikację typu usługa-usługa, najprostszym rozwiązaniem może być określenie wpisu tajnego w żądaniach nagłówka autoryzacji.

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 tajny wpis 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 konwersacji i wygasną, o ile nie zostaną odświeżone.

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

Ostrzeżenie

Zdecydowanie odradzamy ujawnianie tajnego wpisu w jakimkolwiek kodzie działającym w przeglądarce, zakodowanym na stałe lub przesłanym przez połączenie sieciowe.

Zabezpieczanie tokenu przy użyciu wpisu tajnego w kodzie usługi jest najbardziej bezpiecznym sposobem ochrony pomocnika Microsoft 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 sieci Web.

2. Wybierz Kopiuj dla Tajny wpis 1 lub Tajny wpis 2, aby skopiować do schowka. Wybierz ikonę widoczności ikona widoczności , aby odsłonić dany klucz tajny. Zanim będzie można go ujawnić, pojawi się ostrzeżenie.

Zamiana tajnych wpisów

Jeśli musisz zmienić wpis tajny używany przez pomocnika, możesz to zrobić bez przestojów i przerw.

Microsoft Copilot Studio dostarcza dwa tajne wpisy, które mogą pracować równocześnie. Możesz zamienić używany tajny wpis na inny. Gdy sekrety zostaną zamienione, a Twoi użytkownicy połączą się za pomocą nowego tajnego wpisu, możesz bezpiecznie odtworzyć sekret.

Wygeneruj ponownie wpis tajny

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

Ostrzeżenie

Każdy użytkownik połączony przy użyciu oryginalnego wpisu tajnego lub tokenu uzyskanego z tego wpisu tajnego zostanie odłączony.

Generowanie tokenu

Można wygenerować token, który może być używany podczas rozpoczynania jednokrotnej konwersacji z pomocnikiem. Aby uzyskać więcej informacji, zobacz sekcję Pobierz token Direct Line w artykule Dodawanie pomocnika do aplikacji mobilny i niestandardowych .

1. Uzyskiwanie tajnego wpisu.

2. Wyślij następujące żądanie w kodzie usługi, aby wymienić tajny wpis na token. Zamień <SECRET> na wartość wpisu tajnego uzyskanego w Kroku 1.

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

Poniższe fragmenty kodu zawierają przykłady wygenerowanego żądania tokenu i jego odpowiedzi.

Przykłady generowania żądania tokenu

POST https://directline.botframework.com/v3/directline/tokens/generate
Authorization: Bearer RCurR_XV9ZA.cwA.BKA.iaJrC8xpy8qbOF5xnR2vtCX7CZj0LdjAPGfiCpg4Fv0

Przykłady generowania odpowiedzi tokenu

HTTP/1.1 200 OK
[other headers]

{
  "conversationId": "abc123",
  "token": "RCurR_XV9ZA.cwA.BKA.iaJrC8xpy8qbOF5xnR2vtCX7CZj0LdjAPGfiCpg4Fv0y8qbOF5xPGfiCpg4Fv0y8qqbOF5x8qbOF5xn",
  "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ł dalej przydatny, należy odświeżyć token przed jego wygaśnięciem.

Odświeżanie tokenu

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

Nie można odświeżyć tokenu, który wygasł.

Aby odświeżyć token, należy wygenerować poniższe żądanie i zastąpić <TOKEN TO BE REFRESHED> tokenem, który ma być odświeżony.

POST https://directline.botframework.com/v3/directline/tokens/refresh
Authorization: Bearer <TOKEN TO BE REFRESHED>

Poniższe fragmenty zawierają przykłady żądania odświeżanie tokenu i odpowiedzi.

Przykładowe żądanie odświeżania

POST https://directline.botframework.com/v3/directline/tokens/refresh
Authorization: Bearer CurR_XV9ZA.cwA.BKA.iaJrC8xpy8qbOF5xnR2vtCX7CZj0LdjAPGfiCpg4Fv0y8qbOF5xPGfiCpg4Fv0y8qqbOF5x8qbOF5xn

Przykładowa odpowiedź odświeżania

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

Aby nowy token pozostał użyteczny, należy go ponownie odświeżyć, zanim wygaśnie.

HTTP/1.1 200 OK
[other headers]

{
  "conversationId": "abc123",
  "token": "RCurR_XV9ZA.cwA.BKA.y8qbOF5xPGfiCpg4Fv0y8qqbOF5x8qbOF5xniaJrC8xpy8qbOF5xnR2vtCX7CZj0LdjAPGfiCpg4Fv0",
  "expires_in": 1800
}

Aby uzyskać więcej informacji o odświeżaniu tokenu, zobacz sekcję Odświeżanie tokenu Direct Line w artykule Interfejs API Direct Line — uwierzytelnianie.

Powiązane artykuły

• Najważniejsze koncepcje — publikowanie pomocnika
• Dodawanie pomocnika do aplikacji mobilnych i niestandardowych (opartych na sieci Web lub macierzystych)
• Dodawanie pomocnika do kanałów usługi Azure Bot Service