JupyterHub首次使用身份验证器

这是一个JupyterHub身份验证器，它帮助新用户在首次登录JupyterHub时设置他们的密码。

您是否在一个单一物理位置运行研讨会，例如大学研讨会或用户组？

首次使用认证器可以简化您的用户设置。在单个物理位置使用短暂的JupyterHub实例时非常有用。它允许多个用户登录，但您不需要安装预先存在的认证设置。使用此认证器，用户只需选择用户名和密码就可以开始工作了！

安装

您可以使用以下命令安装此认证器：

pip install jupyterhub-firstuseauthenticator

安装完成后，通过向您的 jupyterhub_config.py 文件添加以下内容来配置JupyterHub以使用它：

c.JupyterHub.authenticator_class = 'firstuseauthenticator.FirstUseAuthenticator'

配置

FirstUseAuthenticator.dbm_path

dbm文件的路径，或一个UNIX数据库文件，例如passwords.dbm，用于存储用户名和密码。dbm文件应放在普通用户没有读写权限的地方。

此认证器的默认设置passwords.dbm的路径是JupyterHub启动的当前目录。

FirstUseAuthenticator.create_users

如果用户不存在，则创建用户。

当设置为False时，用户在登录前必须被明确创建。可以通过管理员面板或设置白名单/管理员列表来创建用户。

默认为True。

常见问题解答

为什么有密码数据库而不使用PAM？

出于安全考虑。用户在登录时可能设置不安全的密码，您不希望通过SSH或其他方式攻击而成功登录。

我如何更改我的密码？

要更改密码，您应在jupyterhub账户中登录，转到 <your_server_ip>/hub/auth/change-password 并更改密码。

在创建用户名时出现错误

用户名不能包含空格或逗号。请检查您的用户名是否不包含这些字符。

安全

在使用FirstUseAuthenticator时，建议自动将用户名的已知前缀（例如jupyter）添加到用户名前。这可以防止例如，有人登录为root，因为创建的用户将是jupyter-root。