Web- en Direct Line-kanaalbeveiliging configureren

Web- en Direct Line-kanaalbeveiliging bepaalt of clients een Direct Line-geheim of token moeten verstrekken om verbinding te maken met je Copilot Studio-agent. Zonder beveiligde toegang kan iedereen die de agent-ID kent verbinding maken via de Demo-website- en Custom website-kanalen.

Note

In de Teams-only ervaring kun je geen clientgeheimen genereren. Beveiligde toegangstokens worden automatisch aangemaakt en beveiligde toegang staat standaard aan. Voor licentievereisten, raadpleeg de Microsoft Product Terms.

Zet 'Beveiligde toegang vereisen' aan om clients te verplichten een geheim of token te tonen. Deze inloggegevens autoriseren toegang tot het Direct Line-kanaal; ze authenticeren de eindgebruiker niet en beperken de toegang tot een bepaalde website niet zelf. Configureer gebruikersauthenticatie afzonderlijk wanneer gebruikers moeten inloggen.

Je kunt geheimen omwisselen en regenereren, tokens verversen of beveiligde toegang uitschakelen wanneer deze niet meer nodig is.

Copilot Studio maakt gebruik van het kanaal Bot Framework Direct Line om uw webpagina of app te verbinden met de agent.

Zet webkanaalbeveiliging aan of uit

U kunt het gebruik van geheimen en tokens voor elke individuele agent afdwingen.

Wanneer u deze optie inschakelt, hebben kanalen de client nodig om hun aanvragen te verifiëren met behulp van een geheim of met behulp van een token dat wordt gegenereerd met behulp van het geheim, verkregen tijdens runtime.

Pogingen om zonder deze beveiligingsmaatregel toegang te krijgen tot de agent werken niet.

  1. Ga naar de pagina Instellingen voor uw agent, selecteer Beveiliging en selecteer vervolgens Webkanaalbeveiliging.

    Schermopname van webkanaalbeveiliging uitgelicht in de flyout 'Instellingen'.

  2. Schakel Beveiligde toegang vereist in.

Warning

Wanneer je Beveiligde toegang vereisen aan- of uitzet, kan het tot twee uur duren voordat de nieuwe systeeminstellingen van kracht worden. Tot die tijd is de vorige instelling van kracht. U hoeft de agent niet te publiceren om deze wijziging van kracht te laten worden.

Plan vooruit om te voorkomen dat uw agent onbedoeld zichtbaar wordt.

Om de beveiliging van webkanalen uit te schakelen, zet u 'Vereiste beveiligde toegang' uit en bevestigt u de wijziging. Het kan tot twee uur duren voordat de wijziging van kracht wordt.

Screenshot van de bevestiging dat het uitschakelen van beveiligde toegang de demowebsite en onbeveiligde Direct Line-kanalen beschikbaar maakt.

Geheimen of tokens gebruiken

Voor een service-to-service app specificeer je het geheim in de autorisatieheader van verzoeken van jouw service.

Als u een app schrijft waarbij de client wordt uitgevoerd in een webbrowser of mobiele app, of waarbij de code anders mogelijk zichtbaar is voor klanten, moet u uw secret inwisselen voor een token. Als u geen token gebruikt, kan uw secret worden aangetast. Wanneer u de aanvraag indient om het token in uw service op te halen, geeft u het geheim op in de autorisatie-header.

Tokens werken slechts voor één gesprek en vervallen tenzij ze worden vernieuwd.

Kies het beveiligingsmodel dat het beste bij uw situatie past.

Warning

Stel het geheim niet bloot in code die in de browser draait, hard gecodeerd of overgedragen via een netwerkoproep.

Het verkrijgen van het token met behulp van het geheim in uw servicecode is de veiligste manier om uw Copilot Studio-agent te beveiligen.

Geheimen verkrijgen

U hebt het clientgeheim nodig zodat u het kunt specificeren in verzoeken van uw app met een Authorization-header of iets dergelijks.

  1. Selecteer in het navigatiemenu onder Instellingen de optie Beveiliging. Selecteer vervolgens de tegel Beveiliging webkanaal.

  2. Selecteer Kopiëren voor Secret 1 of Secret 2 om het naar het klembord te kopiëren. Om het geheim te onthullen, selecteer je het zichtbaarheidsicoon en bekijk je de waarschuwingsprompt.

Secrets omwisselen

Als u het geheim wilt wijzigen dat door uw agent wordt gebruikt, kunt u het zonder downtime of onderbreking wijzigen.

Copilot Studio biedt u twee geheimen, die tegelijkertijd werken. U kunt het geheim uitwisselen dat uw agent gebruikt met de andere. Nadat de geheimen zijn gewisseld en uw gebruikers allemaal zijn verbonden met het nieuwe geheim, kunt u het geheim opnieuw genereren.

Geheim opnieuw genereren

Selecteer Opnieuw genereren naast het secret om een secret opnieuw te genereren.

Warning

Het gebruikersprofiel dat verbinding maakt met behulp van het oorspronkelijke geheim of een token dat is verkregen uit dat geheim, wordt verbroken.

Een token genereren

Je kunt een token genereren om een enkel agentgesprek te starten. Deze procedure wisselt een Direct Line secret in voor een conversatietoken in je servicecode. Voor de Copilot Studio token-eindpuntoptie lees meer over Get Direct Line token.

  1. Verkrijg het geheim.

  2. Stuur in je servicecode de voorbeeld-GenerateToken-aanvraag. Vervang <DirectLineSecret> door de geheimcode die je hebt gekopieerd.

Voorbeeld van een aanvraag om een token te genereren

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

Voorbeeld van respons voor genereren van token

HTTP/1.1 200 OK
[other headers]

{
  "conversationId": "abc123",
  "token": "<DirectLineToken>",
  "expires_in": 1800
}

Als het verzoek succesvol is, bevat de respons een token dat geldig is voor één gesprek en een waarde expires_in die het aantal seconden aangeeft totdat het token verloopt.

Als u het token nuttig wilt houden, moet u het token vernieuwen voordat het verloopt.

Een token vernieuwen

U kunt een token een onbeperkt aantal keren vernieuwen, zolang het niet is verlopen.

U kunt een verlopen token niet vernieuwen.

Stuur het voorbeeldvernieuwingsverzoek. Vervang <DirectLineToken> door het niet-verlopen token dat je wilt verversen. Gebruik het gesprekstoken, niet het Direct Line geheim.

Voorbeeld van vernieuwingsverzoek

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

Voorbeeld van refresh-respons

Als de aanvraag succesvol is, bevat de respons een nieuw token dat geldig is voor hetzelfde gesprek als het vorige token en een waarde expires_in die het aantal seconden aangeeft totdat het nieuwe token verloopt.

Als u het nieuwe token nuttig wilt houden, vernieuwt u het token opnieuw voordat het verloopt.

HTTP/1.1 200 OK
[other headers]

{
  "conversationId": "abc123",
  "token": "<DirectLineToken>",
  "expires_in": 1800
}

Lees meer in Refresh a Direct Line token.

  • Laatst bijgewerkt om