diff options
author | CoprDistGit <infra@openeuler.org> | 2023-05-05 03:45:54 +0000 |
---|---|---|
committer | CoprDistGit <infra@openeuler.org> | 2023-05-05 03:45:54 +0000 |
commit | 8146ae4c30b5266fe1569056647019c690d81296 (patch) | |
tree | 1296e0bbc7c1c87fa206ca6cd19dc4dde9a16b51 | |
parent | 8b9cfc2324517b9629a4c4834d54744b3a7b691d (diff) |
automatic import of python-jupyterhub-firstuseauthenticatoropeneuler20.03
-rw-r--r-- | .gitignore | 1 | ||||
-rw-r--r-- | python-jupyterhub-firstuseauthenticator.spec | 293 | ||||
-rw-r--r-- | sources | 1 |
3 files changed, 295 insertions, 0 deletions
@@ -0,0 +1 @@ +/jupyterhub-firstuseauthenticator-1.0.0.tar.gz diff --git a/python-jupyterhub-firstuseauthenticator.spec b/python-jupyterhub-firstuseauthenticator.spec new file mode 100644 index 0000000..ac6aeb1 --- /dev/null +++ b/python-jupyterhub-firstuseauthenticator.spec @@ -0,0 +1,293 @@ +%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 +[](https://pypi.python.org/pypi/jupyterhub-firstuseauthenticator) +[](https://github.com/jupyterhub/zero-to-jupyterhub-k8s/actions) +[](https://github.com/jupyterhub/jupyterhub-firstuseauthenticator/issues) +[](https://discourse.jupyter.org/c/jupyterhub) +[](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 `<your_server_ip>/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 +[](https://pypi.python.org/pypi/jupyterhub-firstuseauthenticator) +[](https://github.com/jupyterhub/zero-to-jupyterhub-k8s/actions) +[](https://github.com/jupyterhub/jupyterhub-firstuseauthenticator/issues) +[](https://discourse.jupyter.org/c/jupyterhub) +[](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 `<your_server_ip>/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 +[](https://pypi.python.org/pypi/jupyterhub-firstuseauthenticator) +[](https://github.com/jupyterhub/zero-to-jupyterhub-k8s/actions) +[](https://github.com/jupyterhub/jupyterhub-firstuseauthenticator/issues) +[](https://discourse.jupyter.org/c/jupyterhub) +[](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 `<your_server_ip>/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 <Python_Bot@openeuler.org> - 1.0.0-1 +- Package Spec generated @@ -0,0 +1 @@ +6444f09404f71051d8f0020785616c9c jupyterhub-firstuseauthenticator-1.0.0.tar.gz |