Käyttäjän todentamisen määrittäminen Copilot Studiossa

Käyttäjän tunnistautuminen antaa käyttäjien kirjautua sisään, jotta agenttisi voi käyttää rajoitettuja resursseja tai tietoja heidän puolestaan. Käyttäjät voivat kirjautua sisään käyttämällä Microsoft Entra ID:tä tai OAuth 2.0 -identiteettipalveluntarjoajaa, kuten Googlea tai Facebookia.

Note

Microsoft Teams -käyttöönottoissa, jotka käyttävät manuaalista tunnistautumista, tarkista käyttöönottovaatimukset Configure SSO (single sign-on) -toiminnolla Microsoft Entra ID for agenteilla Teamsissa.

Voit lisätä käyttäjätodennuksen aiheisiin, kun muokkaat niitä.

Important

Todentamisen määritysten muutokset tulevat voimaan vasta, kun olet julkaissut agentin. Suunnittele etukäteen, ennen kuin teet todennusmuutoksia agentillesi.

Todennusvaihtoehdon valitseminen

Note

Tarkista seuraava Power BI integroinnin rajoitus ennen todentamisasetuksen valitsemista. Copilot Studio agentteja, jotka käyttävät Microsoft todentamista (Entra ID -tunnus), ei voi upottaa Power BI raportteihin iframe-pohjaisia visualisointeja käyttämällä.

Copilot Studio tukee useita todennusvaihtoehtoja. Valitse ja määritä tarpeita vastaava vaihtoehto.

  1. Siirry agenttisi kohtaan Asetukset ja valitse Suojaus.

  2. Valitse Todennus.

  3. Valitse todennusvaihtoehto ja määritä se tarvittaessa. Käytettävissä ovat seuraavat todennusvaihtoehdot:

  4. Valitse Tallenna.

Ei todennusta

Jos todennusta ei ole, agentti ei vaadi käyttäjiä kirjautumaan sisään, kun he ovat vuorovaikutuksessa agentin kanssa. Todentamaton määritys tarkoittaa, että agentti voi käyttää vain julkisia tietoja ja resursseja. Perinteiset keskustelubotit on määritetty oletusarvoisesti siten, että ne eivät vaadi todennusta.

Tämä vaihtoehto ei ole käytettävissä, kun Power Platformin hallintokeskuksessa on määritetty datapolitiikka vaatimaan tunnistautumista.

Varoitus

Kun valitaan Ei todennusta -asetus, kuka tahansa linkin omaava voi keskustella ja käyttää bottia tai agenttia.

Suosittelemme, että otat käyttöön todennuksen, erityisesti jos käytät bottiasi tai asiakaspalvelija organisaatiossasi tai tietyille käyttäjille, sekä muita suojaus- ja hallintotoimintoja.

Kirjaudu sisään Microsoft-tilillä

Important

Jos haluat julkaista sisäänrakennetun Teams + Microsoft 365 -kanavan kautta, käytä Authenticate with Microsoft -toimintoa. Jos autentikointiasetuksesi estää kanavan, tarkista agentin tila. Manuaaliseen todennuskäyttöönottoon Teamsissa noudata erillisiä Teamsin SSO- ja sovellusmanifestivaatimuksia.

Lisäksi Authenticate with Microsoft -vaihtoehtoa ei ole saatavilla agenteille, jotka integroituvat Dynamics 365 Customer Service kanssa.

Tämä asetus asettaa automaattisesti Microsoft Entra ID -tunnistautumisen Teamsille, SharePoint-, Power Apps- ja Microsoft Copilot-laitteille ilman manuaalista konfigurointia. Teamsissa käyttäjiä ei pyydetä kirjautumaan sisään, ellei agenttisi vaadi laajempaa toimintakykyä.

Jos tarvitset todennuksen muilla kanavilla, valitse Autentikointi manuaalisesti.

Jos valitset Authenticate with Microsoft, seuraavat muuttujat ovat käytettävissä aiheen luontikankaassa sekä web-sovelluksessa että Teams-suunnitelmassa:

  • User.Id
  • User.DisplayName

Verkkosovelluksessa User.IsLoggedIn on myös lisäprofiilimuuttujia. Teams-suunnitelmassa User.IsLoggedIn ei ole saatavilla tällä vaihtoehdolla. Lue lisää autentikointimuuttujista.

User.AccessToken ei ole saatavilla tämän vaihtoehdon kanssa. Jos tarvitset todennustunnuksen, käytä Authenticate manuaalisesti.

Jos vaihdat Autentikoidusta manuaalisesti Autentikointiin Microsoft:n kanssa, viittaukset User.AccessToken muuttuvat tuntemattomiksi muuttujiksi. Joukkueiden suunnitelmassa viittaukset User.IsLoggedIn muuttuvat myös tuntemattomiksi muuttujiksi. Korjaa mahdolliset aihevirheet ennen kuin julkaiset agenttisi.

Todenna manuaalisesti

Copilot Studio tukee seuraavia todentamispalveluntarjoajia Authenticate-kohdassa manuaalisesti -vaihtoehdossa:

  • Microsoft Entra ID V2 ja yhdistettyjä tunnistetietoja
  • Microsoft Entra ID V2 ja varmenteet
  • Microsoft Entra ID V2 ja asiakassalaisuudet
  • Microsoft Entra ID
  • Yleinen OAuth 2: Mikä tahansa identiteettipalveluntarjoaja, joka noudattaa OAuth 2.0 -standardia

Jos Todenna manuaalisesti, seuraavia muuttujia voi käytätä aiheen laatimiskaaviossa:

  • User.Id
  • User.DisplayName
  • User.AccessToken
  • User.IsLoggedIn

Lue lisää näistä muuttujista kohdasta Lisää käyttäjän tunnistautuminen aiheisiin.

Note

  • Tunnistautumisen muutokset astuvat voimaan vasta agentin julkaisun jälkeen.
  • Tätä asetusta hallitaan vastaavalla järjestelmänvalvojan ohjausobjektilla Power Platformissa. Kun kytket ohjaimen päälle, se estää Authenticate manual-vaihtoehdon kytkemisen päälle tai pois Copilot Studio:ssa. Ohjausobjekti on aina käytössä, eikä Authenticate manuaalisesti asetusta voi muokata Copilot Studiossa.

Pakollinen käyttäjän kirjautuminen ja agentin jakaminen

Vaadi käyttäjien kirjautumista -asetus määrittää, tarvitseeko käyttäjän kirjautua sisään ennen kuin keskustelee agentin kanssa. Ota tämä asetus käyttöön agenteille, joiden on käytettävä arkaluonteisia tai rajoitettuja tietoja.

Tämä vaihtoehto ei ole käytettävissä vaihtoehtojen Ei todennusta ja Käytä Microsoft -todennusta -vaihtoehtojen osalta.

Note

Et voi poistaa tätä asetusta käytöstä, kun Power Platform -hallintakeskuksen tietokäytäntö on määritetty edellyttämään todentamista. Lisätietoja on artikkelissa Agenttien tietokäytäntöjen määrittäminen.

Jos poistat tämän vaihtoehdon käytöstä, agentti ei pyydä käyttäjiä kirjautumaan, ennen kuin se kohtaa aiheen, joka edellyttää sitä.

Kun otat tämän vaihtoehdon käyttöön, luodaan järjestelmän aihe nimeltä Vaadi käyttäjien kirjautuminen. Tämä aihe koskee vain todennusasetusta Todenna manuaalisesti. Automaattiseen kirjautumiseen tuettuihin Teams-keskusteluihin käytä Authenticate with Microsoft -toimintoa.

Edellytä käyttäjiä kirjautumaan automaattisesti -aihe käynnistyy jokaiselle käyttäjälle, joka puhuu agentille todentamatta häntä. Jos käyttäjä ei kirjaudu sisään, aihe ohjaa uudelleen Eskaloi-järjestelmän aiheeseen.

Kyseinen aihe on vain lukuoikeudella, eikä sitä voi mukauttaa. Voit tarkastella sitä valitsemalla Siirry laatimispohjaan.

Sen hallitseminen, ketkä organisaation jäsenet voivat keskustella agentin kanssa

Agentin todennustyypin ja Require users to sign -asetuksen yhdistelmä määrittää, voitko jakaa agentin ja hallita, ketkä organisaatiossasi voivat keskustella sen kanssa. Todennusasetus ei vaikuta agentin jakamiseen yhteistyötä varten.

  • Ei todentamista: Kuka tahansa käyttäjä, jolla on linkki agenttiin (tai joka voi löytää sen esimerkiksi sivustostasi), voi keskustella sen kanssa. Et voi hallita, ketkä organisaation käyttäjät voivat keskustella agentin kanssa.

  • Todennus Microsoft:n kanssa: Agentti käyttää Microsoft Entra ID -tunnistautumista Teamsissa, SharePoint-, Power Apps- ja Microsoft Copilot-palveluissa. Käyttäjät ovat jo kirjautuneina sisään, joten et voi määrittää Vaadi käyttäjien kirjautumista erikseen. Voit käyttää agentin jakamista hallitaksesi, ketkä organisaation käyttäjät voivat keskustella agentin kanssa.

  • Todenna manuaalisesti:

    • Jos palveluntarjoaja on Microsoft Entra ID, voit ottaa Suosita käyttäjiä kirjautumaan sisään hallitaksesi sitä, kuka organisaatiossasi voi keskustella agentin kanssa agenttien jakamisen avulla.

    • Jos palveluntarjoaja on Generic OAuth 2, voit kytkeä Vaadi käyttäjien kirjautumista päälle tai pois päältä. Kun se on käytössä, sisään kirjautuva käyttäjä voi keskustella agentin kanssa. Et voi hallita, ketkä yksittäiset organisaation käyttäjät voivat keskustella agentin kanssa käyttäen agentin jakamista.

Kun agentin todennusasetuksella ei mahdollista sen hallintaa, ketkä voivat keskustella agentin kanssa ja agentin yhteenvetosivulla valitaan Jaa, avautuva sanoma ilmoittaa, että kuka tahansa voi keskustella agentin kanssa.

Manuaalisen todentamisen kentät

Seuraavassa taulukossa kuvataan kentät, joita voit kohdata manuaalista todentamista määritettäessä. Näkyviin tulevat kentät määräytyvät valitun palveluntarjoajan mukaan.

Kentän nimi Kuvaus
Todennuksen URL-malli Tunnistetietopalvelusi määrittämä URL-todennusmalli. Esimerkki: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Todennuksen URL-kyselymerkkijonon malli Tunnistetietopalvelun määrittämä todennuksen kyselymalli. Kyselymerkkijonomallin avaimet vaihtelevat tunnistetietopalvelun mukaan (?client_id={ClientId}&response_type=code&redirect_uri={RedirectUrl}&scope={Scopes}&state={State}).
Asiakkaan tunnus Tunnistetietopalvelulta saatu asiakasohjelman tunnus.
Asiakassalaisuus Asiakasohjelman salasana, jonka saat, kun luot tunnistetietopalvelun sovelluksen rekisteröinnin.
Asiakasohjelman varmenteen KeyVaultin URL-osoite Sen KeyVaultin URL-osoite, johon asiakasvarmenne on tallennettu. Pakollinen Microsoft Entra ID, kun varmenteet on todennettu.
Myönnön tyyppi Se OAuth 2.0 -apurahatyyppi, jota haluat käyttää.
Onko x5c-vaatimus pakollinen? Määritetään, onko x5c-vaatimus pakollinen tunnuspyynnössä. Pakollinen Microsoft Entra ID, kun varmenteet on todennettu.
Sisäänkirjautumisen URL-osoite URL-osoite, johon käyttäjät on suunnattu kirjautumaan sisään.
Päivitä sisällön malli Päivitysruumiin malli (refresh_token={RefreshToken}&redirect_uri={RedirectUrl}&grant_type=refresh_token&client_id={ClientId}&client_secret={ClientSecret}).
URL-kyselymerkkijonon mallin päivittäminen Tunnuksen URL-osoitteen päivityksen URL-osoitteen kyselymerkkijonon erottaja, joka on yleensä kysymysmerkki (?).
Päivitä URL-mallipohja Päivityksen URL-osoitteen malli, kutenhttps://login.microsoftonline.com/common/oauth2/v2.0/token.
Resurssin URL-osoite Sen resurssin URL-osoite, johon tunnusta pyydetään.
Vaikutusalueen luettelon erotin Vaikutusalueen luettelon erotinmerkki. Välilyöntejä ei tueta tässä kentässä.1
Laajuudet Niiden vaikutusalueiden luettelo, jotka haluat käyttäjillä olevan, kun he ovat kirjautuneet sisään. Käytä Vaikutusalueen luettelon erotin -merkkiä useiden vaikutusalueiden erottamiseen.1 Määritä vain tarpeelliset vaikutusalueet ja noudata vähimpien käyttöoikeuksien käyttöoikeudenhallintaperiaatetta.
Palveluntarjoaja Palveluntarjoaja, jota haluat käyttää todennukseen. Lue lisää OAuthin geneeristen lääkäreiden palveluntarjoajista.
Vuokraajan tunnus Microsoft Entra ID vuokraajan tunnus. Lue lisää kohdasta Kuinka löytää Microsoft Entra -vuokralaistunnuksesi.
Tunnuksen sisältömalli Tunnuksen kehysmalli. (code={Code}&grant_type=authorization_code&redirect_uri={RedirectUrl}&client_id={ClientId}&client_secret={ClientSecret})
Tunnuksen vaihdon URL-osoite (pakollinen kertakirjautumista (SSO) varten) Vaaditaan, kun konfiguroit yksittäisen kirjautumisen; muuten valinnainen.
Tunnuksen URL-malli Tunnistetietopalvelun antama tunnusten URL-malli, kuten https://login.microsoftonline.com/common/oauth2/v2.0/token
Tunnuksen URL-kyselymerkkijonon malli Tunnuksen URL-osoitteen kyselymerkkijonon erottaja, joka on yleensä kysymysmerkki (?).

1 Voit käyttää välilyöntejä Vaikutusalueet-kentässä, jos tunnistetietopalvelu edellyttää sitä. Kirjoita tällöin pilkku (,) kohtaan Vaikutusalueen luettelon erotin ja kirjoita välilyöntejä Vaikutusalueet-kenttään.

Todennuksen käytöstä poistaminen

  1. Kun agentti on avoinna, valitse Asetukset ylävalikkorivillä.

  2. Valitse Suojaus ja sitten Todentaminen.

  3. Valitse Ei todennusta.

    Jos aiheessa käytetään todennusmuuttujia, niistä tulee tuntemattomia muuttujia. Siirry Aiheet-sivulle katsomaan, missä aiheissa on virheitä, ja korjaa virheet ennen julkaisemista.

  4. Valitse Tallenna ja julkaise agentti.

Important

Jos agentillasi on työkaluja, jotka vaativat käyttäjätunnuksia, älä poista tunnistautumista pois päältä agenttitasolla. Tämä toiminto estää näiden työkalujen toiminnan.

  • Viimeksi päivitetty