Självstudie: Registrera ett webb-API med Microsofts identitetsplattform

I den här självstudien lär du dig hur du registrerar ett webb-API i en Microsoft Entra-ID-klientorganisation. Du måste registrera ett program i administrationscentret för Microsoft Entra för att programmet ska kunna interagera med Microsofts identitetsplattform. I den här artikeln, du;

• Registrera ett webb-API i en klientorganisation
• Registrera webb-API:ets unika identifierare
• Exponera ett API genom att lägga till ett omfång

Förutsättningar

• Ett Azure-konto med en aktiv prenumeration. Skapa ett konto utan kostnad.
• Det här Azure-kontot måste ha behörighet att hantera program. Använd någon av följande roller som behövs för att registrera programmet:
  • Programadministratör
  • Programutvecklare
  • Molnprogramadministratör

Registrera program- och postidentifierare

Dricks

Stegen i den här artikeln kan variera något beroende på vilken portal du börjar från.

För att slutföra registreringen anger du ett namn för programmet och anger vilka kontotyper som stöds. När programmets översiktssida har registrerats visas de identifierare som behövs i programmets källkod.

1. Logga in på administrationscentret för Microsoft Entra som minst programutvecklare.

2. Om du har åtkomst till flera klienter använder du ikonen Inställningar på den översta menyn för att växla till den klientorganisation där du vill registrera programmet från menyn Kataloger + prenumerationer.

3. Bläddra till Identitetsprogram>> Appregistreringar.

4. Välj Ny registrering.

5. Ange ett namn för programmet, till exempel NewWebAPI1.

6. För Kontotyper som stöds väljer du Endast konton i den här organisationskatalogen. Om du vill ha information om olika kontotyper väljer du Alternativet Hjälp mig att välja .

7. Välj Registrera.

   

8. Programmets översiktsfönster visas när registreringen är klar. Registrera katalog-ID:t (klient)-ID:t och program-ID:t (klient) som ska användas i programmets källkod.

   

Kommentar

Kontotyper som stöds kan ändras genom att referera till Ändra konton som stöds av ett program.

Gör ett API tillgängligt

När API:et har registrerats kan du konfigurera dess behörighet genom att definiera de omfång som API:et exponerar för klientprogram. Klientprogram begär behörighet att utföra åtgärder genom att skicka en åtkomsttoken tillsammans med dess begäranden till det skyddade webb-API:et. Webb-API:et utför sedan endast den begärda åtgärden om den åtkomsttoken som den tar emot innehåller de nödvändiga omfången.

1. Under Hantera väljer du Exponera ett API > Lägg till ett omfång. Acceptera den föreslagna program-ID-URI:(api://{clientId}) n genom att välja Spara och fortsätta. {clientId} Kommer att vara värdet som registreras från översiktssidan. Ange sedan följande information:

   1. Som Omfångsnamn anger du Forecast.Read.
   2. För Vem kan samtycka kontrollerar du att alternativet Administratörer och användare är valt.
   3. I rutan Visningsnamn för administratörsmedgivande anger du Read forecast data.
   4. I rutan Beskrivning av administratörsmedgivande anger du Allows the application to read weather forecast data.
   5. I rutan Visningsnamn för användarmedgivande anger du Read forecast data.
   6. I rutan Beskrivning av användarmedgivande anger du Allows the application to read weather forecast data.
   7. Kontrollera att tillståndet är inställt på Aktiverad.

2. Välj Lägg till definitionsområde. Om omfånget har angetts korrekt visas det i fönstret Exponera ett API .

   

Nästa steg

Självstudie: Skapa ett ASP.NET Core-projekt och konfigurera API:et