ClientAssertionCredentialBuilder Klasse

Fluent-Anmeldeinformationsgenerator zum Instanziieren von ClientAssertionCredential.

Ruft ClientAssertionCredential ein Token über clientassertion und Dienstprinzipalauthentifizierung ab. Diese Authentifizierungsmethode bietet eine sichere und skalierbare Möglichkeit für Clientanwendungen, auf Azure-Ressourcen zuzugreifen, ohne dass Benutzer ihre Anmeldeinformationen angeben müssen. Sie wird häufig in Szenarien verwendet, in denen eine Clientanwendung im Namen eines Benutzers auf Azure-Ressourcen zugreifen muss, z. B. in einer Anwendungsarchitektur mit mehreren Ebenen. Bei dieser Authentifizierungsmethode erstellt die Clientanwendung ein JSON-Webtoken (JWT), das Informationen zum Dienstprinzipal (z. B. client-ID und Mandanten-ID) enthält, und signiert es mithilfe eines geheimen Clientschlüssels. Der Client sendet dieses Token dann als Nachweis seiner Identität an Azure Active Directory (Azure AD ). Azure AD überprüft die Tokensignatur und überprüft, ob der Dienstprinzipal über die erforderlichen Berechtigungen für den Zugriff auf die angeforderte Azure-Ressource verfügt. Wenn das Token gültig ist und der Dienstprinzipal autorisiert ist, gibt Azure AD ein Zugriffstoken aus, das die Clientanwendung für den Zugriff auf die angeforderte Ressource verwenden kann. Ruft ClientAssertionCredential ein Zugriffstoken mit einer Clientclientassertion für eine Dienstprinzipal-/registrierte AAD-Anwendung ab. Die tenantId, clientId und clientAssertion des Dienstprinzipals sind erforderlich, damit diese Anmeldeinformationen ein Zugriffstoken abrufen können. Sie kann sowohl in von Azure gehosteten als auch in lokalen Entwicklungsumgebungen für die Authentifizierung verwendet werden.

Beispiel: Erstellen eines einfachen ClientAssertionCredential

Im folgenden Codebeispiel wird die Erstellung eines ClientAssertionCredentialveranschaulicht, wobei verwendet wird, ClientAssertionCredentialBuilder um ihn zu konfigurieren. Die tenantIdParameter , clientId und certificate sind erforderlich, um zu erstellen ClientAssertionCredential. Nachdem diese Anmeldeinformationen erstellt wurden, können sie als Parameter "credential" an den Generator vieler Client-Generatoren des Azure SDK für Java übergeben werden.

TokenCredential clientAssertionCredential = new ClientAssertionCredentialBuilder()
     .tenantId(tenantId)
     .clientId(clientId)
     .clientAssertion(() -> "<Client-Assertion>")
     .build();

Beispiel: Erstellen eines ClientAssertionCredential hinter einem Proxy

Im folgenden Codebeispiel wird die Erstellung eines ClientAssertionCredentialveranschaulicht, wobei verwendet wird, ClientAssertionCredentialBuilder um ihn zu konfigurieren. Die tenantIdParameter , clientId und clientAssertion sind erforderlich, um zu erstellen ClientAssertionCredential. THe proxyOptions kann optional für einen Proxy konfiguriert werden. Nachdem diese Anmeldeinformationen erstellt wurden, können sie als Parameter "credential" an den Generator vieler Client-Generatoren des Azure SDK für Java übergeben werden.

TokenCredential assertionCredential = new ClientAssertionCredentialBuilder()
     .tenantId(tenantId)
     .clientId(clientId)
     .clientAssertion(() -> "<Client-Assertion>")
     .proxyOptions(new ProxyOptions(Type.HTTP, new InetSocketAddress("10.21.32.43", 5465)))
     .build();