Jaa


Entra ID -sovelluksen määrittäminen

Jotta kuormituksesi toimisi Fabricissa, sinun on rekisteröitävä sovellus Microsoftin käyttäjätietoympäristössä, joka tunnetaan myös nimellä Microsoft Entra ID. Tämän sovelluksen avulla voit todentaa kuormituksesi Azuressa.

Edellytykset

Vaihe 1: Rekisteröi Entra ID -sovellus

Jos haluat luoda uuden Entra ID -sovelluksen, toimi seuraavasti:

  1. Kirjaudu sisään Microsoft Entra -hallintakeskukseen.

  2. Siirry kohtaan Identity > Applications > App registrations ja valitse Uusi rekisteröinti.

  3. Anna sovelluksen näyttönimi.

  4. Valitse Tuetut tilityypit -osassa Tilit missä tahansa organisaatiohakemistossa (mikä tahansa Microsoft Entra -tunnus vuokraaja – monivuokraaja).

  5. Valitse Rekisteröi.

Vaihe 2: Uudelleenohjauksen URI:n määrittäminen

Sinun on määritettävä uudelleenohjauksen URI-osoite URI:lle, joka sulkee sivun heti, kun siirryt siihen. Lisätietoja on kohdassa Uudelleenohjauksen URI-osoite (vastauksen URL-osoitteen) jäsennys ja rajoitukset.

Määritä Entra ID -sovelluksesi seuraavasti:

  1. Kirjaudu sisään Microsoft Entra -hallintakeskukseen.

  2. Siirry kohtaan Sovellukset > Sovelluksen rekisteröinti ja valitse sovelluksesi.

  3. Valitse Lisää uudelleenohjauksen URI-.

  4. Valitse Ympäristön kokoonpanot -kohdasta Lisää ympäristön.

  5. Valitse Määritä ympäristöt -ruudussa Yksisivuinen sovellus -.

  6. Lisää yksisivuisen sovelluksen -uudelleenohjauksen URI-osoite Uudelleenohjauksen URI-osoitteet -. esimerkkiesimerkkinä käyttää http://localhost:60006/close uudelleenohjauksen URI-osoitetta.

  7. Valitse Configure.

Vaihe 3: Tarkista, että sinulla on useita sovelluksia

Jos haluat varmistaa, että sovelluksesi on monitallennen sovellus, toimi seuraavasti.

  1. Kirjaudu sisään Microsoft Entra -hallintakeskukseen.

  2. Siirry kohtaan Sovellukset > Sovelluksen rekisteröinti ja valitse sovelluksesi.

  3. Valitse sovelluksessa Manage -osiosta Authentication.

  4. Varmista tuettujen tilityyppien , että kaikkien organisaatiohakemistojen tilit (mikä tahansa Microsoft Entra -vuokraaja – monivuokraaja) on valittuna. Jos se ei ole, valitse se ja valitse sitten Tallenna.

Vaihe 4: Anna sovellustunnuksen URI

Luo sovellustunnuksen URI käyttämällä tätä muotoa: api://localdevinstance/<tenant ID>/<workload name>/<(optional)subpath>. TUNNUKSEN URI-tunnus ei voi päättyä vinoviivaan.

  • Kuormituksen nimi – Kehitettävän kuormituksen nimi. Kuormituksen nimen on oltava sama kuin taustaluettelossa määritetyn WorkloadName -, ja nimeksi on syytä alkaa Org..
  • vuokraajan tunnus - Vuokraajatunnuksesi. Jos et tiedä, mikä vuokraajatunnuksesi on, katso Miten löydät Microsoft Entra -vuokraajatunnuksesi.
  • Subpath – (Valinnainen) Merkkijono, joka sisältää englanninkielisiä pieniä tai isoja kirjaimia, numeroita ja ajatusviivoja. Alipolkumerkkijono voi olla enintään 36 merkkiä pitkä.

Seuraavassa on esimerkkejä kelvollisista ja virheellisista URI-osoitteista, kun vuokraajatunnus on bbbbcccc-1111-dddd-2222-eeee3333ff, ja kuormituksen nimenä on Fabric.WorkloadSample:

  • kelvolliset URI-osoitteet

    • api://localdevinstance/bbbbcccc-1111-dddd-2222-eeee3333ffff/Org.WorkloadSample
    • api://localdevinstance/bbbbcccc-1111-dddd-2222-eeee3333ffff/Org.WorkloadSample/abc
  • virheelliset URI-osoitteet:

    • api://localdevinstance/bbbbcccc-1111-dddd-2222-eeee3333ffff/Org.WorkloadSample/af/
    • api://localdevinstance/bbbbcccc-1111-dddd-2222-eeee3333ffff/Org.WorkloadSample/af/a

Jos haluat lisätä sovellustunnuksen URI-tunnuksen sovellukseesi, toimi seuraavasti.

  1. Kirjaudu sisään Microsoft Entra -hallintakeskukseen.

  2. Siirry kohtaan Sovellukset > Sovelluksen rekisteröinti ja valitse sovelluksesi.

  3. Valitse sovelluksessasi Hallinta -osiossa Ohjelmointirajapinnan.

  4. Valitse Sovellustunnuksen URI-vieristä Lisää .

  5. Lisää sovellustunnuksen URI -ruudun Muokkaa sovellustunnusta -URI.

Vaihe 5: Lisää vaikutusalueita

Sinun on määritettävä vaikutusalueet (tunnetaan myös nimellä käyttöoikeudet) sovelluksellesi. Vaikutusalueiden avulla muut voivat käyttää sovelluksesi toimintoja. Esimerkiksi kuormitusmalli antaa neljä esimerkkiä ohjelmointirajapinnan käyttöoikeuksista, joita muut voivat käyttää. Voit nähdä nämä mallikäyttöoikeudet scopes.cs:

  • Item1.Read.All – Kuormituskohteiden lukemiseen

  • Item1.ReadWrite.All – Kuormituskohteiden lukemiseen ja kirjoittamiseen

  • FabricLakehouse.Read.All - Lakehouse-tiedostojen lukemiseen

  • FabricLakehouse.ReadWrite.All - Lakehouse-tiedostojen lukemiseen ja kirjoittamiseen

Jos haluat lisätä vaikutusalueita sovellukseesi, toimi seuraavasti.

  1. Kirjaudu sisään Microsoft Entra -hallintakeskukseen.

  2. Siirry kohtaan Sovellukset > Sovelluksen rekisteröinti ja valitse sovelluksesi.

  3. Valitse sovelluksessasi Hallinta -osiossa Ohjelmointirajapinnan.

  4. Valitse tämän ohjelmointirajapinnan määrittämienVaikutusalueet-kohdassa Lisää vaikutusalue.

  5. Valitse Lisää vaikutusalue ja noudata ohjeita kohdassa Lisää vaikutusalue.

Vaihe 6: Lisää asiakassovelluksia

Salli Fabricin pyytää tunnusta sovelluksellesi ilman käyttäjän suostumusta.

  1. Kirjaudu sisään Microsoft Entra -hallintakeskukseen.

  2. Siirry kohtaan Sovellukset > Sovelluksen rekisteröinti ja valitse sovelluksesi.

  3. Valitse sovelluksessasi Hallinta -osiossa Ohjelmointirajapinnan.

  4. Valitse tämän ohjelmointirajapinnan määrittämienVaikutusalueet-kohdassa Lisää vaikutusalue.

  5. Valitse Lisää asiakassovellus -.

  6. Lisää alla luetellut asiakassovellukset. Näiden sovellusten sovellustunnukset löytyvät usein käytettyjen Microsoft-sovellusten sovellustunnuksista. Sinun on lisättävä kukin asiakassovellus yksinään.

    • d2450708-699c-41e3-8077-b0c8341509aa – Fabric-asiakas taustatoimintoihin.
    • 871c010f-5e61-4fb1-83ac-98610a7e9110 – Fabric-asiakas edustatoimintoihin.

Vaihe 7: Ohjelmointirajapinnan käyttöoikeuksien lisääminen

Ohjelmointirajapinnan käyttöoikeuksien avulla sovellus voi käyttää ulkoisia palveluriippuvuuksia. Jos haluat lisätä ohjelmointirajapintakäyttöoikeuksia sovellukseesi, noudata ohjeita kohdassa Käyttöoikeuksien lisääminen sovellukseen.

Vaihe 8: Luo sovellukselle salainen koodi

Jos haluat määrittää taustan, sinun on määritettävä sovellukselle salauskoodi.

  1. Kirjaudu sisään Microsoft Entra -hallintakeskukseen.

  2. Siirry kohtaan Sovellukset > Sovelluksen rekisteröinti ja valitse sovelluksesi.

  3. Valitse sovelluksessasi Hallinta -osassa Varmenteet & salasanat.

  4. Valitse Client secretes - ja valitse sitten Uusi asiakassalaisuus -.

  5. Kirjoita Lisää asiakassalaisuus -ruudun seuraava:

    • Description – Nimi, jota haluat käyttää salaisuutena.
    • Vanhentuu - Valitse salaisen koodin vanhentumispäivä.
  6. Valitse Lisää.

Vaihe 9: Lisää idtyp-valinnainen vaatimus

Te idtypeväittää signaaleja, että tunnus, jonka kuormitus saa Fabricista, on vain sovellustunnus.

  1. Kirjaudu sisään Microsoft Entra -hallintakeskukseen.

  2. Siirry kohtaan Sovellukset > Sovelluksen rekisteröinti ja valitse sovelluksesi.

  3. Valitse sovelluksessa Hallinta -osassa tunnuksen määritys.

  4. Valitse Lisää valinnainen vaatimus.

  5. Valitse Lisää valinnainen vaatimus -ruudun -tunnustyypilleAccess.

  6. Valitse Ota-kohdassa idtyp.

  7. Valitse Lisää.