TACACS+客户端工具包技术文档

本文档将详细介绍如何安装、使用以及配置TACACS+客户端工具包，包括其API使用说明。以下是本文档的结构：

1. 安装指南
2. 项目使用说明
3. 项目API使用文档
4. 项目安装方式

1. 安装指南

基本安装

该模块在大多数Linux发行版中可用：

sudo apt install libpam-tacplus

若要从源代码编译，需要使用GNU autotools 和 gnulib：

sudo apt install libpam-tacplus autoconf build-essential libtool automake libpam-dev libssl-dev gnulib

git clone https://github.com/kravietz/pam_tacplus.git
cd pam-tacplus

gnulib-tool --makefile-name=Makefile.gnulib --libtool --import \
                  fcntl crypto/md5 array-list list xlist getrandom realloc-posix \
                  explicit_bzero xalloc getopt-gnu

autoreconf -f -v -i
./configure
make
sudo make install

如果需要将pam_tacplus.so安装到/lib/security而不是/usr/local，可以使用./configure --libdir=/lib选项。在这种情况下，需要相应调整/etc/pam.d文件中的行。

过时gnulib处理

如果在运行./configure时遇到如下错误：

error: GL_GENERATE_ALLOCA_H does not appear in AM_CONDITIONAL

则可能是gnulib版本过旧。解决方法是安装最新版的gnulib：

git clone https://git.savannah.gnu.org/git/gnulib.git $HOME/gnulib
$HOME/gnulib/gnulib-tool --makefile-name=Makefile.gnulib --libtool --import \
                  fcntl crypto/md5 array-list list xlist getrandom realloc-posix \
                  explicit_bzero xalloc
autoreconf -f -v -i
./configure
...

2. 项目使用说明

项目包含三个模块，通常用于向TACACS+服务器发送请求：

• libtac - 核心TACACS+客户端库
• pam_tacplus - PAM模块，用于验证用户身份
• tacc - 简单的命令行TACACS+客户端

支持以下TACACS+核心功能：

TACACS+名称	PAM名称	功能描述
Authentication	Authenticate	验证用户是否为其声明的身份
Authorization	Account management	用户是否有权使用服务X
Account	Session open/close	记录服务的开始和结束

TACACS+协议由Cisco Systems在90年代设计，旨在为简单网络路由器（例如通过PPP连接）提供对中央身份验证服务器的简单验证手段。路由器可以发送关于身份验证、授权和计账的查询。服务器可以响应简单的是/否响应，或发送包含密码提示等属性的响应。

3. 项目API使用文档

由于项目API使用文档通常涉及详细的技术规格和示例代码，这里仅提供概览。具体API文档应参考项目源代码和相关开发文档。

4. 项目安装方式

项目安装方式已在“基本安装”部分提供。以下是简要步骤：

1. 安装必要的依赖项。
2. 克隆项目仓库。
3. 运行gnulib-tool导入必要的库。
4. 运行autoreconf。
5. 配置项目。
6. 编译并安装项目。

以上步骤将帮助用户成功安装并使用TACACS+客户端工具包。