Mattermost 安全加固实战:会话与上传收口

Mattermost 安全加固的核心只有三件事:把入口从「谁都能注册」改成「只能被邀请」,把会话与访问令牌的有效期压到可接受范围,把文件外链与 Webhook 这类出站通道逐个关掉。本文以 9.x 自建实例为对象,用 mmctl 逐项落地,配置改完即时生效,不需要重启服务。

很多团队把 Mattermost 当成内部 IM 随手部署,装完就把 8065 端口挂到公网,结果既没有注册限制也没有上传限制,最后变成公开的图床和垃圾账号温床。下面按「身份入口 — 会话令牌 — 数据面 — 代理层」四层收口,每层都给出可验证的检查命令。

适用场景

  • 自建 Mattermost 已上线,但没做过注册管控与上传限制,存在被批量注册、被当图床滥用的风险
  • 安全评估或等保整改要求提供「账号只能由管理员创建」「会话超时」「外发通道受控」的配置证据
  • 团队已接入 SSO,需要关闭本地密码登录、只保留企业身份源
  • 出现过来历不明的 Incoming Webhook 把消息推到外部群,需要排查并收口

前置条件

  • Mattermost 9.x(Team Edition 或 Enterprise Edition),PostgreSQL 13 及以上
  • 具备 mattermost 系统用户权限,mmctl --local 依赖本机 unix socket,必须在该用户下执行
  • 前置 Nginx 已完成 HTTPS,ServiceSettings.SiteURL 与实际访问域名一致
  • 已有可回滚的备份:pg_dump 一份数据库、config/config.json 一份配置
  • 注意:mmctl config set 修改的是运行中的配置,部分项(如端口、数据目录)需要重启进程才彻底生效

原理说明

Mattermost 的配置只有一份事实来源:config/config.json。启动后它被读入内存并写入数据库,mmctl --local config set 走 unix socket 直接改运行态,所以绝大多数安全项改完立刻生效,日志里能看到 config 变更记录。这一点很关键:不要直接编辑 config.json 后指望热加载,进程不重启就会在下次写配置时被内存值覆盖回去。

四层收口的逻辑各不相同:

  • 身份入口层:EnableOpenServer 为 true 时任何人都能在登录页自助建号;置为 false 后只能由管理员创建或通过邀请链接加入。配合 TeamSettings.EnableOpenInvite 关闭「任意成员可生成邀请链接」,才算真正收口
  • 会话与令牌层:SessionLengthWebInDays 控制 Web 会话存活时间,默认 30 天对内部工具偏长;EnableUserAccessTokens 允许用户自建长期令牌,这类令牌不受会话超时约束,是横向移动最常被利用的凭据
  • 数据面:FileSettings.EnablePublicLink 打开后,任何成员都能把附件转成不需要登录的外链;FileSettings.Directory 若落在 Nginx 的站点根目录内,附件可被直接遍历下载
  • 代理层:HSTS、CSP、X-Frame-Options 只能在 Nginx 补,Mattermost 自身不输出这些头;/api/v4/config 这类系统接口应限制来源网段

还有一个容易被忽略的项:ServiceSettings.AllowedUntrustedInternalConnections。Mattermost 的出站 Webhook 和 Slash 命令会由服务端发起 HTTP 请求,默认禁止访问内网地址以防 SSRF。一旦为了「让机器人调内网接口」把它填成 10.0.0.0/8,就等于把整个内网的回连能力交给了任何能建 Webhook 的成员——这是自建实例最常见的 SSRF 敞口。

操作步骤

1. 身份入口收口

以下命令全部在 mattermost 用户下执行,--local 表示通过本地 socket 通信,不需要额外的管理员令牌:

sudo -u mattermost mmctl --local config set ServiceSettings.SiteURL https://chat.example.com
sudo -u mattermost mmctl --local config set ServiceSettings.EnableOpenServer false
sudo -u mattermost mmctl --local config set TeamSettings.EnableOpenInvite false
sudo -u mattermost mmctl --local config set EmailSettings.RequireEmailVerification true
sudo -u mattermost mmctl --local config set PrivacySettings.ShowEmailAddress false

EnableOpenServer=false 是这一步的分水岭:改之前登录页有「创建账户」,改之后只剩登录框,新成员必须由管理员在系统控制台创建,或由管理员生成一次性邀请链接。如果企业已接入 GitLab / OIDC 单点登录,还要同时关闭本地注册,避免绕过 SSO 建号:

sudo -u mattermost mmctl --local config set GitLabSettings.Enable true
sudo -u mattermost mmctl --local config set GitLabSettings.Id <GitLab OAuth App ID>
sudo -u mattermost mmctl --local config set GitLabSettings.Secret <GitLab OAuth App Secret>
sudo -u mattermost mmctl --local config set GitLabSettings.AuthEndpoint https://git.example.com/oauth/authorize
sudo -u mattermost mmctl --local config set GitLabSettings.TokenEndpoint https://git.example.com/oauth/token
sudo -u mattermost mmctl --local config set GitLabSettings.UserApiEndpoint https://git.example.com/api/v4/user

2. 会话与令牌收口

把会话压到 1 天,禁用个人访问令牌,关闭双向 Webhook。真正需要机器人集成的场景,改用 Bot 账号 + 限定来源 IP 的方式,而不是给每个人开长令牌:

sudo -u mattermost mmctl --local config set ServiceSettings.SessionLengthWebInDays 1
sudo -u mattermost mmctl --local config set ServiceSettings.SessionLengthSSOInDays 1
sudo -u mattermost mmctl --local config set ServiceSettings.SessionLengthMobileInDays 7
sudo -u mattermost mmctl --local config set ServiceSettings.EnableUserAccessTokens false
sudo -u mattermost mmctl --local config set ServiceSettings.EnableIncomingWebhooks false
sudo -u mattermost mmctl --local config set ServiceSettings.EnableOutgoingWebhooks false
sudo -u mattermost mmctl --local config set ServiceSettings.EnableCommands false
sudo -u mattermost mmctl --local config set ServiceSettings.AllowedUntrustedInternalConnections ""
sudo -u mattermost mmctl --local config set ServiceSettings.EnableMultifactorAuthentication true
sudo -u mattermost mmctl --local config set RateLimitSettings.Enable true
sudo -u mattermost mmctl --local config set RateLimitSettings.PerSec 20

存量令牌不会因为开关关闭而失效,必须逐个撤销。列出全部令牌并确认哪些是活跃集成:

# 列出所有用户的访问令牌(需要系统管理员身份)
sudo -u mattermost mmctl --local token list --all

# 撤销指定用户的全部令牌
sudo -u mattermost mmctl --local token revoke --all --user someone@example.com

3. 数据面上传与存储收口

把附件目录移出 Web 根目录,关掉公开链接,限制单文件体积与图片像素,避免被当成免费图床:

# 迁移附件目录(先停服务,改完再启动,避免写入丢失)
sudo systemctl stop mattermost
sudo mkdir -p /srv/mattermost-data
sudo rsync -a /opt/mattermost/data/ /srv/mattermost-data/
sudo chown -R mattermost:mattermost /srv/mattermost-data
sudo chmod 750 /srv/mattermost-data
sudo -u mattermost mmctl --local config set FileSettings.Directory /srv/mattermost-data/
sudo systemctl start mattermost

# 上传限制
sudo -u mattermost mmctl --local config set FileSettings.EnablePublicLink false
sudo -u mattermost mmctl --local config set FileSettings.MaxFileSize 26214400
sudo -u mattermost mmctl --local config set FileSettings.MaxImageDecoderConcurrency -1
sudo -u mattermost mmctl --local config set ImageSettings.Enable true

26214400 即 25MB,按业务实际需要往下压;图片像素上限由 FileSettings.MaxImageResolution 与本项共同约束,防止超大图片在解码阶段耗尽内存。目录权限 750 保证 Nginx 进程即使误配也读不到原始文件。

4. 代理层补安全响应头

Mattermost 不输出 HSTS 与 CSP,必须在 Nginx 补,同时把系统接口限制到内网:

server {
    listen 443 ssl;
    http2 on;
    server_name chat.example.com;

    ssl_certificate     /etc/letsencrypt/live/chat.example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/chat.example.com/privkey.pem;
    ssl_protocols       TLSv1.2 TLSv1.3;
    ssl_ciphers         ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256;
    ssl_prefer_server_ciphers off;

    add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
    add_header X-Content-Type-Options "nosniff" always;
    add_header X-Frame-Options "SAMEORIGIN" always;
    add_header Referrer-Policy "strict-origin-when-cross-origin" always;
    add_header Content-Security-Policy "default-src 'self'; img-src 'self' data: https:; style-src 'self' 'unsafe-inline'; connect-src 'self' wss://chat.example.com" always;

    client_max_body_size 30m;

    location / {
        proxy_pass http://127.0.0.1:8065;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_read_timeout 300s;
    }

    # 系统配置与集群接口只允许内网访问
    location ~ ^/api/v4/(config|system|cluster|license) {
        allow 10.0.0.0/8;
        allow 127.0.0.1;
        deny  all;
        proxy_pass http://127.0.0.1:8065;
        proxy_set_header Host $host;
    }
}

最后让 8065 只监听回环,杜绝绕过 Nginx 直连:

sudo -u mattermost mmctl --local config set ServiceSettings.ListenAddress "127.0.0.1:8065"
sudo systemctl restart mattermost
sudo nginx -t && sudo systemctl reload nginx

配置验证

# 1) 确认关键项已生效
sudo -u mattermost mmctl --local config get ServiceSettings.EnableOpenServer
sudo -u mattermost mmctl --local config get ServiceSettings.EnableUserAccessTokens
sudo -u mattermost mmctl --local config get FileSettings.EnablePublicLink
sudo -u mattermost mmctl --local config get FileSettings.Directory

# 2) 8085 不应出现在公网网卡上
ss -tlnp | grep 8065

# 3) 安全响应头
curl -sI https://chat.example.com | grep -iE 'strict-transport|x-frame|content-security|referrer'

# 4) 未登录访问系统接口应被 403 拦截
curl -s -o /dev/null -w '%{http_code}\n' https://chat.example.com/api/v4/config

# 5) 服务健康
curl -s https://chat.example.com/api/v4/system/ping

预期结果:前四项分别为 false、false、false、/srv/mattermost-data/;端口只出现 127.0.0.1:8065;四个安全头齐全;系统接口返回 403;ping 返回 {"status":"OK"}。

常见问题

FAQ 1:关闭 EnableOpenServer 后,已有账号会被踢下线吗?

不会。该项只影响自助注册入口,与登录态无关,存量用户照常登录。真正会踢下线的是 SessionLengthWebInDays:把它从 30 改成 1,旧会话在下一次校验时因超期而失效,用户需重新登录。建议在低峰期改,并提前通知。

FAQ 2:关掉 Incoming Webhooks 后,现有的告警机器人全挂了怎么办?

这是预期行为。Webhook URL 一旦泄露就是无鉴权写入通道,不适合长期开放。迁移路径是改用 Bot 账号 + 个人访问令牌,并把令牌限定到单个团队、设置过期时间,由 Nginx 对调用来源做 IP 白名单。若暂时不能迁移,可只对指定团队开启 Webhook,并用 ServiceSettings.AllowedUntrustedInternalConnections 保持为空,禁止其回连内网。

FAQ 3:迁移附件目录后,历史图片全部 404?

说明 rsync 没有保留属主,或服务未重启。检查 /srv/mattermost-data 下是否存在 data/<teamid>/channels/<channelid>/images/ 结构,属主必须是 mattermost:mattermost;另外 FileSettings.Directory 的结尾斜杠要保留,缺少斜杠会把路径拼成 /srv/mattermost-datadata。

总结

Mattermost 的安全边界不在应用本身,而在「谁能进来、能带什么出去」。把 EnableOpenServer 关掉解决入口,把 SessionLengthWebInDays 与 EnableUserAccessTokens 收紧解决凭据,把 EnablePublicLink 与出站 Webhook 关掉解决数据外流,最后用 Nginx 补上应用不输出的安全头并限制系统接口。四层做完,一个默认部署的「公开聊天室」才变成一个可控的内部协作平台。上线后建议每月复查一次令牌清单与附件目录权限,这两处是最容易被重新打开的口子。