https://github.com/bloomberg/jupyterhub-kdcauthenticator
A Kerberos authenticator module for the JupyterHub platform
https://github.com/bloomberg/jupyterhub-kdcauthenticator
jupyterhub kerberos
Last synced: about 1 year ago
JSON representation
A Kerberos authenticator module for the JupyterHub platform
- Host: GitHub
- URL: https://github.com/bloomberg/jupyterhub-kdcauthenticator
- Owner: bloomberg
- License: apache-2.0
- Created: 2017-05-31T17:54:29.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2018-09-02T19:59:45.000Z (almost 8 years ago)
- Last Synced: 2025-04-19T23:31:58.478Z (over 1 year ago)
- Topics: jupyterhub, kerberos
- Language: Python
- Size: 6.84 KB
- Stars: 21
- Watchers: 3
- Forks: 20
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# KDCAuthenticator
KDC authenticator allows to authenticate the JuypterHub user using Kerberos protocol.
# Install, Configure and Run
1. Install KDC Authenticator -
Run the following command at kdcauthenticator directory
```
pip3 install jupyterhub-kdcauthenticator
```
Or clone the repository and install -
```
git clone https://github.com/bloomberg/kdcauthenticator.git
cd kdcauthenticator
pip3 install -e .
```
2. Configure JupyterHub for KDC Authenticator
Add the following line to the jupyterHub config file
```
c.JupyterHub.authenticator_class = 'kdcauthenticator.kdcauthenticator.KDCAuthenticator'
```
Optionally you can add the following lines to create local system users
```
c.LocalAuthenticator.add_user_cmd = ['adduser', '-m']
c.LocalAuthenticator.create_system_users = True
```
3. The Service principal for JupyterHub authenticator is configured to "HTTP" but can be configured by -
```
c.KDCAuthenticator.service_name = ''
```
4. Run the JupyterHub command with Kerberos environment variables -
```
KRB5_CONFIG=[Kerberos-config-path] KRB5_KTNAME=[HTTP-Service-Principle-Keytab-path] jupyterhub --ip=0.0.0.0 --port=8000 --no-ssl --config=[jupyterHub-config-file-path]
```