Kertakirjautumisen määrittäminen Microsoft Entra ID avulla

Sovelluksen rekisteröintien luominen mukautettua verkkosivustoa varten

SSO:n konfigurointia varten luo kaksi erillistä sovellusrekisteröintiä:

• Todennussovelluksen rekisteröinti agentin Microsoft Entra ID:n käyttäjän todennusta varten.
• Pohjaan perustuvan sovelluksen rekisteröinti mukautettua verkkosivua varten.

Suojaussyistä älä käytä samaa sovelluksen rekisteröintiä uudelleen sekä agentillesi että mukautetulle sivustollesi.

1. Luo todennussovelluksen rekisteröinti noudattamalla ohjeita artikkelissa Käyttäjän todentamisen määrittäminen Microsoft Entra -tunnuksella.

2. Luo toinen sovellusrekisteröinti, joka toimii pohjaan perustuvan sovelluksen rekisteröintinä.

Tunnuksenvaihdon URL-osoitteen lisääminen

Käytä koko laajuuden URI-tunnistetta, jonka todennussovelluksen rekisteröinti näkyy tunnuksen vaihdon URL-osoitteena. Jos et ole luonut mukautettua scopea, toimi ensin ohjeen Määritä käyttäjän todentaminen Microsoft Entra ID:n avulla mukaan.

1. Siirry todennussovelluksen rekisteröintisivun Azure-portaalissa kohtaan Ohjelmointirajapinnan paljastaminen.

2. Valitse Vaikutusalueet-kohdassa Kopioi leikepöydälle -kuvake.

3. Valitse Copilot Studiossa Settings -kohdan siirtymisvalikosta Security ja valitse sitten Authentication -ruutu.

4. Liitä Tunnuksen vaihdon URL-osoite (vaaditaan kertakirjautumisessa) -kenttään aiemmin kopioimasi vaikutusalue.

5. Valitse Tallenna ja julkaise agenttisi.

Valtuuta pohjaan perustuva sovellus käyttämään todennussovelluksen laajuutta

1. Avaa Azure-portaalissa pohjaan perustuvan sovelluksen rekisteröinti ja valitse Yleiskatsaus.

2. Kopioi Sovelluksen (asiakkaan) tunnus -arvo kohdasta Essentials.

3. Avaa todennussovelluksen rekisteröinti ja valitse Hallitse>Näytä ohjelmointirajapinta.

4. Valitse Valtuutetut asiakassovellukset -kohdassa Lisää asiakassovellus.

5. Liitä Asiakasohjelman tunnus -kohtaan pohjaan perustuvan sovelluksen asiakasohjelman tunnus.

6. Valitse Valtuutetut laajuudet -kohdassa tunnuksen vaihtoa varten luotu laajuus ja valitse sitten Lisää sovellus.

Pohjaan perustuvan sovelluksen rekisteröinnin määrittäminen

1. Avaa pohjaan perustuvan sovelluksen rekisteröinti ja valitse Todentaminen.

2. Valitse Ympäristömääritykset-kohdassa Lisää ympäristö ja valitse sitten SPA.

3. Kirjoita Uudelleenohjauksen URI-osoitteet -kohtaan verkkosivusi URL-osoite. Esimerkki: https://www.contoso.com/index.html.

4. Ota Implisiittinen myöntäminen ja hybridityönkulku -osassa käyttöön Käyttöoikeustietueet (käytetään implisiittisiin työnkulkuihin) sekä ID-tunnukset (käytetään implisiittisiin ja hybridityönkulkuihin).

5. Valitse Määritä.

SSO-kirjautumisen määrittäminen verkkosivustolle

Käytä täydellistä Microsoft Entra ID:n SSO-näytettä, mukaan lukien sen kirjastot ja WWW-keskustelu -middleware. Seuraa esimerkin README-ohjetta ja päivitä konfiguraation paikkamerkit kohdassa index.html.

1. Avaa Azure-portaalissa pohjaan perustuvan sovelluksen rekisteröinti.

2. Yleiskatsauksessa kopioi Application (client) ID ja Directory (tenant) ID.

   

3. Korvaa esimerkin asiakasohjelman tunnuksen ja vuokraajan tunnuksen paikkamerkit pohjaan perustuvan sovelluksen rekisteröinnin arvoilla. Älä käytä todennussovelluksen asiakastunnusta tässä.

4. Korvaa token-päätepisteen paikkamerkki agentin token-päätepisteen URL-osoitteella.

5. Jos muokkaat käyttäjätunnusta, pidä se esimerkin 64 merkin rajan sisällä.

6. Tallenna tekemäsi muutokset.

7. Isännöi sivua rekisteröidyssä uudelleenohjauksen URL-osoitteessa. Kirjaudu sisään käyttämällä esimerkin kirjautumispainiketta ja aloita sitten keskustelu, joka vaatii todennuksen.

   Kun token-vaihto onnistuu, agentti ei pyydä sinua kirjautumaan uudelleen sisään tai kopioimaan vahvistuskoodia chattiin. Jos näin on, tarkista canvas-sovelluksen tunnisteet, valtuutettu käyttöalue, token-vaihdon URL-osoite ja agentin julkaiseminen.

   Note

   Esimerkin kirjautumispainike muodostaa alkuperäisen kirjautuneen istunnon. Tuotannossa sovelluksesi täytyy huolehtia ensimmäisestä kirjautumisesta. Pidä kirjautumisen varatoiminnon kortti saatavilla siltä varalta, että tunnuksen vaihto epäonnistuu.

Seuraavat menettelytavat määrittävät mukautetun sivustopohjan agentille, joka on luotu Teams-palvelupaketissa. Tämä ei ole Microsoft Teams -kanavan määritysmenettely.

Tekninen yleiskatsaus

Mukautetun pohjan SSO-kirjautuminen käyttää seuraavaa tunnuksen vaihdon työnkulkua:

1. Agentin käyttäjä kirjoittaa lauseen, joka käynnistää kirjautumisaiheen. Kirjautumisaihe on suunniteltu kirjaamaan käyttäjä sisään ja käyttämään käyttäjän todennettua tunnusta (User.AccessToken-muuttujaa).

2. Copilot Studio lähettää sisäänkirjautumiskehotteen, jotta käyttäjä voi kirjautua sisään määritetyn tunnistetietopalvelun avulla.

3. Agentin mukautettu pohja sieppaa kirjautumiskehotteen ja agentti pyytää Microsoft Entra ID:ltä OBO-tunnusta. Kaavio lähettää tunnuksen agentille.

4. Agentti vaihtaa OBO-tokenin käyttöoikeustokeniksi ja tallentaa sen User.AccessToken. Myös muuttuja User.IsLoggedIn määritetään tässä yhteydessä.

Sovelluksen rekisteröinnin luominen Microsoft Entra ID mukautettua pohjaa varten

SSO:n konfigurointiin tarvitset kaksi erillistä sovellusrekisteröintiä:

• Yhden agentin käyttäjän todennus Microsoft Entra ID:n avulla.
• Yksi SSO-kirjautumista varten mukautetussa pohjassa.

Sovelluksen rekisteröinnin luominen agentin kaaviolle

1. Kirjaudu sisään Azure-portaaliin.

2. Siirry kohtaan App registrations joko valitsemalla kuvake tai etsimällä yläreunan hakupalkista.

3. Valitse Uusi rekisteröinti.

4. Anna rekisteröinnille nimi. Käytä sen agentin nimeä, jonka kangasta olet rekisteröimässä ja johon sisältyy "kangas", jotta voit erottaa sen sovelluksen rekisteröinnistä todentamista varten.

   Jos agenttisi nimi esimerkiksi on Contoson myyntiapu, sovellusrekisteröinnin nimeksi voisi antaa ContosoSalesCanvas tai vastaavaa.

5. Valitse Tuetut tilityypit -kohdassa Tilit missä tahansa organisaation hakemistossa (mikä tahansa Microsoft Entra ID -hakemisto – palveluna tarjottava sovellus) ja henkilökohtaiset Microsoft-tilit (kuten skype, XBOX).

6. Jätä Uudelleenohjauksen URI -osa vielä tyhjäksi, koska syötät kyseiset tiedot seuraavissa vaiheissa. Valitse Rekisteröi.

7. Kun rekisteröinti on valmis, Yleiskatsaus-sivu avautuu. Siirry kohtaan Luettelo. Vahvista, että accessTokenAcceptedVersion-arvo on 2. Jos näin ei ole, muuta sen arvoksi 2 ja valitse sitten Tallenna.

Uudelleenohjauksen URL-osoitteen lisääminen

1. Kun rekisteröinti on auki, siirry kohtaan Todennus ja valitse sitten Lisää ympäristö.

2. Valitse Määritä ympäristöt -paneelissa Verkko.

3. Lisää kohtaan Uudelleenohjauksen URI-osoitteet täysi URL-osoite sille sivulle, jolla keskustelun kaaviota isännöidään. Valitse Implisiittinen myöntäminen -osassa valintaruudut ID-tunnukset ja Käyttöoikeustunnukset.

4. Vahvista muutoksesi valitsemalla Määritä.

5. Siirry Ohjelmointirajapintaoikeuksiin. Valitse Myönnä järjestelmänvalvojan suostumus vuokraajalle <your tenant name> ja sitten Kyllä.

   Important

   Jotta käyttäjien ei tarvitsisi antaa suostumusta jokaiseen sovellukseen, sovelluksen järjestelmänvalvojan tai pilvisovelluksen järjestelmänvalvojan on myönnettävä vuokraajanlaajuinen suostumus sovellusrekisteröinneillesi.

Mukautetun vaikutusalueen määrittäminen agentille

Määritä mukautettu laajuus todennussovelluksen rekisteröinnissä ja valtuuta pohjaan perustuva sovellus käyttämään sitä. Lisätietoja laajuuksista on kohdassa Microsoftin käyttäjätietoympäristön kehittäjien sanasto.

Tämä vaihe luo luottamussuhteen todennusta varten luotavan todennussovelluksen rekisteröinnin ja mukautetun kaavion sovellusrekisteröinnin välille.

1. Avaa sovellusrekisteröinti, jonka loit määrittäessäsi todennuksen.

2. Mene API-oikeuksiin ja varmista, että lisäät oikeat oikeudet agentillesi. Valitse Myönnä järjestelmänvalvojan suostumus vuokraajalle <your tenant name> ja sitten Kyllä.

   Important

   Jotta käyttäjien ei tarvitsisi antaa suostumusta jokaiseen sovellukseen, sovelluksen järjestelmänvalvojan tai pilvisovelluksen järjestelmänvalvojan on myönnettävä vuokraajanlaajuinen suostumus sovellusrekisteröinneillesi.

3. Siirry kohtaan Tarjoa ohjelmointirajapintaa ja valitse Lisää vaikutusalue.

4. Anna vaikutusalueen nimi sekä näyttötiedot, jotka käyttäjät näkevät tullessaan kertakirjautumisnäyttöön. Valitse Lisää vaikutusalue.

5. Valitse Lisää asiakassovellus -.

6. Syötä Yleiskatsaus-sivun Sovelluksen (asiakas) tunnus pohjaan perustuvan sovelluksen rekisteröintiä varten Asiakastunnus-kenttään. Valitse luomasi luettelon vaikutusalueen valintaruutu.

7. Valitse Lisää sovellus.

Todennuksen määrittäminen Copilot Studiossa SSO-kirjautumista varten

Käytä token-vaihto-URL-osoitetta Copilot Studio -todennuskonfiguraatiossa vaihtaaksesi OBO-tokenin pyydetyksi käyttöoikeustunnukseksi Bot Frameworkin kautta.

Copilot Studio kutsuu Microsoft Entra ID todellisen vaihdon suorittamiseksi.

1. Kirjaudu sisään Copilot Studioon.

2. Avaa agentti, jonka haluat konfiguroida.

3. Valitse siirtymisvalikon Asetukset-kohdasta Suojaus. Valitse sitten Todentaminen-kortti.

4. Kohdassa Token exchange URL syötä todennussovelluksen rekisteröinnin Expose an API -sivulta täydellinen käyttöalueen URI. Muoto on api://<AuthenticationAppClientId>/<ScopeName>.

5. Valitse Tallenna ja julkaise sitten agentin sisältö.

Mukautetun alustan HTML-kielen määrittäminen SSO-kirjautumista varten

Käytä täydellistä Microsoft Entra ID SSO -mallia osittaisten skriptifragmenttien yhdistämisen sijaan. Esimerkki sisältää Microsoft Authentication Library (MSAL) -määritykset, WWW-keskustelu -middleware-ohjelmiston ja token-vaihdon käsittelyn.

1. Määritä pohjaan perustuvan sovelluksen sovelluksen (asiakasohjelman) tunnus ja hakemiston (vuokraajan) tunnus noudattamalla esimerkin README-tiedoston ohjeita.

2. Määritä agentillesi token-päätepisteen URL-osoite. Älä rakenna token-päätepistettä agentin ID:stä.

3. Säilytä kirjautumiskortin varavaihtoehto, kun hiljainen tokenin hankinta tai token-vaihto epäonnistuu.

4. Isännöi sivua rekisteröidyssä uudelleenohjauksen URL-osoitteessa. Kirjaudu sisään käyttämällä esimerkin painiketta. Käynnistä sitten agenttiaihe, joka vaatii tunnistautumisen. Varmista, että onnistunut tunnuksen vaihto välttää toisen kirjautumiskehotteen tai vahvistuskoodin.

Täysi näytekoodi

Lue lisää Microsoft Entra ID SSO -näytteestä. Käytä sovelluksen rekisteröinti- ja konfigurointiohjeita, jotka vastaavat käyttöösi ottamasi esimerkin versiota.