https://github.com/bringhurst/nginx-mod-auth-kerb
An nginx module to enable the use of SPNEGO, GSSAPI, and Kerberos for HTTP SSO authentication.
https://github.com/bringhurst/nginx-mod-auth-kerb
Last synced: 9 months ago
JSON representation
An nginx module to enable the use of SPNEGO, GSSAPI, and Kerberos for HTTP SSO authentication.
- Host: GitHub
- URL: https://github.com/bringhurst/nginx-mod-auth-kerb
- Owner: bringhurst
- License: other
- Created: 2011-04-21T18:18:53.000Z (about 15 years ago)
- Default Branch: master
- Last Pushed: 2025-03-30T04:20:58.000Z (about 1 year ago)
- Last Synced: 2025-05-15T07:42:35.571Z (about 1 year ago)
- Language: C
- Homepage:
- Size: 40 KB
- Stars: 37
- Watchers: 5
- Forks: 8
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Changelog: ChangeLog
- License: LICENSE.md
Awesome Lists containing this project
README
# nginx-mod-auth-kerb
This is an [nginx](http://nginx.org/) module to enable the use of SPNEGO,
GSSAPI, and Kerberos for HTTP SSO authentication.
*Warning*: This code probably has a ton of bugs. Personally, I suggest that you
don't use it in production without a bit of auditing. This repository was
created because the original download site disappeared.
## Compilation
First, you need to compile the spnegohelp dynamic library. 'make' in that
subdirectory should do it, then place it by hand somewhere where linker
and loader can find it by default (probably /usr/lib or perhaps even
/usr/local/lib depending on your setup).
When compiling from source build as usual adding the -add-module option:
````
./configure --add-module=$PATH_TO_MODULE
````
inside top Nginx source directory.
## Configuration
The module has following directives:
- auth_gss: "on"/"off", for ease of unsecuring while leaving other
options in the config file,
- auth_gss_realm: what Kerberos realm name to use, for now only used to
remove it from full user@realm.name,
- auth_gss_keytab: absolute path-name to keytab file containing service
credentials,
- auth_gss_service_name: what service name to use when acquiring
credentials. (TOFIX: HTTP but should be a list in case of some other
browsers wanting perhaps khttp or http),
- auth_gss_format_full: "on"/"off", default "off", when "on" realm name will not
be stripped from $remote_user variable
FIXME: for now they are all merely location specific. i.e. no way to
specify main or per server defaults, except for ...
## Examples
````
... current "hardcodeds" ;-}
location /topsecret {
auth_gss on;
auth_gss_realm LOCALDOMAIN;
auth_gss_keytab /etc/krb5.keytab;
auth_gss_service_name HTTP;
}
````
## Credit and License
This code is derived from the [Apache Kerberos/SPNEGO module](http://modgssapache.sf.net).
Please see the LICENSE.md file for more information.