PAM authentication plugin for StackStorm.
Project description
PAM authentication plugin for StackStorm
PAM authentication backend allows users to authenticate against the PAM (Pluggable Authentication
Modules) on the system where st2auth
service is running.
Requirements
Ubuntu:
sudo apt-get -y install libpam0g
RHEL/CentOS:
sudo yum -y install pam-devel
Installation
Install this into the ST2 virtualenv with:
sudo /opt/stackstorm/st2/bin/pip install git+https://github.com/StackStorm/st2-auth-backend-pam.git@master#egg=st2_auth_backend_pam
Edit the file: /lib/systemd/system/st2auth.service
. Modify it so that the stauth
service runs as root.
Configuration Options
option | required | default | description |
---|---|---|---|
service | no | login | PAM service to authenticate against |
Configuration Example
Please refer to the authentication section in the StackStorm documentation for basic setup concept. The following is an example of the auth section in the StackStorm configuration file for the PAM backend.
[auth]
mode = standalone
backend = pam
backend_kwargs = {"service": "login"}
...
Limitations
The python implementation of PAM does not allow authentication as the root
user.
When utilizing this backend, you will need to authenticate as a non-root
user.
Copyright, License, and Contributors Agreement
Copyright 2015 StackStorm, Inc.
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this work except in compliance with the License. You may obtain a copy of the License in the LICENSE file, or at: http://www.apache.org/licenses/LICENSE-2.0
By contributing you agree that these contributions are your own (or approved by your employer) and you grant a full, complete, irrevocable copyright license to all users and developers of the project, present and future, pursuant to the license of the project.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file st2-auth-backend-pam-0.4.0.tar.gz
.
File metadata
- Download URL: st2-auth-backend-pam-0.4.0.tar.gz
- Upload date:
- Size: 11.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.1 CPython/3.11.9
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 70d1b8ee8bfbc185c3c6105f37950cc2f4294085d90e70af5679ca055f3cf1d4 |
|
MD5 | 5226a90070dec1dc63b761533fb526b0 |
|
BLAKE2b-256 | c98742380af11e4814c3cf5d985aa07dbd099a8a0aad0969f31976eadbfdab11 |
File details
Details for the file st2_auth_backend_pam-0.4.0-py3-none-any.whl
.
File metadata
- Download URL: st2_auth_backend_pam-0.4.0-py3-none-any.whl
- Upload date:
- Size: 12.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.1 CPython/3.11.9
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2df97ffcb0c89b7eedb4499473cdcab6afa0667921c9a33db4093c623e379476 |
|
MD5 | f16e62e990d3627109aed71c69315676 |
|
BLAKE2b-256 | 29296104ce02df120aadd6ddfd22f68e48d3527ef6cb387dfb22f726b0a85f3d |