com.adobe.flashaccess.sdk.protocol
Interface ClientState

public interface ClientState

Client state information included in a request. This information can be used by the server to detect tampering on the client.

Method Summary

long	getCounter() Gets the current value of the client state counter.
String	getTimeZoneId() Gets the client's timezone as an offset from GMT (does not reflect changes due to daylight savings time).
void	incrementCounter() Increments the client state counter.

Method Detail

getTimeZoneId

String getTimeZoneId()

Gets the client's timezone as an offset from GMT (does not reflect changes due to daylight savings time). The format of this string follows the java.util.TimeZone custom time zone identifier. This string can be used to construct a java.util.TimeZone.

Returns:

An identifier for the client's time zone.

getCounter

long getCounter()

Gets the current value of the client state counter. If the server depends on client state for enforcement of any policies (for example, the client stores the playback start time to enforce the playback window restriction), it is highly recommended that the server store the counter value along with a machine identifier and check the counter during each request:

• In most cases, the counter value will be greater than the last value stored on the server. The server should first store the current counter value, then increment the counter by calling incrementCounter(). The server should store the current counter value instead of the updated value in case the client does not receive the server's response and needs to re-send the request. The updated counter will be sent back to the client in the response and the client will store the updated value.
• The counter value in the request could be equal to the last value stored on the server if the client did not receive the server's last response. This could also happen if the client rolls back to the state before the last request. If the server detects that the client's counter is not being updated, the user may be tampering with the client state and the server may wish to take some action.
• If the value in the request is less than the last value stored on the server, the state on the client has been rolled back. This could happen if the client's state is corrupted and needs to be reset. However, if this is detected multiple times, the user may be tampering with the client state and the server may wish to take some action.

Returns:

The rollback counter.

incrementCounter

void incrementCounter()

Increments the client state counter.

See Also:

ClientState.getCounter()