Authelia与MeshCentral的OpenID Connect集成指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00838/article/details/148361965

Authelia与MeshCentral的OpenID Connect集成指南

authelia The Single Sign-On Multi-Factor portal for web apps 项目地址: https://gitcode.com/gh_mirrors/au/authelia

前言

在现代IT基础设施管理中，远程设备管理工具MeshCentral与身份认证代理Authelia的集成，能够为企业提供安全可靠的远程访问解决方案。本文将详细介绍如何通过OpenID Connect协议将MeshCentral与Authelia进行集成。

环境准备

版本兼容性

Authelia版本：v4.39.4及以上
MeshCentral版本：v1.1.44及以上

基础假设

在开始配置前，我们需要明确以下基础信息：

MeshCentral访问地址：https://meshcentral.example.com/
Authelia服务地址：https://auth.example.com/
客户端ID：meshcentral
客户端密钥：insecure_secret（生产环境请使用更安全的密钥）

Authelia配置详解

客户端配置

在Authelia的配置文件configuration.yml中，需要添加MeshCentral作为OIDC客户端。以下是关键配置项说明：

identity_providers:
  oidc:
    clients:
      - client_id: 'meshcentral'  # 客户端唯一标识
        client_name: 'MeshCentral'  # 客户端显示名称
        client_secret: '$pbkdf2-sha512$...'  # 客户端密钥的PBKDF2哈希值
        public: false  # 是否为公共客户端
        authorization_policy: 'two_factor'  # 要求双因素认证
        redirect_uris:
          - 'https://meshcentral.example.com/auth-oidc-callback'  # 回调地址
        scopes:
          - 'openid'  # 必须包含的基础scope
          - 'profile'  # 用户基本信息
          - 'email'    # 用户邮箱信息
        userinfo_signed_response_alg: 'none'  # 用户信息签名算法
        token_endpoint_auth_method: 'client_secret_basic'  # 认证方式

配置要点说明

客户端密钥：生产环境不应使用示例中的简单密钥，应生成强随机密钥并使用Authelia提供的工具进行哈希处理
认证策略：two_factor表示要求用户完成双因素认证才能访问
回调地址：必须与MeshCentral配置中的地址完全匹配
scope配置：至少需要包含openid，根据需求可添加其他scope

MeshCentral配置详解

配置文件方式

在MeshCentral的config.json配置文件中添加OIDC认证策略：

{
  "domains": {
    "": {
      "title": "Example",
      "title2": "example.com",
      "authStrategies": {
        "oidc": {
          "issuer": "https://auth.example.com",  // Authelia服务地址
          "clientid": "meshcentral",  // 与Authelia配置匹配的客户端ID
          "clientsecret": "insecure_secret",  // 客户端密钥
          "newAccounts": true  // 是否允许自动创建新账户
        }
      }
    }
  }
}