https://github.com/radcli/radcli
A simple RADIUS client library
https://github.com/radcli/radcli
freeradius-client radius radiusclient-ng
Last synced: 4 months ago
JSON representation
A simple RADIUS client library
- Host: GitHub
- URL: https://github.com/radcli/radcli
- Owner: radcli
- License: other
- Created: 2015-11-21T12:59:00.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2025-09-18T09:05:42.000Z (10 months ago)
- Last Synced: 2026-02-13T12:46:11.733Z (5 months ago)
- Topics: freeradius-client, radius, radiusclient-ng
- Language: C
- Homepage: https://radcli.github.io/radcli/
- Size: 2.26 MB
- Stars: 72
- Watchers: 8
- Forks: 55
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
- Authors: AUTHORS
Awesome Lists containing this project
README
# The radcli library
## Introduction
The radcli library is a library for writing RADIUS Clients. The library's
approach is to allow writing RADIUS-aware application in less than 50 lines
of C code. It was based originally on freeradius-client and radiusclient-ng
and is source compatible with them.
## Background
For the development of the openconnect VPN server, I needed a simple library to
allow using radius for authentication and accounting without having to understand
the internals of radius. Such library was the freeradius-client library, but
was undocumented, had too much legacy code centered around radlogin, a tool
which is of no significance today, was IPv4-only and had no releases for
several years, and zero tests.
This library addresses these shortcomings, adds a test suite and test driven
development, adds package management via pkg-config, adds support for TCP,
TLS and DTLS, provides documentation of the API, and will include any new
features for the task. It is provided as a shared library in case it is
useful to other projects as well, and is also made source compatible with
radiusclient-ng and freeradius-client.
## Documentation
Documentation and examples are available at:
http://radcli.github.io/radcli/
## Compilation
Run autogen.sh to generate the configure script and makefiles.
Required dependencies (Fedora/RHEL pkg):
```
dnf install -y autoconf libtool automake nettle-devel gnutls-devel gettext-devel libabigail doxygen doxy2man
```
## Contributing/Submitting pull requests
For adding new features or extending functionality in addition to the code,
please also submit a test program which verifies the correctness of operation.
See `tests/` and `.travis.yml` for the existing test suite.
## Bug reporting
Please use the issue tracker at:
https://github.com/radcli/radcli/issues
## Web Site
The web site http://radcli.github.io/radcli is the primary web-site for
radcli and is auto-generated via the 'make web' rule.