Merge pull request #4552 from consideRatio/pr/small-services-docs-fixes

Small fixes to services docs
This commit is contained in:
Yuvi Panda
2023-09-08 19:39:22 -07:00
committed by GitHub

View File

@@ -163,8 +163,8 @@ to perform its API requests. Each Externally-Managed Service will need a
unique API token, because the Hub authenticates each API request and the API unique API token, because the Hub authenticates each API request and the API
token is used to identify the originating Service or user. token is used to identify the originating Service or user.
A configuration example of an Externally-Managed Service with admin access and A configuration example of an Externally-Managed Service running its own web
running its own web server is: server is:
```python ```python
c.JupyterHub.services = [ c.JupyterHub.services = [
@@ -385,7 +385,7 @@ There are two levels of authentication with the Hub:
This should be used for any service that serves pages that should be visited with a browser. This should be used for any service that serves pages that should be visited with a browser.
To use HubAuth, you must set the `.api_token` instance variable. This can be To use HubAuth, you must set the `.api_token` instance variable. This can be
done either programmatically when constructing the class, or via the done via the HubAuth constructor, direct assignment to a HubAuth object, or via the
`JUPYTERHUB_API_TOKEN` environment variable. A number of the examples in the `JUPYTERHUB_API_TOKEN` environment variable. A number of the examples in the
root of the jupyterhub git repository set the `JUPYTERHUB_API_TOKEN` variable root of the jupyterhub git repository set the `JUPYTERHUB_API_TOKEN` variable
so consider having a look at those for further reading so consider having a look at those for further reading
@@ -445,7 +445,7 @@ for more details.
### Authenticating tornado services with JupyterHub ### Authenticating tornado services with JupyterHub
Since most Jupyter services are written with tornado, Since most Jupyter services are written with tornado,
we include a mixin class, [`HubOAuthenticated`][huboauthenticated], we include a mixin class, {class}`.HubOAuthenticated`,
for quickly authenticating your own tornado services with JupyterHub. for quickly authenticating your own tornado services with JupyterHub.
Tornado's {py:func}`~.tornado.web.authenticated` decorator calls a Handler's {py:meth}`~.tornado.web.RequestHandler.get_current_user` Tornado's {py:func}`~.tornado.web.authenticated` decorator calls a Handler's {py:meth}`~.tornado.web.RequestHandler.get_current_user`