Konfigurere nett- og Direct Line kanalsikkerhet

Web- og Direct Line-kanalsikkerhet styrer om klientene må oppgi en Direct Line-hemmelighet eller token for å koble til din Copilot Studio-agent. Uten sikker tilgang kan hvem som helst som kjenner agent-ID-en, koble seg til via kanalene Demonettsted og Egendefinert nettsted.

Note

I Teams-only-opplevelsen kan du ikke generere secrets. Sikre tilgangstokener opprettes automatisk, og sikker tilgang er aktivert som standard. Når det gjelder lisenskrav, se Microsoft Product Terms.

Aktiver Krev sikker tilgang for å kreve at klientene presenterer en hemmelighet eller et token. Denne påloggingsinformasjonen autoriserer tilgang til Direct Line-kanalen. Den autentiserer ikke sluttbrukeren eller begrenser tilgangen til et bestemt nettsted i seg selv. Konfigurer brukerautentisering separat når brukere trenger å logge inn.

Du kan bytte og regenerere hemmeligheter, oppdatere tokener eller deaktivere sikret tilgang når det ikke lenger trengs.

Copilot Studio bruker Bot Framework Direct Line kanal til å koble nettsiden eller appen til agenten.

Slå nettkanalsikkerheten av eller på

Du kan fremtvinge bruk av hemmeligheter og tokener for hver enkelt agent.

Når du aktiverer dette alternativet, trenger kanaler klienten til å godkjenne forespørslene sine enten ved hjelp av en hemmelighet eller ved hjelp av et token som genereres ved hjelp av hemmeligheten, innhentet ved kjøring.

Forsøk på å få tilgang til agenten som ikke gir dette sikkerhetstiltaket, fungerer ikke.

  1. Gå til Innstillinger-siden for agenten din, velg Sikkerhet, og velg deretter Nettkanalsikkerhet.

    Skjermbilde av webkanalsikkerhet uthevet på undermenyen Innstillinger.

  2. Aktiver Krev sikret tilgang.

Advarsel!

Når du slår Krev sikker tilgang på eller av, kan det ta opptil to timer før de nye systeminnstillingene trer i kraft. Frem til da trer den forrige innstillingen i kraft. Du trenger ikke å publisere agenten for at denne endringen skal tre i kraft.

Planlegg på forhånd for å unngå å utsette agenten utilsiktet.

For å slå av nettkanalsikkerhet, slå av Krev sikker tilgang og bekreft endringen. Endringen kan ta opptil to timer før den trer i kraft.

Skjermbilde av bekreftelsen på at det å slå av sikret tilgang gjør demonettstedet og usikrede Direct Line-kanaler tilgjengelige.

Bruke hemmeligheter eller tokener

For en tjeneste-til-tjeneste-app, spesifiser hemmeligheten i autorisasjonsheaderen for forespørsler fra tjenesten din.

Hvis du skriver en app der klienten kjører i en nettleser eller mobilapp, eller det kan hende at koden på en annen måte er synlig for kundene, må du bytte hemmeligheten mot et token. Hvis du ikke bruker et token, kan hemmeligheten bli kompromittert. Når du utfører forespørselen om å hente tokenet i servicen, angir du hemmeligheten i autorisasjonshodet.

Tokener fungerer bare for én diskusjon og utløper med mindre de oppdateres.

Velg sikkerhetsmodellen som fungerer best for din situasjon.

Advarsel!

Ikke vis hemmeligheten i noen kode som kjører i nettleseren, enten hardkodet eller overført via et nettverksanrop.

Å anskaffe tokenet ved hjelp av hemmeligheten i tjenestekoden er den sikreste måten å beskytte din Copilot Studio agent på.

Få hemmelighetene

Du trenger hemmeligheten, slik at du kan angi den i appens autorisasjonshodeforespørsler eller lignende.

  1. Velg Sikkerhet under Innstillinger på navigasjonsmenyen. Velg deretter flisen Nettkanalsikkerhet.

  2. Velg Kopier for Hemmelighet 1 eller Hemmelighet 2 for å kopiere den til utklippstavlen. For å avsløre hemmeligheten, velg synlighetsikonet og se advarselsmeldingen.

Bytt hemmeligheter

Hvis du trenger å endre hemmeligheten som agenten din bruker, kan du endre den uten nedetid eller avbrudd.

Copilot Studio gir deg to hemmeligheter, som fungerer samtidig. Du kan bytte hemmeligheten som agenten din bruker med den andre. Når hemmelighetene er byttet, og alle brukerne er tilkoblet ved hjelp av den nye hemmeligheten, kan du regenerere hemmeligheten.

Generer en hemmelighet på nytt

Hvis du vil generere en hemmelighet på nytt, velger du Generer på nytt ved siden av hemmeligheten.

Advarsel!

Brukerprofilen som kobles til ved hjelp av den opprinnelige hemmeligheten eller et token hentet fra denne hemmeligheten, kobles fra.

Generer et token

Du kan generere en token for å starte en enkelt agentsamtale. Denne prosedyren bytter en Direct Line-secret mot en samtaletoken i tjenestekoden din. For alternativet for Copilot Studio-tokenendepunkt kan du lese mer i Get Direct Line token.

  1. Få hemmeligheten.

  2. Send eksempelforespørselen for å generere token i tjenestekoden din. Bytt ut <DirectLineSecret> med hemmeligheten du kopierte.

Eksempel på forespørsel av generering av token

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

Eksempel på svar for token-generering

HTTP/1.1 200 OK
[other headers]

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

Hvis forespørselen er vellykket, inneholder svaret et token som er gyldig for én diskusjon, og en expires_in-verdi som angir antall sekunder til tokenet utløper.

Hvis du vil beholde tokenet nyttig, må du oppdatere tokenet før det utløper.

Oppdatere et token

Du kan oppdatere et token et ubegrenset antall ganger, så lenge det ikke er utløpt.

Du kan ikke oppdatere et utløpt token.

Send eksempeloppdateringsforespørselen. Erstatt <DirectLineToken> med det ikke-utgåtte tokenet du ønsker å oppdatere. Bruk samtaletokenet, ikke Direct Line Secret.

Eksempel på oppdateringsforespørsel

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

Eksempel på oppdateringssvar

Hvis forespørselen er vellykket, inneholder svaret et nytt token som er gyldig for samme diskusjon som det forrige tokenet, og en expires_in-verdi som angir antall sekunder til det nye tokenet utløper.

Hvis du vil holde det nye tokenet nyttig, oppdaterer du tokenet på nytt før det utløper.

HTTP/1.1 200 OK
[other headers]

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

Lær mer i Refresh a Direct Line token.

  • Sist oppdatert