Acquire.Identity._loginsession module

class LoginSession(public_key=None, public_cert=None, ip_addr=None, hostname=None, login_message=None)

Bases: object

This class holds all details of a single login session

creation_time()

Return the date and time when this was created

static from_data(data)

Return a LoginSession constructed from the passed data (dictionary)

hostname()

Return the user-supplied hostname of the host making the login request

hours_since_creation()

Return the number of hours since this request was created. This will return a float, so 1 second is 1 / 3600th of an hour

is_approved()

Return whether or not this session is open and approved by the user

is_logged_out()

Return whether or not this session has logged out

is_null()

Return whether or not this object is null

is_suspicious()

Return whether or not this session is suspicious

login()

Convenience function to set the session into the logged in state

login_message()

Return any login message that has been set by the user

login_time()

Return the date and time when the user logged in. This returns None if the user has not yet logged in

logout()

Convenience function to set the session into the logged out state

logout_time()

Return the date and time when the user logged out. This returns None if the user has not yet logged out

public_certificate()

Return the public certificate

public_key()

Return the public key

regenerate_uid()

Synonym for regenerate_uuid

regenerate_uuid()

Regenerate the UUID as there has been a clash

request_source()

Return the IP address of the source of this request. This is used to rate limit someone who is maliciously requesting logins…

set_approved()

Register that this request has been approved

set_denied()

Register that this request has been denied

set_logged_out()

Register that this request has been closed as the user has logged out

set_suspicious()

Put this login session into a suspicious state. This will be because weird activity has been detected which indicates that the session may be have been cracked. A login session in a suspicious state should not be granted any permissions.

short_uid()

Synonym for short_uuid

short_uuid()

Return a short UUID that will be used to provide a more human-readable session ID

status()

Return the status of this login session

to_data()

Return a data version (dictionary) of this LoginSession

static to_short_uid(long_uid)

Return the short UID version of the passed long uid

uid()

Synonym for uuid

uuid()

Return the UUID of this request