Apache Kerby 项目使用教程
1. 项目的目录结构及介绍
Apache Kerby 项目的目录结构如下:
directory-kerby/
├── benchmark
├── build-tools
├── docs
├── kerby-backend
├── kerby-common
├── kerby-dist
├── kerby-kdc-test
├── kerby-kdc
├── kerby-kerb
├── kerby-pkix
├── kerby-provider
├── kerby-tool
├── parent
├── asf.yaml
├── .gitignore
├── BUILDING.txt
├── LICENSE
├── NOTICE
├── README.md
└── pom.xml
目录介绍
- benchmark: 包含性能测试相关的文件。
- build-tools: 包含构建工具相关的文件。
- docs: 包含项目文档。
- kerby-backend: 包含后端实现。
- kerby-common: 包含通用模块。
- kerby-dist: 包含分发包。
- kerby-kdc-test: 包含 KDC 测试相关文件。
- kerby-kdc: 包含 KDC 实现。
- kerby-kerb: 包含 Kerberos 相关实现。
- kerby-pkix: 包含 PKIX 相关实现。
- kerby-provider: 包含提供者实现。
- kerby-tool: 包含工具类。
- parent: 包含父项目配置。
- asf.yaml: Apache 项目配置文件。
- .gitignore: Git 忽略文件配置。
- BUILDING.txt: 构建说明文件。
- LICENSE: 许可证文件。
- NOTICE: 版权声明文件。
- README.md: 项目介绍文件。
- pom.xml: Maven 项目配置文件。
2. 项目的启动文件介绍
Apache Kerby 项目的启动文件主要位于 kerby-kdc
目录下。以下是一些关键的启动文件:
- KerbyKdcServer.java: KDC 服务器的主启动类。
- KerbyKdcServerMain.java: KDC 服务器的主入口类。
启动步骤
- 确保已安装 Java 和 Maven。
- 克隆项目到本地:
git clone https://github.com/apache/directory-kerby.git
- 进入项目目录:
cd directory-kerby
- 编译项目:
mvn clean install
- 启动 KDC 服务器:
cd kerby-kdc/target/kerby-kdc-2.0.3-SNAPSHOT/bin ./start-kdc.sh
3. 项目的配置文件介绍
Apache Kerby 项目的配置文件主要位于 kerby-kdc
目录下。以下是一些关键的配置文件:
- kdc.conf: KDC 服务器的配置文件,包含端口、日志级别等配置。
- krb5.conf: Kerberos 客户端的配置文件,包含 KDC 地址、域名等配置。
配置文件示例
kdc.conf
[kdcdefaults]
kdc_ports = 88
kdc_tcp_ports = 88
[realms]
EXAMPLE.COM = {
kdc_hostname = localhost
kdc_ports = 88
kdc_tcp_ports = 88
default_principal_flags = +preauth
}
krb5.conf
[libdefaults]
default_realm = EXAMPLE.COM
dns_lookup_realm = false
dns_lookup_kdc = false
ticket_lifetime = 24h
renew_lifetime = 7d
forwardable = true
[realms]
EXAMPLE.COM = {
kdc = localhost:88
admin_server = localhost:749
default_domain = example.com
}
[domain_realm]
.example.com = EXAMPLE.COM
example.com = EXAMPLE.COM
通过以上配置文件,可以对 KDC 服务器和 Kerberos 客户端进行详细的配置。