Dela via


Ansluta till Eventstream med Microsoft Entra ID-autentisering

Anpassad slutpunkt är en särskild typ av Eventstream-källa eller mål som gör att ditt program kan skicka och hämta data från Eventstream. Den stöder två autentiseringsmetoder för att ansluta till ditt program: SAS-nycklar och Entra-ID-autentisering .

  • SAS-nyckelautentisering: Gör att du kan producera och använda Eventstream-data med hjälp av SAS-nycklar (Signatur för delad åtkomst).
  • Entra-ID-autentisering: Gör att ett säkerhetsobjekt (till exempel en användare eller ett huvudnamn för tjänsten) kan producera och använda Eventstream-data med Microsoft Entra ID-autentisering.

Den här artikeln beskriver hur du skapar ett program för tjänstens huvudnamn, konfigurerar Java-projektet i Visual Studio Code och ansluter till Eventstream med Microsoft Entra ID-autentisering.

Förutsättningar

Kontrollera att följande förutsättningar är uppfyllda innan du börjar:

  • Klientadministratören aktiverade följande inställning i administratörsportalen. Lära sig mer
    • Tjänsthuvudprincipaler kan anropa Fabrics offentliga API:er
  • Du har medlemsbehörigheter eller högre behörigheter på arbetsytan. Detta behövs för att hantera åtkomst till arbetsytan och tilldela nödvändiga behörigheter till huvudkontoappen för din tjänst.
  • En Eventstream-post i ditt arbetsyta med en anpassad slutpunktskälla. Mer information om hur du lägger till en anpassad slutpunkt i Eventstream finns i den här guiden .
  • Installera Visual Studio Code.
  • Konfigurera VS Code för Java-utveckling. Installera Kodningspaket för Java.

Steg 1: Skapa en tjänstens huvudanvändarapp

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

  2. Bläddra till Identitet>Program>Appregistreringar och välj Ny registrering.

  3. Ange ett visningsnamn för programmet.

  4. Öppna appen, kopiera klient-ID och klient-ID för senare användning.

    Skärmbild av app-ID.

  5. Gå till Certifikat och hemligheter, lägg till en ny klienthemlighet och kopiera värdet.

    Skärmbild av apphemlighet.

  6. När du är klar bör du ha följande tre informationspunkter klara:

    • Azure-klient-ID
    • Azure-hyresgäst-ID
    • Azure-klienthemlighet

Steg 2: Tilldela behörighet för Fabric-arbetsyta

  1. Gå till din Fabric-arbetsyta och välj Hantera åtkomst.

    Skärmbild av hantering av arbetsytans åtkomst.

  2. Sök efter programmet som skapades i föregående steg och tilldela rollen Medverkande (eller högre) till din app.

    Skärmbild av tilldelning av arbetsytebehörighet till en app.

Steg 3: Konfigurera projekt i VS Code

  1. Öppna terminalen i VS Code och ladda ned GitHub-projektet eller kör följande kommando för att klona projektet.

    git clone https://github.com/ruiminwang/eventstream-entra-id-auth-samples.git
    
  2. Installera Java och Maven. Om du inte har Java och Maven installerade använder du Scoop för att installera dem:

    # https://scoop.sh/
    Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
    Invoke-RestMethod -Uri https://get.scoop.sh | Invoke-Expression
    
    scoop bucket add java
    scoop install oraclejdk-lts
    scoop install maven
    
  3. Konfigurera miljövariabler. Konfigurera miljövariabler för din tjänsthuvudnamnsapp:

    $env:AZURE_CLIENT_ID="00001111-aaaa-2222-bbbb-3333cccc4444"
    $env:AZURE_TENANT_ID="aaaabbbb-0000-cccc-1111-dddd2222eeee"
    $env:AZURE_CLIENT_SECRET="Aa1Bb~2Cc3.-Dd4Ee5Ff6Gg7Hh8Ii9_Jj0Kk1Ll2"
    

Steg 4: Skapa och köra projektet

Skicka data till Eventstream

  1. I Eventstream lägger du till en anpassad slutpunkt som källa.

  2. Välj Anpassad endpoint>Entra ID-autentisering, kopiera följande information och klistra in den i ProducerSample.java-filen.

    • Namnområde för händelsehubb
    • Event Hub

    Skärmbild av producentexempelkoden i VS Code.

  3. Kör följande kommando för att skapa och köra projektet:

    mvn clean package
    
    java -cp .\target\EventHubOAuth-1.0-SNAPSHOT-jar-with-dependencies.jar com.microsoft.ProducerSample
    

Om data har skickats kan du gå till din händelseström och visa inkommande data.

Hämta data från Eventstream

  1. I Eventstream lägger du till en anpassad slutpunkt som mål.

  2. Välj Anpassad endpoint>Entra-ID-autentisering, kopiera följande information och klistra in den i ConsumerSample.java-filen:

    • Namnområde för händelsehubb
    • Event Hub
    • Konsumentgrupp

    Skärmbild av exempelkoden för konsumenter i VS Code.

  3. Kör följande kommando för att skapa och köra projektet:

    mvn clean package
    
    java -cp .\target\EventHubOAuth-1.0-SNAPSHOT-jar-with-dependencies.jar com.microsoft.ConsumerSample
    

När projektet har körts kan du visa inkommande data i ditt program.