【亲测免费】 开源项目 ZITADEL OIDC 使用教程

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

zitadel/oidc
├── cmd
│   └── oidc
│       └── main.go
├── config
│   └── config.yaml
├── docs
│   └── README.md
├── internal
│   ├── handlers
│   │   └── handlers.go
│   └── services
│       └── services.go
├── pkg
│   └── utils
│       └── utils.go
├── go.mod
├── go.sum
└── README.md

• cmd: 包含项目的启动文件。
• config: 包含项目的配置文件。
• docs: 包含项目的文档文件。
• internal: 包含项目的内部逻辑，如处理程序和服务。
• pkg: 包含项目的公共库，如工具函数。
• go.mod 和 go.sum: Go 模块文件，用于管理依赖。
• README.md: 项目的主文档文件。

2. 项目的启动文件介绍

在 cmd/oidc/main.go 文件中，定义了项目的启动逻辑。以下是简要介绍：

package main

import (
    "log"
    "net/http"
    "zitadel/oidc/config"
    "zitadel/oidc/internal/handlers"
)

func main() {
    // 加载配置
    cfg, err := config.LoadConfig("config/config.yaml")
    if err != nil {
        log.Fatalf("Failed to load config: %v", err)
    }

    // 设置路由
    http.HandleFunc("/auth", handlers.AuthHandler)
    http.HandleFunc("/callback", handlers.CallbackHandler)

    // 启动服务器
    log.Printf("Starting server on :%d", cfg.Port)
    if err := http.ListenAndServe(fmt.Sprintf(":%d", cfg.Port), nil); err != nil {
        log.Fatalf("Failed to start server: %v", err)
    }
}

• main 函数: 项目的入口点，负责加载配置、设置路由和启动 HTTP 服务器。
• config.LoadConfig: 加载配置文件。
• handlers: 处理 HTTP 请求的处理程序。

3. 项目的配置文件介绍

在 config/config.yaml 文件中，定义了项目的配置信息。以下是简要介绍：

port: 8080
client_id: "your_client_id"
client_secret: "your_client_secret"
redirect_uri: "http://localhost:8080/callback"
issuer: "https://your-issuer.com"

• port: 服务器监听的端口。
• client_id 和 client_secret: OIDC 客户端的 ID 和密钥。
• redirect_uri: 认证后的回调地址。
• issuer: OIDC 提供者的地址。

以上是 ZITADEL OIDC 项目的目录结构、启动文件和配置文件的介绍。希望这份文档能帮助你更好地理解和使用该项目。