The official Bitwarden Passwordless.dev Python library, for Python 3+.
Install with python -m pip install passwordless.
- Requests for HTTP API
- marshmallow for JSON (de)serialization
Follow the Get started guide.
frompasswordlessimport (
PasswordlessClient,
PasswordlessClientBuilder,
PasswordlessOptions,
)
classPasswordlessPythonSdkExample:
client: PasswordlessClientdef__init__(self):
options=PasswordlessOptions("your_api_secret")
self.client=PasswordlessClientBuilder(options).build()importuuidfrompasswordlessimportPasswordlessClient, RegisterToken, RegisteredTokenclassPasswordlessPythonSdkExample:
client: PasswordlessClientdefget_register_token(self, alias: str) ->str:
# Get existing userid from session or create a new user.user_id=str(uuid.uuid4())
# Options to give the Apiregister_token=RegisterToken(
user_id=user_id, # your user idusername=alias, # e.g. user email, is shown in browser uialiases=[alias] # Optional: Link this userid to an alias (e.g. email)
)
response: RegisteredToken=self.client.register_token(register_token)
# return this tokenreturnresponse.tokenfrompasswordlessimportPasswordlessClient, VerifySignIn, VerifiedUserclassPasswordlessPythonSdkExample:
client: PasswordlessClientdefverify_sign_in_token(self, token: str) ->VerifiedUser:
verify_sign_in=VerifySignIn(token)
# Sign the user in, set a cookie, etc,returnself.client.sign_in(verify_sign_in)Customize PasswordlessOptions by providing api_secret with your Application's Api Secret.
You can also change the api_url if you prefer to self-host.
Customize PasswordlessClientBuilder by providing sessionrequests Session instance.
See Passwordless Python Example for Flash Web application.
For a comprehensive list of examples, check out the API documentation.
This library is compatible with Python 3 and requires minimum Python 3.9 installed. Install Poetry if not already installed.
Activate shell: poetry shell
Install dependencies: poetry install --with dev,test
Build: poetry build