Zabbix5 对接 SAML 协议 SSO

  在 Zabbix5.0 开始已经支持 SAML 认证

官文文档：

https://www.zabbix.com/documentation/current/manual/web_interface/frontend_sections/administration/authentication

首先给出了统一认证地址和单点退出地址。

然后有两步操作

1. 在 Zabbix 服务器放一个 IDP 证书文件。
2. 在 Zabbix 上配置 SAML 对接信息。

对接 Keycloak SAML 示例

环境

# Zabbix

http://192.168.20.72/zabbix

# SSO

http://my.keycloak.com/

添加证书文件

首先在 Zabbix 服务器的 /usr/share/zabbix/conf/certs 目录创建 idp.crt 文件

/usr/share/zabbix/conf/certs/idp.crt

文件内容来自 Keycloak “领域设置” --> “秘钥” --> “证书”。

这个修改不需要重启 Zabbix。

创建客户端

然后在 Keycloak 中创建 saml 客户端 test_saml_zabbix。

配置如下

IDP发起的SSO URL名称：

http://my.keycloak.com/auth/realms/master/protocol/saml/clients/test_saml_zabbix

断言使用者服务POST绑定URL ：

http://192.168.20.72/zabbix/index_sso.php?acs

在客户端模板标签页，移除 role_list。

Mappers 标签页中，添加 User Property 映射器，名称、属性、SAML Attribute Name 三项全部写成 username。

在 Zabbix 中配置 SAML 认证

进入 “管理” --> “认证”，选择“SAML settings”标签。

勾选启用。

配置如下：

# 启用 SAML

Enable SAML authentication

勾选

# 根据实际 Keycloak 地址填写

IdP entity ID

http://my.keycloak.com/auth/realms/master

# Keycloak 中 SAML 客户端的 IDP发起的SSO URL名称

SSO service URL

http://my.keycloak.com/auth/realms/master/protocol/saml/clients/test_saml_zabbix

# Keycloak 中创建的 Mappers

Username attribute

username

# Keycloak 客户端ID

SP entity ID

test_saml_zabbix

# 用户名不区分大小写，根据需要，Zabbix 的默认 Admin 用户，首字母是大写的，可能映射不到。

登录区分大小写

取消勾选

最后，通过 SAML 登录的用户，必须提前在 Zabbix 中创建好。