Verkon ja Direct Line kanavan suojauksen määrittäminen

Verkko- ja Direct Line -kanavan suojauksen ohjausobjektit määrittävät, onko asiakasohjelman toimitettava Direct Line -salasana tai -tunnus, jotta Copilot Studio -agentti voi muodostaa yhteyden. Ilman suojattua käyttöä kuka tahansa, joka tietää agentin tunnuksen, voi muodostaa yhteyden esittelysivuston ja mukautetun sivuston kanavien kautta.

Ota Vaadi suojattua käyttöä -kohta käyttöön, jotta asiakasohjelmien on annettava salasana tai tunnus. Nämä tunnistetiedot valtuuttavat pääsyn Direct Line -kanavalle; ne eivät todenna loppukäyttäjää tai rajoita pääsyä tiettyyn verkkosivustoon yksinään. Määritä käyttäjän todennus erikseen, kun käyttäjän on kirjauduttava sisään.

Voit vaihtaa salasanoja ja luoda niitä uudelleen, päivittää tunnuksia ja poistaa käytöstä suojatun käytön, kun sitä ei enää tarvita.

Copilot Studio yhdistää verkkosivun tai sovelluksen agenttiin Bot Framework Direct Line kanavan avulla.

Kytke verkkokanavan suojaus päälle tai pois

Voit pakottaa salasanojen ja tunnusten käytön kunkin yksittäisen agentin osalta.

Kun otat tämän asetuksen käyttöön, kanavat tarvitsevat asiakasta pyyntöjen todentamiseen joko salaisen koodin avulla tai käyttämällä tunnusta, joka luodaan käyttämällä suorituksen aikana saatua salaista koodia.

Yritykset käyttää agenttia ilman tätä suojauskeinoa eivät toimi.

1. Siirry agenttisi Asetukset-sivulle , valitse Suojaus ja valitse sitten Verkkokanavan suojaus.

   

2. Ota käyttöön Edellytä suojattua käyttöoikeutta.

Voit poistaa verkkokanavan suojauksen käytöstä poistamalla käytöstä Vaadi suojattua käyttöä -kohdan ja vahvistamalla muutoksen. Muutoksen voimaantulo voi kestää jopa kaksi tuntia.

Salasanojen tai tunnusten käyttö

Määritä palvelujen väliselle sovellukselle salasana palvelun pyyntöjen todennusotsikossa.

Jos kirjoitat sovellusta, jossa asiakas toimii verkkoselaimessa tai mobiilisovelluksessa tai koodi voi muuten olla näkyvissä asiakkaille, sinun on vaihdettava salasanasi tunnukseen. Jos et käytä tunnusta, salasanasi voi vaarantua. Kun teet pyynnön tunnuksen saamiseksi palvelussasi, määritä salasana todennusotsikossa.

Tunnukset toimivat vain yhdessä keskustelussa, ja ne vanhenevat, ellei niitä päivitetä.

Valitse tilanteeseen parhaiten sopiva suojausmalli.

Salasanojen hankkiminen

Tarvitset salasanan, jotta voit määrittää sen esimerkiksi sovelluksesi todennusotsikossa.

1. Valitse siirtymisvalikon Asetukset-kohdasta Suojaus. Valitse sitten Verkkokanavan suojaus -ruutu.

2. Kopioi joko Salasana 1 tai Salasana 2 leikepöydälle valitsemalla Kopioi. Salasana saadaan näkyviin valitsemalla näkyvyyskuvake ja tarkistamalla varoituskehote.

Salasanojen vaihtaminen

Jos sinun täytyy muuttaa agenttisi käyttämää salaisuutta, voit muuttaa sen ilman käyttökatkoja tai keskeytyksiä.

Copilot Studio tarjoaa kaksi salaista koodia, jotka toimivat samanaikaisesti. Voit vaihtaa agenttisi käyttämän salaisen koodin toiseen. Kun salaiset koodit on vaihdettu ja kaikki käyttäjät on yhdistetty käyttämällä uutta salaista salaista koodia, voit luoda salaisen koodin uudelleen.

Salaisen avaimen luominen uudelleen

Voit luoda salaisen avaimen uudelleen valitsemalla sen vierestä Luo uudelleen.

Tunnuksen luominen

Voit luoda tokenin, jolla voit aloittaa yhden agentin keskustelun. Tämä menettely vaihtaa Direct Line -salasanan keskustelutunnukseksi palvelukoodissa. Lisätietoja Copilot Studio -tunnuksen päätepisteen vaihtoehdoista on kohdassa Direct Line -tunnuksen hakeminen.

1. Salasanan hankkiminen.

2. Lähetä palvelukoodissasi esimerkkipyyntö tokenin luomiseen. Korvaa <DirectLineSecret> salaisuudella, jonka kopioit.

Esimerkki tunnuksenluontipyynnöstä

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

Esimerkki tunnuksenluontivastauksesta

HTTP/1.1 200 OK
[other headers]

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

Jos pyyntö onnistuu, vastaus sisältää tunnuksen, joka on voimassa yhtä keskustela varten, sekä expires_in-arvon, joka ilmaisee jäljellä olevien sekuntien määrän tunnuksen vanhenemiseen.

Tunnus on päivitettävä ennen sen vanhenemista, jotta tunnus on hyödyllinen.

Tunnuksen päivitys

Voit päivittää tunnuksen rajoittamattoman määrän kertoja, kunhan se ei ole vanhentunut.

Et voi päivittää vanhentunutta tunnusta.

Lähetä päivityspyyntöesimerkki. Korvaa <DirectLineToken> voimassa olevalla tunnuksella, jonka haluat päivittää. Käytä keskustelutunnusta, älä Direct Line -salaisuutta.

Esimerkki päivityspyynnöstä

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

Esimerkki päivitysvastauksesta

Jos pyyntö onnistuu, vastaus sisältää uuden tunnuksen, joka on voimassa samaa keskustela varten kuin edellinen tunnus, sekä expires_in-arvon, joka ilmaisee jäljellä olevien sekuntien määrän uuden tunnuksen vanhenemiseen.

Jotta uusi tunnus on hyödyllinen, päivitä tunnus uudelleen ennen sen vanhenemista.

HTTP/1.1 200 OK
[other headers]

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

Lue lisää kohdasta Direct Line -tunnuksen päivittäminen.

Liittyvät tiedot

• Keskeiset käsitteet – agentin julkaiseminen ja käyttöönotto
• Agentin julkaiseminen mobiilisovelluksiin tai mukautettuihin sovelluksiin
• Julkaise agentti Azure Bot Service kanaviin
• Käyttäjätodennuksen määrittäminen Copilot Studiossa
• Testaa keskusteluagentteja Direct Linen avulla