인증서 기반 인증(실험적)

Mattermost v11.11번역일: 2026-09-02원본 보기

Enterprise, Enterprise Advanced 플랜에서 사용할 수 있습니다.

중요

실험적 인증서 기반 인증은 Mattermost v11.0부터 사용 중단되었습니다. Mattermost v11부터는 서버를 시작하려면 이 기능을 비활성화해야 합니다. 이 설정을 활성화하면 서버가 시작되지 않습니다.

v11 이전에는 인증서 기반 인증(CBA)이 실험적 기능으로 제공되어, Mattermost 접근을 허용하기 전에 사용자나 기기를 식별하고 시스템 접근에 추가 보안 계층을 제공했습니다.

시작하기 전에, SSL 및 HTTP/2를 적용한 프록시로서의 NGINX 구성과 Let's Encrypt 같은 유효한 SSL 인증서를 포함해 시스템에 Mattermost를 설치하는 공식 가이드를 따르세요.

그런 다음 아래 단계를 따라 브라우저와 Mattermost 데스크톱 앱에 대한 사용자 CBA를 구성하세요. 개인 기기(BYOD)별 인증서 배포와 수명 주기 관리는 OpenSSL 같은 서비스로 처리할 수 있습니다.

웹 앱용 상호 TLS 인증 설정

상호 TLS 인증 설정은 인증서 기반 인증을 구성하는 첫 단계입니다.

클라이언트 인증서로 로그인하도록 Mattermost 서버 설정

  1. Mattermost 서버에 유효한 Enterprise 라이선스가 적용되어 있는지 확인합니다.
  2. config.json 파일의 ExperimentalSettings에서 ClientSideCertEnable을 true로 설정하고, ClientSideCertCheck를 다음 값 중 하나로 설정합니다.
  • primary - 클라이언트 측 인증서가 검증된 뒤, 인증서에서 사용자의 이메일을 가져와 비밀번호 없이 로그인하는 데 사용합니다.
  • secondary - 클라이언트 측 인증서가 검증된 뒤, 인증서에서 사용자의 이메일을 가져와 사용자가 입력한 이메일과 대조합니다.

두 값이 일치하면 사용자는 일반 이메일/비밀번호 자격 증명으로 로그인합니다.

그러면 config.json 파일에는 다음 줄이 포함되어야 합니다.

  "ExperimentalSettings": {
      "ClientSideCertEnable": true,
      "ClientSideCertCheck": "secondary"
  },
  1. Mattermost 서버를 재시작합니다.
  2. https://example.mattermost.com으로 이동해 로그인을 시도합니다. 서버는 x.509 인증서의 emailAddress가 Mattermost 사용자의 이메일과 같을 것을 요구해야 합니다.