com.microsoft.azure.sdk.iot.service.auth

Class IotHubServiceSasToken

java.lang.Object

com.microsoft.azure.sdk.iot.service.auth.IotHubServiceSasToken

public final class IotHubServiceSasToken
extends Object

Grants device access to an IoT Hub for the specified amount of time.

Field Summary

Fields

Modifier and Type	Field and Description
protected long	expiryTimeSeconds
protected String	keyName
protected String	keyValue
protected String	resourceUri
protected String	token
static String	TOKEN_FORMAT The SAS token format.
protected long	tokenLifespanSeconds

Constructor Summary

Constructors

Constructor and Description
IotHubServiceSasToken(IotHubConnectionString iotHubConnectionString) Constructor.
IotHubServiceSasToken(IotHubConnectionString iotHubConnectionString, long tokenLifespanSeconds) Constructor.

Method Summary

Modifier and Type	Method and Description
long	getExpiryTimeMillis()
long	getTokenLifespanSeconds()
String	toString() Returns the string representation of the SAS token.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

TOKEN_FORMAT

public static final String TOKEN_FORMAT

The SAS token format. The parameters to be interpolated are, in order: the signature the resource URI the expiry time the key name Example: SharedAccessSignature sr=IOTHUBURI&sig=SIGNATURE&se=EXPIRY&skn=SHAREDACCESSKEYNAME

See Also:

Constant Field Values

resourceUri

protected final String resourceUri

keyValue

protected final String keyValue

expiryTimeSeconds

protected final long expiryTimeSeconds

keyName

protected final String keyName

token

protected final String token

tokenLifespanSeconds

protected final long tokenLifespanSeconds

Constructor Detail

IotHubServiceSasToken

public IotHubServiceSasToken(IotHubConnectionString iotHubConnectionString)

Constructor. Generates a SAS token that grants access to an IoT Hub for the default amount of time of 1 hour.

Parameters:

iotHubConnectionString - Connection string object containing the connection parameters

IotHubServiceSasToken

public IotHubServiceSasToken(IotHubConnectionString iotHubConnectionString,
                             long tokenLifespanSeconds)

Constructor. Generates a SAS token that grants access to an IoT Hub for the specified amount of time.

Parameters:

iotHubConnectionString - Connection string object containing the connection parameters.

tokenLifespanSeconds - The number of seconds that the created SAS token will be valid for.

Method Detail

getExpiryTimeMillis

public final long getExpiryTimeMillis()

Returns:

the number of milliseconds since the UNIX Epoch when this token will expire

getTokenLifespanSeconds

public long getTokenLifespanSeconds()

Returns:

The number of seconds that this token is valid for. Not to be confused with how many seconds the SAS token is still valid for at the time of calling this method.

toString

public String toString()

Returns the string representation of the SAS token.

Overrides:

toString in class Object

Returns:

The string representation of the SAS token.