TokenProvider Class

Package:

com.microsoft.azure.servicebus.security

Maven Artifact:

com.microsoft.azure:azure-servicebus:3.6.7

• java.lang.Object
• • com.microsoft.azure.servicebus.security.TokenProvider

public abstract class TokenProvider

This abstract class defines the contract of a token provider. All token providers should inherit from this class. An instance of token provider is used to obtain a security token for a given audience.

Constructor Summary

Constructor	Description
TokenProvider()

Method Summary

Modifier and Type	Method and Description
static TokenProvider	createAzureActiveDirectoryTokenProvider(AzureActiveDirectoryTokenProvider.AuthenticationCallback callback, String authority, Object callbackState) Creates a Azure Active Directory token provider that creates a token with the user defined AuthenticationCallback.
static TokenProvider	createManagedIdentityTokenProvider() Creates a Managed Identity token provider.
static TokenProvider	createSharedAccessSignatureTokenProvider(String sasKeyName, String sasKey) Creates a Shared Access Signature token provider with the given key name and key value.
static TokenProvider	createSharedAccessSignatureTokenProvider(String sasToken, Instant sasTokenValidUntil) Creates a Shared Access Signature token provider that always returns an already created token.
abstract CompletableFuture<SecurityToken>	getSecurityTokenAsync(String audience) Asynchronously gets a security token for the given audience.

Methods inherited from java.lang.Object

clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Constructor Details

TokenProvider

public TokenProvider()

Method Details

createAzureActiveDirectoryTokenProvider

public static TokenProvider createAzureActiveDirectoryTokenProvider(AzureActiveDirectoryTokenProvider.AuthenticationCallback callback, String authority, Object callbackState)

Creates a Azure Active Directory token provider that creates a token with the user defined AuthenticationCallback. This is a utility method.

Parameters:

callback - A custom AuthenticationCallback that takes in the target resource and address of the authority to issue token and provides a security token for the target url

authority - URL of the Azure Active Directory instance

callbackState - Custom parameter that may be provided to the AuthenticationCallback

Returns:

an instance of Azure Active Directory token provider

createManagedIdentityTokenProvider

public static TokenProvider createManagedIdentityTokenProvider()

Creates a Managed Identity token provider. This is a utility method.

Returns:

an instance of Managed Identity token provider

createSharedAccessSignatureTokenProvider

public static TokenProvider createSharedAccessSignatureTokenProvider(String sasKeyName, String sasKey)

Creates a Shared Access Signature token provider with the given key name and key value. Returned token provider creates tokens with validity of 20 minutes. This is a utility method.

Parameters:

sasKeyName - SAS key name

sasKey - SAS key value

Returns:

an instance of Shared Access Signature token provider with the given key name, key value.

createSharedAccessSignatureTokenProvider

public static TokenProvider createSharedAccessSignatureTokenProvider(String sasToken, Instant sasTokenValidUntil)

Creates a Shared Access Signature token provider that always returns an already created token. This is a utility method.

Parameters:

sasToken - Already created Shared Access Signature token to be returned by getSecurityTokenAsync(String audience) method.

sasTokenValidUntil - Instant when the token expires

Returns:

an instance of Shared Access Signature token provider that always returns an already created token.

getSecurityTokenAsync

public abstract CompletableFuture getSecurityTokenAsync(String audience)

Asynchronously gets a security token for the given audience. Implementations of this method may choose to create a new token for every call or return a cached token. But the token returned must be valid.

Parameters:

audience - path of the entity for which this security token is to be presented

Returns:

an instance of CompletableFuture which returns a SecurityToken on completion.