Bemærk
Adgang til denne side kræver godkendelse. Du kan prøve at logge på eller ændre mapper.
Adgang til denne side kræver godkendelse. Du kan prøve at ændre mapper.
Web- og Direct Line-kanalsikkerhed styrer, om klienter skal levere en Direct Line-hemmelighed eller token for at forbinde til din Copilot Studio-agent. Uden sikret adgang kan alle, der kender agent-id'et, oprette forbindelse via kanalerne Demo-hjemmesiden og Brugerdefineret hjemmeside.
Notat
I Teams-only oplevelsen kan du ikke generere secrets. Sikre adgangstokens oprettes automatisk, og sikret adgang er slået til som standard. Se Microsoft Produktvilkår for at få mere at vide om licenskrav.
Slå Kræv sikker adgang til for at kræve, at klienter præsenterer en hemmelighed eller et token. Disse godkendelsesoplysninger autoriserer adgang til Direct Line-kanalen; de autentificerer ikke slutbrugeren eller begrænser adgangen til en bestemt hjemmeside alene. Konfigurer brugerautentificering separat, når brugere skal logge ind.
Du kan bytte og gengenerere secrets, refresh-tokens eller slå sikker adgang fra, når det ikke længere er nødvendigt.
Copilot Studio bruger kanalen Bot Framework Direct Line til at forbinde din webside eller app med agenten.
Tænd eller sluk webkanalsikkerhed
Du kan gennemtvinge brugen af hemmeligheder og tokens for de enkelte agenter.
Når du aktiverer denne indstilling, skal kanaler have klienten til at godkende deres anmodninger enten ved hjælp af en hemmelighed eller ved hjælp af et token, der genereres ved hjælp af hemmeligheden, som hentes på kørselstidspunktet.
Forsøg på at få adgang til den agent, der ikke leverer denne sikkerhedsmåling, fungerer ikke.
Gå til siden Indstillinger for din agent, vælg Sikkerhed, og vælg derefter Webkanalsikkerhed.
Slå Kræv sikker adgang til.
Alarm
Når du slår Sikker adgang kræves til eller fra, kan det tage op til to timer, før de nye systemindstillinger træder i kraft. Indtil da er den forrige indstilling i kraft. Du behøver ikke at publicere agenten, for at ændringen kan træde i kraft.
Planlæg for at undgå at vise din agent utilsigtet.
For at slå webkanalsikkerhed fra, slå Kræver sikret adgang fra og bekræft ændringen. Ændringen kan tage op til to timer at træde i kraft.
Brug hemmeligheder eller tokens
For en service-to-service-app, angiv hemmeligheden i autorisationsheaderen for anmodninger fra din service.
Hvis du skriver en app, hvor klienten kører i en webbrowser eller mobil-app, eller hvis du på anden måde får vist koden, skal du sende bytte hemmeligheden til et token. Hvis du ikke bruger et token, kan din hemmelighed være blevet kompromitteret. Når du anmoder om at få et token i din tjeneste, skal du angive hemmeligheden i godkendelsesheaderen.
Tokens virker kun for en enkelt samtale og udløber, medmindre de opdateres.
Vælg den sikkerhedsmodel, der passer bedst til din situation.
Alarm
Vis ikke hemmeligheden i nogen kode, der kører i browseren, enten hard-coded eller overført via et netværksopkald.
Hentning af tokenet ved hjælp af hemmeligheden i tjenestekoden er den mest sikre måde at beskytte din Copilot Studio agent på.
Hent hemmelighederne
Du skal bruge hemmeligheden, så du kan specificere den i appens anmodninger om godkendelsesheadere eller lignende.
Vælg Sikkerhed under Indstillinger i navigationsmenuen. Vælg derefter feltet Webkanalsikkerhed.
Vælg Kopi for enten Hemmelighed 1 eller Hemmelighed 2 for at kopiere den til udklipsholderen. For at afsløre hemmeligheden skal du vælge synlighedsikonet og gennemgå advarselsprompten.
Bytte hemmeligheder
Hvis du har brug for at ændre den hemmelighed, som din agent bruger, kan du ændre den uden nedetid eller afbrydelse.
Copilot Studio giver dig to hemmeligheder, som fungerer samtidigt. Du kan bytte den hemmelighed, som din agent bruger, med den anden. Når hemmelighederne er blevet byttet om, og dine brugere alle har forbindelse ved hjælp af den nye hemmelighed, kan du genoprette hemmeligheden.
Gendan en hemmelighed
Hvis du vil gendanne en hemmelighed, skal du vælge Gendan ved siden af hemmeligheden.
Alarm
Forbindelsen til den brugerprofil, der oprettes forbindelse til, ved hjælp af den oprindelige hemmelighed eller et token, der er hentet fra den pågældende hemmelighed, afbrydes.
Generér et adgangstoken
Du kan generere et token til at starte en enkelt agent-samtale. Denne procedure udveksler en Direct Line secret for en samtaletoken i din servicekode. For Copilot Studio-token-endpoint-muligheden, lær mere i Get Direct Line token.
Send eksempelanmodningen om at generere token i din servicekode. Erstat
<DirectLineSecret>med hemmeligheden, du kopierede.
Eksempel på anmodning om generering af token
POST https://directline.botframework.com/v3/directline/tokens/generate
Authorization: Bearer <DirectLineSecret>
Eksempel på svar på generering af token
HTTP/1.1 200 OK
[other headers]
{
"conversationId": "abc123",
"token": "<DirectLineToken>",
"expires_in": 1800
}
Hvis anmodningen fuldføres, indeholder svaret et token, der er gyldigt for én samtale, og en expires_in-værdi, der angiver antallet af sekunder, indtil tokenet udløber.
Hvis tokenet skal være nyttigt, skal du opdatere tokenet , før det udløber.
Opdater et token
Du kan opdatere et token et ubegrænset antal gange, så længe det ikke er udløbet.
Du kan ikke opdatere et udløbet token.
Send anmodning om opdatering af eksempeldata. Erstat <DirectLineToken> med det uudløbne token, du vil forny. Brug konversationstokenet, ikke Direct Line-hemmeligheden.
Eksempel på anmodning om opdatering
POST https://directline.botframework.com/v3/directline/tokens/refresh
Authorization: Bearer <DirectLineToken>
Eksempel på svar vedrørende opdatering
Hvis anmodningen fuldføres, indeholder svaret et nyt token, der er gyldigt for den samme samtale som det forrige token, og en expires_in-værdi, der angiver antallet af sekunder, indtil det nye token udløber.
Hvis du vil bevare det nye token nyttigt, skal du opdatere tokenet igen, før det udløber.
HTTP/1.1 200 OK
[other headers]
{
"conversationId": "abc123",
"token": "<DirectLineToken>",
"expires_in": 1800
}
Lær mere i Refresh a Direct Line token.