RADIUS authentication module
Project description
py-radius
RADIUS authentication module for Python 2.7.13+
(c) 1999 Stuart Bishop <stuart@stuartbishop.net>
This module provides basic RADIUS client capabilities, allowing your Python code to authenticate against any RFC2138 compliant RADIUS server.
Installation
$ pip install py-radius
Usage
The radius.py module can be run from the command line, providing a minimal RADIUS client to test out RADIUS servers:
$ python -m radius Host [default: 'radius']: radius Port [default: 1812]: 1812 Enter RADIUS Secret: s3cr3t Enter your username: foobar Enter your password: qux ... Authentication Successful
Example
Here is an example of using the library.
import radius
radius.authenticate(secret, username, password, host='radius', port=1812)
# - OR -
r = radius.Radius(secret, host='radius', port=1812)
print('success' if r.authenticate(username, password) else 'failure')
If your RADIUS server requires challenge/response, the usage is a bit more complex.
import radius
r = radius.Radius(secret, host='radius')
try:
print('success' if r.authenticate(username, password) else 'failure')
sys.exit(0)
except radius.ChallengeResponse as e:
pass
# The ChallengeResponse exception has `messages` and `state` attributes
# `messages` can be displayed to the user to prompt them for their
# challenge response. `state` must be echoed back as a RADIUS attribute.
# Send state as an attribute _IF_ provided.
attrs = {'State': e.state} if e.state else {}
# Finally authenticate again using the challenge response from the user
# in place of the password.
print('success' if r.authenticate(username, response, attributes=attrs)
else 'failure')
This module has extensive logging, enable it using the Python logging framework.
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
radius-0.0.4.tar.gz
(9.0 kB
view hashes)
Built Distribution
Close
Hashes for radius-0.0.4-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | cb46dbd0c1caaa951e118dee74b1c0adef33d634df5214d6cd9b8c1c54e24f9d |
|
MD5 | 28e9ff03ba39dac4d0f6c09851753756 |
|
BLAKE2b-256 | 01740c2564eb261a04faa9aea250270b325161c8f4d8116cf3803ba333f7159c |