mirror of
https://github.com/fastapi-users/fastapi-users.git
synced 2025-11-01 18:48:14 +08:00
87c73e974c
* Update cookie.md to reflect correct status code on login * Add complete HTTP response code * Update HTTP response code in docs for cookie transport
1.5 KiB
1.5 KiB
Cookie
Cookies are an easy way to store stateful information into the user browser. Thus, it is more useful for browser-based navigation (e.g. a front-end app making API requests) rather than pure API interaction.
Configuration
from fastapi_users.authentication import CookieTransport
cookie_transport = CookieTransport(cookie_max_age=3600)
As you can see, instantiation is quite simple. It accepts the following arguments:
cookie_name(fastapiusersauth): Name of the cookie.cookie_max_age(Optional[int]): The lifetime of the cookie in seconds.Noneby default, which means it's a session cookie.cookie_path(/): Cookie path.cookie_domain(None): Cookie domain.cookie_secure(True): Whether to only send the cookie to the server via SSL request.cookie_httponly(True): Whether to prevent access to the cookie via JavaScript.cookie_samesite(lax): A string that specifies the samesite strategy for the cookie. Valid values arelax,strictandnone. Defaults tolax.
Login
This method will return a response with a valid set-cookie header upon successful login:
!!! success "204 No content"
Check documentation about login route.
Logout
This method will remove the authentication cookie:
!!! success "204 No content"
Check documentation about logout route.
Authentication
This method expects that you provide a valid cookie in the headers.