Skip to main content

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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

st2-auth-backend-pam-0.4.0.tar.gz (11.6 kB view details)

Uploaded Source

Built Distribution

st2_auth_backend_pam-0.4.0-py3-none-any.whl (12.3 kB view details)

Uploaded Python 3

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

Hashes for st2-auth-backend-pam-0.4.0.tar.gz
Algorithm Hash digest
SHA256 70d1b8ee8bfbc185c3c6105f37950cc2f4294085d90e70af5679ca055f3cf1d4
MD5 5226a90070dec1dc63b761533fb526b0
BLAKE2b-256 c98742380af11e4814c3cf5d985aa07dbd099a8a0aad0969f31976eadbfdab11

See more details on using hashes here.

File details

Details for the file st2_auth_backend_pam-0.4.0-py3-none-any.whl.

File metadata

File hashes

Hashes for st2_auth_backend_pam-0.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 2df97ffcb0c89b7eedb4499473cdcab6afa0667921c9a33db4093c623e379476
MD5 f16e62e990d3627109aed71c69315676
BLAKE2b-256 29296104ce02df120aadd6ddfd22f68e48d3527ef6cb387dfb22f726b0a85f3d

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page