Auktorisera en programbegäran med hjälp av Microsoft Entra-ID

Azure Web PubSub stöder Microsoft Entra-ID för auktorisering av begäranden från program.

Den här artikeln visar hur du konfigurerar din Web PubSub-resurs och kod för att auktorisera en begäran till en Web PubSub-resurs från ett Azure-program.

Registrera en app

Det första steget är att registrera ett Azure-program.

  1. I Azure Portal söker du efter och väljer sedan Microsoft Entra-ID.
  2. På den vänstra menyn under Hantera väljer du Appregistreringar.
  3. Välj Ny registrering.
  4. Som Namn anger du ett namn som ska användas för ditt program.
  5. Välj Registrera för att bekräfta programregistreringen.

Skärmbild som visar registrering av ett program.

När programmet har registrerats går du till programöversikten för att visa värdena för program-ID (klient)-ID och katalog-ID (klientorganisation). Du använder dessa värden i följande avsnitt.

Skärmbild som visar ett program.

Mer information om hur du registrerar ett program finns i snabbstarten Registrera ett program med hjälp av Microsofts identitetsplattform.

Lägg till autentiseringsuppgifter

Du kan lägga till både certifikat och klienthemligheter (en sträng) som autentiseringsuppgifter i din konfidentiella klientappregistrering.

Mer information om hur du lägger till autentiseringsuppgifter finns i Lägga till autentiseringsuppgifter.

Lägg till en klienthemlighet

Programmet kräver en klienthemlighet för att en klient ska kunna bevisa sin identitet när den begär en token.

Så här skapar du en klienthemlighet:

  1. På den vänstra menyn under Hantera väljer du Certifikat och hemligheter.

  2. På fliken Klienthemligheter väljer du Ny klienthemlighet.

    Skärmbild som visar hur du skapar en klienthemlighet.

  3. Ange en beskrivning för klienthemligheten och välj sedan en Förfallen tid för hemligheten.

  4. Kopiera värdet för klienthemligheten och klistra in den på en säker plats för senare användning.

    Kommentar

    Hemligheten visas bara när du skapar hemligheten. Du kan inte visa klienthemligheten i portalen senare.

Lägga till ett certifikat

Du kan ladda upp ett certifikat i stället för att skapa en klienthemlighet.

Skärmbild som visar uppladdning av ett certifikat.

Lägg till en rolltilldelning i Azure Portal

Det här avsnittet visar hur du tilldelar rollen Web PubSub-tjänstens ägare till tjänstens huvudnamn (program) för en Web PubSub-resurs.

Kommentar

Du kan tilldela en roll till valfritt omfång, inklusive hanteringsgrupp, prenumeration, resursgrupp och enskild resurs. Mer information om omfång finns i Förstå omfånget för rollbaserad åtkomstkontroll i Azure.

  1. I Azure Portal går du till din Web PubSub-resurs.

  2. På den vänstra menyn väljer du Åtkomstkontroll (IAM) för att visa inställningar för åtkomstkontroll för resursen.

  3. Välj fliken Rolltilldelningar och visa rolltilldelningarna i det här omfånget.

    Följande bild visar ett exempel på fönstret Åtkomstkontroll (IAM) för en Web PubSub-resurs:

    Skärmbild som visar ett exempel på fönstret Åtkomstkontroll (IAM).

  4. Välj Lägg till>Lägg till rolltilldelning.

  5. Välj fliken Roller och välj sedan Web PubSub-tjänstägare.

  6. Välj Nästa.

    Skärmbild som visar hur du lägger till en rolltilldelning.

  7. Välj fliken Medlemmar . Under Tilldela åtkomst till väljer du Användare, grupp eller tjänstens huvudnamn.

  8. Välj Välj medlemmar.

  9. Sök efter och välj det program som rollen ska tilldelas till.

  10. Välj Välj för att bekräfta markeringen.

  11. Välj Nästa.

    Skärmbild som visar hur du tilldelar en roll till tjänstens huvudnamn.

  12. Välj Granska + tilldela för att bekräfta ändringen.

Viktigt!

Azure-rolltilldelningar kan ta upp till 30 minuter att sprida.

Mer information om hur du tilldelar och hanterar Azure-rolltilldelningar finns i följande artiklar:

Kodexempel som använder Microsoft Entra-auktorisering

Hämta exempel som använder Microsoft Entra-auktorisering i våra fyra programmeringsspråk som stöds officiellt: