FusionDirectory 技术文档

1. 安装指南

1.1 系统要求

在安装FusionDirectory之前，请确保您的系统满足以下要求：

• 支持的操作系统：Linux（推荐使用Debian或Ubuntu）
• 依赖软件：Apache、PHP、LDAP服务器（如OpenLDAP）
• 其他依赖：php-ldap、php-xml、php-json等PHP扩展

1.2 安装步骤

1. 安装依赖：

   sudo apt-get update
   sudo apt-get install apache2 php libapache2-mod-php php-ldap php-xml php-json
   

2. 下载FusionDirectory：

   wget https://github.com/fusiondirectory/fusiondirectory/releases/download/v1.4/fusiondirectory-1.4.tar.gz
   tar -xvzf fusiondirectory-1.4.tar.gz
   cd fusiondirectory-1.4
   

3. 配置Apache：

   sudo cp -r fusiondirectory /var/www/html/
   sudo chown -R www-data:www-data /var/www/html/fusiondirectory
   sudo chmod -R 755 /var/www/html/fusiondirectory
   

4. 配置FusionDirectory：

   • 编辑/var/www/html/fusiondirectory/include/config.inc.php文件，配置LDAP连接信息。
   • 设置LDAP服务器地址、管理员DN和密码。

5. 启动Apache服务：

   sudo systemctl restart apache2
   

6. 访问FusionDirectory：

   • 打开浏览器，访问http://<服务器IP>/fusiondirectory，按照向导完成初始配置。

2. 项目使用说明

2.1 用户管理

FusionDirectory提供了用户、组、邮件、sudo、ssh、系统、服务等的管理功能。用户可以通过界面轻松管理这些数据。

2.2 角色管理

FusionDirectory支持复杂角色管理，允许管理员为不同角色分配不同的权限。常见的角色包括：

• 用户：可以登录并修改自己的数据。
• 本地管理员：可以管理用户、组和分支。
• 全局管理员：拥有所有操作权限。
• 人力资源：只能从模板创建用户。

2.3 触发器

FusionDirectory内置了触发器系统，可以在特定操作（如创建、编辑、删除用户）时自动执行脚本。例如，创建用户时可以自动生成访问卡或发送欢迎邮件。

2.4 与非LDAP应用的交互

对于不支持LDAP的应用，FusionDirectory提供了插件和Argonaut模块，帮助管理员将这些应用与LDAP集成。

3. 项目API使用文档

3.1 API概述

FusionDirectory提供了简单的API接口，允许开发者通过编程方式与系统交互。API支持的操作包括：

• 用户管理：创建、编辑、删除用户
• 组管理：创建、编辑、删除组
• 系统管理：管理服务器和服务

3.2 API调用示例

以下是一个使用API创建用户的示例：

$api = new FusionDirectoryAPI('http://<服务器IP>/fusiondirectory/api');
$api->login('admin', 'password');
$userData = [
    'cn' => 'John Doe',
    'sn' => 'Doe',
    'givenName' => 'John',
    'mail' => '[e-mail]'
];
$api->createUser($userData);
$api->logout();

4. 项目安装方式

FusionDirectory的安装方式主要包括以下几种：

• 手动安装：按照上述步骤手动下载、配置和安装。
• 包管理器安装：在支持的发行版上，可以使用包管理器（如apt）直接安装。
• Docker安装：FusionDirectory提供了Docker镜像，方便用户通过容器化方式部署。

4.1 手动安装

详见安装指南。

4.2 包管理器安装

在Debian/Ubuntu系统上，可以使用以下命令安装：

sudo apt-get install fusiondirectory

4.3 Docker安装

1. 拉取FusionDirectory Docker镜像：

   docker pull fusiondirectory/fusiondirectory
   

2. 运行容器：

   docker run -d -p 80:80 fusiondirectory/fusiondirectory
   

3. 访问http://<服务器IP>/fusiondirectory，完成初始配置。

通过以上步骤，您可以顺利安装并使用FusionDirectory，管理LDAP目录中的数据。