InfoGrab DocsInfoGrab Docs

인증 구성 설정

요약

Mattermost는 최대 4가지의 동시 사용자 인증 방법을 지원합니다: 제품 메뉴를 선택하고 System Console을 선택한 다음 Authentication을 선택하여 System Console에서 다음 인증 구성 옵션을 검토하고 관리하세요:

사용 가능 플랜: Entry, Professional, Enterprise, Enterprise Advanced

Mattermost는 최대 4가지의 동시 사용자 인증 방법을 지원합니다:

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

제품 제품 메뉴 아이콘을 사용하여 채널, 협업 플레이북, 보드 사이를 이동합니다. 메뉴를 선택하고 System Console을 선택한 다음 Authentication을 선택하여 System Console에서 다음 인증 구성 옵션을 검토하고 관리하세요:

Tip

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

  • jq와 같은 도구를 사용하는 경우 cat config/config.json | jq '.TeamSettings.EnableUserCreation'을 입력합니다.
  • config.json 파일을 수동으로 편집할 때는 TeamSettings와 같은 객체를 찾은 뒤 그 안에서 EnableUserCreation 키를 찾으세요.

가입#

System Console에서 Authentication > Signup으로 이동하여 다음 구성 설정에 접근하세요.

계정 생성 활성화#

  • true: (기본값) 초대 없이도 누구나 이 서버에서 사용자 계정을 가입할 수 있습니다. 이메일 기반 가입에만 적용됩니다.
  • false: 계정 생성 기능이 비활성화됩니다. Create Account를 선택하면 오류가 표시됩니다. 이메일, OpenID Connect, OAuth 2.0 사용자 계정 인증에 적용됩니다.
  • 시스템 구성 경로: Authentication > Signup
  • config.json 설정: TeamSettings > EnableUserCreation > true
  • 환경 변수: MM_TEAMSETTINGS_ENABLEUSERCREATION
Note
  • LDAP 및 SAML 사용자는 이 구성 설정의 활성화 여부와 관계없이 LDAP 또는 SAML 사용자 자격 증명으로 로그인하여 Mattermost 계정을 항상 생성할 수 있습니다.
  • Mattermost v10.9부터 꺾쇠 괄호로 묶인 이메일 주소(예: [billy@example.com](mailto:billy@example.com))는 거부됩니다. 문제를 방지하려면 모든 사용자 이메일이 일반 주소 형식(예: billy@example.com)을 준수하는지 확인하세요. 또한, 이 제품 변경 사항에 맞게 Mattermost 사용자 데이터를 사전에 감사하고 업데이트하는 조치를 취하는 것을 강력히 권장합니다. 영향을 받는 사용자는 Mattermost 접근 또는 사용자 프로필 관리에 문제가 생길 수 있습니다. mmctl user email을 사용하여 이러한 사용자 이메일을 수동으로 업데이트할 수 있습니다.
  • 지원되는 SAML 암호화 방법을 참조하세요.

계정 생성을 지정된 이메일 도메인으로 제한#

이 설정은 새 계정 또는 팀을 만드는 데 사용할 수 있는 이메일 주소 도메인을 제한합니다. | - 시스템 구성 경로: Authentication > Signup | 제한이 작동하려면 이메일 인증 필수를 | - config.json 설정: TeamSettings > RestrictCreationToDomains true로 반드시 설정해야 합니다. 이 설정은 이메일 로그인에만 영향을 줍니다. | - 환경 변수: MM_TEAMSETTINGS_RESTRICTCREATIONTODOMAINS |

오픈 서버 활성화#

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

이메일 초대 활성화#

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

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

대기 중인 이메일 초대 무효화#

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

이 옵션에는 config.json 설정이나 환경 변수가 없습니다.

  • 시스템 구성 경로: Authentication > Signup
  • config.json 설정: 해당 없음
  • 환경 변수: 해당 없음

이메일#

System Console에서 Authentication > Email로 이동하여 다음 구성 설정에 접근하세요.

이메일로 계정 생성 활성화#

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

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

이메일 인증 필수#

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

이메일로 로그인 활성화#

  • true: (기본값) 사용자가 이메일과 비밀번호로 로그인할 수 있습니다.
  • false: 이메일과 비밀번호를 사용한 인증을 비활성화하고 로그인 화면에서 해당 옵션을 제거합니다. 인증을 싱글 사인온 서비스로 제한하려면 이 옵션을 사용하세요.
  • 시스템 구성 경로: Authentication > Email
  • config.json 설정: EmailSettings > EnableSignInWithEmail
  • 환경 변수: MM_EMAILSETTINGS_ENABLESIGNINWITHEMAIL
Note

- 로그인 페이지에서 사용자에게 이메일 로그인 옵션만 단일하게 제공하려면, 사용자명으로 로그인 활성화 구성 설정이 false로 설정되어 있는지 확인하세요. - Mattermost v10.9부터 꺾쇠 괄호로 묶인 이메일 주소(예: [billy@example.com](mailto:billy@example.com))는 거부됩니다. 문제를 방지하려면 모든 사용자 이메일이 일반 주소 형식(예: billy@example.com)을 준수하는지 확인하세요. 또한, 이 제품 변경 사항에 맞게 Mattermost 사용자 데이터를 사전에 감사하고 업데이트하는 조치를 취하는 것을 강력히 권장합니다. 영향을 받는 사용자는 Mattermost 접근 또는 사용자 프로필 관리에 문제가 생길 수 있습니다. mmctl user email을 사용하여 이러한 사용자 이메일을 수동으로 업데이트할 수 있습니다.

사용자명으로 로그인 활성화#

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

이메일 기반 인증은 개인 네트워크의 소규모 팀에서만 사용하도록 강력히 권장합니다.


비밀번호#

System Console에서 Authentication > Password로 이동하여 다음 구성 설정에 접근하세요.

Note

Mattermost v11.0부터 비밀번호 해싱에 보안 강화를 위해 PBKDF2를 사용합니다. 사용자 비밀번호는 v11.0 이상으로 업그레이드한 후 로그인할 때 자동으로 마이그레이션됩니다. 이 마이그레이션은 점진적으로 이루어지며 사용자가 인증할 때 투명하게 처리됩니다.

최소 비밀번호 길이#

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

숫자 입력. 기본값은 5입니다.

  • 시스템 구성 경로: Authentication > Password
  • config.json 설정: PasswordSettings > MinimumLength
  • 환경 변수: MM_PASSWORDSETTINGS_MINIMUMLENGTH

비밀번호 요건#

이 설정은 비밀번호 문자 요건을 제어합니다. 해당 확인란을 선택하면 비밀번호에 다음이 포함되어야 합니다:

  • 소문자 하나 이상
  • 대문자 하나 이상
  • 숫자 하나 이상
  • 기호 하나 이상(다음 중에서): !"#$%&'()*+,-./:;<=>?@[]^_`|~.

사용자가 유효하지 않은 비밀번호를 설정하려고 하면 System Console에서 미리 본 오류 메시지가 표시됩니다.

모든 확인란의 기본값은 선택 해제입니다. 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

최대 로그인 시도 횟수#

이 설정은 사용자가 계정이 잠기기 전까지 로그인에 실패할 수 있는 횟수를 결정합니다. 계정이 잠기면 이메일을 통한 비밀번호 재설정 절차를 거쳐야 합니다.

숫자 입력. 기본값은 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
Note

비밀번호 찾기 링크 URL은 Site Configuration > Customization > Forgot Password Custom Link에서 사용자 지정할 수 있습니다. 자세한 내용은 구성 문서를 참조하세요.


MFA#

사용 가능 플랜: Entry, Professional, Enterprise, Enterprise Advanced

System Console에서 Authentication > MFA로 이동하여 다음 구성 설정에 접근하세요.

자체 사설 네트워크 내에 Mattermost를 배포하고 모바일 액세스를 위해 VPN 클라이언트를 사용하여 기존 프로토콜로 Mattermost를 보호하는 것을 권장합니다. 기존 보안 프로토콜을 우회하여 사설 네트워크 외부에서 Mattermost를 실행하려는 경우, Mattermost 액세스를 위한 다중 인증 서비스를 별도로 추가하는 것을 권장합니다.

다중 인증 활성화#

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

다중 인증 강제 적용#

- true: AD/LDAP 또는 이메일 주소로 로그인하는 사용자에게 다중 인증(MFA)을 요구합니다. | - 시스템 구성 경로: Authentication > MFA | | - config.json 설정: ServiceSettings > EnforceMultifactorAuthentication > false

신규 사용자는 MFA를 설정해야 합니다. 로그인한 사용자는 구성이 완료될 때까지 MFA | - 환경 변수: MM_SERVICESETTINGS_ENFORCEMULTIFACTORAUTHENTICATION | 설정 페이지로 리디렉션됩니다. | | | |

  • false: (기본값) MFA는 선택 사항입니다. | |
Note

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


AD/LDAP#

System Console에서 Authentication > AD/LDAP으로 이동하여 다음 구성 설정에 접근하세요. 이렇게 하면 각 설정을 단계별로 구성하고 테스트하는 AD/LDAP 설정 마법사가 열립니다.

마법사는 다음 섹션으로 구성됩니다:

Note

각 섹션에는 구성을 단계적으로 확인할 수 있는 테스트 옵션이 있어, 설정 과정 초기에 문제를 파악하고 해결하는 데 도움이 됩니다.

연결 설정#

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

AD/LDAP로 로그인 활성화#

  • true: AD/LDAP를 사용한 로그인을 허용합니다.
  • false: (기본값) AD/LDAP를 사용한 로그인을 비활성화합니다.
  • 시스템 구성 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > Enable > false
  • 환경 변수: MM_LDAPSETTINGS_ENABLE

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
Note

System Console의 AD/LDAP 동기화 설정은 임의의 호스트에 대한 연결 가능 여부와 가용성을 확인하는 데 사용될 수 있습니다. 이 점이 우려되는 시스템 관리자는 사용자 지정 관리자 역할을 사용하여 이러한 설정을 수정할 수 있는 권한을 제한할 수 있습니다. 자세한 내용은 위임된 세분화 관리) 문서를 참조하세요.

로그인 필드 이름#

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

문자열 입력. 기본값은 AD/LDAP Username입니다.

  • 시스템 구성 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > LoginFieldName
  • 환경 변수: MM_LDAPSETTINGS_LOGINFIELDNAME

AD/LDAP 서버#

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

문자열 입력.

  • 시스템 구성 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > LdapServer
  • 환경 변수: MM_LDAPSETTINGS_LDAPSERVER
Note

System Console의 AD/LDAP 동기화 설정은 임의의 호스트에 대한 연결 가능 여부와 가용성을 확인하는 데 사용될 수 있습니다. 이 점이 우려되는 시스템 관리자는 사용자 지정 관리자 역할을 사용하여 이러한 설정을 수정할 수 있는 권한을 제한할 수 있습니다. 자세한 내용은 위임된 세분화 관리) 문서를 참조하세요.

AD/LDAP 포트#

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

숫자 입력. 기본값은 389입니다.

  • 시스템 구성 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > LdapPort > 389
  • 환경 변수: MM_LDAPSETTINGS_LDAPPORT

바인드 사용자명#

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

계정 권한을 Base DN 설정에 지정된 AD/LDAP 트리 부분에 대한 읽기 전용 액세스로 제한하세요.

Active Directory를 사용하는 경우 Bind Username은 "DOMAIN/username" 형식으로 도메인을 지정해야 합니다.

문자열 입력.

  • 시스템 구성 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > BindUsername
  • 환경 변수: MM_LDAPSETTINGS_BINDUSERNAME
Note

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

바인드 비밀번호#

Bind Username 설정에 지정된 사용자명의 비밀번호입니다.

문자열 입력.

  • 시스템 구성 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > BindPassword
  • 환경 변수: MM_LDAPSETTINGS_BINDPASSWORD

연결 보안#

이 설정은 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

인증서 확인 건너뛰기#

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

개인 키#

TLS 클라이언트 인증서가 기본 인증 메커니즘인 경우, 이 설정을 사용하여 LDAP 인증 공급자의 개인 키 파일을 업로드합니다.

문자열 입력.

  • 시스템 구성 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > PrivateKeyFile
  • 환경 변수: MM_LDAPSETTINGS_PRIVATEKEYFILE

공개 인증서#

TLS 클라이언트 인증서가 기본 인증 메커니즘인 경우, 이 설정을 사용하여 LDAP 인증 공급자의 공개 TLS 인증서를 업로드합니다.

문자열 입력.

  • 시스템 구성 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > PublicCertificateFile
  • 환경 변수: MM_LDAPSETTINGS_PUBLICCERTIFICATEFILE

최대 로그인 시도 횟수#

이 설정은 사용자가 계정이 잠기기 전까지 로그인에 실패할 수 있는 횟수를 결정합니다. 계정이 잠기면 이메일을 통한 비밀번호 재설정 절차를 거쳐야 합니다.

System Console의 사용자 페이지에서 계정 잠금을 해제할 수 있습니다. 이 값을 LDAP의 최대 로그인 시도 횟수보다 낮게 설정하면, Mattermost에서 로그인에 실패하더라도 사용자가 LDAP 서버에서 잠기지 않습니다.

숫자 입력. 기본값은 10입니다.

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

사용자 필터#

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

Base DN#

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

문자열 입력.

  • 시스템 구성 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > BaseDN
  • 환경 변수: MM_LDAPSETTINGS_BASEDN

사용자 필터#

이 설정은 사용자 객체를 검색할 때 적용되는 일반 구문 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
Note

이 필터는 Bind Username 계정의 권한으로 검색을 실행합니다. 이 계정은 Mattermost 전용이어야 하며 Base DN 필드에 지정된 AD/LDAP 트리 부분에 대한 읽기 전용 액세스 권한을 가져야 합니다.

그룹 필터#

사용 가능 플랜: Entry, Enterprise, Enterprise Advanced(Professional 제외)

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

문자열 입력. 기본값은 (|(objectClass=group)(objectClass=groupOfNames)(objectClass=groupOfUniqueNames))입니다.

  • 시스템 구성 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > GroupFilter
  • 환경 변수: MM_LDAPSETTINGS_GROUPFILTER
Note

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

관리자 필터 활성화#

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

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

관리자 필터#

이 설정은 선택된 사용자를 시스템 관리자로 지정하는 AD/LDAP 필터를 입력받습니다. 사용자는 다음 AD/LDAP 로그인 시 이 역할로 승격됩니다. 이 필터는 예약된 AD/LDAP 동기화 중에는 평가되지 않으며, Enable Synchronizing SAML Accounts With AD/LDAP가 활성화되어 있더라도 SAML로 인증하는 사용자에게는 적용되지 않습니다. SAML로 인증하는 사용자의 시스템 관리자를 지정하려면 SAML Admin Attribute 설정을 사용하세요.

Admin Filter가 제거되면, 현재 로그인한 사용자는 다음 로그인 시까지 관리자 역할을 유지합니다.

문자열 입력.

  • 시스템 구성 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > AdminFilter
  • 환경 변수: MM_LDAPSETTINGS_ADMINFILTER

게스트 필터#

이 설정은 Mattermost에 게스트 액세스 권한이 있는 외부 사용자를 검색할 때 적용할 AD/LDAP 필터를 입력받습니다. 쿼리로 선택된 사용자만 게스트로 Mattermost에 액세스할 수 있습니다. | - 시스템 구성 경로: Authentication > AD/LDAP |
- config.json 설정: LdapSettings > GuestFilter |
자세한 내용은 게스트 계정을 참조하세요. | - 환경 변수: MM_LDAPSETTINGS_GUESTFILTER
|

문자열 입력. | |

계정 동기화#

사용 가능 플랜: Entry, Enterprise, Enterprise Advanced(Professional 제외)

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

ID 속성#

Mattermost에서 고유 사용자 식별자로 사용되는 AD/LDAP 서버의 속성입니다.

이 속성은 objectGUID 또는 entryUUID처럼 변하지 않는 고유한 값을 가져야 합니다. 변경하기 전에 사용 중인 환경에서 이러한 속성을 사용할 수 있는지 확인하세요.

문자열 입력.

  • 시스템 구성 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > IdAttribute
  • 환경 변수: MM_LDAPSETTINGS_IDATTRIBUTE
Note

사용자의 ID 속성이 변경되면 이전 계정과 연결되지 않은 새 Mattermost 계정이 만들어집니다. 사용자가 로그인한 후에 이 필드를 변경해야 하는 경우 mmctl ldap idmigrate 명령을 사용하세요.

Note

ID 속성 값은 입력된 그대로 일치 여부를 판단하며, Mattermost는 대소문자 정규화를 적용하지 않습니다. PostgreSQL의 기본 대소문자 구분 콜레이션에서는 대소문자가 바뀌면 새 사용자로 취급되어 별도의 계정이 만들어집니다. AD/LDAP 서버가 이 속성을 일관된 대소문자로 반환하는지 확인하세요.

로그인 ID 속성#

Mattermost에 로그인할 때 사용하는 AD/LDAP 서버의 속성입니다. 일반적으로 Username Attribute와 동일합니다.

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

문자열 입력.

  • 시스템 구성 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > LoginIdAttribute
  • 환경 변수: MM_LDAPSETTINGS_LOGINIDATTRIBUTE

사용자명 속성#

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

이메일 속성#

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

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

문자열 입력.

  • 시스템 구성 경로: Authentication > AD/LDAP
  • config.json 설정 LdapSettings > EmailAttribute
  • 환경 변수: MM_LDAPSETTINGS_EMAILATTRIBUTE

이름 속성#

Mattermost의 이름 필드를 채우는 AD/LDAP 서버의 속성입니다. | - 시스템 구성 경로: Authentication > AD/LDAP |
- config.json 설정: LdapSettings > FirstNameAttribute |
설정하면 사용자가 이름을 편집할 수 없습니다. | - 환경 변수: MM_LDAPSETTINGS_FIRSTNAMEATTRIBUTE |
|

설정하지 않으면 사용자가 | | 프로필 설정에서 이름을 편집할 수 있습니다. | | | 문자열 입력. | |

성 속성#

Mattermost의 성 필드를 채우는 AD/LDAP 서버의 속성입니다. | - 시스템 구성 경로: Authentication > AD/LDAP |
- config.json 설정: LdapSettings > LastNameAttribute |
설정하면 사용자가 성을 편집할 수 없습니다. | - 환경 변수: MM_LDAPSETTINGS_LASTNAMEATTRIBUTE |
|

설정하지 않으면 사용자가 | | 프로필 설정의 일부로 성을 편집할 수 있습니다. | | | | 문자열 입력. | |

닉네임 속성#

Mattermost의 닉네임 필드를 채우는 AD/LDAP 서버의 속성입니다. | - 시스템 구성 경로: Authentication > AD/LDAP |
- config.json 설정: LdapSettings > NicknameAttribute |
설정하면 사용자가 닉네임을 편집할 수 없습니다. | - 환경 변수: MM_LDAPSETTINGS_NICKNAMEATTRIBUTE |
|

설정하지 않으면 사용자가 | | 프로필 설정의 일부로 닉네임을 편집할 수 있습니다. | | | 문자열 입력. | |

직책 속성#

Mattermost의 직책 필드를 채우는 AD/LDAP 서버의 속성입니다. | - 시스템 구성 경로: Authentication > AD/LDAP |
- config.json 설정: LdapSettings > PositionAttribute |
설정하면 사용자가 직책을 편집할 수 없습니다. | - 환경 변수: MM_LDAPSETTINGS_POSITIONATTRIBUTE |
|

설정하지 않으면 사용자가 | | 프로필 설정의 일부로 직책을 편집할 수 있습니다. | | | 문자열 입력. | |

프로필 사진 속성#

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

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

Mattermost의 이미지가 이미 AD/LDAP 이미지와 일치하면 이미지는 업데이트되지 않습니다.

문자열 입력.

  • 시스템 구성 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > PictureAttribute
  • 환경 변수: MM_LDAPSETTINGS_PICTUREATTRIBUTE

그룹 동기화#

사용 가능 플랜: Entry, Enterprise, Enterprise Advanced(Professional 제외)

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

그룹 표시 이름 속성#

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

문자열 입력.

  • 시스템 구성 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > GroupDisplayNameAttribute
  • 환경 변수: MM_LDAPSETTINGS_GROUPDISPLAYNAMEATTRIBUTE
Note

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

그룹 ID 속성#

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

이 속성은 entryUUID 또는 objectGUID처럼 변하지 않는 값이어야 합니다.

문자열 입력.

  • 시스템 구성 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > GroupIdAttribute
  • 환경 변수: MM_LDAPSETTINGS_GROUPIDATTRIBUTE
Note

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

Note

그룹 ID 속성 값은 입력된 그대로 일치 여부를 판단하며, Mattermost는 대소문자 정규화를 적용하지 않습니다. PostgreSQL의 기본 대소문자 구분 콜레이션에서는 대소문자가 바뀌면 Mattermost가 이전에 동기화된 그룹을 더 이상 인식하지 못하고 연결되지 않은 새 그룹으로 취급합니다. AD/LDAP 서버가 이 속성을 일관된 대소문자로 반환하는지 확인하세요.

동기화 성능#

사용 가능 플랜: Entry, Enterprise, Enterprise Advanced(Professional 제외)

AD/LDAP 동기화의 타이밍과 성능 설정을 구성합니다. 이 설정은 Mattermost가 AD/LDAP 서버와 동기화하는 빈도를 제어합니다.

동기화 간격(분)#

이 값은 각 동기화 사이의 간격을 분 단위로 설정하여 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
Note

LDAP 동기화에는 많은 수의 데이터베이스 읽기 쿼리가 필요합니다. 데이터베이스 부하를 모니터링하고 동기화 간격을 조정하여 성능 저하를 최소화하세요.

최대 페이지 크기#

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

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

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

숫자 입력. 기본값은 0입니다.

  • 시스템 구성 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > MaxPageSize > 0
  • 환경 변수: MM_LDAPSETTINGS_MAXPAGESIZE

쿼리 시간 제한(초)#

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

숫자 입력. 기본값은 60입니다.

  • 시스템 구성 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > QueryTimeout > 60
  • 환경 변수: MM_LDAPSETTINGS_QUERYTIMEOUT

동기화 기록#

사용 가능 플랜: Entry, Enterprise, Enterprise Advanced(Professional 제외)

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

AD/LDAP 지금 동기화#

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

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

수동 동기화 후 다음 동기화는 Synchronization Interval에 설정된 시간이 지난 뒤에 실행됩니다.

  • 시스템 구성 경로: Authentication > AD/LDAP
  • config.json 설정: 해당 없음
  • 환경 변수: 해당 없음
Note

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

/images/ldap-sync-table.png

AD/LDAP 마법사에서 사용할 수 없는 구성 설정#

사용 가능 플랜: Entry, Enterprise, Enterprise Advanced(Professional 제외)

다음 AD/LDAP 구성 설정은 config.json 파일에서만 사용할 수 있으며 System Console의 AD/LDAP 마법사 인터페이스에서는 사용할 수 없습니다.

동기화 시 제거된 멤버 다시 추가#

이 설정을 활성화하면 LDAP 동기화 중에, 그룹 동기화된 팀 또는 채널에서 이전에 제거된 LDAP 그룹 멤버를 다시 추가합니다.

  • true: 이전에 제거된 LDAP 그룹 멤버가 LDAP 동기화 중에 그룹 동기화된 팀 또는 채널에 다시 추가됩니다.
  • false: (기본값) 이전에 제거된 LDAP 그룹 멤버가 LDAP 동기화 중에 그룹 동기화된 팀 또는 채널에 다시 추가되지 않습니다.
  • 시스템 구성 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > ReAddRemovedMembers
  • 환경 변수: MM_LDAPSETTINGS_READDREMOVEDMEMBERS
Note

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


SAML 2.0#

System Console에서 Authentication > SAML 2.0으로 이동하여 다음 구성 설정에 접근하세요.

지원되는 SAML 암호화 방법을 참조하세요.

Important

Microsoft ADFS 가이드에 따라 WIA를 지원하지 않는 디바이스에 대해 인트라넷 양식 기반 인증을 구성하는 것을 권장합니다.

SAML 로그인 활성화#

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

SAML 계정과 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부터 Mattermost는 로그인 중에 연결된 LDAP 서버에 사용자가 존재하는지 확인하지 않습니다.
  • 시스템 구성 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > EnableSyncWithLdap > false
  • 환경 변수: MM_SAMLSETTINGS_ENABLESYNCWITHLDAP
Note
  • AD/LDAP 동기화는 Authentication > AD/LDAP 아래의 설정을 통해 활성화하고 구성해야 합니다.
  • Mattermost v10.9 이전에는 LDAP 서버에 없는 사용자도 로그인할 수 있었지만 다음 LDAP 동기화 시 비활성화되었습니다.
  • 동기화는 사용자 속성만 업데이트합니다. 사용자의 시스템 관리자 역할은 변경하지 않습니다. AD/LDAP 관리자 필터는 SAML로 인증된 사용자에게 적용되지 않으므로, 시스템 관리자를 지정하려면 대신 SAML 관리자 속성 설정을 사용하세요.
  • AD/LDAP 구성에 대한 자세한 내용은 AD/LDAP 설정을 참조하세요.

AD/LDAP와 동기화할 때 게스트 사용자 무시#

사용 가능 플랜: Entry, Enterprise, Enterprise Advanced(Professional 제외)

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

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

AD/LDAP 정보로 SAML 바인드 데이터 덮어쓰기#

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

이 설정은 SAML 인증과 AD/LDAP 동기화가 모두 활성화된 경우에만 사용할 수 있습니다.

  • 시스템 구성 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > EnableSyncWithLdapIncludeAuth > false
  • 환경 변수: MM_SAMLSETTINGS_ENABLESYNCWITHLDAPINCLUDEAUTH
Note

- LDAP 동기화가 활성화되지 않은 경우 이 설정은 false여야 합니다. 이 설정을 true에서 false로 변경하면 덮어쓰기가 비활성화됩니다. - 덮어쓰기가 활성화된 경우 SAML ID는 LDAP ID와 일치해야 합니다. - 자세한 내용은 AD/LDAP Setup을 참조하세요.

ID 공급자 메타데이터 URL#

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

문자열 입력.

  • 시스템 구성 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > IdpMetadataURL
  • 환경 변수: MM_SAMLSETTINGS_IDPMETADATAURL

SAML SSO URL#

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

문자열 입력.

  • 시스템 구성 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > IdpURL
  • 환경 변수: MM_SAMLSETTINGS_IDPURL

ID 공급자 발급자 URL#

이 설정은 SAML 요청에 사용되는 ID 공급자의 발급자 URL입니다.

문자열 입력.

  • 시스템 구성 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > IdpDescriptorURL
  • 환경 변수: MM_SAMLSETTINGS_IDPDESCRIPTORURL

ID 공급자 공개 인증서#

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

문자열 입력.

  • 시스템 구성 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > IdpCertificateFile
  • 환경 변수: MM_SAMLSETTINGS_IDPCERTIFICATEFILE

서명 확인#

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

서비스 공급자 로그인 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

서비스 공급자 식별자#

이 설정은 서비스 공급자의 고유 식별자이며, 대부분의 경우 서비스 공급자 로그인 URL과 같습니다. ADFS에서는 신뢰 당사자 식별자(Relying Party Identifier)와 일치해야 합니다.

문자열 입력.

  • 시스템 구성 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > ServiceProviderIdentifier
  • 환경 변수: MM_SAMLSETTINGS_SERVICEPROVIDERIDENTIFIER

암호화 활성화#

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

지원되는 SAML 암호화 방식#

Mattermost는 SAML에 대해 다음 암호화 방식을 지원합니다.

  • aes128-gcm
  • aes192-gcm
  • aes256-gcm
  • aes128-cbc
  • aes256-cbc

AES-192-GCM과 AES-256-GCM 지원은 Mattermost v10.9에서 도입되었습니다.

서비스 공급자 개인 키#

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

문자열 입력.

  • 시스템 구성 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > PrivateKeyFile
  • 환경 변수: MM_SAMLSETTINGS_PRIVATEKEYFILE

서비스 공급자 공개 인증서#

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

문자열 입력.

  • 시스템 구성 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > PublicCertificateFile
  • 환경 변수: MM_SAMLSETTINGS_PUBLICCERTIFICATEFILE

요청 서명#

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

서명 알고리즘#

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

문자열 입력.

Note

Mattermost v11부터 기본 서명 알고리즘이 보안 강화를 위해 RSAwithSHA1에서 RSAwithSHA256으로 변경되었습니다. 기존 구성은 계속 작동하지만, 신규 설치는 기본적으로 RSAwithSHA256을 사용합니다.

  • 시스템 구성 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > SignatureAlgorithm
  • 환경 변수: MM_SAMLSETTINGS_SIGNATUREALGORITHM

정규화 알고리즘#

이 설정은 정규화 알고리즘을 결정합니다. 옵션은 다음과 같습니다.

문자열 입력.

  • 시스템 구성 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > CanonicalAlgorithm
  • 환경 변수: MM_SAMLSETTINGS_CANONICALALGORITHM

이메일 속성#

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

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

문자열 입력.

  • 시스템 구성 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > EmailAttribute
  • 환경 변수: MM_SAMLSETTINGS_EMAILATTRIBUTE

사용자명 속성#

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

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

문자열 입력.

  • 시스템 구성 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > UsernameAttribute
  • 환경 변수: MM_SAMLSETTINGS_USERNAMEATTRIBUTE

Id 속성#

(선택 사항) 이 설정은 SAML 사용자를 Mattermost 사용자와 바인드하는 데 사용하는 SAML 어설션 속성을 결정합니다.

문자열 입력.

  • 시스템 구성 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > IdAttribute
  • 환경 변수: MM_SAMLSETTINGS_IDATTRIBUTE
Note

ID 속성 값은 원문 그대로 비교됩니다 - Mattermost는 대소문자 정규화를 적용하지 않습니다. PostgreSQL의 기본 대소문자 구분 데이터 정렬(collation)에서는 대소문자 표기가 변경되면 새로운 사용자로 처리되어 별도의 계정이 생성됩니다. ID 공급자가 이 속성을 일관된 대소문자로 반환하는지 확인하세요.

게스트 속성#

(선택 사항) 이 설정은 Mattermost 사용자에게 게스트 역할을 적용하는 데 사용하는 SAML 어설션 속성을 결정합니다. | - 시스템 구성 경로: Authentication > SAML 2.0 |
- config.json 설정: SamlSettings > GuestAttribute|
자세한 내용은 게스트 계정 문서를 참조하세요. | - 환경 변수: MM_SAMLSETTINGS_GUESTATTRIBUTE
|

문자열 입력. | |

관리자 속성 활성화#

  • true: 시스템 관리자 상태가 관리자 속성에 설정된 SAML 어설션 속성으로 결정됩니다.
  • false: (기본값) 시스템 관리자 상태가 SAML 어설션 속성으로 결정되지 않습니다.
  • 시스템 구성 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > EnableAdminAttribute > false
  • 환경 변수: MM_SAMLSETTINGS_ENABLEADMINATTRIBUTE

관리자 속성#

(선택 사항) 이 설정은 시스템 관리자를 지정하는 SAML 어설션의 속성을 결정합니다.

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

관리자 속성을 제거하더라도 로그인 중인 사용자는 관리자 상태를 유지합니다. 이 역할은 사용자가 로그아웃할 때에만 해제됩니다.

문자열 입력.

  • 시스템 구성 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > AdminAttribute
  • 환경 변수: MM_SAMLSETTINGS_ADMINATTRIBUTE

이름 속성#

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

문자열 입력.

  • 시스템 구성 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > FirstNameAttribute
  • 환경 변수: MM_SAMLSETTINGS_FIRSTNAMEATTRIBUTE

성 속성#

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

문자열 입력.

  • 시스템 구성 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > LastNameAttribute
  • 환경 변수: MM_SAMLSETTINGS_LASTNAMEATTRIBUTE

닉네임 속성#

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

문자열 입력.

  • 시스템 구성 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > NicknameAttribute
  • 환경 변수: MM_SAMLSETTINGS_NICKNAMEATTRIBUTE

직위 속성#

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

문자열 입력.

  • 시스템 구성 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > PositionAttribute
  • 환경 변수: MM_SAMLSETTINGS_POSITIONATTRIBUTE

선호 언어 속성#

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

문자열 입력.

  • 시스템 구성 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > LocaleAttribute
  • 환경 변수: MM_SAMLSETTINGS_LOCALEATTRIBUTE

로그인 버튼 텍스트#

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

문자열 입력. 기본값은 SAML입니다.

  • 시스템 구성 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > LoginButtonText
  • 환경 변수: MM_SAMLSETTINGS_LOGINBUTTONTEXT

OAuth 2.0#

System Console에서 Authentication > OAuth 2.0으로 이동하여 다음 구성 설정에 접근하세요. GitLab OAuth 인증 설정은 셀프 호스팅 배포에서 Authentication > GitLab 아래에서도 접근할 수 있습니다.

이 설정들을 사용하여 계정 생성 및 로그인을 위한 OAuth 2.0을 구성하세요.

OAuth 2.0 서비스 공급자 선택#

이 설정을 사용하여 OAuth를 활성화하고 서비스 공급자를 지정합니다. 옵션은 다음과 같습니다.

  • 시스템 구성 경로: Authentication > OAuth 2.0
  • config.json 설정: N/A
  • 환경 변수: N/A

GitLab OAuth 2.0 설정#

Note

Enterprise 구독의 경우 GitLab 설정은 OAuth 2.0 아래에서 찾을 수 있습니다.

GitLab과의 OAuth 2.0 인증 활성화#
  • true: GitLab OAuth 인증을 사용한 팀 및 계정 생성을 허용합니다. 구성하려면 시크릿과 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 애플리케이션 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 System Console 필드, config.json 설정 또는 환경 변수에 입력합니다.

문자열 입력.

  • 시스템 구성 경로: Authentication > OAuth 2.0 (or GitLab)
  • config.json 설정: GitLabSettings > Id
  • 환경 변수: MM_GITLABSETTINGS_ID
Note

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

GitLab OAuth 2.0 애플리케이션 시크릿 키#

이 설정은 GitLab의 OAuth 애플리케이션 시크릿 키를 저장합니다. 이 키는 애플리케이션 ID와 동시에 생성됩니다(GitLab OAuth 2.0 애플리케이션 ID 참조).

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

문자열 입력.

  • 시스템 구성 경로: Authentication > OAuth 2.0 (or GitLab)
  • config.json 설정: GitLabSettings > Secret
  • 환경 변수: MM_GITLABSETTINGS_SECRET
GitLab OAuth 2.0 사이트 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 사용자 API 엔드포인트#

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

이 URL을 Mattermost System Console 필드, config.json 설정 또는 환경 변수에 입력하세요.

문자열 입력.

  • 시스템 구성 경로: Authentication > OAuth 2.0 (or GitLab)
  • config.json 설정: GitLabSettings > UserAPIEndpoint
  • 환경 변수: MM_GITLABSETTINGS_USERAPIENDPOINT
GitLab OAuth 2.0 인증 엔드포인트#

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

이 URL을 Mattermost System Console 필드, config.json 설정 또는 환경 변수에 입력하세요.

문자열 입력.

  • 시스템 구성 경로: Authentication > OAuth 2.0 (or GitLab)
  • config.json 설정: GitLabSettings > AuthEndpoint
  • 환경 변수: MM_GITLABSETTINGS_AUTHENDPOINT
GitLab OAuth 2.0 토큰 엔드포인트#

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

이 URL을 Mattermost System Console 필드, config.json 설정 또는 환경 변수에 입력하세요.

문자열 입력.

  • 시스템 구성 경로: Authentication > OAuth 2.0 (or GitLab)
  • config.json 설정: GitLabSettings > TokenEndpoint
  • 환경 변수: MM_GITLABSETTINGS_TOKENENDPOINT

Google OAuth 2.0 설정#

Google과의 OAuth 2.0 인증 활성화#
  • true: Google OAuth 인증을 사용한 팀 및 계정 생성을 허용합니다. 구성하려면 클라이언트 ID와 클라이언트 시크릿 자격 증명을 입력하세요. | - 시스템 구성 경로: Authentication > OAuth 2.0 |
- false: (기본값) Google OAuth 인증을 비활성화합니다. | - config.json 설정: GoogleSettings > Enable > false|
- 환경 변수: MM_GOOGLESETTINGS_ENABLE |

Google Single Sign-On 구현 지침을 참조하세요. |

Google OAuth 2.0 클라이언트 ID#
이 설정은 Google의 OAuth 클라이언트 ID를 저장합니다. Google Cloud Platform APIs & Services 메뉴의 사용자 인증 정보 섹션으로 이동하여 Create Credentials > OAuth client ID를 선택해 ID를 생성하세요. | - 시스템 구성 경로: Authentication > OAuth 2.0 |
- config.json 설정: GoogleSettings > Id|
Google OAuth 또는 OpenID 인증을 구현하는 데 사용할 수 있는 지침은 Google Single Sign-On을 참조하세요. | - 환경 변수: MM_GOOGLESETTINGS_ID
|

문자열 입력. | |

Google OAuth 2.0 클라이언트 시크릿#

이 설정은 Google의 OAuth 클라이언트 시크릿을 저장합니다. 시크릿은 클라이언트 ID와 동시에 생성됩니다.

문자열 입력.

  • 시스템 구성 경로: Authentication > OAuth 2.0
  • config.json 설정: GoogleSettings > Secret
  • 환경 변수: MM_GOOGLESETTINGS_SECRET
Google OAuth 2.0 사용자 API 엔드포인트#

사용자 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 인증 엔드포인트#

인증 엔드포인트로 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 토큰 엔드포인트#

토큰 엔드포인트로 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 설정#

Note

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

Entra ID와의 OAuth 2.0 인증 활성화#
  • true: Entra ID OAuth 인증을 사용한 팀 및 계정 생성을 허용합니다.
  • false: (기본값) Entra ID OAuth 인증을 비활성화합니다.
  • 시스템 구성 경로: Authentication > OAuth 2.0
  • config.json 설정: Office365Settings > Enable > false
  • 환경 변수: MM_OFFICE365SETTINGS_ENABLE
Note

자세한 내용은 Entra ID Single Sign-On 문서를 참조하세요.

Entra ID OAuth 2.0 애플리케이션 ID#

이 설정은 Microsoft Azure Portal을 통해 Entra ID를 싱글 사인온 서비스로 구성할 때 생성되는 애플리케이션 ID를 저장합니다.

문자열 입력.

  • 시스템 구성 경로: Authentication > OAuth 2.0
  • config.json 설정: Office365Settings > Id
  • 환경 변수: MM_OFFICE365SETTINGS_ID
Note

자세한 내용은 Entra ID Single Sign-On 문서를 참조하세요.

Entra ID OAuth 2.0 애플리케이션 시크릿 비밀번호#

이 설정은 Microsoft Azure Portal을 통해 Entra ID를 싱글 사인온 서비스로 구성할 때 생성되는 애플리케이션 시크릿 비밀번호를 저장합니다.

문자열 입력.

  • 시스템 구성 경로: Authentication > OAuth 2.0
  • config.json 설정: Office365Settings > Secret
  • 환경 변수: MM_OFFICE365SETTINGS_SECRET
Note

자세한 내용은 Entra ID Single Sign-On 문서를 참조하세요.

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

이 설정은 Azure Portal을 통해 Mattermost에 설정된 디렉터리 (테넌트) ID를 저장합니다.

문자열 입력.

  • 시스템 구성 경로: Authentication > OAuth 2.0
  • config.json 설정: Office365Settings > DirectoryId
  • 환경 변수: MM_OFFICE365SETTINGS_DIRECTORYID
Note

자세한 내용은 Entra ID Single Sign-On 문서를 참조하세요.

Entra ID OAuth 2.0 사용자 API 엔드포인트#

사용자 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 인증 엔드포인트#

인증 엔드포인트로 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 토큰 엔드포인트#

토큰 엔드포인트로 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#

System Console에서 Authentication > OpenID Connect로 이동하여 다음 구성 설정에 접근하세요.

OpenID Connect 서비스 공급자 선택#

이 설정을 사용하여 OpenID Connect를 활성화합니다. 옵션은 다음과 같습니다.

  • 시스템 구성 경로: Authentication > OpenID Connect
  • config.json 설정: N/A
  • 환경 변수: N/A
Note

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

GitLab OpenID 설정#

GitLab과의 OpenID Connect 인증 활성화#
  • true: GitLab OpenID Connect 인증을 사용한 팀 및 계정 생성을 허용합니다.
  • false: (기본값) GitLab OpenID Connect 인증을 비활성화합니다.
  • 시스템 구성 경로: Authentication > OpenID Connect
  • config.json 설정: GitLabSettings > Enable > false
  • 환경 변수: MM_GITLABSETTINGS_ENABLE
Note

자세한 내용은 GitLab Single Sign-On 문서를 참조하세요.

GitLab OpenID 사이트 URL#

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

문자열 입력.

  • 시스템 구성 경로: Authentication > OpenID Connect
  • config.json 설정: N/A
  • 환경 변수: N/A
Note

자세한 내용은 GitLab Single Sign-On 문서의 2단계를 참조하세요.

GitLab OpenID 검색 엔드포인트#

이 설정에는 GitLab OpenID Connect의 검색 엔드포인트가 미리 입력되어 있습니다.

문자열 입력. 기본값은 https://gitlab.com/.well-known/openid-configuration입니다.

  • 시스템 구성 경로: Authentication > OpenID Connect
  • config.json 설정: GitLabSettings > DiscoveryEndpoint
  • 환경 변수: MM_GITLABSETTINGS_DISCOVERYENDPOINT
Note

자세한 내용은 GitLab Single Sign-On 문서의 2단계를 참조하세요.

GitLab OpenID 클라이언트 ID#

이 설정은 GitLab이 생성한 애플리케이션 ID를 저장합니다.

문자열 입력.

  • 시스템 구성 경로: Authentication > OpenID Connect
  • config.json 설정: GitLabSettings > Id
  • 환경 변수: MM_GITLABSETTINGS_ID
Note

자세한 내용은 GitLab Single Sign-On 문서의 2단계를 참조하세요.

GitLab OpenID 클라이언트 시크릿#

이 설정은 GitLab이 생성한 애플리케이션 시크릿 키를 저장합니다.

문자열 입력.

  • 시스템 구성 경로: Authentication > OpenID Connect
  • config.json 설정: GitLabSettings > Secret
  • 환경 변수: MM_GITLABSETTINGS_SECRET
Note

자세한 내용은 GitLab Single Sign-On 문서의 2단계를 참조하세요.

GitLab OpenID 선호 사용자명 사용#
  • true: Mattermost가 GitLab OpenID 토큰의 preferred_username 클레임을 Mattermost | - 시스템 구성 경로: Authentication > OpenID Connect | 사용자명으로 사용합니다. | - config.json 설정: GitLabSettings > UsePreferredUsername > false
  • false: (기본값) Mattermost가 사용자명 할당에 preferred_username 클레임을 사용하지 않습니다. | - 환경 변수: MM_GITLABSETTINGS_USEPREFERREDUSERNAME

Google OpenID 설정#

Google과의 OpenID Connect 인증 활성화#
  • true: Google OpenID Connect를 사용한 팀 생성 및 계정 가입을 허용합니다.
  • false: (기본값) 팀 생성이나 계정 가입에 Google OpenID Connect를 사용할 수 없습니다.
  • true: Google OpenID 인증을 사용한 팀 및 계정 생성을 허용합니다. | - 시스템 구성 경로: Authentication > OpenID Connect |
- false: (기본값) Google OpenID 인증을 비활성화합니다. | - config.json 설정: GoogleSettings > Enable > false |
- 환경 변수: MM_GOOGLESETTINGS_ENABLE |

Google Single Sign-On 구현 지침을 참조하세요. |

Google OpenID 검색 엔드포인트#
이 설정에는 Google OpenID Connect의 검색 엔드포인트가 미리 입력되어 있습니다. | - 시스템 구성 경로: Authentication > OpenID Connect |
- config.json 설정: GoogleSettings > DiscoveryEndpoint |
Configure Mattermost for Google Apps SSO를 참조하세요. | - 환경 변수: MM_GOOGLESETTINGS_DISCOVERYENDPOINT
|

문자열 입력. 기본값은 https://accounts.google.com/.well-known/openid-configuration입니다. | |

Google OpenID 클라이언트 ID#
이 설정은 Google이 생성한 클라이언트 ID를 저장합니다. | - 시스템 구성 경로: Authentication > OpenID Connect |
- config.json 설정: GoogleSettings > Id |
Google Single Sign-On 구현 지침을 참조하세요. | - 환경 변수: MM_GOOGLESETTINGS_ID
|

문자열 입력. | |

Google OpenID 클라이언트 시크릿#
이 설정은 Google이 생성한 클라이언트 시크릿을 저장합니다. | - 시스템 구성 경로: Authentication > OpenID Connect |
- config.json 설정: GoogleSettings > Secret|
Google Single Sign-On 구현 지침을 참조하세요. | - 환경 변수: MM_GOOGLESETTINGS_SECRET
|

문자열 입력. | |

Google OpenID 선호 사용자명 사용#
  • true: Mattermost가 Google OpenID 토큰의 preferred_username 클레임을 Mattermost | - 시스템 구성 경로: Authentication > OpenID Connect | 사용자명으로 사용합니다. | - config.json 설정: GoogleSettings > UsePreferredUsername > false
  • false: (기본값) Mattermost가 사용자명 할당에 preferred_username 클레임을 사용하지 않습니다. | - 환경 변수: MM_GOOGLESETTINGS_USEPREFERREDUSERNAME

Entra ID OpenID 설정#

Note

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

Entra ID와의 OpenID Connect 인증 활성화#
  • true: Entra ID OpenID Connect 인증을 사용한 팀 및 계정 생성을 허용합니다. | - 시스템 구성 경로: Authentication > OpenID Connect |
- false: (기본값) Entra ID OpenID Connect 인증을 비활성화합니다. | - config.json 설정: Office365Settings > Enable > false |
- 환경 변수: MM_OFFICE365SETTINGS_ENABLE |

Entra ID Single Sign-On 구현 지침을 참조하세요. |

Entra ID OpenID 디렉터리 (테넌트) ID#
이 설정은 Microsoft Azure Portal을 통해 Mattermost에 설정된 디렉터리 (테넌트) ID를 저장합니다. | - 시스템 구성 경로: Authentication > OpenID Connect |
- config.json 설정: Office365Settings > DirectoryId |
Entra ID Single Sign-On 구현 지침을 참조하세요. | - 환경 변수: MM_OFFICE365SETTINGS_DIRECTORYID
|

문자열 입력. | |

Entra ID OpenID 검색 엔드포인트#
이 설정에는 Entra ID OpenID Connect의 검색 엔드포인트가 미리 입력되어 있습니다. | - 시스템 구성 경로: Authentication > OpenID Connect |
- config.json 설정: Office365Settings > DiscoveryEndpoint |
Entra ID Single Sign-On 구현 지침을 참조하세요. | - 환경 변수: MM_OFFICE365SETTINGS_DISCOVERYENDPOINT
|

문자열 입력. 기본값은 https://login.microsoftonline.com/common/v2.0/.well-known/openid-configuration입니다. | |

Entra ID 클라이언트 ID#
이 설정은 Microsoft Azure Portal을 통해 생성된 애플리케이션(클라이언트) ID를 저장합니다. | - 시스템 구성 경로: Authentication > OpenID Connect |
- config.json 설정: Office365Settings > Id |
Entra ID Single Sign-On 구현 지침을 참조하세요. | - 환경 변수: MM_OFFICE365SETTINGS_ID
|

문자열 입력. | |

Entra ID 클라이언트 시크릿#
이 설정은 Microsoft Azure Portal을 통해 생성된 클라이언트 시크릿을 저장합니다. | - 시스템 구성 경로: Authentication > OpenID Connect |
- config.json 설정: Office365Settings > Secret |
Entra ID Single Sign-On 구현 지침을 참조하세요. | - 환경 변수: MM_OFFICE365SETTINGS_SECRET
|

문자열 입력. | |

Entra ID 선호 사용자명 사용#
  • true: Mattermost가 Entra ID OpenID 토큰의 preferred_username 클레임을 Mattermost 사용자명으로 사용합니다. | - 시스템 구성 경로: Authentication > OpenID Connect |
  • false: (기본값) Mattermost가 사용자명 할당에 preferred_username 클레임을 사용하지 않습니다. | - config.json 설정: Office365Settings > UsePreferredUsername > false
    - 환경 변수: MM_OFFICE365SETTINGS_USEPREFERREDUSERNAME
Note

preferred_username 클레임을 사용할 수 있도록 하려면 Azure Portal의 App registrations > Token configuration 에서 선택적 클레임으로 추가하세요. 설정 세부 정보는 Entra ID Single Sign-On을 참조하세요.

OpenID Connect (기타) 설정#

다른 서비스 공급자와의 OpenID Connect 인증 활성화#
  • true: 다른 OpenID Connect 서비스 공급자를 사용한 팀 및 계정 생성을 허용합니다. | - 시스템 구성 경로: Authentication > OpenID Connect |
- false: (기본값) 다른 서비스 공급자와의 OpenID Connect 인증을 비활성화합니다. | - config.json 설정: OpenIdSettings > Enable > false |
- 환경 변수: MM_OPENIDSETTINGS_ENABLE |

구현 지침은 OpenID Connect Single Sign-On을 참조하세요. |

OpenID Connect (기타) 버튼 이름#

이 설정은 OpenID 로그인 버튼에 표시되는 텍스트입니다.

문자열 입력.

  • 시스템 구성 경로: Authentication > OpenID Connect
  • config.json 설정: OpenIdSettings > ButtonText
  • 환경 변수: MM_OPENIDSETTINGS_BUTTONTEXT
OpenID Connect (기타) 버튼 색상#

이 설정은 OpenID 로그인 버튼의 색상입니다. 코드 앞에 #(해시) 기호를 붙인 16진수 코드를 사용하세요. 예: #145DBF.

문자열 입력.

  • 시스템 구성 경로: Authentication > OpenID Connect
  • config.json 설정: OpenIdSettings > ButtonColor
  • 환경 변수: MM_OPENIDSETTINGS_BUTTONCOLOR
OpenID Connect (기타) 검색 엔드포인트#
이 설정은 OpenID 공급자의 검색 엔드포인트(Discovery Endpoint) URL을 저장합니다. | - 시스템 구성 경로: Authentication > OpenID Connect | URL은 https://myopenid.provider.com/{my_organization}/ | -config.jsonsetting:OpenIdSettings>DiscoveryEndpoint| .well-known/openid-configuration 형식이어야 합니다. | - 환경 변수: MM_OPENIDSETTINGS_DISCOVERYENDPOINT | | | 구현 지침은 OpenID Connect Single Sign-On을 | 참조하세요. | | | | 문자열 입력. | |
Note

검색 엔드포인트 설정은 임의 호스트의 연결 및 가용성을 확인하는 데 사용될 수 있습니다. 이에 우려가 있는 시스템 관리자는 사용자 지정 관리자 역할을 사용하여 이 설정 수정에 대한 접근을 제한할 수 있습니다. 자세한 내용은 위임된 세분화된 관리) 문서를 참조하세요.

OpenID Connect (기타) 클라이언트 ID#
이 설정은 OpenID 공급자의 클라이언트 ID를 저장합니다. | - 시스템 구성 경로: Authentication > OpenID Connect |
- config.json 설정: OpenIdSettings > Id |
구현 지침은 OpenID Connect Single Sign-On을 참조하세요. | - 환경 변수: MM_OPENIDSETTINGS_ID
|

문자열 입력. | |

OpenID Connect (기타) 클라이언트 시크릿#
이 설정은 OpenID 공급자의 클라이언트 시크릿(Client Secret)을 저장합니다. | - 시스템 구성 경로: Authentication > OpenID Connect |
- config.json 설정: OpenIdSettings > Secret|
구현 지침은 OpenID Connect Single Sign-On을 참조하세요. | - 환경 변수: MM_OPENIDSETTINGS_SECRET
|

문자열 입력. | |

OpenID Connect (기타) 선호 사용자명 사용#
  • true: Mattermost가 공급자의 OpenID 토큰에 있는 preferred_username 클레임을 Mattermost 사용자명으로 사용합니다.
  • false: (기본값) Mattermost가 사용자명 할당에 preferred_username 클레임을 사용하지 않습니다.
  • 시스템 구성 경로: Authentication > OpenID Connect |
  • config.json 설정: OpenIdSettings > | UsePreferredUsername > false |
  • 환경 변수: | MM_OPENIDSETTINGS_USEPREFERREDUSERNAME

게스트 접근#

System Console에서 Authentication > Guest Access로 이동하여 다음 구성 설정에 접근하세요.

게스트 접근 활성화#

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

게스트 청구는 채널 접근에 따라 달라집니다. 정확히 하나의 활성 채널에 있는 게스트는 단일 채널 게스트로 처리되며 기본 유료 시트 수에 포함되지 않습니다. 라이선스된 시트와 1:1 비율까지 무료입니다. 여러 활성 채널에 있는 게스트는 계속해서 청구 목적상 활성화된 사용자로 계산됩니다. 다이렉트 메시지와 그룹 메시지는 게스트가 단일 채널 게스트로 계산되는지 여부에 영향을 미치지 않습니다. 활성 채널만 청구를 위한 게스트 채널 접근에 포함됩니다. 보관된 채널은 제외됩니다. 자세한 내용은 게스트 계정 문서를 참조하세요.

허용된 게스트 도메인#

이 설정을 사용하여 게스트 계정 생성을 제한합니다. 설정하면 게스트 계정은 나열된 도메인 중 하나의 검증된 이메일 주소가 필요합니다.

쉼표로 구분된 하나 이상의 도메인을 문자열로 입력합니다.

  • 시스템 구성 경로: Authentication > Guest Access
  • config.json 설정: GuestAccountsSettings > RestrictCreationToDomains
  • 환경 변수: MM_GUESTACCOUNTSSETTINGS_RESTRICTCREATIONTODOMAINS

게스트 태그 표시#

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

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

게스트 매직 링크 인증 활성화#

사용 가능 플랜: Entry, Enterprise, Enterprise Advanced(Professional 제외)

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

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

인증 구성 설정

Mattermost v12.0
원문 보기

요약

Mattermost는 최대 4가지의 동시 사용자 인증 방법을 지원합니다: 제품 메뉴를 선택하고 System Console을 선택한 다음 Authentication을 선택하여 System Console에서 다음 인증 구성 옵션을 검토하고 관리하세요:

사용 가능 플랜: Entry, Professional, Enterprise, Enterprise Advanced

Mattermost는 최대 4가지의 동시 사용자 인증 방법을 지원합니다:

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

제품 제품 메뉴 아이콘을 사용하여 채널, 협업 플레이북, 보드 사이를 이동합니다. 메뉴를 선택하고 System Console을 선택한 다음 Authentication을 선택하여 System Console에서 다음 인증 구성 옵션을 검토하고 관리하세요:

Tip

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

  • jq와 같은 도구를 사용하는 경우 cat config/config.json | jq '.TeamSettings.EnableUserCreation'을 입력합니다.
  • config.json 파일을 수동으로 편집할 때는 TeamSettings와 같은 객체를 찾은 뒤 그 안에서 EnableUserCreation 키를 찾으세요.

가입#

System Console에서 Authentication > Signup으로 이동하여 다음 구성 설정에 접근하세요.

계정 생성 활성화#

  • true: (기본값) 초대 없이도 누구나 이 서버에서 사용자 계정을 가입할 수 있습니다. 이메일 기반 가입에만 적용됩니다.
  • false: 계정 생성 기능이 비활성화됩니다. Create Account를 선택하면 오류가 표시됩니다. 이메일, OpenID Connect, OAuth 2.0 사용자 계정 인증에 적용됩니다.
  • 시스템 구성 경로: Authentication > Signup
  • config.json 설정: TeamSettings > EnableUserCreation > true
  • 환경 변수: MM_TEAMSETTINGS_ENABLEUSERCREATION
Note
  • LDAP 및 SAML 사용자는 이 구성 설정의 활성화 여부와 관계없이 LDAP 또는 SAML 사용자 자격 증명으로 로그인하여 Mattermost 계정을 항상 생성할 수 있습니다.
  • Mattermost v10.9부터 꺾쇠 괄호로 묶인 이메일 주소(예: [billy@example.com](mailto:billy@example.com))는 거부됩니다. 문제를 방지하려면 모든 사용자 이메일이 일반 주소 형식(예: billy@example.com)을 준수하는지 확인하세요. 또한, 이 제품 변경 사항에 맞게 Mattermost 사용자 데이터를 사전에 감사하고 업데이트하는 조치를 취하는 것을 강력히 권장합니다. 영향을 받는 사용자는 Mattermost 접근 또는 사용자 프로필 관리에 문제가 생길 수 있습니다. mmctl user email을 사용하여 이러한 사용자 이메일을 수동으로 업데이트할 수 있습니다.
  • 지원되는 SAML 암호화 방법을 참조하세요.

계정 생성을 지정된 이메일 도메인으로 제한#

이 설정은 새 계정 또는 팀을 만드는 데 사용할 수 있는 이메일 주소 도메인을 제한합니다. | - 시스템 구성 경로: Authentication > Signup | 제한이 작동하려면 이메일 인증 필수를 | - config.json 설정: TeamSettings > RestrictCreationToDomains true로 반드시 설정해야 합니다. 이 설정은 이메일 로그인에만 영향을 줍니다. | - 환경 변수: MM_TEAMSETTINGS_RESTRICTCREATIONTODOMAINS |

오픈 서버 활성화#

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

이메일 초대 활성화#

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

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

대기 중인 이메일 초대 무효화#

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

이 옵션에는 config.json 설정이나 환경 변수가 없습니다.

  • 시스템 구성 경로: Authentication > Signup
  • config.json 설정: 해당 없음
  • 환경 변수: 해당 없음

이메일#

System Console에서 Authentication > Email로 이동하여 다음 구성 설정에 접근하세요.

이메일로 계정 생성 활성화#

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

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

이메일 인증 필수#

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

이메일로 로그인 활성화#

  • true: (기본값) 사용자가 이메일과 비밀번호로 로그인할 수 있습니다.
  • false: 이메일과 비밀번호를 사용한 인증을 비활성화하고 로그인 화면에서 해당 옵션을 제거합니다. 인증을 싱글 사인온 서비스로 제한하려면 이 옵션을 사용하세요.
  • 시스템 구성 경로: Authentication > Email
  • config.json 설정: EmailSettings > EnableSignInWithEmail
  • 환경 변수: MM_EMAILSETTINGS_ENABLESIGNINWITHEMAIL
Note

- 로그인 페이지에서 사용자에게 이메일 로그인 옵션만 단일하게 제공하려면, 사용자명으로 로그인 활성화 구성 설정이 false로 설정되어 있는지 확인하세요. - Mattermost v10.9부터 꺾쇠 괄호로 묶인 이메일 주소(예: [billy@example.com](mailto:billy@example.com))는 거부됩니다. 문제를 방지하려면 모든 사용자 이메일이 일반 주소 형식(예: billy@example.com)을 준수하는지 확인하세요. 또한, 이 제품 변경 사항에 맞게 Mattermost 사용자 데이터를 사전에 감사하고 업데이트하는 조치를 취하는 것을 강력히 권장합니다. 영향을 받는 사용자는 Mattermost 접근 또는 사용자 프로필 관리에 문제가 생길 수 있습니다. mmctl user email을 사용하여 이러한 사용자 이메일을 수동으로 업데이트할 수 있습니다.

사용자명으로 로그인 활성화#

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

이메일 기반 인증은 개인 네트워크의 소규모 팀에서만 사용하도록 강력히 권장합니다.


비밀번호#

System Console에서 Authentication > Password로 이동하여 다음 구성 설정에 접근하세요.

Note

Mattermost v11.0부터 비밀번호 해싱에 보안 강화를 위해 PBKDF2를 사용합니다. 사용자 비밀번호는 v11.0 이상으로 업그레이드한 후 로그인할 때 자동으로 마이그레이션됩니다. 이 마이그레이션은 점진적으로 이루어지며 사용자가 인증할 때 투명하게 처리됩니다.

최소 비밀번호 길이#

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

숫자 입력. 기본값은 5입니다.

  • 시스템 구성 경로: Authentication > Password
  • config.json 설정: PasswordSettings > MinimumLength
  • 환경 변수: MM_PASSWORDSETTINGS_MINIMUMLENGTH

비밀번호 요건#

이 설정은 비밀번호 문자 요건을 제어합니다. 해당 확인란을 선택하면 비밀번호에 다음이 포함되어야 합니다:

  • 소문자 하나 이상
  • 대문자 하나 이상
  • 숫자 하나 이상
  • 기호 하나 이상(다음 중에서): !"#$%&'()*+,-./:;<=>?@[]^_`|~.

사용자가 유효하지 않은 비밀번호를 설정하려고 하면 System Console에서 미리 본 오류 메시지가 표시됩니다.

모든 확인란의 기본값은 선택 해제입니다. 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

최대 로그인 시도 횟수#

이 설정은 사용자가 계정이 잠기기 전까지 로그인에 실패할 수 있는 횟수를 결정합니다. 계정이 잠기면 이메일을 통한 비밀번호 재설정 절차를 거쳐야 합니다.

숫자 입력. 기본값은 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
Note

비밀번호 찾기 링크 URL은 Site Configuration > Customization > Forgot Password Custom Link에서 사용자 지정할 수 있습니다. 자세한 내용은 구성 문서를 참조하세요.


MFA#

사용 가능 플랜: Entry, Professional, Enterprise, Enterprise Advanced

System Console에서 Authentication > MFA로 이동하여 다음 구성 설정에 접근하세요.

자체 사설 네트워크 내에 Mattermost를 배포하고 모바일 액세스를 위해 VPN 클라이언트를 사용하여 기존 프로토콜로 Mattermost를 보호하는 것을 권장합니다. 기존 보안 프로토콜을 우회하여 사설 네트워크 외부에서 Mattermost를 실행하려는 경우, Mattermost 액세스를 위한 다중 인증 서비스를 별도로 추가하는 것을 권장합니다.

다중 인증 활성화#

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

다중 인증 강제 적용#

- true: AD/LDAP 또는 이메일 주소로 로그인하는 사용자에게 다중 인증(MFA)을 요구합니다. | - 시스템 구성 경로: Authentication > MFA | | - config.json 설정: ServiceSettings > EnforceMultifactorAuthentication > false

신규 사용자는 MFA를 설정해야 합니다. 로그인한 사용자는 구성이 완료될 때까지 MFA | - 환경 변수: MM_SERVICESETTINGS_ENFORCEMULTIFACTORAUTHENTICATION | 설정 페이지로 리디렉션됩니다. | | | |

  • false: (기본값) MFA는 선택 사항입니다. | |
Note

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


AD/LDAP#

System Console에서 Authentication > AD/LDAP으로 이동하여 다음 구성 설정에 접근하세요. 이렇게 하면 각 설정을 단계별로 구성하고 테스트하는 AD/LDAP 설정 마법사가 열립니다.

마법사는 다음 섹션으로 구성됩니다:

Note

각 섹션에는 구성을 단계적으로 확인할 수 있는 테스트 옵션이 있어, 설정 과정 초기에 문제를 파악하고 해결하는 데 도움이 됩니다.

연결 설정#

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

AD/LDAP로 로그인 활성화#

  • true: AD/LDAP를 사용한 로그인을 허용합니다.
  • false: (기본값) AD/LDAP를 사용한 로그인을 비활성화합니다.
  • 시스템 구성 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > Enable > false
  • 환경 변수: MM_LDAPSETTINGS_ENABLE

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
Note

System Console의 AD/LDAP 동기화 설정은 임의의 호스트에 대한 연결 가능 여부와 가용성을 확인하는 데 사용될 수 있습니다. 이 점이 우려되는 시스템 관리자는 사용자 지정 관리자 역할을 사용하여 이러한 설정을 수정할 수 있는 권한을 제한할 수 있습니다. 자세한 내용은 위임된 세분화 관리) 문서를 참조하세요.

로그인 필드 이름#

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

문자열 입력. 기본값은 AD/LDAP Username입니다.

  • 시스템 구성 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > LoginFieldName
  • 환경 변수: MM_LDAPSETTINGS_LOGINFIELDNAME

AD/LDAP 서버#

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

문자열 입력.

  • 시스템 구성 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > LdapServer
  • 환경 변수: MM_LDAPSETTINGS_LDAPSERVER
Note

System Console의 AD/LDAP 동기화 설정은 임의의 호스트에 대한 연결 가능 여부와 가용성을 확인하는 데 사용될 수 있습니다. 이 점이 우려되는 시스템 관리자는 사용자 지정 관리자 역할을 사용하여 이러한 설정을 수정할 수 있는 권한을 제한할 수 있습니다. 자세한 내용은 위임된 세분화 관리) 문서를 참조하세요.

AD/LDAP 포트#

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

숫자 입력. 기본값은 389입니다.

  • 시스템 구성 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > LdapPort > 389
  • 환경 변수: MM_LDAPSETTINGS_LDAPPORT

바인드 사용자명#

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

계정 권한을 Base DN 설정에 지정된 AD/LDAP 트리 부분에 대한 읽기 전용 액세스로 제한하세요.

Active Directory를 사용하는 경우 Bind Username은 "DOMAIN/username" 형식으로 도메인을 지정해야 합니다.

문자열 입력.

  • 시스템 구성 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > BindUsername
  • 환경 변수: MM_LDAPSETTINGS_BINDUSERNAME
Note

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

바인드 비밀번호#

Bind Username 설정에 지정된 사용자명의 비밀번호입니다.

문자열 입력.

  • 시스템 구성 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > BindPassword
  • 환경 변수: MM_LDAPSETTINGS_BINDPASSWORD

연결 보안#

이 설정은 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

인증서 확인 건너뛰기#

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

개인 키#

TLS 클라이언트 인증서가 기본 인증 메커니즘인 경우, 이 설정을 사용하여 LDAP 인증 공급자의 개인 키 파일을 업로드합니다.

문자열 입력.

  • 시스템 구성 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > PrivateKeyFile
  • 환경 변수: MM_LDAPSETTINGS_PRIVATEKEYFILE

공개 인증서#

TLS 클라이언트 인증서가 기본 인증 메커니즘인 경우, 이 설정을 사용하여 LDAP 인증 공급자의 공개 TLS 인증서를 업로드합니다.

문자열 입력.

  • 시스템 구성 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > PublicCertificateFile
  • 환경 변수: MM_LDAPSETTINGS_PUBLICCERTIFICATEFILE

최대 로그인 시도 횟수#

이 설정은 사용자가 계정이 잠기기 전까지 로그인에 실패할 수 있는 횟수를 결정합니다. 계정이 잠기면 이메일을 통한 비밀번호 재설정 절차를 거쳐야 합니다.

System Console의 사용자 페이지에서 계정 잠금을 해제할 수 있습니다. 이 값을 LDAP의 최대 로그인 시도 횟수보다 낮게 설정하면, Mattermost에서 로그인에 실패하더라도 사용자가 LDAP 서버에서 잠기지 않습니다.

숫자 입력. 기본값은 10입니다.

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

사용자 필터#

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

Base DN#

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

문자열 입력.

  • 시스템 구성 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > BaseDN
  • 환경 변수: MM_LDAPSETTINGS_BASEDN

사용자 필터#

이 설정은 사용자 객체를 검색할 때 적용되는 일반 구문 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
Note

이 필터는 Bind Username 계정의 권한으로 검색을 실행합니다. 이 계정은 Mattermost 전용이어야 하며 Base DN 필드에 지정된 AD/LDAP 트리 부분에 대한 읽기 전용 액세스 권한을 가져야 합니다.

그룹 필터#

사용 가능 플랜: Entry, Enterprise, Enterprise Advanced(Professional 제외)

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

문자열 입력. 기본값은 (|(objectClass=group)(objectClass=groupOfNames)(objectClass=groupOfUniqueNames))입니다.

  • 시스템 구성 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > GroupFilter
  • 환경 변수: MM_LDAPSETTINGS_GROUPFILTER
Note

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

관리자 필터 활성화#

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

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

관리자 필터#

이 설정은 선택된 사용자를 시스템 관리자로 지정하는 AD/LDAP 필터를 입력받습니다. 사용자는 다음 AD/LDAP 로그인 시 이 역할로 승격됩니다. 이 필터는 예약된 AD/LDAP 동기화 중에는 평가되지 않으며, Enable Synchronizing SAML Accounts With AD/LDAP가 활성화되어 있더라도 SAML로 인증하는 사용자에게는 적용되지 않습니다. SAML로 인증하는 사용자의 시스템 관리자를 지정하려면 SAML Admin Attribute 설정을 사용하세요.

Admin Filter가 제거되면, 현재 로그인한 사용자는 다음 로그인 시까지 관리자 역할을 유지합니다.

문자열 입력.

  • 시스템 구성 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > AdminFilter
  • 환경 변수: MM_LDAPSETTINGS_ADMINFILTER

게스트 필터#

이 설정은 Mattermost에 게스트 액세스 권한이 있는 외부 사용자를 검색할 때 적용할 AD/LDAP 필터를 입력받습니다. 쿼리로 선택된 사용자만 게스트로 Mattermost에 액세스할 수 있습니다. | - 시스템 구성 경로: Authentication > AD/LDAP |
- config.json 설정: LdapSettings > GuestFilter |
자세한 내용은 게스트 계정을 참조하세요. | - 환경 변수: MM_LDAPSETTINGS_GUESTFILTER
|

문자열 입력. | |

계정 동기화#

사용 가능 플랜: Entry, Enterprise, Enterprise Advanced(Professional 제외)

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

ID 속성#

Mattermost에서 고유 사용자 식별자로 사용되는 AD/LDAP 서버의 속성입니다.

이 속성은 objectGUID 또는 entryUUID처럼 변하지 않는 고유한 값을 가져야 합니다. 변경하기 전에 사용 중인 환경에서 이러한 속성을 사용할 수 있는지 확인하세요.

문자열 입력.

  • 시스템 구성 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > IdAttribute
  • 환경 변수: MM_LDAPSETTINGS_IDATTRIBUTE
Note

사용자의 ID 속성이 변경되면 이전 계정과 연결되지 않은 새 Mattermost 계정이 만들어집니다. 사용자가 로그인한 후에 이 필드를 변경해야 하는 경우 mmctl ldap idmigrate 명령을 사용하세요.

Note

ID 속성 값은 입력된 그대로 일치 여부를 판단하며, Mattermost는 대소문자 정규화를 적용하지 않습니다. PostgreSQL의 기본 대소문자 구분 콜레이션에서는 대소문자가 바뀌면 새 사용자로 취급되어 별도의 계정이 만들어집니다. AD/LDAP 서버가 이 속성을 일관된 대소문자로 반환하는지 확인하세요.

로그인 ID 속성#

Mattermost에 로그인할 때 사용하는 AD/LDAP 서버의 속성입니다. 일반적으로 Username Attribute와 동일합니다.

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

문자열 입력.

  • 시스템 구성 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > LoginIdAttribute
  • 환경 변수: MM_LDAPSETTINGS_LOGINIDATTRIBUTE

사용자명 속성#

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

이메일 속성#

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

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

문자열 입력.

  • 시스템 구성 경로: Authentication > AD/LDAP
  • config.json 설정 LdapSettings > EmailAttribute
  • 환경 변수: MM_LDAPSETTINGS_EMAILATTRIBUTE

이름 속성#

Mattermost의 이름 필드를 채우는 AD/LDAP 서버의 속성입니다. | - 시스템 구성 경로: Authentication > AD/LDAP |
- config.json 설정: LdapSettings > FirstNameAttribute |
설정하면 사용자가 이름을 편집할 수 없습니다. | - 환경 변수: MM_LDAPSETTINGS_FIRSTNAMEATTRIBUTE |
|

설정하지 않으면 사용자가 | | 프로필 설정에서 이름을 편집할 수 있습니다. | | | 문자열 입력. | |

성 속성#

Mattermost의 성 필드를 채우는 AD/LDAP 서버의 속성입니다. | - 시스템 구성 경로: Authentication > AD/LDAP |
- config.json 설정: LdapSettings > LastNameAttribute |
설정하면 사용자가 성을 편집할 수 없습니다. | - 환경 변수: MM_LDAPSETTINGS_LASTNAMEATTRIBUTE |
|

설정하지 않으면 사용자가 | | 프로필 설정의 일부로 성을 편집할 수 있습니다. | | | | 문자열 입력. | |

닉네임 속성#

Mattermost의 닉네임 필드를 채우는 AD/LDAP 서버의 속성입니다. | - 시스템 구성 경로: Authentication > AD/LDAP |
- config.json 설정: LdapSettings > NicknameAttribute |
설정하면 사용자가 닉네임을 편집할 수 없습니다. | - 환경 변수: MM_LDAPSETTINGS_NICKNAMEATTRIBUTE |
|

설정하지 않으면 사용자가 | | 프로필 설정의 일부로 닉네임을 편집할 수 있습니다. | | | 문자열 입력. | |

직책 속성#

Mattermost의 직책 필드를 채우는 AD/LDAP 서버의 속성입니다. | - 시스템 구성 경로: Authentication > AD/LDAP |
- config.json 설정: LdapSettings > PositionAttribute |
설정하면 사용자가 직책을 편집할 수 없습니다. | - 환경 변수: MM_LDAPSETTINGS_POSITIONATTRIBUTE |
|

설정하지 않으면 사용자가 | | 프로필 설정의 일부로 직책을 편집할 수 있습니다. | | | 문자열 입력. | |

프로필 사진 속성#

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

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

Mattermost의 이미지가 이미 AD/LDAP 이미지와 일치하면 이미지는 업데이트되지 않습니다.

문자열 입력.

  • 시스템 구성 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > PictureAttribute
  • 환경 변수: MM_LDAPSETTINGS_PICTUREATTRIBUTE

그룹 동기화#

사용 가능 플랜: Entry, Enterprise, Enterprise Advanced(Professional 제외)

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

그룹 표시 이름 속성#

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

문자열 입력.

  • 시스템 구성 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > GroupDisplayNameAttribute
  • 환경 변수: MM_LDAPSETTINGS_GROUPDISPLAYNAMEATTRIBUTE
Note

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

그룹 ID 속성#

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

이 속성은 entryUUID 또는 objectGUID처럼 변하지 않는 값이어야 합니다.

문자열 입력.

  • 시스템 구성 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > GroupIdAttribute
  • 환경 변수: MM_LDAPSETTINGS_GROUPIDATTRIBUTE
Note

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

Note

그룹 ID 속성 값은 입력된 그대로 일치 여부를 판단하며, Mattermost는 대소문자 정규화를 적용하지 않습니다. PostgreSQL의 기본 대소문자 구분 콜레이션에서는 대소문자가 바뀌면 Mattermost가 이전에 동기화된 그룹을 더 이상 인식하지 못하고 연결되지 않은 새 그룹으로 취급합니다. AD/LDAP 서버가 이 속성을 일관된 대소문자로 반환하는지 확인하세요.

동기화 성능#

사용 가능 플랜: Entry, Enterprise, Enterprise Advanced(Professional 제외)

AD/LDAP 동기화의 타이밍과 성능 설정을 구성합니다. 이 설정은 Mattermost가 AD/LDAP 서버와 동기화하는 빈도를 제어합니다.

동기화 간격(분)#

이 값은 각 동기화 사이의 간격을 분 단위로 설정하여 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
Note

LDAP 동기화에는 많은 수의 데이터베이스 읽기 쿼리가 필요합니다. 데이터베이스 부하를 모니터링하고 동기화 간격을 조정하여 성능 저하를 최소화하세요.

최대 페이지 크기#

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

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

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

숫자 입력. 기본값은 0입니다.

  • 시스템 구성 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > MaxPageSize > 0
  • 환경 변수: MM_LDAPSETTINGS_MAXPAGESIZE

쿼리 시간 제한(초)#

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

숫자 입력. 기본값은 60입니다.

  • 시스템 구성 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > QueryTimeout > 60
  • 환경 변수: MM_LDAPSETTINGS_QUERYTIMEOUT

동기화 기록#

사용 가능 플랜: Entry, Enterprise, Enterprise Advanced(Professional 제외)

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

AD/LDAP 지금 동기화#

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

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

수동 동기화 후 다음 동기화는 Synchronization Interval에 설정된 시간이 지난 뒤에 실행됩니다.

  • 시스템 구성 경로: Authentication > AD/LDAP
  • config.json 설정: 해당 없음
  • 환경 변수: 해당 없음
Note

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

/images/ldap-sync-table.png

AD/LDAP 마법사에서 사용할 수 없는 구성 설정#

사용 가능 플랜: Entry, Enterprise, Enterprise Advanced(Professional 제외)

다음 AD/LDAP 구성 설정은 config.json 파일에서만 사용할 수 있으며 System Console의 AD/LDAP 마법사 인터페이스에서는 사용할 수 없습니다.

동기화 시 제거된 멤버 다시 추가#

이 설정을 활성화하면 LDAP 동기화 중에, 그룹 동기화된 팀 또는 채널에서 이전에 제거된 LDAP 그룹 멤버를 다시 추가합니다.

  • true: 이전에 제거된 LDAP 그룹 멤버가 LDAP 동기화 중에 그룹 동기화된 팀 또는 채널에 다시 추가됩니다.
  • false: (기본값) 이전에 제거된 LDAP 그룹 멤버가 LDAP 동기화 중에 그룹 동기화된 팀 또는 채널에 다시 추가되지 않습니다.
  • 시스템 구성 경로: Authentication > AD/LDAP
  • config.json 설정: LdapSettings > ReAddRemovedMembers
  • 환경 변수: MM_LDAPSETTINGS_READDREMOVEDMEMBERS
Note

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


SAML 2.0#

System Console에서 Authentication > SAML 2.0으로 이동하여 다음 구성 설정에 접근하세요.

지원되는 SAML 암호화 방법을 참조하세요.

Important

Microsoft ADFS 가이드에 따라 WIA를 지원하지 않는 디바이스에 대해 인트라넷 양식 기반 인증을 구성하는 것을 권장합니다.

SAML 로그인 활성화#

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

SAML 계정과 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부터 Mattermost는 로그인 중에 연결된 LDAP 서버에 사용자가 존재하는지 확인하지 않습니다.
  • 시스템 구성 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > EnableSyncWithLdap > false
  • 환경 변수: MM_SAMLSETTINGS_ENABLESYNCWITHLDAP
Note
  • AD/LDAP 동기화는 Authentication > AD/LDAP 아래의 설정을 통해 활성화하고 구성해야 합니다.
  • Mattermost v10.9 이전에는 LDAP 서버에 없는 사용자도 로그인할 수 있었지만 다음 LDAP 동기화 시 비활성화되었습니다.
  • 동기화는 사용자 속성만 업데이트합니다. 사용자의 시스템 관리자 역할은 변경하지 않습니다. AD/LDAP 관리자 필터는 SAML로 인증된 사용자에게 적용되지 않으므로, 시스템 관리자를 지정하려면 대신 SAML 관리자 속성 설정을 사용하세요.
  • AD/LDAP 구성에 대한 자세한 내용은 AD/LDAP 설정을 참조하세요.

AD/LDAP와 동기화할 때 게스트 사용자 무시#

사용 가능 플랜: Entry, Enterprise, Enterprise Advanced(Professional 제외)

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

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

AD/LDAP 정보로 SAML 바인드 데이터 덮어쓰기#

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

이 설정은 SAML 인증과 AD/LDAP 동기화가 모두 활성화된 경우에만 사용할 수 있습니다.

  • 시스템 구성 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > EnableSyncWithLdapIncludeAuth > false
  • 환경 변수: MM_SAMLSETTINGS_ENABLESYNCWITHLDAPINCLUDEAUTH
Note

- LDAP 동기화가 활성화되지 않은 경우 이 설정은 false여야 합니다. 이 설정을 true에서 false로 변경하면 덮어쓰기가 비활성화됩니다. - 덮어쓰기가 활성화된 경우 SAML ID는 LDAP ID와 일치해야 합니다. - 자세한 내용은 AD/LDAP Setup을 참조하세요.

ID 공급자 메타데이터 URL#

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

문자열 입력.

  • 시스템 구성 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > IdpMetadataURL
  • 환경 변수: MM_SAMLSETTINGS_IDPMETADATAURL

SAML SSO URL#

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

문자열 입력.

  • 시스템 구성 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > IdpURL
  • 환경 변수: MM_SAMLSETTINGS_IDPURL

ID 공급자 발급자 URL#

이 설정은 SAML 요청에 사용되는 ID 공급자의 발급자 URL입니다.

문자열 입력.

  • 시스템 구성 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > IdpDescriptorURL
  • 환경 변수: MM_SAMLSETTINGS_IDPDESCRIPTORURL

ID 공급자 공개 인증서#

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

문자열 입력.

  • 시스템 구성 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > IdpCertificateFile
  • 환경 변수: MM_SAMLSETTINGS_IDPCERTIFICATEFILE

서명 확인#

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

서비스 공급자 로그인 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

서비스 공급자 식별자#

이 설정은 서비스 공급자의 고유 식별자이며, 대부분의 경우 서비스 공급자 로그인 URL과 같습니다. ADFS에서는 신뢰 당사자 식별자(Relying Party Identifier)와 일치해야 합니다.

문자열 입력.

  • 시스템 구성 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > ServiceProviderIdentifier
  • 환경 변수: MM_SAMLSETTINGS_SERVICEPROVIDERIDENTIFIER

암호화 활성화#

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

지원되는 SAML 암호화 방식#

Mattermost는 SAML에 대해 다음 암호화 방식을 지원합니다.

  • aes128-gcm
  • aes192-gcm
  • aes256-gcm
  • aes128-cbc
  • aes256-cbc

AES-192-GCM과 AES-256-GCM 지원은 Mattermost v10.9에서 도입되었습니다.

서비스 공급자 개인 키#

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

문자열 입력.

  • 시스템 구성 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > PrivateKeyFile
  • 환경 변수: MM_SAMLSETTINGS_PRIVATEKEYFILE

서비스 공급자 공개 인증서#

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

문자열 입력.

  • 시스템 구성 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > PublicCertificateFile
  • 환경 변수: MM_SAMLSETTINGS_PUBLICCERTIFICATEFILE

요청 서명#

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

서명 알고리즘#

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

문자열 입력.

Note

Mattermost v11부터 기본 서명 알고리즘이 보안 강화를 위해 RSAwithSHA1에서 RSAwithSHA256으로 변경되었습니다. 기존 구성은 계속 작동하지만, 신규 설치는 기본적으로 RSAwithSHA256을 사용합니다.

  • 시스템 구성 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > SignatureAlgorithm
  • 환경 변수: MM_SAMLSETTINGS_SIGNATUREALGORITHM

정규화 알고리즘#

이 설정은 정규화 알고리즘을 결정합니다. 옵션은 다음과 같습니다.

문자열 입력.

  • 시스템 구성 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > CanonicalAlgorithm
  • 환경 변수: MM_SAMLSETTINGS_CANONICALALGORITHM

이메일 속성#

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

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

문자열 입력.

  • 시스템 구성 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > EmailAttribute
  • 환경 변수: MM_SAMLSETTINGS_EMAILATTRIBUTE

사용자명 속성#

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

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

문자열 입력.

  • 시스템 구성 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > UsernameAttribute
  • 환경 변수: MM_SAMLSETTINGS_USERNAMEATTRIBUTE

Id 속성#

(선택 사항) 이 설정은 SAML 사용자를 Mattermost 사용자와 바인드하는 데 사용하는 SAML 어설션 속성을 결정합니다.

문자열 입력.

  • 시스템 구성 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > IdAttribute
  • 환경 변수: MM_SAMLSETTINGS_IDATTRIBUTE
Note

ID 속성 값은 원문 그대로 비교됩니다 - Mattermost는 대소문자 정규화를 적용하지 않습니다. PostgreSQL의 기본 대소문자 구분 데이터 정렬(collation)에서는 대소문자 표기가 변경되면 새로운 사용자로 처리되어 별도의 계정이 생성됩니다. ID 공급자가 이 속성을 일관된 대소문자로 반환하는지 확인하세요.

게스트 속성#

(선택 사항) 이 설정은 Mattermost 사용자에게 게스트 역할을 적용하는 데 사용하는 SAML 어설션 속성을 결정합니다. | - 시스템 구성 경로: Authentication > SAML 2.0 |
- config.json 설정: SamlSettings > GuestAttribute|
자세한 내용은 게스트 계정 문서를 참조하세요. | - 환경 변수: MM_SAMLSETTINGS_GUESTATTRIBUTE
|

문자열 입력. | |

관리자 속성 활성화#

  • true: 시스템 관리자 상태가 관리자 속성에 설정된 SAML 어설션 속성으로 결정됩니다.
  • false: (기본값) 시스템 관리자 상태가 SAML 어설션 속성으로 결정되지 않습니다.
  • 시스템 구성 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > EnableAdminAttribute > false
  • 환경 변수: MM_SAMLSETTINGS_ENABLEADMINATTRIBUTE

관리자 속성#

(선택 사항) 이 설정은 시스템 관리자를 지정하는 SAML 어설션의 속성을 결정합니다.

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

관리자 속성을 제거하더라도 로그인 중인 사용자는 관리자 상태를 유지합니다. 이 역할은 사용자가 로그아웃할 때에만 해제됩니다.

문자열 입력.

  • 시스템 구성 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > AdminAttribute
  • 환경 변수: MM_SAMLSETTINGS_ADMINATTRIBUTE

이름 속성#

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

문자열 입력.

  • 시스템 구성 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > FirstNameAttribute
  • 환경 변수: MM_SAMLSETTINGS_FIRSTNAMEATTRIBUTE

성 속성#

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

문자열 입력.

  • 시스템 구성 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > LastNameAttribute
  • 환경 변수: MM_SAMLSETTINGS_LASTNAMEATTRIBUTE

닉네임 속성#

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

문자열 입력.

  • 시스템 구성 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > NicknameAttribute
  • 환경 변수: MM_SAMLSETTINGS_NICKNAMEATTRIBUTE

직위 속성#

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

문자열 입력.

  • 시스템 구성 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > PositionAttribute
  • 환경 변수: MM_SAMLSETTINGS_POSITIONATTRIBUTE

선호 언어 속성#

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

문자열 입력.

  • 시스템 구성 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > LocaleAttribute
  • 환경 변수: MM_SAMLSETTINGS_LOCALEATTRIBUTE

로그인 버튼 텍스트#

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

문자열 입력. 기본값은 SAML입니다.

  • 시스템 구성 경로: Authentication > SAML 2.0
  • config.json 설정: SamlSettings > LoginButtonText
  • 환경 변수: MM_SAMLSETTINGS_LOGINBUTTONTEXT

OAuth 2.0#

System Console에서 Authentication > OAuth 2.0으로 이동하여 다음 구성 설정에 접근하세요. GitLab OAuth 인증 설정은 셀프 호스팅 배포에서 Authentication > GitLab 아래에서도 접근할 수 있습니다.

이 설정들을 사용하여 계정 생성 및 로그인을 위한 OAuth 2.0을 구성하세요.

OAuth 2.0 서비스 공급자 선택#

이 설정을 사용하여 OAuth를 활성화하고 서비스 공급자를 지정합니다. 옵션은 다음과 같습니다.

  • 시스템 구성 경로: Authentication > OAuth 2.0
  • config.json 설정: N/A
  • 환경 변수: N/A

GitLab OAuth 2.0 설정#

Note

Enterprise 구독의 경우 GitLab 설정은 OAuth 2.0 아래에서 찾을 수 있습니다.

GitLab과의 OAuth 2.0 인증 활성화#
  • true: GitLab OAuth 인증을 사용한 팀 및 계정 생성을 허용합니다. 구성하려면 시크릿과 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 애플리케이션 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 System Console 필드, config.json 설정 또는 환경 변수에 입력합니다.

문자열 입력.

  • 시스템 구성 경로: Authentication > OAuth 2.0 (or GitLab)
  • config.json 설정: GitLabSettings > Id
  • 환경 변수: MM_GITLABSETTINGS_ID
Note

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

GitLab OAuth 2.0 애플리케이션 시크릿 키#

이 설정은 GitLab의 OAuth 애플리케이션 시크릿 키를 저장합니다. 이 키는 애플리케이션 ID와 동시에 생성됩니다(GitLab OAuth 2.0 애플리케이션 ID 참조).

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

문자열 입력.

  • 시스템 구성 경로: Authentication > OAuth 2.0 (or GitLab)
  • config.json 설정: GitLabSettings > Secret
  • 환경 변수: MM_GITLABSETTINGS_SECRET
GitLab OAuth 2.0 사이트 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 사용자 API 엔드포인트#

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

이 URL을 Mattermost System Console 필드, config.json 설정 또는 환경 변수에 입력하세요.

문자열 입력.

  • 시스템 구성 경로: Authentication > OAuth 2.0 (or GitLab)
  • config.json 설정: GitLabSettings > UserAPIEndpoint
  • 환경 변수: MM_GITLABSETTINGS_USERAPIENDPOINT
GitLab OAuth 2.0 인증 엔드포인트#

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

이 URL을 Mattermost System Console 필드, config.json 설정 또는 환경 변수에 입력하세요.

문자열 입력.

  • 시스템 구성 경로: Authentication > OAuth 2.0 (or GitLab)
  • config.json 설정: GitLabSettings > AuthEndpoint
  • 환경 변수: MM_GITLABSETTINGS_AUTHENDPOINT
GitLab OAuth 2.0 토큰 엔드포인트#

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

이 URL을 Mattermost System Console 필드, config.json 설정 또는 환경 변수에 입력하세요.

문자열 입력.

  • 시스템 구성 경로: Authentication > OAuth 2.0 (or GitLab)
  • config.json 설정: GitLabSettings > TokenEndpoint
  • 환경 변수: MM_GITLABSETTINGS_TOKENENDPOINT

Google OAuth 2.0 설정#

Google과의 OAuth 2.0 인증 활성화#
  • true: Google OAuth 인증을 사용한 팀 및 계정 생성을 허용합니다. 구성하려면 클라이언트 ID와 클라이언트 시크릿 자격 증명을 입력하세요. | - 시스템 구성 경로: Authentication > OAuth 2.0 |
- false: (기본값) Google OAuth 인증을 비활성화합니다. | - config.json 설정: GoogleSettings > Enable > false|
- 환경 변수: MM_GOOGLESETTINGS_ENABLE |

Google Single Sign-On 구현 지침을 참조하세요. |

Google OAuth 2.0 클라이언트 ID#
이 설정은 Google의 OAuth 클라이언트 ID를 저장합니다. Google Cloud Platform APIs & Services 메뉴의 사용자 인증 정보 섹션으로 이동하여 Create Credentials > OAuth client ID를 선택해 ID를 생성하세요. | - 시스템 구성 경로: Authentication > OAuth 2.0 |
- config.json 설정: GoogleSettings > Id|
Google OAuth 또는 OpenID 인증을 구현하는 데 사용할 수 있는 지침은 Google Single Sign-On을 참조하세요. | - 환경 변수: MM_GOOGLESETTINGS_ID
|

문자열 입력. | |

Google OAuth 2.0 클라이언트 시크릿#

이 설정은 Google의 OAuth 클라이언트 시크릿을 저장합니다. 시크릿은 클라이언트 ID와 동시에 생성됩니다.

문자열 입력.

  • 시스템 구성 경로: Authentication > OAuth 2.0
  • config.json 설정: GoogleSettings > Secret
  • 환경 변수: MM_GOOGLESETTINGS_SECRET
Google OAuth 2.0 사용자 API 엔드포인트#

사용자 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 인증 엔드포인트#

인증 엔드포인트로 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 토큰 엔드포인트#

토큰 엔드포인트로 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 설정#

Note

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

Entra ID와의 OAuth 2.0 인증 활성화#
  • true: Entra ID OAuth 인증을 사용한 팀 및 계정 생성을 허용합니다.
  • false: (기본값) Entra ID OAuth 인증을 비활성화합니다.
  • 시스템 구성 경로: Authentication > OAuth 2.0
  • config.json 설정: Office365Settings > Enable > false
  • 환경 변수: MM_OFFICE365SETTINGS_ENABLE
Note

자세한 내용은 Entra ID Single Sign-On 문서를 참조하세요.

Entra ID OAuth 2.0 애플리케이션 ID#

이 설정은 Microsoft Azure Portal을 통해 Entra ID를 싱글 사인온 서비스로 구성할 때 생성되는 애플리케이션 ID를 저장합니다.

문자열 입력.

  • 시스템 구성 경로: Authentication > OAuth 2.0
  • config.json 설정: Office365Settings > Id
  • 환경 변수: MM_OFFICE365SETTINGS_ID
Note

자세한 내용은 Entra ID Single Sign-On 문서를 참조하세요.

Entra ID OAuth 2.0 애플리케이션 시크릿 비밀번호#

이 설정은 Microsoft Azure Portal을 통해 Entra ID를 싱글 사인온 서비스로 구성할 때 생성되는 애플리케이션 시크릿 비밀번호를 저장합니다.

문자열 입력.

  • 시스템 구성 경로: Authentication > OAuth 2.0
  • config.json 설정: Office365Settings > Secret
  • 환경 변수: MM_OFFICE365SETTINGS_SECRET
Note

자세한 내용은 Entra ID Single Sign-On 문서를 참조하세요.

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

이 설정은 Azure Portal을 통해 Mattermost에 설정된 디렉터리 (테넌트) ID를 저장합니다.

문자열 입력.

  • 시스템 구성 경로: Authentication > OAuth 2.0
  • config.json 설정: Office365Settings > DirectoryId
  • 환경 변수: MM_OFFICE365SETTINGS_DIRECTORYID
Note

자세한 내용은 Entra ID Single Sign-On 문서를 참조하세요.

Entra ID OAuth 2.0 사용자 API 엔드포인트#

사용자 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 인증 엔드포인트#

인증 엔드포인트로 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 토큰 엔드포인트#

토큰 엔드포인트로 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#

System Console에서 Authentication > OpenID Connect로 이동하여 다음 구성 설정에 접근하세요.

OpenID Connect 서비스 공급자 선택#

이 설정을 사용하여 OpenID Connect를 활성화합니다. 옵션은 다음과 같습니다.

  • 시스템 구성 경로: Authentication > OpenID Connect
  • config.json 설정: N/A
  • 환경 변수: N/A
Note

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

GitLab OpenID 설정#

GitLab과의 OpenID Connect 인증 활성화#
  • true: GitLab OpenID Connect 인증을 사용한 팀 및 계정 생성을 허용합니다.
  • false: (기본값) GitLab OpenID Connect 인증을 비활성화합니다.
  • 시스템 구성 경로: Authentication > OpenID Connect
  • config.json 설정: GitLabSettings > Enable > false
  • 환경 변수: MM_GITLABSETTINGS_ENABLE
Note

자세한 내용은 GitLab Single Sign-On 문서를 참조하세요.

GitLab OpenID 사이트 URL#

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

문자열 입력.

  • 시스템 구성 경로: Authentication > OpenID Connect
  • config.json 설정: N/A
  • 환경 변수: N/A
Note

자세한 내용은 GitLab Single Sign-On 문서의 2단계를 참조하세요.

GitLab OpenID 검색 엔드포인트#

이 설정에는 GitLab OpenID Connect의 검색 엔드포인트가 미리 입력되어 있습니다.

문자열 입력. 기본값은 https://gitlab.com/.well-known/openid-configuration입니다.

  • 시스템 구성 경로: Authentication > OpenID Connect
  • config.json 설정: GitLabSettings > DiscoveryEndpoint
  • 환경 변수: MM_GITLABSETTINGS_DISCOVERYENDPOINT
Note

자세한 내용은 GitLab Single Sign-On 문서의 2단계를 참조하세요.

GitLab OpenID 클라이언트 ID#

이 설정은 GitLab이 생성한 애플리케이션 ID를 저장합니다.

문자열 입력.

  • 시스템 구성 경로: Authentication > OpenID Connect
  • config.json 설정: GitLabSettings > Id
  • 환경 변수: MM_GITLABSETTINGS_ID
Note

자세한 내용은 GitLab Single Sign-On 문서의 2단계를 참조하세요.

GitLab OpenID 클라이언트 시크릿#

이 설정은 GitLab이 생성한 애플리케이션 시크릿 키를 저장합니다.

문자열 입력.

  • 시스템 구성 경로: Authentication > OpenID Connect
  • config.json 설정: GitLabSettings > Secret
  • 환경 변수: MM_GITLABSETTINGS_SECRET
Note

자세한 내용은 GitLab Single Sign-On 문서의 2단계를 참조하세요.

GitLab OpenID 선호 사용자명 사용#
  • true: Mattermost가 GitLab OpenID 토큰의 preferred_username 클레임을 Mattermost | - 시스템 구성 경로: Authentication > OpenID Connect | 사용자명으로 사용합니다. | - config.json 설정: GitLabSettings > UsePreferredUsername > false
  • false: (기본값) Mattermost가 사용자명 할당에 preferred_username 클레임을 사용하지 않습니다. | - 환경 변수: MM_GITLABSETTINGS_USEPREFERREDUSERNAME

Google OpenID 설정#

Google과의 OpenID Connect 인증 활성화#
  • true: Google OpenID Connect를 사용한 팀 생성 및 계정 가입을 허용합니다.
  • false: (기본값) 팀 생성이나 계정 가입에 Google OpenID Connect를 사용할 수 없습니다.
  • true: Google OpenID 인증을 사용한 팀 및 계정 생성을 허용합니다. | - 시스템 구성 경로: Authentication > OpenID Connect |
- false: (기본값) Google OpenID 인증을 비활성화합니다. | - config.json 설정: GoogleSettings > Enable > false |
- 환경 변수: MM_GOOGLESETTINGS_ENABLE |

Google Single Sign-On 구현 지침을 참조하세요. |

Google OpenID 검색 엔드포인트#
이 설정에는 Google OpenID Connect의 검색 엔드포인트가 미리 입력되어 있습니다. | - 시스템 구성 경로: Authentication > OpenID Connect |
- config.json 설정: GoogleSettings > DiscoveryEndpoint |
Configure Mattermost for Google Apps SSO를 참조하세요. | - 환경 변수: MM_GOOGLESETTINGS_DISCOVERYENDPOINT
|

문자열 입력. 기본값은 https://accounts.google.com/.well-known/openid-configuration입니다. | |

Google OpenID 클라이언트 ID#
이 설정은 Google이 생성한 클라이언트 ID를 저장합니다. | - 시스템 구성 경로: Authentication > OpenID Connect |
- config.json 설정: GoogleSettings > Id |
Google Single Sign-On 구현 지침을 참조하세요. | - 환경 변수: MM_GOOGLESETTINGS_ID
|

문자열 입력. | |

Google OpenID 클라이언트 시크릿#
이 설정은 Google이 생성한 클라이언트 시크릿을 저장합니다. | - 시스템 구성 경로: Authentication > OpenID Connect |
- config.json 설정: GoogleSettings > Secret|
Google Single Sign-On 구현 지침을 참조하세요. | - 환경 변수: MM_GOOGLESETTINGS_SECRET
|

문자열 입력. | |

Google OpenID 선호 사용자명 사용#
  • true: Mattermost가 Google OpenID 토큰의 preferred_username 클레임을 Mattermost | - 시스템 구성 경로: Authentication > OpenID Connect | 사용자명으로 사용합니다. | - config.json 설정: GoogleSettings > UsePreferredUsername > false
  • false: (기본값) Mattermost가 사용자명 할당에 preferred_username 클레임을 사용하지 않습니다. | - 환경 변수: MM_GOOGLESETTINGS_USEPREFERREDUSERNAME

Entra ID OpenID 설정#

Note

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

Entra ID와의 OpenID Connect 인증 활성화#
  • true: Entra ID OpenID Connect 인증을 사용한 팀 및 계정 생성을 허용합니다. | - 시스템 구성 경로: Authentication > OpenID Connect |
- false: (기본값) Entra ID OpenID Connect 인증을 비활성화합니다. | - config.json 설정: Office365Settings > Enable > false |
- 환경 변수: MM_OFFICE365SETTINGS_ENABLE |

Entra ID Single Sign-On 구현 지침을 참조하세요. |

Entra ID OpenID 디렉터리 (테넌트) ID#
이 설정은 Microsoft Azure Portal을 통해 Mattermost에 설정된 디렉터리 (테넌트) ID를 저장합니다. | - 시스템 구성 경로: Authentication > OpenID Connect |
- config.json 설정: Office365Settings > DirectoryId |
Entra ID Single Sign-On 구현 지침을 참조하세요. | - 환경 변수: MM_OFFICE365SETTINGS_DIRECTORYID
|

문자열 입력. | |

Entra ID OpenID 검색 엔드포인트#
이 설정에는 Entra ID OpenID Connect의 검색 엔드포인트가 미리 입력되어 있습니다. | - 시스템 구성 경로: Authentication > OpenID Connect |
- config.json 설정: Office365Settings > DiscoveryEndpoint |
Entra ID Single Sign-On 구현 지침을 참조하세요. | - 환경 변수: MM_OFFICE365SETTINGS_DISCOVERYENDPOINT
|

문자열 입력. 기본값은 https://login.microsoftonline.com/common/v2.0/.well-known/openid-configuration입니다. | |

Entra ID 클라이언트 ID#
이 설정은 Microsoft Azure Portal을 통해 생성된 애플리케이션(클라이언트) ID를 저장합니다. | - 시스템 구성 경로: Authentication > OpenID Connect |
- config.json 설정: Office365Settings > Id |
Entra ID Single Sign-On 구현 지침을 참조하세요. | - 환경 변수: MM_OFFICE365SETTINGS_ID
|

문자열 입력. | |

Entra ID 클라이언트 시크릿#
이 설정은 Microsoft Azure Portal을 통해 생성된 클라이언트 시크릿을 저장합니다. | - 시스템 구성 경로: Authentication > OpenID Connect |
- config.json 설정: Office365Settings > Secret |
Entra ID Single Sign-On 구현 지침을 참조하세요. | - 환경 변수: MM_OFFICE365SETTINGS_SECRET
|

문자열 입력. | |

Entra ID 선호 사용자명 사용#
  • true: Mattermost가 Entra ID OpenID 토큰의 preferred_username 클레임을 Mattermost 사용자명으로 사용합니다. | - 시스템 구성 경로: Authentication > OpenID Connect |
  • false: (기본값) Mattermost가 사용자명 할당에 preferred_username 클레임을 사용하지 않습니다. | - config.json 설정: Office365Settings > UsePreferredUsername > false
    - 환경 변수: MM_OFFICE365SETTINGS_USEPREFERREDUSERNAME
Note

preferred_username 클레임을 사용할 수 있도록 하려면 Azure Portal의 App registrations > Token configuration 에서 선택적 클레임으로 추가하세요. 설정 세부 정보는 Entra ID Single Sign-On을 참조하세요.

OpenID Connect (기타) 설정#

다른 서비스 공급자와의 OpenID Connect 인증 활성화#
  • true: 다른 OpenID Connect 서비스 공급자를 사용한 팀 및 계정 생성을 허용합니다. | - 시스템 구성 경로: Authentication > OpenID Connect |
- false: (기본값) 다른 서비스 공급자와의 OpenID Connect 인증을 비활성화합니다. | - config.json 설정: OpenIdSettings > Enable > false |
- 환경 변수: MM_OPENIDSETTINGS_ENABLE |

구현 지침은 OpenID Connect Single Sign-On을 참조하세요. |

OpenID Connect (기타) 버튼 이름#

이 설정은 OpenID 로그인 버튼에 표시되는 텍스트입니다.

문자열 입력.

  • 시스템 구성 경로: Authentication > OpenID Connect
  • config.json 설정: OpenIdSettings > ButtonText
  • 환경 변수: MM_OPENIDSETTINGS_BUTTONTEXT
OpenID Connect (기타) 버튼 색상#

이 설정은 OpenID 로그인 버튼의 색상입니다. 코드 앞에 #(해시) 기호를 붙인 16진수 코드를 사용하세요. 예: #145DBF.

문자열 입력.

  • 시스템 구성 경로: Authentication > OpenID Connect
  • config.json 설정: OpenIdSettings > ButtonColor
  • 환경 변수: MM_OPENIDSETTINGS_BUTTONCOLOR
OpenID Connect (기타) 검색 엔드포인트#
이 설정은 OpenID 공급자의 검색 엔드포인트(Discovery Endpoint) URL을 저장합니다. | - 시스템 구성 경로: Authentication > OpenID Connect | URL은 https://myopenid.provider.com/{my_organization}/ | -config.jsonsetting:OpenIdSettings>DiscoveryEndpoint| .well-known/openid-configuration 형식이어야 합니다. | - 환경 변수: MM_OPENIDSETTINGS_DISCOVERYENDPOINT | | | 구현 지침은 OpenID Connect Single Sign-On을 | 참조하세요. | | | | 문자열 입력. | |
Note

검색 엔드포인트 설정은 임의 호스트의 연결 및 가용성을 확인하는 데 사용될 수 있습니다. 이에 우려가 있는 시스템 관리자는 사용자 지정 관리자 역할을 사용하여 이 설정 수정에 대한 접근을 제한할 수 있습니다. 자세한 내용은 위임된 세분화된 관리) 문서를 참조하세요.

OpenID Connect (기타) 클라이언트 ID#
이 설정은 OpenID 공급자의 클라이언트 ID를 저장합니다. | - 시스템 구성 경로: Authentication > OpenID Connect |
- config.json 설정: OpenIdSettings > Id |
구현 지침은 OpenID Connect Single Sign-On을 참조하세요. | - 환경 변수: MM_OPENIDSETTINGS_ID
|

문자열 입력. | |

OpenID Connect (기타) 클라이언트 시크릿#
이 설정은 OpenID 공급자의 클라이언트 시크릿(Client Secret)을 저장합니다. | - 시스템 구성 경로: Authentication > OpenID Connect |
- config.json 설정: OpenIdSettings > Secret|
구현 지침은 OpenID Connect Single Sign-On을 참조하세요. | - 환경 변수: MM_OPENIDSETTINGS_SECRET
|

문자열 입력. | |

OpenID Connect (기타) 선호 사용자명 사용#
  • true: Mattermost가 공급자의 OpenID 토큰에 있는 preferred_username 클레임을 Mattermost 사용자명으로 사용합니다.
  • false: (기본값) Mattermost가 사용자명 할당에 preferred_username 클레임을 사용하지 않습니다.
  • 시스템 구성 경로: Authentication > OpenID Connect |
  • config.json 설정: OpenIdSettings > | UsePreferredUsername > false |
  • 환경 변수: | MM_OPENIDSETTINGS_USEPREFERREDUSERNAME

게스트 접근#

System Console에서 Authentication > Guest Access로 이동하여 다음 구성 설정에 접근하세요.

게스트 접근 활성화#

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

게스트 청구는 채널 접근에 따라 달라집니다. 정확히 하나의 활성 채널에 있는 게스트는 단일 채널 게스트로 처리되며 기본 유료 시트 수에 포함되지 않습니다. 라이선스된 시트와 1:1 비율까지 무료입니다. 여러 활성 채널에 있는 게스트는 계속해서 청구 목적상 활성화된 사용자로 계산됩니다. 다이렉트 메시지와 그룹 메시지는 게스트가 단일 채널 게스트로 계산되는지 여부에 영향을 미치지 않습니다. 활성 채널만 청구를 위한 게스트 채널 접근에 포함됩니다. 보관된 채널은 제외됩니다. 자세한 내용은 게스트 계정 문서를 참조하세요.

허용된 게스트 도메인#

이 설정을 사용하여 게스트 계정 생성을 제한합니다. 설정하면 게스트 계정은 나열된 도메인 중 하나의 검증된 이메일 주소가 필요합니다.

쉼표로 구분된 하나 이상의 도메인을 문자열로 입력합니다.

  • 시스템 구성 경로: Authentication > Guest Access
  • config.json 설정: GuestAccountsSettings > RestrictCreationToDomains
  • 환경 변수: MM_GUESTACCOUNTSSETTINGS_RESTRICTCREATIONTODOMAINS

게스트 태그 표시#

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

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

게스트 매직 링크 인증 활성화#

사용 가능 플랜: Entry, Enterprise, Enterprise Advanced(Professional 제외)

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

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