인증 구성 설정

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

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

Mattermost는 서로 다른 최대 4가지 사용자 인증 방식을 동시에 지원합니다.

  • OpenID 공급자
  • SAML 공급자
  • LDAP 인스턴스(예: Active Directory, OpenLDAP)
  • 이메일 및 비밀번호

시스템 콘솔에서 Product 제품 메뉴 아이콘 메뉴를 선택하고 System Console, Authentication을 차례로 선택해 다음 인증 구성 옵션을 확인하고 관리하세요.

팁

자체 호스팅 Mattermost 배포를 관리하는 시스템 관리자는 아래 표에 설명된 대로 config.json 파일을 편집할 수 있습니다. 아래의 각 구성 값에는 JSON을 다룰 수 있는 도구로 config.json 파일에서 해당 값에 프로그래밍 방식으로 접근할 수 있는 JSON 경로가 함께 표시됩니다. 예를 들어 EnableUserCreation 값은 TeamSettings 아래에 있습니다.

  • jq 같은 도구를 사용한다면 다음과 같이 입력합니다: cat config/config.json | jq '.TeamSettings.EnableUserCreation'
  • config.json 파일을 직접 편집할 때는 TeamSettings 같은 객체를 찾은 뒤 그 객체 안에서 EnableUserCreation 키를 찾습니다.

가입

시스템 콘솔에서 Authentication > Signup으로 이동해 다음 구성 설정에 접근합니다.

계정 생성 활성화 (Enable account creation)

  • true: (기본값) 초대 없이도 누구나 이 서버에 사용자 계정을 만들 수 있습니다. 이메일 기반 가입에만 적용됩니다.
  • false: 계정 생성 기능이 비활성화됩니다. Create Account를 선택하면 오류가 표시됩니다. 이메일, OpenID Connect, OAuth 2.0 사용자 계정 인증에 적용됩니다.
  • 시스템 콘솔 경로: Authentication > Signup
  • config.json 설정: TeamSettings > EnableUserCreation > true
  • 환경 변수: MM_TEAMSETTINGS_ENABLEUSERCREATION
참고
  • LDAP과 SAML 사용자는 이 구성 설정의 활성화 여부와 관계없이 LDAP 또는 SAML 사용자 자격 증명으로 로그인해 언제든지 Mattermost 계정을 만들 수 있습니다.
  • Mattermost v10.9부터 꺾쇠괄호로 감싼 이메일 주소(예: <billy@example.com>)는 거부됩니다. 문제를 피하려면 모든 사용자 이메일이 일반 주소 형식(예: billy@example.com)을 따르는지 확인하세요. 또한 영향을 받는 사용자는 Mattermost 접근이나 프로필 관리에 문제를 겪을 수 있으므로, 이 제품 변경에 맞춰 Mattermost 사용자 데이터를 선제적으로 점검하고 갱신할 것을 강력히 권장합니다. mmctl user email로 이러한 사용자 이메일을 직접 갱신할 수 있습니다.
  • Mattermost가 SAML에서 지원하는 암호화 방식에 대한 자세한 내용은 암호화 옵션 문서를 참고하세요.

지정한 이메일 도메인으로 계정 생성 제한 (Restrict account creation to specified email domains)

이 설정은 새 계정이나 팀을 만들 때 사용할 수 있는 이메일 주소 도메인을 제한합니다. 이 제한이 동작하려면 이메일 인증 요구를 true로 설정해야 합니다. 이 설정은 이메일 로그인에만 영향을 줍니다.
  • 시스템 콘솔 경로: Authentication > Signup
  • config.json 설정: TeamSettings > RestrictCreationToDomains
  • 환경 변수: MM_TEAMSETTINGS_RESTRICTCREATIONTODOMAINS

오픈 서버 활성화 (Enable open server)

  • true: 사용자가 초대 없이 서버에 계정을 만들 수 있습니다.
  • false: (기본값) 서버에 계정을 만들려면 초대가 반드시 있어야 합니다.
  • 시스템 콘솔 경로: Authentication > Signup
  • config.json 설정: TeamSettings > EnableOpenServer
  • 환경 변수: MM_TEAMSETTINGS_ENABLEOPENSERVER

이메일 초대 활성화 (Enable email invitations)

  • true: (클라우드 배포 기본값) 사용자가 이메일 초대를 보낼 수 있습니다.
  • false: (자체 호스팅 배포 기본값) 이메일 초대를 비활성화합니다.
  • 시스템 콘솔 경로: Authentication > Signup
  • config.json 설정: ServiceSettings > EnableEmailInvitations > false
  • 환경 변수: MM_SERVICESETTINGS_ENABLEEMAILINVITATIONS
참고

클라우드 관리자는 이 구성 설정을 변경할 수 없습니다.

대기 중인 이메일 초대 무효화 (Invalidate pending email invites)

이 버튼은 아직 수락되지 않은 이메일 초대를 무효화합니다(기본적으로 초대는 48시간이 지나면 만료됩니다).

이 옵션에는 해당하는 config.json 설정이나 환경 변수가 없습니다.
  • 시스템 콘솔 경로: Authentication > Signup
  • config.json 설정: N/A
  • 환경 변수: N/A

이메일

시스템 콘솔에서 Authentication > Email로 이동해 다음 구성 설정에 접근합니다.

이메일 계정 생성 활성화 (Enable account creation with email)

  • true: (기본값) 이메일과 비밀번호로 팀과 사용자 계정을 만들 수 있습니다.
  • false: 이메일과 비밀번호로 팀과 사용자 계정을 만드는 기능을 비활성화합니다. 계정을 만들려면 싱글 사인온(SSO) 서비스가 필요합니다.
  • 시스템 콘솔 경로: Authentication > Email
  • config.json 설정: EmailSettings > EnableSignUpWithEmail
  • 환경 변수: MM_EMAILSETTINGS_ENABLESIGNUPWITHEMAIL
참고

클라우드 관리자는 이 구성 설정을 변경할 수 없습니다.

이메일 인증 요구 (Require email verification)

  • true: (클라우드 배포 기본값) 새 계정이 로그인하기 전에 이메일 인증을 요구합니다.
  • false: (자체 호스팅 배포 기본값) 이메일 인증을 비활성화합니다. 인증 절차를 건너뛰어 개발 속도를 높이는 데 사용할 수 있습니다.
  • 시스템 콘솔 경로: Authentication > Email
  • config.json 설정: EmailSettings > RequireEmailVerification > false
  • 환경 변수: MM_EMAILSETTINGS_REQUIREEMAILVERIFICATION

이메일 로그인 활성화 (Enable sign-in with email)

  • true: (기본값) 사용자가 이메일과 비밀번호로 로그인할 수 있습니다.
  • false: 이메일과 비밀번호 인증을 비활성화하고 로그인 화면에서 해당 옵션을 제거합니다. 인증을 싱글 사인온 서비스로 제한하려면 이 옵션을 사용하세요.
  • 시스템 콘솔 경로: Authentication > Email
  • config.json 설정: EmailSettings > EnableSignInWithEmail
  • 환경 변수: MM_EMAILSETTINGS_ENABLESIGNINWITHEMAIL
참고
  • 로그인 페이지에서 이메일 로그인 옵션 하나만 제공하려면 사용자 이름 로그인 활성화 구성 설정이 false로 지정되어 있는지 확인하세요.
  • Mattermost v10.9부터 꺾쇠괄호로 감싼 이메일 주소(예: <billy@example.com>)는 거부됩니다. 문제를 피하려면 모든 사용자 이메일이 일반 주소 형식(예: billy@example.com)을 따르는지 확인하세요. 또한 영향을 받는 사용자는 Mattermost 접근이나 프로필 관리에 문제를 겪을 수 있으므로, 이 제품 변경에 맞춰 Mattermost 사용자 데이터를 선제적으로 점검하고 갱신할 것을 강력히 권장합니다. mmctl user email로 이러한 사용자 이메일을 직접 갱신할 수 있습니다.

사용자 이름 로그인 활성화 (Enable sign-in with username)

  • true: (기본값) 이메일 주소로 만든 계정에 대해 사용자 이름과 비밀번호로 인증할 수 있습니다. 이 설정은 AD/LDAP 로그인에는 영향을 주지 않습니다.
  • false: 사용자 이름 인증을 비활성화하고 로그인 화면에서 해당 로그인 옵션을 제거합니다.
  • 시스템 콘솔 경로: Authentication > Email
  • config.json 설정: EmailSettings > EnableSignInWithUsername
  • 환경 변수: MM_EMAILSETTINGS_ENABLESIGNINWITHUSERNAME
참고

이메일 기반 인증은 프라이빗 네트워크의 소규모 팀에서만 사용할 것을 강력히 권장합니다.

비밀번호

시스템 콘솔에서 Authentication > Password로 이동해 다음 구성 설정에 접근합니다.

참고

Mattermost v11.0부터 비밀번호 해싱에 보안이 강화된 PBKDF2를 사용합니다. v11.0 이상으로 업그레이드한 뒤 사용자가 로그인하면 비밀번호가 자동으로 마이그레이션됩니다. 이 마이그레이션은 점진적으로 진행되며 사용자 인증 과정에서 투명하게 이루어집니다.

최소 비밀번호 길이 (Minimum password length)

이 설정은 비밀번호의 최소 문자 수를 결정합니다. 5 이상 72 이하의 정수여야 합니다.

숫자 입력. 기본값은 5입니다.
  • 시스템 콘솔 경로: Authentication > Password
  • config.json 설정: PasswordSettings > MinimumLength
  • 환경 변수: MM_PASSWORDSETTINGS_MINIMUMLENGTH

비밀번호 요구 사항 (Password requirements)

이 설정은 비밀번호 문자 요구 사항을 제어합니다. 해당 항목을 체크하면 비밀번호에 다음이 포함되어야 합니다.

  • At least one lowercase letter(소문자 1자 이상)
  • At least one uppercase letter(대문자 1자 이상)
  • At least one number(숫자 1자 이상)
  • At least one symbol(다음 기호 중 1자 이상): !"#$%&'()*+,-./:;<=>?@[]^_`|~.

사용자가 유효하지 않은 비밀번호를 설정하려고 하면 시스템 콘솔에서 미리 볼 수 있는 오류 메시지가 표시됩니다.

모든 항목의 기본값은 체크 해제입니다. config.json의 모든 설정 기본값은 false입니다.
  • 시스템 콘솔 경로: Authentication > Password
  • config.json 설정: PasswordSettings > Lowercase > false, PasswordSettings > Uppercase > false, PasswordSettings > Number > false, PasswordSettings > Symbol > false
  • 환경 변수: MM_PASSWORDSETTINGS_LOWERCASE, MM_PASSWORDSETTINGS_UPPERCASE, MM_PASSWORDSETTINGS_NUMBER, MM_PASSWORDSETTINGS_SYMBOL

최대 로그인 시도 횟수 (Maximum login attempts)

이 설정은 사용자가 계정이 잠기고 이메일을 통한 비밀번호 재설정을 요구받기 전까지 실패할 수 있는 로그인 시도 횟수를 결정합니다.

숫자 입력. 기본값은 10입니다.
  • 시스템 콘솔 경로: Authentication > Password
  • config.json 설정: ServiceSettings > MaximumLoginAttempts > 10
  • 환경 변수: MM_SERVICESETTINGS_MAXIMUMLOGINATTEMPTS
  • true: (기본값) Mattermost 로그인 페이지에 Forget Password 링크를 표시합니다.
  • false: Mattermost 로그인 페이지에서 Forgot Password 링크를 숨깁니다.
  • 시스템 콘솔 경로: Authentication > Enable forgot password link
  • config.json 설정: LdapSettings > ForgotPasswordLink > true
  • 환경 변수: MM_LDAPSETTINGS_FORGOTPASSWORDLINK
참고

Site Configuration > Customization > Forgot Password Custom Link로 이동해 Forgot Password 링크의 URL을 맞춤 지정할 수 있습니다. 자세한 내용은 구성 문서를 참고하세요.

MFA

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

시스템 콘솔에서 Authentication > MFA로 이동해 다음 구성 설정에 접근합니다.

Mattermost를 자체 프라이빗 네트워크 안에 배포하고 모바일 접근에는 VPN 클라이언트를 사용해, 기존 보안 프로토콜로 Mattermost를 보호할 것을 권장합니다. 기존 보안 프로토콜을 우회해 프라이빗 네트워크 외부에서 Mattermost를 운영하기로 했다면, Mattermost 접근 전용으로 다중 인증 서비스를 추가할 것을 권장합니다.

다중 인증 활성화 (Enable multi-factor authentication)

  • true: AD/LDAP 또는 이메일 주소로 로그인하는 사용자가 자신의 계정에 다중 인증을 추가할 수 있습니다.
  • false: (기본값) 다중 인증을 비활성화합니다.
  • 시스템 콘솔 경로: Authentication > MFA
  • config.json 설정: ServiceSettings > EnableMultifactorAuthentication > false
  • 환경 변수: MM_SERVICESETTINGS_ENABLEMULTIFACTORAUTHENTICATION

다중 인증 강제 적용 (Enforce multi-factor authentication)

  • true: AD/LDAP 또는 이메일 주소로 로그인하는 사용자에게 다중 인증(MFA)을 요구합니다. 신규 사용자는 MFA를 설정해야 합니다. 이미 로그인한 사용자는 설정을 마칠 때까지 MFA 설정 페이지로 이동됩니다.
  • false: (기본값) MFA는 선택 사항입니다.
  • 시스템 콘솔 경로: Authentication > MFA
  • config.json 설정: ServiceSettings > EnforceMultifactorAuthentication > false
  • 환경 변수: MM_SERVICESETTINGS_ENFORCEMULTIFACTORAUTHENTICATION
참고

시스템에 AD/LDAP과 이메일 이외의 방식으로 인증하는 사용자가 있다면, MFA는 Mattermost 외부의 인증 공급자에서 강제해야 합니다.

AD/LDAP

시스템 콘솔에서 Authentication > AD/LDAP으로 이동해 다음 구성 설정에 접근합니다. 이 메뉴를 열면 각 설정을 구성하는 데 도움이 되도록 단계별 섹션과 테스트를 제공하는 AD/LDAP 설정 마법사가 열립니다.

마법사는 다음 섹션으로 구성되어 있습니다.

  • 연결 설정: 서버 연결 정보를 구성합니다
  • 사용자 필터: 사용자 식별과 필터링을 설정합니다
  • 계정 동기화: AD/LDAP 속성을 Mattermost 사용자 필드에 매핑합니다
  • 그룹 동기화: LDAP 그룹을 사용하는 경우 그룹 설정과 그룹 속성을 구성합니다
  • 동기화 성능: 동기화 주기와 성능 설정을 조정합니다
  • 동기화 기록: 동기화 상태를 확인하고 수동으로 동기화를 실행합니다
참고

각 섹션에는 Test 옵션이 있어 구성을 단계적으로 검증할 수 있으며, 설정 과정 초기에 문제를 발견하고 해결하는 데 도움이 됩니다.

연결 설정 (Connection settings)

AD/LDAP 서버 연결과 기본 인증 설정을 구성합니다. 다른 구성 단계로 넘어가기 전에 이 섹션의 Test Connection 버튼으로 서버 연결을 확인하세요.

AD/LDAP 로그인 활성화 (Enable sign-in with AD/LDAP)

  • true: AD/LDAP으로 로그인할 수 있습니다.
  • false: (기본값) AD/LDAP 로그인을 비활성화합니다.
  • 시스템 콘솔 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > Enable > false
  • 환경 변수: MM_LDAPSETTINGS_ENABLE

AD/LDAP 동기화 활성화 (Enable synchronization with AD/LDAP)

Entry, Enterprise, Enterprise Advanced 플랜에서 사용할 수 있습니다 (Professional에서는 사용할 수 없습니다).

  • true: Mattermost가 AD/LDAP에서 사용자를 주기적으로 동기화합니다.
  • false: (기본값) AD/LDAP 동기화를 비활성화합니다.
  • 시스템 콘솔 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > EnableSync > false
  • 환경 변수: MM_LDAPSETTINGS_ENABLESYNC
참고

시스템 콘솔의 AD/LDAP 동기화 설정은 임의 호스트의 연결 가능 여부와 가용성을 확인하는 데 악용될 수 있습니다. 이를 우려하는 시스템 관리자는 맞춤 관리자 역할을 사용해 이 설정을 수정할 수 있는 권한을 제한할 수 있습니다. 자세한 내용은 위임형 세분화 관리 문서를 참고하세요.

로그인 필드 이름 (Login field name)

이 설정은 로그인 페이지의 로그인 필드에 표시되는 자리 표시자 텍스트를 지정합니다. 이 텍스트로 AD/LDAP 자격 증명으로 로그인하도록 사용자에게 안내할 수 있습니다.

문자열 입력. 기본값은 AD/LDAP Username입니다.
  • 시스템 콘솔 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > LoginFieldName
  • 환경 변수: MM_LDAPSETTINGS_LOGINFIELDNAME

AD/LDAP 서버 (AD/LDAP server)

AD/LDAP 서버의 도메인 이름 또는 IP 주소입니다.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > LdapServer
  • 환경 변수: MM_LDAPSETTINGS_LDAPSERVER
참고

시스템 콘솔의 AD/LDAP 동기화 설정은 임의 호스트의 연결 가능 여부와 가용성을 확인하는 데 악용될 수 있습니다. 이를 우려하는 시스템 관리자는 맞춤 관리자 역할을 사용해 이 설정을 수정할 수 있는 권한을 제한할 수 있습니다. 자세한 내용은 위임형 세분화 관리 문서를 참고하세요.

AD/LDAP 포트 (AD/LDAP port)

Mattermost가 AD/LDAP 서버에 연결할 때 사용하는 포트입니다.

숫자 입력. 기본값은 389입니다.
  • 시스템 콘솔 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > LdapPort > 389
  • 환경 변수: MM_LDAPSETTINGS_LDAPPORT

바인드 사용자 이름 (Bind username)

Mattermost가 AD/LDAP 검색을 수행할 때 사용하는 계정의 사용자 이름입니다. Mattermost 전용 계정이어야 합니다.

이 계정의 권한은 Base DN 설정에 지정된 AD/LDAP 트리 영역에 대한 읽기 전용 접근으로 제한하세요.

Active Directory를 사용할 때는 Bind Username에 "DOMAIN/username" 형식으로 도메인을 함께 지정해야 합니다.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > BindUsername
  • 환경 변수: MM_LDAPSETTINGS_BINDUSERNAME
참고

이 필드는 필수입니다. 익명 바인드는 현재 지원되지 않습니다.

바인드 비밀번호 (Bind password)

Bind Username 설정에 지정한 사용자 이름의 비밀번호입니다.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > BindPassword
  • 환경 변수: MM_LDAPSETTINGS_BINDPASSWORD

연결 보안 (Connection security)

이 설정은 Mattermost가 AD/LDAP 서버에 연결할 때 사용하는 보안 유형을 제어하며, 다음 옵션이 있습니다.

  • None: (자체 호스팅 배포 기본값) 암호화하지 않습니다. 이 옵션을 사용할 때는 stunnel 프록시 등으로 Mattermost 외부에서 연결을 보호할 것을 강력히 권장합니다. config.json 옵션: ""
  • TLS: (클라우드 배포 기본값) TLS로 통신을 암호화합니다. config.json 옵션: "TLS"
  • STARTTLS: 기존의 안전하지 않은 연결을 TLS 보안 연결로 업그레이드하려고 시도합니다. config.json 옵션: "STARTTLS"
  • 시스템 콘솔 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > ConnectionSecurity > ""
  • 환경 변수: MM_LDAPSETTINGS_CONNECTIONSECURITY

인증서 검증 건너뛰기 (Skip certificate verification)

  • true: TLS 및 STARTTLS 연결의 인증서 검증 단계를 비활성화합니다. 테스트 용도로만 사용하세요. 프로덕션에서 TLS가 필요한 경우에는 이 옵션을 사용하지 마세요.
  • false: (기본값) 인증서 검증을 활성화합니다.
  • 시스템 콘솔 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > SkipCertificateVerification > false
  • 환경 변수: MM_LDAPSETTINGS_SKIPCERTIFICATEVERIFICATION

개인 키 (Private key)

TLS 클라이언트 인증서가 기본 인증 수단인 경우, 이 설정으로 LDAP 인증 공급자의 개인 키 파일을 업로드합니다.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > PrivateKeyFile
  • 환경 변수: MM_LDAPSETTINGS_PRIVATEKEYFILE

공개 인증서 (Public certificate)

TLS 클라이언트 인증서가 기본 인증 수단인 경우, 이 설정으로 LDAP 인증 공급자의 공개 TLS 인증서를 업로드합니다.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > PublicCertificateFile
  • 환경 변수: MM_LDAPSETTINGS_PUBLICCERTIFICATEFILE

최대 로그인 시도 횟수 (Maximum login attempts)

이 설정은 사용자가 계정이 잠기고 이메일을 통한 비밀번호 재설정을 요구받기 전까지 실패할 수 있는 로그인 시도 횟수를 결정합니다.

시스템 콘솔의 사용자 페이지에서 계정 잠금을 해제할 수 있습니다. 이 값을 LDAP의 최대 로그인 시도 횟수보다 작게 설정하면, Mattermost에서의 로그인 실패 때문에 사용자가 LDAP 서버에서 잠기는 일을 막을 수 있습니다.

숫자 입력. 기본값은 10입니다.
  • 시스템 콘솔 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > MaximumLoginAttempts > 10
  • 환경 변수: MM_LDAPSETTINGS_MAXIMUMLOGINATTEMPTS
참고
  • 조직의 인증 정책에 맞게 이 값을 조정하세요.
  • 사용자 계정이 잠긴 경우 System console > User Management > Users로 이동해 수동으로 잠금을 해제할 수 있습니다.

사용자 필터 (User filters)

Mattermost가 AD/LDAP 디렉터리에서 사용자와 그룹을 식별하고 필터링하는 방식을 정의합니다. 다른 구성 단계로 넘어가기 전에 이 섹션의 Test Filters 버튼으로 필터가 올바르게 동작하는지 확인하세요.

Base DN (Base DN)

Mattermost가 사용자 검색을 시작할 AD/LDAP 트리 위치의 Base Distinguished Name입니다.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > BaseDN
  • 환경 변수: MM_LDAPSETTINGS_BASEDN

사용자 필터 (User filter)

이 설정은 사용자 객체를 검색할 때 적용되는 일반 구문 AD/LDAP 필터를 받습니다. 쿼리로 선택된 사용자만 Mattermost에 접근할 수 있습니다. 예를 들어 비활성화된 사용자를 걸러내려면 다음과 같은 필터를 사용합니다: (&(objectCategory=Person)(!(UserAccountControl:1.2.840.113556.1.4.803:=2))).

그룹 멤버십으로 필터링하려면 해당 그룹의 distinguishedName을 확인한 뒤, 그룹 멤버십 일반 구문으로 필터를 작성합니다. 예를 들어 보안 그룹의 distinguishedName이 CN=group1,OU=groups,DC=example,DC=com이라면 필터는 (memberOf=CN=group1,OU=groups,DC=example,DC=com)입니다. 필터가 적용되려면 사용자가 이 그룹에 명시적으로 속해 있어야 합니다.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > UserFilter
  • 환경 변수: MM_LDAPSETTINGS_USERFILTER
참고

이 필터는 Bind Username 계정의 권한으로 검색을 수행합니다. 이 계정은 Mattermost 전용이어야 하며 Base DN 필드에 지정된 AD/LDAP 트리 영역에 대한 읽기 전용 접근 권한만 가져야 합니다.

그룹 필터 (Group filter)

Entry, Enterprise, Enterprise Advanced 플랜에서 사용할 수 있습니다 (Professional에서는 사용할 수 없습니다).

이 설정은 그룹 객체를 검색할 때 적용되는 일반 구문 AD/LDAP 필터를 받습니다. 쿼리로 선택된 그룹만 Mattermost에 접근할 수 있습니다.

문자열 입력. 기본값은 (|(objectClass=group)(objectClass=groupOfNames)(objectClass=groupOfUniqueNames))입니다.
  • 시스템 콘솔 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > GroupFilter
  • 환경 변수: MM_LDAPSETTINGS_GROUPFILTER
참고

이 필터는 AD/LDAP 그룹 동기화가 활성화된 경우에만 사용됩니다. 자세한 내용은 AD/LDAP 그룹 동기화를 참고하세요.

관리자 필터 활성화 (Enable admin filter)

  • true: AD/LDAP 필터로 시스템 관리자를 지정하는 Admin Filter 설정을 활성화합니다.
  • false: (기본값) Admin Filter 설정을 비활성화합니다.
  • 시스템 콘솔 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > EnableAdminFilter > false
  • 환경 변수: MM_LDAPSETTINGS_ENABLEADMINFILTER
참고

이 설정이 false이면 필터로 추가 지정되는 시스템 관리자는 없습니다. 이전에 시스템 관리자로 지정된 사용자는 필터를 변경하거나 제거하지 않는 한 해당 역할을 유지합니다.

관리자 필터 (Admin filter)

이 설정은 선택된 사용자를 시스템 관리자로 지정하는 AD/LDAP 필터를 받습니다. 사용자는 다음 로그인 시점 또는 다음 예약된 AD/LDAP 동기화 시점에 이 역할로 승격됩니다.

관리자 필터를 제거하면, 현재 로그인해 있는 사용자는 다음 로그인 전까지 관리자 역할을 유지합니다.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > AdminFilter
  • 환경 변수: MM_LDAPSETTINGS_ADMINFILTER

게스트 필터 (Guest filter)

이 설정은 Mattermost에 게스트 접근 권한을 가진 외부 사용자를 검색할 때 적용할 AD/LDAP 필터를 받습니다. 쿼리로 선택된 사용자만 게스트로 Mattermost에 접근할 수 있습니다.

자세한 내용은 게스트 계정을 참고하세요.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > GuestFilter
  • 환경 변수: MM_LDAPSETTINGS_GUESTFILTER

계정 동기화 (Account synchronization)

Entry, Enterprise, Enterprise Advanced 플랜에서 사용할 수 있습니다 (Professional에서는 사용할 수 없습니다).

AD/LDAP 사용자 속성을 Mattermost 사용자 프로필 필드에 매핑합니다. 다른 구성 단계로 넘어가기 전에 이 섹션의 Test Attributes 버튼으로 속성 매핑과 데이터 동기화가 올바른지 확인하세요.

ID 속성 (ID attribute)

Mattermost에서 사용자 고유 식별자 역할을 하는 AD/LDAP 서버의 속성입니다.

이 속성은 objectGUID나 entryUUID처럼 변하지 않는 고유한 값이어야 합니다. 변경하기 전에 해당 속성을 사용 중인 환경에서 쓸 수 있는지 확인하세요.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > IdAttribute
  • 환경 변수: MM_LDAPSETTINGS_IDATTRIBUTE
참고

사용자의 ID 속성이 바뀌면 이전 계정과 연결되지 않는 새 Mattermost 계정이 생성됩니다. 사용자가 이미 로그인한 뒤 이 필드를 변경해야 한다면 mmctl ldap idmigrate 명령을 사용하세요.

참고

ID 속성 값은 있는 그대로 대조되며 Mattermost는 대소문자를 정규화하지 않습니다. PostgreSQL의 기본 대소문자 구분 콜레이션에서는 대소문자가 달라지면 다른 사용자로 간주되어 별도의 계정이 만들어집니다. AD/LDAP 서버가 이 속성을 일관된 대소문자로 반환하는지 확인하세요.

로그인 ID 속성 (Login ID attribute)

Mattermost 로그인에 사용되는 AD/LDAP 서버의 속성입니다. 보통 Username Attribute와 동일합니다.

팀에서 AD/LDAP을 사용하는 다른 서비스에 domain\username 형식으로 로그인한다면, 사이트 간 일관성을 유지하기 위해 이 필드에 domain\username을 입력할 수 있습니다.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > LoginIdAttribute
  • 환경 변수: MM_LDAPSETTINGS_LOGINIDATTRIBUTE

사용자 이름 속성 (Username attribute)

Mattermost의 사용자 이름 필드를 채우는 AD/LDAP 서버의 속성입니다.

이 속성은 UI에서 사용자를 식별합니다. 예를 들어 Username Attribute가 john.smith로 설정되어 있으면 @john을 입력할 때 @john.smith가 자동 완성 후보로 표시되고, @john.smith가 포함된 메시지를 게시하면 해당 사용자에게 알림이 전송됩니다.

보통 Login ID Attribute와 동일하지만 다른 속성에 매핑할 수도 있습니다.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > UsernameAttribute
  • 환경 변수: MM_LDAPSETTINGS_USERNAMEATTRIBUTE

이메일 속성 (Email attribute)

Mattermost의 이메일 주소 필드를 채우는 AD/LDAP 서버의 속성입니다.

이메일 알림이 이 주소로 전송됩니다. 개인정보 설정에 따라 다른 Mattermost 사용자에게 이 주소가 보일 수 있습니다.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > AD/LDAP
  • config.json 설정 LdapSettings > EmailAttribute
  • 환경 변수: MM_LDAPSETTINGS_EMAILATTRIBUTE

이름 속성 (First name attribute)

Mattermost의 이름(first name) 필드를 채우는 AD/LDAP 서버의 속성입니다.

이 값을 설정하면 사용자가 자신의 이름을 편집할 수 없습니다.

이 값을 설정하지 않으면 사용자가 프로필 설정에서 자신의 이름을 편집할 수 있습니다.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > FirstNameAttribute
  • 환경 변수: MM_LDAPSETTINGS_FIRSTNAMEATTRIBUTE

성 속성 (Last name attribute)

Mattermost의 성(last name) 필드를 채우는 AD/LDAP 서버의 속성입니다.

이 값을 설정하면 사용자가 자신의 성을 편집할 수 없습니다.

이 값을 설정하지 않으면 사용자가 프로필 설정에서 자신의 성을 편집할 수 있습니다.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > LastNameAttribute
  • 환경 변수: MM_LDAPSETTINGS_LASTNAMEATTRIBUTE

닉네임 속성 (Nickname attribute)

Mattermost의 닉네임 필드를 채우는 AD/LDAP 서버의 속성입니다.

이 값을 설정하면 사용자가 자신의 닉네임을 편집할 수 없습니다.

이 값을 설정하지 않으면 사용자가 프로필 설정에서 자신의 닉네임을 편집할 수 있습니다.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > NicknameAttribute
  • 환경 변수: MM_LDAPSETTINGS_NICKNAMEATTRIBUTE

직책 속성 (Position attribute)

Mattermost의 직책 필드를 채우는 AD/LDAP 서버의 속성입니다.

이 값을 설정하면 사용자가 자신의 직책을 편집할 수 없습니다.

이 값을 설정하지 않으면 사용자가 프로필 설정에서 자신의 직책을 편집할 수 있습니다.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > PositionAttribute
  • 환경 변수: MM_LDAPSETTINGS_POSITIONATTRIBUTE

프로필 사진 속성 (Profile picture attribute)

Mattermost의 프로필 사진을 동기화하고 잠그는 AD/LDAP 서버의 속성입니다.

이미지는 Mattermost가 AD/LDAP 서버와 동기화할 때가 아니라 사용자가 로그인할 때 갱신됩니다.

Mattermost의 이미지가 이미 AD/LDAP 이미지와 같다면 갱신되지 않습니다.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > PictureAttribute
  • 환경 변수: MM_LDAPSETTINGS_PICTUREATTRIBUTE

그룹 동기화 (Group synchronization)

Entry, Enterprise, Enterprise Advanced 플랜에서 사용할 수 있습니다 (Professional에서는 사용할 수 없습니다).

AD/LDAP 그룹 동기화를 위한 그룹 매핑을 구성합니다. 다른 구성 단계로 넘어가기 전에 이 섹션의 Test Group Attributes 버튼으로 그룹 속성 매핑이 올바른지 확인하세요.

그룹 표시 이름 속성 (Group display name attribute)

Mattermost의 그룹 이름 필드를 채우는 AD/LDAP 그룹 표시 이름 속성입니다.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > GroupDisplayNameAttribute
  • 환경 변수: MM_LDAPSETTINGS_GROUPDISPLAYNAMEATTRIBUTE
참고

이 속성은 AD/LDAP 그룹 동기화가 활성화된 경우에만 사용되며 필수입니다. 자세한 내용은 AD/LDAP 그룹 동기화 문서를 참고하세요.

그룹 ID 속성 (Group ID attribute)

그룹의 고유 식별자를 지정하는 AD/LDAP 그룹 ID 속성입니다.

entryUUID나 objectGUID처럼 변하지 않는 값이어야 합니다.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > GroupIdAttribute
  • 환경 변수: MM_LDAPSETTINGS_GROUPIDATTRIBUTE
참고

이 속성은 AD/LDAP 그룹 동기화가 활성화된 경우에만 사용되며 필수입니다. 자세한 내용은 AD/LDAP 그룹 동기화 문서를 참고하세요.

참고

그룹 ID 속성 값은 있는 그대로 대조되며 Mattermost는 대소문자를 정규화하지 않습니다. PostgreSQL의 기본 대소문자 구분 콜레이션에서는 대소문자가 달라지면 Mattermost가 이전에 동기화한 그룹을 인식하지 못하고 연결되지 않은 새 그룹으로 취급합니다. AD/LDAP 서버가 이 속성을 일관된 대소문자로 반환하는지 확인하세요.

동기화 성능 (Synchronization performance)

Entry, Enterprise, Enterprise Advanced 플랜에서 사용할 수 있습니다 (Professional에서는 사용할 수 없습니다).

AD/LDAP 동기화의 주기와 성능 설정을 구성합니다. 이 설정들은 Mattermost가 AD/LDAP 서버와 얼마나 자주 동기화할지를 제어합니다.

동기화 간격(분) (Synchronization interval (minutes))

이 값은 동기화 간 간격을 분 단위로 지정해 Mattermost가 AD/LDAP 서버와 얼마나 자주 동기화할지를 결정합니다.

AD/LDAP 서버와 동기화하면 AD/LDAP 속성의 변경 사항에 맞춰 Mattermost 계정이 갱신됩니다.

비활성화된 AD/LDAP 계정은 Mattermost에서 비활성화된 사용자가 되며, 활성 세션은 모두 취소됩니다.

AD/LDAP 계정을 비활성화한 뒤 세션을 즉시 취소하려면 AD/LDAP Synchronize Now 버튼을 사용하세요.

숫자 입력. 기본값은 60입니다.
  • 시스템 콘솔 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > SyncIntervalMinutes > 60
  • 환경 변수: MM_LDAPSETTINGS_SYNCINTERVALMINUTES
참고

LDAP 동기화는 많은 데이터베이스 읽기 쿼리를 발생시킵니다. 데이터베이스 부하를 모니터링하고 성능 저하가 최소화되도록 동기화 간격을 조정하세요.

최대 페이지 크기 (Maximum page size)

이 설정은 AD/LDAP 서버 쿼리 결과를 페이지 단위로 나눕니다. AD/LDAP 서버에 페이지 크기 제한이 있다면 이 설정을 사용하세요.

권장 값은 1500입니다. 이는 AD/LDAP의 기본 MaxPageSize입니다.

페이지 크기를 0으로 지정하면 결과 페이지 나누기가 비활성화됩니다.

숫자 입력. 기본값은 0입니다.
  • 시스템 콘솔 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > MaxPageSize > 0
  • 환경 변수: MM_LDAPSETTINGS_MAXPAGESIZE

쿼리 제한 시간(초) (Query timeout (seconds))

이 설정은 AD/LDAP 쿼리의 제한 시간(초)을 결정합니다. 응답이 느린 서버에 쿼리할 때 제한 시간 오류를 피하려면 이 값을 늘리세요.

숫자 입력. 기본값은 60입니다.
  • 시스템 콘솔 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > QueryTimeout > 60
  • 환경 변수: MM_LDAPSETTINGS_QUERYTIMEOUT

동기화 기록 (Synchronization history)

Entry, Enterprise, Enterprise Advanced 플랜에서 사용할 수 있습니다 (Professional에서는 사용할 수 없습니다).

동기화 상태를 확인하고 AD/LDAP 동기화를 수동으로 실행합니다. 이 섹션에는 즉시 동기화를 실행하는 AD/LDAP Synchronize Now 버튼이 있습니다.

지금 AD/LDAP 동기화 (AD/LDAP synchronize now)

이 버튼을 사용하면 AD/LDAP 서버와 즉시 동기화합니다.

동기화 상태는 버튼 아래 표에 표시됩니다(아래 그림 참고).

수동 동기화 이후에는 Synchronization Interval에 설정된 시간이 지난 뒤 다음 동기화가 실행됩니다.
  • 시스템 콘솔 경로: Authentication > AD/LDAP
  • config.json 설정: N/A
  • 환경 변수: N/A
참고

동기화가 Pending 상태에서 완료되지 않는다면 Enable Synchronization with AD/LDAP가 true로 설정되어 있는지 확인하세요.

Mattermost 시스템 콘솔의 AD/LDAP 동기화 표 예시 스크린샷.

AD/LDAP 마법사에서 제공되지 않는 구성 설정 (Config settings not available in the AD/LDAP Wizard)

Entry, Enterprise, Enterprise Advanced 플랜에서 사용할 수 있습니다 (Professional에서는 사용할 수 없습니다).

다음 AD/LDAP 구성 설정들은 config.json 파일에서만 제공되며 시스템 콘솔의 AD/LDAP 마법사 인터페이스에서는 사용할 수 없습니다.

동기화 시 제거된 구성원 재추가 (Re-add removed members on sync)

LDAP 동기화 과정에서, 그룹 동기화된 팀이나 채널에서 이전에 제거된 LDAP 그룹 구성원을 다시 추가하려면 이 설정을 활성화하세요.

  • true: 이전에 제거된 LDAP 그룹 구성원이 LDAP 동기화 과정에서 그룹 동기화된 팀이나 채널에 다시 추가됩니다.
  • false: (기본값) 이전에 제거된 LDAP 그룹 구성원은 LDAP 동기화 과정에서 그룹 동기화된 팀이나 채널에 다시 추가되지 않습니다.
  • 시스템 콘솔 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > ReAddRemovedMembers
  • 환경 변수: MM_LDAPSETTINGS_READDREMOVEDMEMBERS
참고

mmctl ldap sync 명령이 이 서버 구성 설정보다 우선합니다. 이 설정을 비활성화한 상태에서 --include-removed-members 플래그와 함께 mmctl 명령을 실행하면, LDAP 동기화 과정에서 제거된 구성원이 다시 추가됩니다.

SAML 2.0

시스템 콘솔에서 Authentication > SAML 2.0으로 이동해 다음 구성 설정에 접근합니다.

Mattermost가 SAML에서 지원하는 암호화 방식에 대한 자세한 내용은 암호화 옵션 문서를 참고하세요.

중요

Microsoft ADFS 지침에 따라 WIA를 지원하지 않는 기기를 위한 인트라넷 폼 기반 인증 구성을 권장합니다.

SAML 로그인 활성화 (Enable login with SAML)

  • true: SAML 로그인을 활성화합니다. 자세한 내용은 SAML 싱글 사인온을 참고하세요.
  • false: (기본값) SAML 로그인을 비활성화합니다.
  • 시스템 콘솔 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > Enable > false
  • 환경 변수: MM_SAMLSETTINGS_ENABLE

SAML 계정과 AD/LDAP 동기화 활성화 (Enable synchronizing SAML accounts with AD/LDAP)

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

  • true: Mattermost가 구성된 Mattermost 사용자 속성(예: FirstName, Position, Email)을 AD/LDAP의 값으로 갱신합니다. v10.9부터 Mattermost는 로그인 시 연결된 LDAP 서버에 해당 사용자가 존재하는지 확인합니다. LDAP 서버에 사용자가 없으면 로그인이 실패합니다.
  • false: (기본값) SAML로 인증된 Mattermost 사용자와 AD/LDAP 간 동기화를 비활성화합니다. Mattermost v10.9부터, 이 경우 로그인 시 연결된 LDAP 서버에 사용자가 존재하는지 확인하지 않습니다.
  • 시스템 콘솔 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > EnableSyncWithLdap > false
  • 환경 변수: MM_SAMLSETTINGS_ENABLESYNCWITHLDAP
참고
  • Authentication > AD/LDAP 아래의 설정을 통해 AD/LDAP 동기화가 활성화되고 구성되어 있어야 합니다.
  • Mattermost v10.9 이전에는 LDAP 서버에 없는 사용자도 로그인할 수 있었지만, 다음 LDAP 동기화에서 비활성화되었습니다.
  • AD/LDAP 구성에 대한 자세한 내용은 AD/LDAP 설정을 참고하세요.

AD/LDAP 동기화 시 게스트 사용자 제외 (Ignore guest users when synchronizing with AD/LDAP)

Entry, Enterprise, Enterprise Advanced 플랜에서 사용할 수 있습니다 (Professional에서는 사용할 수 없습니다).

  • true: AD/LDAP 서버와 동기화할 때 Mattermost가 SAML로 인증된 게스트 사용자 정보를 AD/LDAP 서버에서 동기화하지 않습니다. 게스트 비활성화는 System Console > Users에서 직접 관리하세요.
  • false: (기본값) Mattermost를 AD/LDAP 서버와 동기화하면 게스트 사용자 속성이 갱신되고, AD/LDAP 서버에서 더 이상 활성 상태가 아닌 게스트 사용자의 SAML 인증 계정은 비활성화·제거됩니다.
  • 시스템 콘솔 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > IgnoreGuestsLdapSync > false
  • 환경 변수: MM_SAMLSETTINGS_IGNOREGUESTSLDAPSYNC

자세한 내용은 AD/LDAP 설정을 참고하세요.

SAML 바인드 데이터를 AD/LDAP 정보로 재정의 (Override SAML bind data with AD/LDAP information)

  • true: SAML ID 속성이 구성되어 있으면 Mattermost가 SAML ID 속성을 AD/LDAP ID 속성으로 재정의합니다. SAML ID 속성이 없으면 SAML Email 속성을 AD/LDAP Email 속성으로 재정의합니다.
  • false: (기본값) Mattermost가 이메일 속성으로 사용자를 SAML에 바인딩합니다.

이 설정은 SAML 인증과 AD/LDAP 동기화가 모두 활성화된 경우에만 사용할 수 있습니다.
  • 시스템 콘솔 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > EnableSyncWithLdapIncludeAuth > false
  • 환경 변수: MM_SAMLSETTINGS_ENABLESYNCWITHLDAPINCLUDEAUTH
참고
  • LDAP 동기화가 활성화된 경우가 아니라면 이 설정은 false여야 합니다. 이 설정을 true에서 false로 변경하면 재정의가 해제됩니다.
  • 재정의를 활성화한 경우 SAML ID가 LDAP ID와 일치해야 합니다.
  • 자세한 내용은 AD/LDAP 설정을 참고하세요.

ID 공급자 메타데이터 URL (Identity provider metadata URL)

Mattermost가 공급자에게 설정 메타데이터를 요청하는 URL입니다.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > IdpMetadataURL
  • 환경 변수: MM_SAMLSETTINGS_IDPMETADATAURL

SAML SSO URL (SAML SSO URL)

Mattermost가 로그인 절차를 시작하기 위해 SAML 요청을 보내는 URL입니다.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > IdpURL
  • 환경 변수: MM_SAMLSETTINGS_IDPURL

ID 공급자 발급자 URL (Identity provider issuer URL)

SAML 요청에 사용하는 ID 공급자의 발급자(issuer) URL입니다.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > IdpDescriptorURL
  • 환경 변수: MM_SAMLSETTINGS_IDPDESCRIPTORURL

ID 공급자 공개 인증서 (Identity provider public certificate)

ID 공급자가 발급한 공개 인증 인증서입니다.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > IdpCertificateFile
  • 환경 변수: MM_SAMLSETTINGS_IDPCERTIFICATEFILE

서명 검증 (Verify signature)

  • true: (기본값) Mattermost가 SAML 응답 서명이 서비스 공급자 로그인 URL과 일치하는지 확인합니다.
  • false: 서명을 검증하지 않습니다. 프로덕션에서는 권장하지 않습니다. 테스트 용도로만 사용하세요.
  • 시스템 콘솔 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > Verify > true
  • 환경 변수: MM_SAMLSETTINGS_VERIFY

서비스 공급자 로그인 URL (Service provider login URL)

Mattermost 서버의 URL 뒤에 /login/sso/saml을 붙여 입력합니다. 예: https://example.com/login/sso/saml.

서버 구성에 따라 HTTP 또는 HTTPS를 사용하세요.

이 설정은 Assertion Consumer Service URL이라고도 합니다.
  • 시스템 콘솔 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > AssertionConsumerServiceURL
  • 환경 변수: MM_SAMLSETTINGS_ASSERTIONCONSUMERSERVICEURL

서비스 공급자 식별자 (Service provider identifier)

서비스 공급자의 고유 식별자로, 대부분의 경우 서비스 공급자 로그인 URL과 동일합니다. ADFS에서는 이 값이 Relying Party Identifier와 일치해야 합니다.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > ServiceProviderIdentifier
  • 환경 변수: MM_SAMLSETTINGS_SERVICEPROVIDERIDENTIFIER

암호화 활성화 (Enable encryption)

  • true: (기본값) Mattermost가 서비스 공급자 공개 인증서로 암호화된 SAML Assertion을 복호화합니다.
  • false: Mattermost가 SAML Assertion을 복호화하지 않습니다. 테스트 용도로만 사용하세요. 프로덕션에서는 권장하지 않습니다.
  • 시스템 콘솔 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > Encrypt > true
  • 환경 변수: MM_SAMLSETTINGS_ENCRYPT

서비스 공급자 개인 키 (Service provider private key)

ID 공급자로부터 받은 SAML Assertion을 복호화하는 데 사용하는 개인 키를 저장합니다.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > PrivateKeyFile
  • 환경 변수: MM_SAMLSETTINGS_PRIVATEKEYFILE

서비스 공급자 공개 인증서 (Service provider public certificate)

Mattermost가 서비스 공급자로서 로그인을 개시할 때, ID 공급자로 보내는 SAML 로그인 요청에 서명하는 데 사용하는 인증서 파일을 저장합니다.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > PublicCertificateFile
  • 환경 변수: MM_SAMLSETTINGS_PUBLICCERTIFICATEFILE

요청 서명 (Sign request)

  • true: Mattermost가 서비스 공급자 개인 키로 SAML 요청에 서명합니다.
  • false: Mattermost가 SAML 요청에 서명하지 않습니다.
  • 시스템 콘솔 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > SignRequest
  • 환경 변수: MM_SAMLSETTINGS_SIGNREQUEST

서명 알고리즘 (Signature algorithm)

이 설정은 SAML 요청 서명에 사용할 서명 알고리즘을 결정합니다. 옵션: RSAwithSHA1, RSAwithSHA256, RSAwithSHA512.

문자열 입력.

참고

Mattermost v11부터 보안 강화를 위해 기본 서명 알고리즘이 RSAwithSHA1에서 RSAwithSHA256으로 변경되었습니다. 기존 구성은 계속 동작하지만, 신규 설치에서는 RSAwithSHA256이 기본값이 됩니다.
  • 시스템 콘솔 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > SignatureAlgorithm
  • 환경 변수: MM_SAMLSETTINGS_SIGNATUREALGORITHM

정규화 알고리즘 (Canonical algorithm)

이 설정은 정규화(canonicalization) 알고리즘을 결정하며, 다음 옵션이 있습니다.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > CanonicalAlgorithm
  • 환경 변수: MM_SAMLSETTINGS_CANONICALALGORITHM

이메일 속성 (Email attribute)

이 설정은 Mattermost의 사용자 이메일 주소 필드를 채우는 SAML Assertion 속성을 결정합니다.

알림이 이 이메일 주소로 전송됩니다. 시스템 관리자가 사용자 개인정보를 어떻게 설정했는지에 따라 이 이메일 주소가 다른 사용자에게 보일 수 있습니다.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > EmailAttribute
  • 환경 변수: MM_SAMLSETTINGS_EMAILATTRIBUTE

사용자 이름 속성 (Username attribute)

이 설정은 Mattermost UI의 사용자 이름 필드를 채우는 SAML Assertion 속성을 결정합니다.

이 속성은 UI에서 사용자를 식별합니다. 예를 들어 사용자 이름이 john.smith로 설정되어 있으면 @john을 입력할 때 @john.smith가 자동 완성 후보로 표시되고, @john.smith가 포함된 메시지를 게시하면 해당 사용자에게 알림이 전송됩니다.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > UsernameAttribute
  • 환경 변수: MM_SAMLSETTINGS_USERNAMEATTRIBUTE

Id 속성 (Id attribute)

(선택) 이 설정은 SAML 사용자를 Mattermost 사용자에 바인딩하는 데 사용하는 SAML Assertion 속성을 결정합니다.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > IdAttribute
  • 환경 변수: MM_SAMLSETTINGS_IDATTRIBUTE
참고

ID 속성 값은 있는 그대로 대조되며 Mattermost는 대소문자를 정규화하지 않습니다. PostgreSQL의 기본 대소문자 구분 콜레이션에서는 대소문자가 달라지면 다른 사용자로 간주되어 별도의 계정이 만들어집니다. ID 공급자가 이 속성을 일관된 대소문자로 반환하는지 확인하세요.

게스트 속성 (Guest attribute)

(선택) 이 설정은 Mattermost 사용자에게 게스트 역할을 부여하는 데 사용하는 SAML Assertion 속성을 결정합니다.

자세한 내용은 게스트 계정 문서를 참고하세요.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > GuestAttribute
  • 환경 변수: MM_SAMLSETTINGS_GUESTATTRIBUTE

관리자 속성 활성화 (Enable admin attribute)

  • true: 시스템 관리자 여부를 Admin attribute에 지정한 SAML Assertion 속성으로 판단합니다.
  • false: (기본값) 시스템 관리자 여부를 SAML Assertion 속성으로 판단하지 않습니다.
  • 시스템 콘솔 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > EnableAdminAttribute > false
  • 환경 변수: MM_SAMLSETTINGS_ENABLEADMINATTRIBUTE

관리자 속성 (Admin attribute)

(선택) 이 설정은 시스템 관리자를 지정하는 데 사용할 SAML Assertion 속성을 결정합니다.

해당 사용자는 Mattermost에 로그인할 때 자동으로 이 역할로 승격됩니다.

관리자 속성을 제거하면, 이미 로그인해 있는 사용자는 관리자 상태를 유지합니다. 로그아웃할 때 비로소 역할이 회수됩니다.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > AdminAttribute
  • 환경 변수: MM_SAMLSETTINGS_ADMINATTRIBUTE

이름 속성 (First name attribute)

(선택) 이 설정은 Mattermost 사용자의 이름(first name)을 채우는 SAML Assertion 속성을 결정합니다.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > FirstNameAttribute
  • 환경 변수: MM_SAMLSETTINGS_FIRSTNAMEATTRIBUTE

성 속성 (Last name attribute)

(선택) 이 설정은 Mattermost 사용자의 성(last name)을 채우는 SAML Assertion 속성을 결정합니다.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > LastNameAttribute
  • 환경 변수: MM_SAMLSETTINGS_LASTNAMEATTRIBUTE

닉네임 속성 (Nickname attribute)

(선택) 이 설정은 Mattermost 사용자의 닉네임을 채우는 SAML Assertion 속성을 결정합니다.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > NicknameAttribute
  • 환경 변수: MM_SAMLSETTINGS_NICKNAMEATTRIBUTE

직책 속성 (Position attribute)

(선택) 이 설정은 Mattermost 사용자의 직책(회사 내 직함 또는 역할)을 채우는 SAML Assertion 속성을 결정합니다.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > PositionAttribute
  • 환경 변수: MM_SAMLSETTINGS_POSITIONATTRIBUTE

선호 언어 속성 (Preferred language attribute)

(선택) 이 설정은 Mattermost 사용자의 언어 설정을 채우는 SAML Assertion 속성을 결정합니다.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > LocaleAttribute
  • 환경 변수: MM_SAMLSETTINGS_LOCALEATTRIBUTE

로그인 버튼 텍스트 (Login button text)

(선택) 로그인 페이지의 로그인 버튼에 표시되는 텍스트입니다.

문자열 입력. 기본값은 SAML입니다.
  • 시스템 콘솔 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > LoginButtonText
  • 환경 변수: MM_SAMLSETTINGS_LOGINBUTTONTEXT

OAuth 2.0

시스템 콘솔에서 Authentication > OAuth 2.0으로 이동해 다음 구성 설정에 접근합니다. 자체 호스팅 배포에서는 GitLab OAuth 인증 설정을 Authentication > GitLab에서도 확인할 수 있습니다.

이 설정들로 계정 생성과 로그인에 사용할 OAuth 2.0을 구성합니다.

OAuth 2.0 서비스 공급자 선택 (Select OAuth 2.0 service provider)

이 설정으로 OAuth를 활성화하고 서비스 공급자를 지정합니다. 다음 옵션이 있습니다.
  • 시스템 콘솔 경로: Authentication > OAuth 2.0
  • config.json 설정: N/A
  • 환경 변수: N/A

GitLab OAuth 2.0 설정

참고

Enterprise 구독에서는 GitLab 설정을 OAuth 2.0 아래에서 확인할 수 있습니다.

GitLab OAuth 2.0 인증 활성화 (Enable OAuth 2.0 authentication with GitLab)
  • true: GitLab OAuth 인증으로 팀과 계정을 만들 수 있습니다. 구성하려면 Secret과 ID 자격 증명을 입력하세요.
  • false: (기본값) GitLab OAuth 인증을 비활성화합니다.
  • 시스템 콘솔 경로: Authentication > OAuth 2.0 (or GitLab)
  • config.json 설정: GitLabSettings > Enable > false
  • 환경 변수: MM_GITLABSETTINGS_ENABLE
GitLab OAuth 2.0 애플리케이션 ID (GitLab OAuth 2.0 Application ID)

GitLab에서 발급받은 OAuth 애플리케이션 ID를 저장합니다. 다음 단계로 ID를 생성합니다.

  1. GitLab 계정에 로그인합니다.
  2. Profile Settings > Applications > New Application으로 이동해 이름을 입력합니다.
  3. 리디렉션 URL을 입력합니다: https://<your-mattermost-url>/login/gitlab/complete와 https://<your-mattermost-url>/signup/gitlab/complete.
  4. GitLab이 제공한 애플리케이션 ID를 Mattermost 시스템 콘솔 필드, config.json 설정 또는 환경 변수에 입력합니다.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > OAuth 2.0 (or GitLab)
  • config.json 설정: GitLabSettings > Id
  • 환경 변수: MM_GITLABSETTINGS_ID
참고

GitLab은 ID와 함께 애플리케이션 시크릿 키도 제공합니다.

GitLab OAuth 2.0 애플리케이션 시크릿 키 (GitLab OAuth 2.0 Application secret key)

GitLab에서 발급받은 OAuth 애플리케이션 시크릿 키를 저장합니다. 이 키는 Application ID와 동시에 생성됩니다(GitLab OAuth 2.0 애플리케이션 ID 참고).

GitLab이 제공한 키를 Mattermost 시스템 콘솔 필드, config.json 설정 또는 환경 변수에 입력하세요.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > OAuth 2.0 (or GitLab)
  • config.json 설정: GitLabSettings > Secret
  • 환경 변수: MM_GITLABSETTINGS_SECRET
GitLab OAuth 2.0 사이트 URL (GitLab OAuth 2.0 site URL)

GitLab 인스턴스의 URL을 저장합니다. 예: https://example.com:3000. GitLab 인스턴스에 SSL이 활성화되어 있지 않다면 http://를 사용하세요.
  • 시스템 콘솔 경로: Authentication > OAuth 2.0 (or GitLab)
  • config.json 설정: N/A
  • 환경 변수: N/A
GitLab OAuth 2.0 User API 엔드포인트 (GitLab OAuth 2.0 User API endpoint)

GitLab User API 엔드포인트의 URL을 저장합니다. 예: https://<your-gitlab-url>/api/v3/user. GitLab 인스턴스에 SSL이 활성화되어 있지 않다면 http://를 사용하세요.

이 URL을 Mattermost 시스템 콘솔 필드, config.json 설정 또는 환경 변수에 입력하세요.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > OAuth 2.0 (or GitLab)
  • config.json 설정: GitLabSettings > UserAPIEndpoint
  • 환경 변수: MM_GITLABSETTINGS_USERAPIENDPOINT
GitLab OAuth 2.0 Auth 엔드포인트 (GitLab OAuth 2.0 Auth endpoint)

GitLab Auth 엔드포인트의 URL을 저장합니다. 예: https://<your-gitlab-url>/oauth/authorize. GitLab 인스턴스에 SSL이 활성화되어 있지 않다면 http://를 사용하세요.

이 URL을 Mattermost 시스템 콘솔 필드, config.json 설정 또는 환경 변수에 입력하세요.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > OAuth 2.0 (or GitLab)
  • config.json 설정: GitLabSettings > AuthEndpoint
  • 환경 변수: MM_GITLABSETTINGS_AUTHENDPOINT
GitLab OAuth 2.0 Token 엔드포인트 (GitLab OAuth 2.0 Token endpoint)

GitLab OAuth Token 엔드포인트의 URL을 저장합니다. 예: https://<your-gitlab-url>/oauth/token. GitLab 인스턴스에 SSL이 활성화되어 있지 않다면 http://를 사용하세요.

이 URL을 Mattermost 시스템 콘솔 필드, config.json 설정 또는 환경 변수에 입력하세요.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > OAuth 2.0 (or GitLab)
  • config.json 설정: GitLabSettings > TokenEndpoint
  • 환경 변수: MM_GITLABSETTINGS_TOKENENDPOINT

Google OAuth 2.0 설정

Google OAuth 2.0 인증 활성화 (Enable OAuth 2.0 authentication with Google)
  • true: Google OAuth 인증으로 팀과 계정을 만들 수 있습니다. 구성하려면 Client ID와 Client Secret 자격 증명을 입력하세요.
  • false: (기본값) Google OAuth 인증을 비활성화합니다.

구현 방법은 Google 싱글 사인온 문서를 참고하세요.
  • 시스템 콘솔 경로: Authentication > OAuth 2.0
  • config.json 설정: GoogleSettings > Enable > false
  • 환경 변수: MM_GOOGLESETTINGS_ENABLE
Google OAuth 2.0 클라이언트 ID (Google OAuth 2.0 Client ID)

Google에서 발급받은 OAuth 클라이언트 ID를 저장합니다. Google Cloud Platform의 APIs & Services 메뉴에서 Credentials 섹션으로 이동해 Create Credentials > OAuth client ID를 선택하면 ID를 생성할 수 있습니다.

Google OAuth 또는 OpenID 인증 구현에 사용할 수 있는 안내는 Google 싱글 사인온을 참고하세요.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > OAuth 2.0
  • config.json 설정: GoogleSettings > Id
  • 환경 변수: MM_GOOGLESETTINGS_ID
Google OAuth 2.0 클라이언트 시크릿 (Google OAuth 2.0 Client secret)

Google에서 발급받은 OAuth 클라이언트 시크릿을 저장합니다. 이 시크릿은 클라이언트 ID와 동시에 생성됩니다.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > OAuth 2.0
  • config.json 설정: GoogleSettings > Secret
  • 환경 변수: MM_GOOGLESETTINGS_SECRET
Google OAuth 2.0 User API 엔드포인트 (Google OAuth 2.0 User API endpoint)

User API 엔드포인트로는 https://people.googleapis.com/v1/people/me?personFields=names,emailAddresses,nicknames,metadata를 권장합니다. 그 외에는 API 서버에서 사용할 수 있는 경우 HTTP 또는 HTTPS로 된 맞춤 엔드포인트를 config.json에 입력하세요.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > OAuth 2.0
  • config.json 설정: GoogleSettings > UserAPIEndpoint
  • 환경 변수: MM_GOOGLESETTINGS_USERAPIENDPOINT
Google OAuth 2.0 Auth 엔드포인트 (Google OAuth 2.0 Auth endpoint)

Auth 엔드포인트로는 https://accounts.google.com/o/oauth2/v2/auth를 권장합니다. 그 외에는 서버에서 사용할 수 있는 경우 HTTP 또는 HTTPS로 된 맞춤 엔드포인트를 config.json에 입력하세요.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > OAuth 2.0
  • config.json 설정: GoogleSettings > AuthEndpoint
  • 환경 변수: MM_GOOGLESETTINGS_AUTHENDPOINT
Google OAuth 2.0 Token 엔드포인트 (Google OAuth 2.0 Token endpoint)

Token 엔드포인트로는 https://www.googleapis.com/oauth2/v4/token을 권장합니다. 그 외에는 서버에서 사용할 수 있는 경우 HTTP 또는 HTTPS로 된 맞춤 엔드포인트를 config.json에 입력하세요.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > OAuth 2.0
  • config.json 설정: GoogleSettings > TokenEndpoint
  • 환경 변수: MM_GOOGLESETTINGS_TOKENENDPOINT

Entra ID OAuth 2.0 설정

참고

Microsoft ADFS 지침에 따라 WIA를 지원하지 않는 기기를 위한 인트라넷 폼 기반 인증 구성을 권장합니다.

Entra ID OAuth 2.0 인증 활성화 (Enable OAuth 2.0 Authentication with Entra ID)
  • true: Entra ID OAuth 인증으로 팀과 계정을 만들 수 있습니다.
  • false: (기본값) Entra ID OAuth 인증을 비활성화합니다.
  • 시스템 콘솔 경로: Authentication > OAuth 2.0
  • config.json 설정: Office365Settings > Enable > false
  • 환경 변수: MM_OFFICE365SETTINGS_ENABLE
참고

자세한 내용은 Entra ID 싱글 사인온 문서를 참고하세요.

Entra ID OAuth 2.0 애플리케이션 ID (Entra ID OAuth 2.0 Application ID)

Microsoft Azure Portal에서 Entra ID를 싱글 사인온 서비스로 구성할 때 생성되는 Application ID를 저장합니다.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > OAuth 2.0
  • config.json 설정: Office365Settings > Id
  • 환경 변수: MM_OFFICE365SETTINGS_ID
참고

자세한 내용은 Entra ID 싱글 사인온 문서를 참고하세요.

Entra ID OAuth 2.0 애플리케이션 시크릿 비밀번호 (Entra ID OAuth 2.0 Application secret password)

Microsoft Azure Portal에서 Entra ID를 싱글 사인온 서비스로 구성할 때 생성되는 Application Secret Password를 저장합니다.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > OAuth 2.0
  • config.json 설정: Office365Settings > Secret
  • 환경 변수: MM_OFFICE365SETTINGS_SECRET
참고

자세한 내용은 Entra ID 싱글 사인온 문서를 참고하세요.

Entra ID OAuth 2.0 디렉터리(테넌트) ID (Entra ID OAuth 2.0 Directory (tenant) ID)

Azure Portal에서 Mattermost용으로 지정한 Directory (tenant) ID를 저장합니다.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > OAuth 2.0
  • config.json 설정: Office365Settings > DirectoryId
  • 환경 변수: MM_OFFICE365SETTINGS_DIRECTORYID
참고

자세한 내용은 Entra ID 싱글 사인온 문서를 참고하세요.

Entra ID OAuth 2.0 User API 엔드포인트 (Entra ID OAuth 2.0 User API endpoint)

User API 엔드포인트로는 https://graph.microsoft.com/v1.0/me를 권장합니다. 그 외에는 서버에서 사용할 수 있는 경우 http 또는 https로 된 맞춤 엔드포인트를 config.json에 입력하세요.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > OAuth 2.0
  • config.json 설정: Office365Settings > UserAPIEndpoint
  • 환경 변수: MM_OFFICE365SETTINGS_USERAPIENDPOINT
Entra ID OAuth 2.0 Auth 엔드포인트 (Entra ID OAuth 2.0 Auth endpoint)

Auth 엔드포인트로는 https://login.microsoftonline.com/common/oauth2/v2.0/authorize를 권장합니다. 그 외에는 서버에서 사용할 수 있는 경우 http 또는 https로 된 맞춤 엔드포인트를 config.json에 입력하세요.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > OAuth 2.0
  • config.json 설정: Office365Settings > AuthEndpoint
  • 환경 변수: MM_OFFICE365SETTINGS_AUTHENDPOINT
Entra ID OAuth 2.0 Token 엔드포인트 (Entra ID OAuth 2.0 Token endpoint)

Token 엔드포인트로는 https://login.microsoftonline.com/common/oauth2/v2.0/token을 권장합니다. 그 외에는 서버에서 사용할 수 있는 경우 http 또는 https로 된 맞춤 엔드포인트를 config.json에 입력하세요.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > OAuth 2.0
  • config.json 설정: Office365Settings > TokenEndpoint
  • 환경 변수: MM_OFFICE365SETTINGS_TOKENENDPOINT

OpenID Connect

시스템 콘솔에서 Authentication > OpenID Connect로 이동해 다음 구성 설정에 접근합니다.

OpenID Connect 서비스 공급자 선택 (Select OpenID Connect service provider)

이 설정으로 OpenID Connect를 활성화합니다. 다음 옵션이 있습니다.
  • 시스템 콘솔 경로: Authentication > OpenID Connect
  • config.json 설정: N/A
  • 환경 변수: N/A
참고

GitLab OpenID는 모든 플랜에서 사용할 수 있습니다. 그 밖의 공급자는 Mattermost Enterprise 또는 Professional이 필요합니다.

GitLab OpenID 설정

GitLab OpenID Connect 인증 활성화 (Enable OpenID Connect authentication with GitLab)
  • true: GitLab OpenID Connect 인증으로 팀과 계정을 만들 수 있습니다.
  • false: (기본값) GitLab OpenID Connect 인증을 비활성화합니다.
  • 시스템 콘솔 경로: Authentication > OpenID Connect
  • config.json 설정: GitLabSettings > Enable > false
  • 환경 변수: MM_GITLABSETTINGS_ENABLE
참고

자세한 내용은 GitLab 싱글 사인온 문서를 참고하세요.

GitLab OpenID 사이트 URL (GitLab OpenID site URL)

GitLab 인스턴스의 URL을 저장합니다. 예: https://example.com:3000.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > OpenID Connect
  • config.json 설정: N/A
  • 환경 변수: N/A
참고

자세한 내용은 GitLab 싱글 사인온 문서의 Step 2를 참고하세요.

GitLab OpenID Discovery 엔드포인트 (GitLab OpenID Discovery endpoint)

이 설정에는 GitLab OpenID Connect의 Discovery 엔드포인트가 미리 채워져 있습니다.

문자열 입력. 기본값은 https://gitlab.com/.well-known/openid-configuration입니다
  • 시스템 콘솔 경로: Authentication > OpenID Connect
  • config.json 설정: GitLabSettings > DiscoveryEndpoint
  • 환경 변수: MM_GITLABSETTINGS_DISCOVERYENDPOINT
참고

자세한 내용은 GitLab 싱글 사인온 문서의 Step 2를 참고하세요.

GitLab OpenID 클라이언트 ID (GitLab OpenID Client ID)

GitLab이 생성한 Application ID를 저장합니다.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > OpenID Connect
  • config.json 설정: GitLabSettings > Id
  • 환경 변수: MM_GITLABSETTINGS_ID
참고

자세한 내용은 GitLab 싱글 사인온 문서의 Step 2를 참고하세요.

GitLab OpenID 클라이언트 시크릿 (GitLab OpenID Client secret)

GitLab이 생성한 Application Secret Key를 저장합니다.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > OpenID Connect
  • config.json 설정: GitLabSettings > Secret
  • 환경 변수: MM_GITLABSETTINGS_SECRET
참고

자세한 내용은 GitLab 싱글 사인온 문서의 Step 2를 참고하세요.

GitLab OpenID preferred username 사용 (GitLab OpenID use preferred username)
  • true: Mattermost가 GitLab OpenID 토큰의 preferred_username 클레임을 Mattermost 사용자 이름으로 사용합니다.
  • false: (기본값) Mattermost가 사용자 이름 지정에 preferred_username 클레임을 사용하지 않습니다.
  • 시스템 콘솔 경로: Authentication > OpenID Connect
  • config.json 설정: GitLabSettings > UsePreferredUsername > false
  • 환경 변수: MM_GITLABSETTINGS_USEPREFERREDUSERNAME

Google OpenID 설정

Google OpenID Connect 인증 활성화 (Enable OpenID Connect authentication with Google)

- true: Google OpenID Connect로 팀 생성과 계정 가입을 허용합니다. - false: (기본값) Google OpenID Connect를 팀 생성이나 계정 가입에 사용할 수 없습니다.

  • true: Google OpenID 인증으로 팀과 계정을 만들 수 있습니다.
  • false: (기본값) Google OpenID 인증을 비활성화합니다.

구현 방법은 Google 싱글 사인온 문서를 참고하세요.
  • 시스템 콘솔 경로: Authentication > OpenID Connect
  • config.json 설정: GoogleSettings > Enable > false
  • 환경 변수: MM_GOOGLESETTINGS_ENABLE
Google OpenID Discovery 엔드포인트 (Google OpenID Discovery endpoint)

이 설정에는 Google OpenID Connect의 Discovery 엔드포인트가 미리 채워져 있습니다.

Google Apps SSO를 위한 Mattermost 구성을 참고하세요.

문자열 입력. 기본값은 https://accounts.google.com/.well-known/openid-configuration입니다
  • 시스템 콘솔 경로: Authentication > OpenID Connect
  • config.json 설정: GoogleSettings > DiscoveryEndpoint
  • 환경 변수: MM_GOOGLESETTINGS_DISCOVERYENDPOINT
Google OpenID 클라이언트 ID (Google OpenID Client ID)

Google이 생성한 클라이언트 ID를 저장합니다.

구현 방법은 Google 싱글 사인온 문서를 참고하세요.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > OpenID Connect
  • config.json 설정: GoogleSettings > Id
  • 환경 변수: MM_GOOGLESETTINGS_ID
Google OpenID 클라이언트 시크릿 (Google OpenID Client secret)

Google이 생성한 클라이언트 시크릿을 저장합니다.

구현 방법은 Google 싱글 사인온 문서를 참고하세요.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > OpenID Connect
  • config.json 설정: GoogleSettings > Secret
  • 환경 변수: MM_GOOGLESETTINGS_SECRET
Google OpenID preferred username 사용 (Google OpenID use preferred username)
  • true: Mattermost가 Google OpenID 토큰의 preferred_username 클레임을 Mattermost 사용자 이름으로 사용합니다.
  • false: (기본값) Mattermost가 사용자 이름 지정에 preferred_username 클레임을 사용하지 않습니다.
  • 시스템 콘솔 경로: Authentication > OpenID Connect
  • config.json 설정: GoogleSettings > UsePreferredUsername > false
  • 환경 변수: MM_GOOGLESETTINGS_USEPREFERREDUSERNAME

Entra ID OpenID 설정

참고

Microsoft ADFS 지침에 따라 WIA를 지원하지 않는 기기를 위한 인트라넷 폼 기반 인증 구성을 권장합니다.

Entra ID OpenID Connect 인증 활성화 (Enable OpenID Connect authentication with Entra ID)
  • true: Entra ID OpenID Connect 인증으로 팀과 계정을 만들 수 있습니다.
  • false: (기본값) Entra ID OpenID Connect 인증을 비활성화합니다.

구현 방법은 Entra ID 싱글 사인온 문서를 참고하세요.
  • 시스템 콘솔 경로: Authentication > OpenID Connect
  • config.json 설정: Office365Settings > Enable > false
  • 환경 변수: MM_OFFICE365SETTINGS_ENABLE
Entra ID OpenID 디렉터리(테넌트) ID (Entra ID OpenID Directory (tenant) ID)

Microsoft Azure Portal에서 Mattermost용으로 지정한 Directory (tenant) ID를 저장합니다.

구현 방법은 Entra ID 싱글 사인온 문서를 참고하세요.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > OpenID Connect
  • config.json 설정: Office365Settings > DirectoryId
  • 환경 변수: MM_OFFICE365SETTINGS_DIRECTORYID
Entra ID OpenID Discovery 엔드포인트 (Entra ID OpenID Discovery endpoint)

이 설정에는 Entra ID OpenID Connect의 Discovery 엔드포인트가 미리 채워져 있습니다.

구현 방법은 Entra ID 싱글 사인온 문서를 참고하세요.

문자열 입력. 기본값은 https://login.microsoftonline.com/common/v2.0/.well-known/openid-configuration입니다
  • 시스템 콘솔 경로: Authentication > OpenID Connect
  • config.json 설정: Office365Settings > DiscoveryEndpoint
  • 환경 변수: MM_OFFICE365SETTINGS_DISCOVERYENDPOINT
Entra ID 클라이언트 ID (Entra ID Client ID)

Microsoft Azure Portal에서 생성한 Application (client) ID를 저장합니다.

구현 방법은 Entra ID 싱글 사인온 문서를 참고하세요.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > OpenID Connect
  • config.json 설정: Office365Settings > Id
  • 환경 변수: MM_OFFICE365SETTINGS_ID
Entra ID 클라이언트 시크릿 (Entra ID Client secret)

Microsoft Azure Portal에서 생성한 Client Secret을 저장합니다.

구현 방법은 Entra ID 싱글 사인온 문서를 참고하세요.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > OpenID Connect
  • config.json 설정: Office365Settings > Secret
  • 환경 변수: MM_OFFICE365SETTINGS_SECRET
Entra ID preferred username 사용 (Entra ID use preferred username)
  • true: Mattermost가 Entra ID OpenID 토큰의 preferred_username 클레임을 Mattermost 사용자 이름으로 사용합니다.
  • false: (기본값) Mattermost가 사용자 이름 지정에 preferred_username 클레임을 사용하지 않습니다.
  • 시스템 콘솔 경로: Authentication > OpenID Connect
  • config.json 설정: Office365Settings > UsePreferredUsername > false
  • 환경 변수: MM_OFFICE365SETTINGS_USEPREFERREDUSERNAME
참고

preferred_username 클레임을 사용할 수 있게 하려면 Azure Portal의 App registrations > Token configuration에서 선택적 클레임으로 추가하세요. 설정 방법은 Entra ID 싱글 사인온을 참고하세요.

OpenID Connect(기타) 설정

기타 서비스 공급자의 OpenID Connect 인증 활성화 (Enable OpenID Connect authentication with other service providers)
  • true: 다른 OpenID Connect 서비스 공급자로 팀과 계정을 만들 수 있습니다.
  • false: (기본값) 다른 서비스 공급자를 통한 OpenID Connect 인증을 비활성화합니다.

구현 방법은 OpenID Connect 싱글 사인온 문서를 참고하세요.
  • 시스템 콘솔 경로: Authentication > OpenID Connect
  • config.json 설정: OpenIdSettings > Enable > false
  • 환경 변수: MM_OPENIDSETTINGS_ENABLE
OpenID Connect(기타) 버튼 이름 (OpenID Connect (other) Button name)

OpenID 로그인 버튼에 표시할 텍스트입니다.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > OpenID Connect
  • config.json 설정: OpenIdSettings > ButtonText
  • 환경 변수: MM_OPENIDSETTINGS_BUTTONTEXT
OpenID Connect(기타) 버튼 색상 (OpenID Connect (other) Button color)

OpenID 로그인 버튼의 색상입니다. 코드 앞에 #을 붙인 16진수 코드를 사용하세요. 예: #145DBF.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > OpenID Connect
  • config.json 설정: OpenIdSettings > ButtonColor
  • 환경 변수: MM_OPENIDSETTINGS_BUTTONCOLOR
OpenID Connect(기타) Discovery 엔드포인트 (OpenID Connect (other) Discovery endpoint)

OpenID 공급자의 Discovery 엔드포인트 URL을 저장합니다. URL은 https://myopenid.provider.com/{my_organization}/.well-known/openid-configuration 형식이어야 합니다.

구현 방법은 OpenID Connect 싱글 사인온 문서를 참고하세요.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > OpenID Connect
  • config.json 설정: OpenIdSettings > DiscoveryEndpoint
  • 환경 변수: MM_OPENIDSETTINGS_DISCOVERYENDPOINT
참고

Discovery Endpoint 설정은 임의 호스트의 연결 가능 여부와 가용성을 확인하는 데 악용될 수 있습니다. 이를 우려하는 시스템 관리자는 맞춤 관리자 역할을 사용해 이 설정을 수정할 수 있는 권한을 제한할 수 있습니다. 자세한 내용은 위임형 세분화 관리 문서를 참고하세요.

OpenID Connect(기타) 클라이언트 ID (OpenID Connect (other) Client ID)

OpenID 공급자에서 발급받은 클라이언트 ID를 저장합니다.

구현 방법은 OpenID Connect 싱글 사인온 문서를 참고하세요.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > OpenID Connect
  • config.json 설정: OpenIdSettings > Id
  • 환경 변수: MM_OPENIDSETTINGS_ID
OpenID Connect(기타) 클라이언트 시크릿 (OpenID Connect (other) Client secret)

OpenID 공급자에서 발급받은 클라이언트 시크릿을 저장합니다.

구현 방법은 OpenID Connect 싱글 사인온 문서를 참고하세요.

문자열 입력.
  • 시스템 콘솔 경로: Authentication > OpenID Connect
  • config.json 설정: OpenIdSettings > Secret
  • 환경 변수: MM_OPENIDSETTINGS_SECRET
OpenID Connect(기타) preferred username 사용 (OpenID Connect (other) use preferred username)
  • true: Mattermost가 해당 공급자의 OpenID 토큰에서 preferred_username 클레임을 Mattermost 사용자 이름으로 사용합니다.
  • false: (기본값) Mattermost가 사용자 이름 지정에 preferred_username 클레임을 사용하지 않습니다.
  • 시스템 콘솔 경로: Authentication > OpenID Connect
  • config.json 설정: OpenIdSettings > UsePreferredUsername > false
  • 환경 변수: MM_OPENIDSETTINGS_USEPREFERREDUSERNAME

게스트 접근

시스템 콘솔에서 Authentication > Guest Access로 이동해 다음 구성 설정에 접근합니다.

게스트 접근 활성화 (Enable guest access)

  • true: 게스트 계정 기능을 활성화합니다.
  • false: (기본값) 게스트 계정 기능을 비활성화합니다.
  • 시스템 콘솔 경로: Authentication > Guest Access
  • config.json 설정: GuestAccountsSettings > Enable > false
  • 환경 변수: MM_GUESTACCOUNTSSETTINGS_ENABLE
참고

게스트 과금은 채널 접근 범위에 따라 달라집니다. 정확히 하나의 활성 채널에 속한 게스트는 단일 채널 게스트로 간주되어 주된 유료 좌석 수에 포함되지 않으며, 라이선스 좌석 수 대비 1:1 비율까지는 무료입니다. 여러 활성 채널에 속한 게스트는 청구 목적상 계속 활성화된 사용자로 집계됩니다. 다이렉트 메시지와 그룹 메시지는 게스트가 단일 채널 게스트로 집계되는지 여부에 영향을 주지 않습니다. 과금 목적의 게스트 채널 접근 집계에는 활성 채널만 포함되며 보관된 채널은 제외됩니다. 자세한 내용은 게스트 계정 문서를 참고하세요.

허용 게스트 도메인 (Whitelisted guest domains)

게스트 계정 생성을 제한하려면 이 설정을 사용합니다. 값을 지정하면 게스트 계정은 목록에 있는 도메인 중 하나로 인증된 이메일 주소를 사용해야 합니다.

하나 이상의 도메인을 쉼표로 구분해 문자열로 입력합니다.
  • 시스템 콘솔 경로: Authentication > Guest Access
  • config.json 설정: GuestAccountsSettings > RestrictCreationToDomains
  • 환경 변수: MM_GUESTACCOUNTSSETTINGS_RESTRICTCREATIONTODOMAINS

게스트 태그 표시 (Show guest tag)

  • true: (기본값) Mattermost에서 게스트 태그가 표시됩니다.
  • false: Mattermost에서 게스트 태그가 표시되지 않습니다.
  • 시스템 콘솔 경로: Authentication > Guest Access
  • config.json 설정: GuestAccountsSettings > HideTags > true
  • 환경 변수: MM_GUESTACCOUNTSSETTINGS_HIDETAGS
참고

이 구성 설정은 웹, 데스크톱 앱, 모바일 앱을 포함한 모든 Mattermost 클라이언트에 적용됩니다. 자세한 내용은 게스트 계정 문서를 참고하세요.

Entry, Enterprise, Enterprise Advanced 플랜에서 사용할 수 있습니다 (Professional에서는 사용할 수 없습니다).

  • true: 게스트 사용자를 위한 비밀번호 없는 매직 링크 인증을 활성화합니다.
  • false: (기본값) 게스트 사용자의 매직 링크 인증이 비활성화됩니다.
  • 시스템 콘솔 경로: Authentication > Guest Access
  • config.json 설정: GuestAccountsSettings > EnableGuestMagicLink > false
참고

게스트 사용자 설정에 대한 자세한 내용은 게스트 계정 문서를 참고하세요.