Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
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ą.
Przejdź do strony Ustawienia agenta, wybierz pozycję Zabezpieczenia, a następnie wybierz pozycję Zabezpieczenia kanału internetowego.
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ć.
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.
W menu nawigacji, w sekcji Ustawienia wybierz Zabezpieczenia. Następnie wybierz kafelek Zabezpieczenia kanału internetowego.
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.
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.