bokeh.server.auth_provider¶

Provide a hook for supplying authorization mechanisms to a Bokeh server.

class AuthModule(module_path: PathLike)[source]¶

An AuthProvider configured from a Python module.

The following properties return the corresponding values from the module if they exist, or None otherwise:

get_login_url,
get_user
get_user_async
login_url
logout_url

The login_handler property will return a LoginHandler class from the module, or None otherwise.

The logout_handler property will return a LogoutHandler class from the module, or None otherwise.

Public Data Attributes:

`get_user`	A function to get the current authenticated user.
`get_user_async`	An async function to get the current authenticated user.
`login_url`	A URL to redirect unauthenticated users to for login.
`get_login_url`	A function that computes a URL to redirect unathenticated users to for login.
`login_handler`	A request handler class for a login page.
`logout_url`	A URL to redirect authenticated users to for logout.
`logout_handler`	A request handler class for a logout page.

Inherited from : py: class:AuthProvider

`endpoints`	URL patterns for login/logout endpoints.
`get_login_url`	A function that computes a URL to redirect unathenticated users to for login.
`get_user`	A function to get the current authenticated user.
`get_user_async`	An async function to get the current authenticated user.
`login_handler`	A request handler class for a login page.
`login_url`	A URL to redirect unauthenticated users to for login.
`logout_handler`	A request handler class for a logout page.
`logout_url`	A URL to redirect authenticated users to for logout.

Public Methods:

__init__(module_path)

Inherited from : py: class:AuthProvider

__init__(module_path)

property get_login_url¶

A function that computes a URL to redirect unathenticated users to for login.

This property may return None, if a login_url is supplied instead.

If a function is returned, it should accept a RequestHandler and return a login URL for unathenticated users.

property get_user¶

A function to get the current authenticated user.

This property may return None, if a get_user_async function is supplied instead.

If a function is returned, it should accept a RequestHandler and return the current authenticated user.

property get_user_async¶

An async function to get the current authenticated user.

This property may return None, if a get_user function is supplied instead.

If a function is returned, it should accept a RequestHandler and return the current authenticated user.

property login_handler¶

A request handler class for a login page.

This property may return None, if login_url is supplied instead.

If a class is returned, it must be a subclass of RequestHandler, which will used for the endpoint specified by logout_url

property login_url¶

A URL to redirect unauthenticated users to for login.

This proprty may return None, if a get_login_url function is supplied instead.

property logout_handler¶

A request handler class for a logout page.

This property may return None.

If a class is returned, it must be a subclass of RequestHandler, which will used for the endpoint specified by logout_url

property logout_url¶

A URL to redirect authenticated users to for logout.

This proprty may return None.

class AuthProvider[source]¶

Abstract base class for implementing authorization hooks.

Subclasses must supply one of: get_user or get_user_async.

Subclasses must also supply one of login_url or get_login_url.

Optionally, if login_url provides a relative URL, then login_handler may also be supplied.

The properties logout_url and get_logout_handler are analogous to the corresponding login properties, and are optional.

Public Data Attributes:

`endpoints`	URL patterns for login/logout endpoints.
`get_login_url`	A function that computes a URL to redirect unathenticated users to for login.
`get_user`	A function to get the current authenticated user.
`get_user_async`	An async function to get the current authenticated user.
`login_handler`	A request handler class for a login page.
`login_url`	A URL to redirect unauthenticated users to for login.
`logout_handler`	A request handler class for a logout page.
`logout_url`	A URL to redirect authenticated users to for logout.

Public Methods:

__init__()

property endpoints: List[Tuple[str, Type[tornado.web.RequestHandler]]]¶: URL patterns for login/logout endpoints.

property get_login_url: Optional[Callable[[tornado.httputil.HTTPServerRequest], str]]¶

A function that computes a URL to redirect unathenticated users to for login.

This property may return None, if a login_url is supplied instead.

If a function is returned, it should accept a RequestHandler and return a login URL for unathenticated users.

property get_user: Optional[Callable[[tornado.httputil.HTTPServerRequest], bokeh.server.auth_provider.User]]¶

A function to get the current authenticated user.

This property may return None, if a get_user_async function is supplied instead.

If a function is returned, it should accept a RequestHandler and return the current authenticated user.

property get_user_async: Optional[Callable[[tornado.httputil.HTTPServerRequest], Awaitable[bokeh.server.auth_provider.User]]]¶

An async function to get the current authenticated user.

This property may return None, if a get_user function is supplied instead.

If a function is returned, it should accept a RequestHandler and return the current authenticated user.

property login_handler: Optional[Type[tornado.web.RequestHandler]]¶

A request handler class for a login page.

This property may return None, if login_url is supplied instead.

If a class is returned, it must be a subclass of RequestHandler, which will used for the endpoint specified by logout_url

property login_url: str | None¶

A URL to redirect unauthenticated users to for login.

This proprty may return None, if a get_login_url function is supplied instead.

property logout_handler: Optional[Type[tornado.web.RequestHandler]]¶

A request handler class for a logout page.

This property may return None.

If a class is returned, it must be a subclass of RequestHandler, which will used for the endpoint specified by logout_url

property logout_url: str | None¶

A URL to redirect authenticated users to for logout.

This proprty may return None.

class NullAuth[source]¶

A default no-auth AuthProvider.

All of the properties of this provider return None.

Public Data Attributes:

`get_user`	A function to get the current authenticated user.
`get_user_async`	An async function to get the current authenticated user.
`login_url`	A URL to redirect unauthenticated users to for login.
`get_login_url`	A function that computes a URL to redirect unathenticated users to for login.
`login_handler`	A request handler class for a login page.
`logout_url`	A URL to redirect authenticated users to for logout.
`logout_handler`	A request handler class for a logout page.

Inherited from : py: class:AuthProvider

`endpoints`	URL patterns for login/logout endpoints.
`get_login_url`	A function that computes a URL to redirect unathenticated users to for login.
`get_user`	A function to get the current authenticated user.
`get_user_async`	An async function to get the current authenticated user.
`login_handler`	A request handler class for a login page.
`login_url`	A URL to redirect unauthenticated users to for login.
`logout_handler`	A request handler class for a logout page.
`logout_url`	A URL to redirect authenticated users to for logout.

Public Methods:

Inherited from : py: class:AuthProvider

__init__()

property get_login_url¶

A function that computes a URL to redirect unathenticated users to for login.

This property may return None, if a login_url is supplied instead.

If a function is returned, it should accept a RequestHandler and return a login URL for unathenticated users.

property get_user¶

A function to get the current authenticated user.

This property may return None, if a get_user_async function is supplied instead.

If a function is returned, it should accept a RequestHandler and return the current authenticated user.

property get_user_async¶

An async function to get the current authenticated user.

This property may return None, if a get_user function is supplied instead.

If a function is returned, it should accept a RequestHandler and return the current authenticated user.

property login_handler¶

A request handler class for a login page.

This property may return None, if login_url is supplied instead.

If a class is returned, it must be a subclass of RequestHandler, which will used for the endpoint specified by logout_url

property login_url¶

A URL to redirect unauthenticated users to for login.

This proprty may return None, if a get_login_url function is supplied instead.

property logout_handler¶

A request handler class for a logout page.

This property may return None.

If a class is returned, it must be a subclass of RequestHandler, which will used for the endpoint specified by logout_url

property logout_url¶

A URL to redirect authenticated users to for logout.

This proprty may return None.

bokeh.server

bokeh.server.callbacks