如何配置Nextcloud User_Saml通过请求头传递多用户组

网关需要提供的内容 #

由于你采用的是environment-variable模式，网关需将用户的角色/组信息以环境变量形式传递给Nextcloud：

• 自定义一个环境变量（推荐用HTTP_X_前缀避免冲突，比如HTTP_X_USER_ROLES）
• 变量值为逗号分隔的组名称列表，示例：admin,editor,regular_user

Nextcloud 端配置命令 #

使用occ saml:config:set命令配置group_mapping，格式为{环境变量名}=>{Nextcloud组名}，多组映射用分号;分隔。

场景1：网关组名与Nextcloud组名完全一致 #

直接让Nextcloud自动同步匹配所有组，用通配符*实现：

sudo -u nginx -- /nextcloud/html/occ saml:config:set --saml-attribute-mapping-group_mapping="HTTP_X_USER_ROLES=>*" 1

执行后，Nextcloud会自动创建不存在的组，并将用户添加到对应组中。

场景2：网关组名需映射为不同的Nextcloud组名 #

比如网关传递的admin对应Nextcloud的管理员，editor对应内容编辑者，命令如下：

sudo -u nginx -- /nextcloud/html/occ saml:config:set --saml-attribute-mapping-group_mapping="HTTP_X_USER_ROLES=>admin=>管理员;HTTP_X_USER_ROLES=>editor=>内容编辑者" 1

验证配置正确性 #

执行以下命令查看当前SAML配置，确认group_mapping已生效：

sudo -u nginx -- /nextcloud/html/occ saml:config:get 1

内容的提问来源于stack exchange，提问作者Steve Bosman