1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
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
|
