LdapCherry 开源项目安装与使用教程

LdapCherry 开源项目安装与使用教程

ldapcherryWeb UI for managing users and groups in multiple directory services.项目地址:https://gitcode.com/gh_mirrors/ld/ldapcherry

1. 项目的目录结构及介绍

ldapcherry/
├── ldapcherry/
│   ├── __init__.py
│   ├── config.py
│   ├── core.py
│   ├── plugins/
│   │   ├── __init__.py
│   │   ├── ldap.py
│   │   ├── active_directory.py
│   │   └── ...
│   └── ...
├── setup.py
├── README.md
├── requirements.txt
└── ...

目录结构介绍

• ldapcherry/: 项目的主目录，包含核心代码和插件。
  • __init__.py: 初始化文件。
  • config.py: 配置管理模块。
  • core.py: 核心功能模块。
  • plugins/: 插件目录，包含各种后端插件，如 LDAP 和 Active Directory。
• setup.py: 安装脚本。
• README.md: 项目说明文档。
• requirements.txt: 项目依赖列表。

2. 项目的启动文件介绍

启动文件

• ldapcherryd: 这是 LdapCherry 的启动脚本，用于启动 LdapCherry 服务。

启动命令

$ ldapcherryd -c /etc/ldapcherry/ldapcherry.ini -D

参数说明

• -c /etc/ldapcherry/ldapcherry.ini: 指定配置文件路径。
• -D: 启用调试模式。

3. 项目的配置文件介绍

配置文件路径

• /etc/ldapcherry/ldapcherry.ini: 主配置文件。
• /etc/ldapcherry/roles.yml: 角色配置文件。
• /etc/ldapcherry/attributes.yml: 属性配置文件。

配置文件内容

ldapcherry.ini

[global]
debug = True
log_level = DEBUG

[backend]
type = ldap
uri = ldap://localhost
base_dn = dc=example,dc=com
bind_dn = cn=admin,dc=example,dc=com
bind_password = secret

roles.yml

roles:
  - name: admin
    description: Administrator role
    permissions:
      - manage_users
      - manage_groups

attributes.yml

attributes:
  - name: cn
    label: Common Name
    type: string
    required: True

配置文件说明

• ldapcherry.ini: 包含全局配置和后端配置。
• roles.yml: 定义角色和权限。
• attributes.yml: 定义用户和组的属性。

通过以上步骤，您可以成功安装、配置并启动 LdapCherry 项目。

ldapcherryWeb UI for managing users and groups in multiple directory services.项目地址:https://gitcode.com/gh_mirrors/ld/ldapcherry