mod_auth_openidc 项目使用教程

mod_auth_openidc 项目使用教程

mod_auth_openidcOpenID Certified™ OpenID Connect Relying Party implementation for Apache HTTP Server 2.x项目地址:https://gitcode.com/gh_mirrors/mo/mod_auth_openidc

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

mod_auth_openidc/
├── AUTHORS
├── ChangeLog
├── INSTALL
├── LICENSE.txt
├── Makefile.am
├── README.md
├── SECURITY.md
├── auth_openidc.conf
├── autogen.sh
├── configure.ac
├── src/
│   ├── mod_auth_openidc.c
│   ├── ...
├── test/
│   ├── test_cases.sh
│   ├── ...
├── clang-format
├── .gitignore

• AUTHORS: 项目贡献者列表。
• ChangeLog: 项目变更日志。
• INSTALL: 安装指南。
• LICENSE.txt: 项目许可证。
• Makefile.am: 自动生成 Makefile 的配置文件。
• README.md: 项目介绍和使用说明。
• SECURITY.md: 安全相关信息。
• auth_openidc.conf: 项目配置文件示例。
• autogen.sh: 自动生成配置脚本。
• configure.ac: 配置脚本模板。
• src/: 源代码目录。
• test/: 测试脚本和用例。
• clang-format: 代码格式化配置。
• .gitignore: Git 忽略文件配置。

2. 项目的启动文件介绍

项目的启动文件主要是 src/mod_auth_openidc.c，这是模块的主源代码文件，负责实现 OpenID Connect Relying Party (RP) 的功能。

3. 项目的配置文件介绍

项目的配置文件是 auth_openidc.conf，这个文件包含了模块的所有配置选项。以下是一些关键配置项的介绍：

<Location /protected>
    AuthType openid-connect
    Require valid-user
</Location>

<Location /restricted>
    AuthType openid-connect
    Require claim read_restricted:true
</Location>

• <Location /protected>: 定义受保护的 URL 路径，要求用户有效。
• <Location /restricted>: 定义受限的 URL 路径，要求用户具有特定的声明。

完整的配置选项可以参考 auth_openidc.conf 文件，该文件也可以作为 httpd.conf 的包含文件。

mod_auth_openidcOpenID Certified™ OpenID Connect Relying Party implementation for Apache HTTP Server 2.x项目地址:https://gitcode.com/gh_mirrors/mo/mod_auth_openidc