Skip to content
Roboto
Esc
↑↓navigate↵open⌘Jpreview
On this page

roboto.domain.tokens

Submodules

Package Contents

CreateTokenRequest

class roboto.domain.tokens.CreateTokenRequest(/, **data)#View Source

Bases: pydantic.BaseModel

Request payload to create a new token

Parameters

data Any

Attributes

CreateTokenRequest.api_scopes

api_scopes set[roboto.auth.scope.ApiScope] | None = None #

CreateTokenRequest.description

description str | None = None #

CreateTokenRequest.expiry_days

expiry_days int = None #

CreateTokenRequest.name

name str = None #

Token

class roboto.domain.tokens.Token(record, roboto_client=None)#View Source

A token allows users and devices to authenticate requests to Roboto.

When a token is generated, a secret value is created which is shared with the user exactly once. This value is required for authentication, if lost a token can be deleted and a new token can be generated.

Token.create()

classmethod create(name, description=None, expiry_days=30, api_scopes=None, roboto_client=None)#View Source

This returns a tuple of the token and the one-time generated secret. After creation, you’ll never be able to retrieve the secret again, so you should save it!

Parameters

name str
description Optional[str]
expiry_days int
api_scopes Optional[set[roboto.auth.scope.ApiScope]]
roboto_client Optional[roboto.http.RobotoClient]

Return type

tuple[Token, str]

Token.delete()

delete()#View Source

Return type

None

Token.disable()

disable()#View Source

Return type

Token.enable()

enable()#View Source

Return type

Token.for_self()

classmethod for_self(roboto_client=None)#View Source

Parameters

roboto_client Optional[roboto.http.RobotoClient]

Return type

collections.abc.Collection[Token]

Token.from_id()

classmethod from_id(token_id, roboto_client=None)#View Source

Parameters

token_id str
roboto_client Optional[roboto.http.RobotoClient]

Return type

Token.to_dict()

to_dict()#View Source

Return type

dict[str, Any]

Properties

Token.token_id

token_id str #
Return type: str

Token.user_id

user_id str #
Return type: str

TokenContext

class roboto.domain.tokens.TokenContext(/, **data)#View Source

Bases: pydantic.BaseModel

Context for token usage

Parameters

data Any

Attributes

TokenContext.api_scopes

TokenContext.description

description str | None = None #

TokenContext.enabled

enabled bool = True #

TokenContext.expires

expires datetime.datetime #

TokenContext.last_used

last_used datetime.datetime | None = None #

TokenContext.name

name str #

TokenContext.token_id

token_id str #

TokenRecord

class roboto.domain.tokens.TokenRecord(/, **data)#View Source

Bases: pydantic.BaseModel

A wire-transmissible representation of a token.

Parameters

data Any

Attributes

TokenRecord.context

context TokenContext | None = None #

TokenRecord.secret

secret str | None = None #

TokenRecord.user_id

user_id str | None = None #

Was this page helpful?