%global _empty_manifest_terminate_build 0 Name: python-jupyterhub-firstuseauthenticator Version: 1.0.0 Release: 1 Summary: JupyterHub Authenticator that lets users set passwords on first use License: BSD-3-Clause URL: https://github.com/jupyterhub/firstuseauthenticator Source0: https://mirrors.nju.edu.cn/pypi/web/packages/8f/4a/21ecf46e9d2a8465c0e062fb88c296e03f00a1a3cbbd28f221c96baddd47/jupyterhub-firstuseauthenticator-1.0.0.tar.gz BuildArch: noarch Requires: python3-bcrypt Requires: python3-jupyterhub %description [![Latest PyPI version](https://img.shields.io/pypi/v/jupyterhub-firstuseauthenticator?logo=pypi)](https://pypi.python.org/pypi/jupyterhub-firstuseauthenticator) [![GitHub Workflow Status - Test](https://img.shields.io/github/workflow/status/jupyterhub/firstuseauthenticator/Test?logo=github&label=tests)](https://github.com/jupyterhub/zero-to-jupyterhub-k8s/actions) [![GitHub](https://img.shields.io/badge/issue_tracking-github-blue?logo=github)](https://github.com/jupyterhub/jupyterhub-firstuseauthenticator/issues) [![Discourse](https://img.shields.io/badge/help_forum-discourse-blue?logo=discourse)](https://discourse.jupyter.org/c/jupyterhub) [![Gitter](https://img.shields.io/badge/social_chat-gitter-blue?logo=gitter)](https://gitter.im/jupyterhub/jupyterhub) # JupyterHub First Use Authenticator A [JupyterHub](https://jupyterhub.readthedocs.io) authenticator that helps new users set their password on their first login to JupyterHub. **Are you running a workshop from a single physical location, such as a university seminar or a user group?** JupyterHub First Use Authenticator can simplify the user set up for you. It's very useful when using transient JupyterHub instances in a single physical location. It allows multiple users to log in, but you do not have install a pre-existing authentication setup. With this authenticator, users can just pick a username and password and get to work! ## Installation You can install this authenticator with: ```bash pip install jupyterhub-firstuseauthenticator ``` Once installed, configure JupyterHub to use it by adding the following to your `jupyterhub_config.py` file: ```python c.JupyterHub.authenticator_class = 'firstuseauthenticator.FirstUseAuthenticator' ``` ## Configuration ### FirstUseAuthenticator.dbm_path Path to the [dbm](https://docs.python.org/3.5/library/dbm.html) file, or a UNIX database file such as `passwords.dbm`, used to store usernames and passwords. The dbm file should be put where regular users do not have read/write access to it. This authenticator's default setting for the path to the `passwords.dbm` is the current directory from which JupyterHub is spawned. ### FirstUseAuthenticator.create_users Create users if they do not exist already. When set to False, users would have to be explicitly created before they can log in. Users can be created via the admin panel or by setting whitelist / admin list. Defaults to True. ## FAQ ### Why have a password DB and not use PAM ? For security Reasons. Users are likely to set an, insecure password at login time, and you do not want a brute-force/dictionary attack to manage to login by attacking via ssh or another mean. ### How can I change my password? To change your password, you should login in your jupyterhub account, go to `/hub/auth/change-password` and change the password. ### I'm getting an error when creating my username Usernames cannot contain spaces or commas. Please check if your username is free of these characters. ## Security When using `FirstUseAuthenticator` it is advised to automatically prepend the name of the user with a known-prefix (for example `jupyter`). This would prevent for example, someone to log-in as `root`, as the created user would be `jupyter-root`. %package -n python3-jupyterhub-firstuseauthenticator Summary: JupyterHub Authenticator that lets users set passwords on first use Provides: python-jupyterhub-firstuseauthenticator BuildRequires: python3-devel BuildRequires: python3-setuptools BuildRequires: python3-pip %description -n python3-jupyterhub-firstuseauthenticator [![Latest PyPI version](https://img.shields.io/pypi/v/jupyterhub-firstuseauthenticator?logo=pypi)](https://pypi.python.org/pypi/jupyterhub-firstuseauthenticator) [![GitHub Workflow Status - Test](https://img.shields.io/github/workflow/status/jupyterhub/firstuseauthenticator/Test?logo=github&label=tests)](https://github.com/jupyterhub/zero-to-jupyterhub-k8s/actions) [![GitHub](https://img.shields.io/badge/issue_tracking-github-blue?logo=github)](https://github.com/jupyterhub/jupyterhub-firstuseauthenticator/issues) [![Discourse](https://img.shields.io/badge/help_forum-discourse-blue?logo=discourse)](https://discourse.jupyter.org/c/jupyterhub) [![Gitter](https://img.shields.io/badge/social_chat-gitter-blue?logo=gitter)](https://gitter.im/jupyterhub/jupyterhub) # JupyterHub First Use Authenticator A [JupyterHub](https://jupyterhub.readthedocs.io) authenticator that helps new users set their password on their first login to JupyterHub. **Are you running a workshop from a single physical location, such as a university seminar or a user group?** JupyterHub First Use Authenticator can simplify the user set up for you. It's very useful when using transient JupyterHub instances in a single physical location. It allows multiple users to log in, but you do not have install a pre-existing authentication setup. With this authenticator, users can just pick a username and password and get to work! ## Installation You can install this authenticator with: ```bash pip install jupyterhub-firstuseauthenticator ``` Once installed, configure JupyterHub to use it by adding the following to your `jupyterhub_config.py` file: ```python c.JupyterHub.authenticator_class = 'firstuseauthenticator.FirstUseAuthenticator' ``` ## Configuration ### FirstUseAuthenticator.dbm_path Path to the [dbm](https://docs.python.org/3.5/library/dbm.html) file, or a UNIX database file such as `passwords.dbm`, used to store usernames and passwords. The dbm file should be put where regular users do not have read/write access to it. This authenticator's default setting for the path to the `passwords.dbm` is the current directory from which JupyterHub is spawned. ### FirstUseAuthenticator.create_users Create users if they do not exist already. When set to False, users would have to be explicitly created before they can log in. Users can be created via the admin panel or by setting whitelist / admin list. Defaults to True. ## FAQ ### Why have a password DB and not use PAM ? For security Reasons. Users are likely to set an, insecure password at login time, and you do not want a brute-force/dictionary attack to manage to login by attacking via ssh or another mean. ### How can I change my password? To change your password, you should login in your jupyterhub account, go to `/hub/auth/change-password` and change the password. ### I'm getting an error when creating my username Usernames cannot contain spaces or commas. Please check if your username is free of these characters. ## Security When using `FirstUseAuthenticator` it is advised to automatically prepend the name of the user with a known-prefix (for example `jupyter`). This would prevent for example, someone to log-in as `root`, as the created user would be `jupyter-root`. %package help Summary: Development documents and examples for jupyterhub-firstuseauthenticator Provides: python3-jupyterhub-firstuseauthenticator-doc %description help [![Latest PyPI version](https://img.shields.io/pypi/v/jupyterhub-firstuseauthenticator?logo=pypi)](https://pypi.python.org/pypi/jupyterhub-firstuseauthenticator) [![GitHub Workflow Status - Test](https://img.shields.io/github/workflow/status/jupyterhub/firstuseauthenticator/Test?logo=github&label=tests)](https://github.com/jupyterhub/zero-to-jupyterhub-k8s/actions) [![GitHub](https://img.shields.io/badge/issue_tracking-github-blue?logo=github)](https://github.com/jupyterhub/jupyterhub-firstuseauthenticator/issues) [![Discourse](https://img.shields.io/badge/help_forum-discourse-blue?logo=discourse)](https://discourse.jupyter.org/c/jupyterhub) [![Gitter](https://img.shields.io/badge/social_chat-gitter-blue?logo=gitter)](https://gitter.im/jupyterhub/jupyterhub) # JupyterHub First Use Authenticator A [JupyterHub](https://jupyterhub.readthedocs.io) authenticator that helps new users set their password on their first login to JupyterHub. **Are you running a workshop from a single physical location, such as a university seminar or a user group?** JupyterHub First Use Authenticator can simplify the user set up for you. It's very useful when using transient JupyterHub instances in a single physical location. It allows multiple users to log in, but you do not have install a pre-existing authentication setup. With this authenticator, users can just pick a username and password and get to work! ## Installation You can install this authenticator with: ```bash pip install jupyterhub-firstuseauthenticator ``` Once installed, configure JupyterHub to use it by adding the following to your `jupyterhub_config.py` file: ```python c.JupyterHub.authenticator_class = 'firstuseauthenticator.FirstUseAuthenticator' ``` ## Configuration ### FirstUseAuthenticator.dbm_path Path to the [dbm](https://docs.python.org/3.5/library/dbm.html) file, or a UNIX database file such as `passwords.dbm`, used to store usernames and passwords. The dbm file should be put where regular users do not have read/write access to it. This authenticator's default setting for the path to the `passwords.dbm` is the current directory from which JupyterHub is spawned. ### FirstUseAuthenticator.create_users Create users if they do not exist already. When set to False, users would have to be explicitly created before they can log in. Users can be created via the admin panel or by setting whitelist / admin list. Defaults to True. ## FAQ ### Why have a password DB and not use PAM ? For security Reasons. Users are likely to set an, insecure password at login time, and you do not want a brute-force/dictionary attack to manage to login by attacking via ssh or another mean. ### How can I change my password? To change your password, you should login in your jupyterhub account, go to `/hub/auth/change-password` and change the password. ### I'm getting an error when creating my username Usernames cannot contain spaces or commas. Please check if your username is free of these characters. ## Security When using `FirstUseAuthenticator` it is advised to automatically prepend the name of the user with a known-prefix (for example `jupyter`). This would prevent for example, someone to log-in as `root`, as the created user would be `jupyter-root`. %prep %autosetup -n jupyterhub-firstuseauthenticator-1.0.0 %build %py3_build %install %py3_install install -d -m755 %{buildroot}/%{_pkgdocdir} if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi pushd %{buildroot} if [ -d usr/lib ]; then find usr/lib -type f -printf "/%h/%f\n" >> filelist.lst fi if [ -d usr/lib64 ]; then find usr/lib64 -type f -printf "/%h/%f\n" >> filelist.lst fi if [ -d usr/bin ]; then find usr/bin -type f -printf "/%h/%f\n" >> filelist.lst fi if [ -d usr/sbin ]; then find usr/sbin -type f -printf "/%h/%f\n" >> filelist.lst fi touch doclist.lst if [ -d usr/share/man ]; then find usr/share/man -type f -printf "/%h/%f.gz\n" >> doclist.lst fi popd mv %{buildroot}/filelist.lst . mv %{buildroot}/doclist.lst . %files -n python3-jupyterhub-firstuseauthenticator -f filelist.lst %dir %{python3_sitelib}/* %files help -f doclist.lst %{_docdir}/* %changelog * Fri May 05 2023 Python_Bot - 1.0.0-1 - Package Spec generated