Microsoft Entra SDK dla AgentID: Przegląd

Microsoft Entra SDK dla AgentID to usługa sieciowa oparta na kontenerach, która obsługuje pozyskiwanie tokenów, ich walidację i bezpieczne wykonywanie połączeń z interfejsem API podrzędnym. Działa jako kontener pomocniczy w połączeniu z aplikacją, co umożliwia odciążenie logiki uwierzytelniania do dedykowanej usługi. Scentralizowanie operacji tożsamości w zestawie Microsoft Entra SDK for AgentID eliminuje konieczność osadzania złożonej logiki zarządzania tokenami w każdej usłudze, zmniejszając duplikację kodu i potencjalne luki w zabezpieczeniach.

Jeśli tworzysz za pomocą platformy Kubernetes, konteneryzowanych usług z platformą Docker lub nowoczesnych mikrousług na platformie Azure, zestaw Microsoft Entra SDK for AgentID zapewnia ustandaryzowany sposób obsługi uwierzytelniania i autoryzacji w aplikacjach natywnych dla chmury.

Co to jest Microsoft Entra SDK dla AgentID?

Zestaw Microsoft Entra SDK for AgentID komunikuje się z aplikacją za pośrednictwem interfejsu API HTTP na potrzeby uwierzytelniania i autoryzacji, zapewniając spójne wzorce integracji niezależnie od stosu technologii. Zamiast osadzać logikę tożsamości bezpośrednio w kodzie aplikacji, zestaw Microsoft Entra SDK for AgentID obsługuje zarządzanie tokenami, walidację i wywołania interfejsu API za pośrednictwem standardowych żądań HTTP.

Takie podejście umożliwia architektury mikrousług wielolotowych, w których można pisać różne usługi w języku Python, Node.js, Go, Java i innych przy zachowaniu spójnych wzorców uwierzytelniania.

Typowa architektura jest następująca:

Aplikacja kliencka → interfejs API sieci Web → Microsoft Entra SDK for AgentID → Microsoft Entra ID

Aby uzyskać najnowsze tagi obrazu kontenera i wersji, zobacz Obraz kontenera , aby rozpocząć pracę.

Zabezpieczenia

Upewnij się, że wdrożenie zestawu Microsoft Entra SDK dla identyfikatora AgentID jest zgodne z najlepszymi rozwiązaniami dotyczącymi bezpiecznej operacji. Zestaw SDK musi działać w środowisku konteneryzowanym z ograniczonym dostępem do sieci, aby zapobiec nieautoryzowanemu dostępowi. Uwidacznianie interfejsu API zestawu SDK publicznie może prowadzić do luk w zabezpieczeniach, takich jak nieautoryzowane pozyskiwanie tokenów.

Zapoznaj się z najlepszymi rozwiązaniami dotyczącymi zabezpieczeń , aby zapewnić najlepsze rozwiązania dotyczące zaleceń dotyczących zabezpieczeń sieci, poświadczeń i środowiska uruchomieniowego.

Szybki start

Aby rozpocząć pracę z zestawem Microsoft Entra SDK for AgentID, zalecane są następujące kroki:

1. Wybieranie wdrożenia — wybierz pozycję Kubernetes, Docker lub AKS
2. Konfigurowanie ustawień — konfigurowanie zmiennych środowiskowych
3. Wybierz scenariusz — postępuj zgodnie z przykładem z przewodnikiem
4. Wdrażanie w środowisku produkcyjnym — przegląd najlepszych rozwiązań w zakresie zabezpieczeń

Najważniejsze korzyści

Architektura oddziela kwestie związane z tożsamością od logiki biznesowej, zapewniając następujące korzyści:

Kiedy używać Microsoft Entra SDK dla AgentID lub Microsoft.Identity.Web

Aby uzyskać szczegółowe wskazówki dotyczące wyboru między dwoma podejściami, zobacz Porównanie z witryną Microsoft.Identity.Web .

Walidacja tokenu

Zestaw Microsoft Entra SDK dla AgentID weryfikuje zarówno tokeny dostępu, jak i tokeny identyfikacyjne wystawione przez Microsoft Entra ID, weryfikując ich podpisy względem publicznych kluczy Microsoft Entra ID, sprawdzając czasy wygaśnięcia oraz upewniając się, że tokeny są przeznaczone dla twojej aplikacji. Po zweryfikowaniu można wyodrębnić oświadczenia użytkownika, role i zakresy, aby podejmować świadome decyzje dotyczące autoryzacji w ramach logiki aplikacji.

Tworzenie nagłówka dla pozyskiwania tokenu i autoryzacji

• Przepływ On-Behalf-Of OAuth 2.0 — delegowanie kontekstu użytkownika do docelowych interfejsów API
• Poświadczenia klienta — uwierzytelnianie aplikacji do aplikacji
• Tożsamość zarządzana — natywne uwierzytelnianie usługi platformy Azure
• Tożsamość agenta — wzorce autonomicznych lub delegowanych agentów

Wywołania interfejsu API podrzędnego

• Automatyczne uzyskiwanie i dołączanie tokenów
• Opcjonalne zastąpienia żądania (zakresy, metoda, nagłówki)
• Obsługa podpisanych żądań HTTP (PoP/SHR)

Scenariusze i samouczki

Poniższe przewodniki to kompleksowe samouczki krok po kroku z praktycznymi przykładami kodu pokazującymi, jak zintegrować zestaw Microsoft Entra SDK for AgentID z aplikacjami. Każdy scenariusz zawiera kompletne przykłady żądań/odpowiedzi, fragmenty kodu i wzorce implementacji dostosowane do różnych języków programowania i struktur.

Wzorce architektury

Typowy przepływ, w którym klient wywołuje internetowy interfejs API, interfejs API deleguje operacje tożsamości do zestawu Microsoft Entra SDK dla identyfikatora AgentID za pośrednictwem punktów końcowych HTTP. Zestaw SDK weryfikuje tokeny przychodzące przy użyciu punktu końcowego /Validate, uzyskuje tokeny przy użyciu /AuthorizationHeader i /AuthorizationHeaderUnauthenticated, i może bezpośrednio wywoływać dalsze interfejsy API przy użyciu /DownstreamApi i /DownstreamApiUnauthenticated.

Wchodzi w interakcję z identyfikatorem Entra firmy Microsoft na potrzeby wystawiania tokenów i pobierania metadanych Open ID Connect z architekturą pokazaną w poniższym fragmencie kodu:

%%{init: {
  "theme": "base",
  "themeVariables": {
    "background": "#121212",
    "primaryColor": "#1E1E1E",
    "primaryBorderColor": "#FFFFFF",
    "primaryTextColor": "#FFFFFF",
    "textColor": "#FFFFFF",
    "lineColor": "#FFFFFF",
    "labelBackground": "#000000"
  }
}}%%
flowchart LR
    classDef dnode fill:#1E1E1E,stroke:#FFFFFF,stroke-width:2px,color:#FFFFFF
    linkStyle default stroke:#FFFFFF,stroke-width:2px,color:#FFFFFF

    client[Client Application]:::dnode -->| Bearer over HTTP | webapi[Web API]:::dnode
    subgraph Pod / Host
        webapi -->|"/Validate<br/>/AuthorizationHeader/{name}<br/>/DownstreamApi/{name}"| sidecar[Microsoft Entra SDK for AgentID]:::dnode
    end
    sidecar -->|Token validation & acquisition| entra[Microsoft Entra ID]:::dnode

Pomoc techniczna i zasoby

Poniższe zasoby zawierają kompleksowe wskazówki i pomoc w rozwiązywaniu problemów i odpowiedzi na typowe pytania.

Aby uzyskać dodatkową pomoc:

• Zgłaszanie problemów z repozytorium Microsoft-identity-web
• Sprawdź przewodniki do rozwiązywania problemów Microsoft Entra ID

Dodatkowe zasoby

• Dokumentacja Microsoft Entra ID
• Dokumentacja platformy tożsamości firmy Microsoft
• Repozytorium Microsoft Identity Web
• Dokumentacja rozwiązania Kubernetes
• Dokumentacja platformy Docker