셀프 호스팅 Mattermost 배포를 관리하는 시스템 관리자는 아래 표에 설명된 대로 config.json 파일을 편집할 수 있습니다. 아래 각 구성 값에는 JSON 인식 도구를 사용하여 프로그래밍 방식으로 config.json 파일에서 값에 접근할 수 있는 JSON 경로가 포함되어 있습니다. 예를 들어, EnableUserCreation 값은 TeamSettings 아래에 있습니다.
jq와 같은 도구를 사용하는 경우 cat config/config.json | jq '.TeamSettings.EnableUserCreation'을 입력합니다.
config.json 파일을 수동으로 편집할 때는 TeamSettings와 같은 객체를 찾은 뒤 그 안에서 EnableUserCreation 키를 찾으세요.
LDAP 및 SAML 사용자는 이 구성 설정의 활성화 여부와 관계없이 LDAP 또는 SAML 사용자 자격 증명으로 로그인하여 Mattermost 계정을 항상 생성할 수 있습니다.
Mattermost v10.9부터 꺾쇠 괄호로 묶인 이메일 주소(예: [billy@example.com](mailto:billy@example.com))는 거부됩니다. 문제를 방지하려면 모든 사용자 이메일이 일반 주소 형식(예: billy@example.com)을 준수하는지 확인하세요. 또한, 이 제품 변경 사항에 맞게 Mattermost 사용자 데이터를 사전에 감사하고 업데이트하는 조치를 취하는 것을 강력히 권장합니다. 영향을 받는 사용자는 Mattermost 접근 또는 사용자 프로필 관리에 문제가 생길 수 있습니다. mmctl user email을 사용하여 이러한 사용자 이메일을 수동으로 업데이트할 수 있습니다.
이 설정은 새 계정 또는 팀을 만드는 데 사용할 수 있는 이메일 주소 도메인을 제한합니다. | - 시스템 구성 경로: Authentication > Signup | 제한이 작동하려면 이메일 인증 필수를 | - config.json 설정: TeamSettings > RestrictCreationToDomainstrue로 반드시 설정해야 합니다. 이 설정은 이메일 로그인에만 영향을 줍니다. | - 환경 변수: MM_TEAMSETTINGS_RESTRICTCREATIONTODOMAINS |
- 로그인 페이지에서 사용자에게 이메일 로그인 옵션만 단일하게 제공하려면, 사용자명으로 로그인 활성화 구성 설정이 false로 설정되어 있는지 확인하세요. - Mattermost v10.9부터 꺾쇠 괄호로 묶인 이메일 주소(예: [billy@example.com](mailto:billy@example.com))는 거부됩니다. 문제를 방지하려면 모든 사용자 이메일이 일반 주소 형식(예: billy@example.com)을 준수하는지 확인하세요. 또한, 이 제품 변경 사항에 맞게 Mattermost 사용자 데이터를 사전에 감사하고 업데이트하는 조치를 취하는 것을 강력히 권장합니다. 영향을 받는 사용자는 Mattermost 접근 또는 사용자 프로필 관리에 문제가 생길 수 있습니다. mmctl user email을 사용하여 이러한 사용자 이메일을 수동으로 업데이트할 수 있습니다.
System Console에서 Authentication > MFA로 이동하여 다음 구성 설정에 접근하세요.
자체 사설 네트워크 내에 Mattermost를 배포하고 모바일 액세스를 위해 VPN 클라이언트를 사용하여 기존 프로토콜로 Mattermost를 보호하는 것을 권장합니다. 기존 보안 프로토콜을 우회하여 사설 네트워크 외부에서 Mattermost를 실행하려는 경우, Mattermost 액세스를 위한 다중 인증 서비스를 별도로 추가하는 것을 권장합니다.
true: AD/LDAP 또는 이메일 주소로 로그인하는 사용자가 계정에 | - 시스템 구성 경로: Authentication > MFA | 다중 인증을 추가할 수 있습니다. | - config.json 설정: ServiceSettings > EnableMultifactorAuthentication > false
false: (기본값) 다중 인증을 비활성화합니다. | - 환경 변수: MM_SERVICESETTINGS_ENABLEMULTIFACTORAUTHENTICATION |
System Console의 AD/LDAP 동기화 설정은 임의의 호스트에 대한 연결 가능 여부와 가용성을 확인하는 데 사용될 수 있습니다. 이 점이 우려되는 시스템 관리자는 사용자 지정 관리자 역할을 사용하여 이러한 설정을 수정할 수 있는 권한을 제한할 수 있습니다. 자세한 내용은 위임된 세분화 관리) 문서를 참조하세요.
System Console의 AD/LDAP 동기화 설정은 임의의 호스트에 대한 연결 가능 여부와 가용성을 확인하는 데 사용될 수 있습니다. 이 점이 우려되는 시스템 관리자는 사용자 지정 관리자 역할을 사용하여 이러한 설정을 수정할 수 있는 권한을 제한할 수 있습니다. 자세한 내용은 위임된 세분화 관리) 문서를 참조하세요.
이 설정은 사용자 객체를 검색할 때 적용되는 일반 구문 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 트리 부분에 대한 읽기 전용 액세스 권한을 가져야 합니다.
이 설정은 선택된 사용자를 시스템 관리자로 지정하는 AD/LDAP 필터를 입력받습니다. 사용자는 다음 AD/LDAP 로그인 시 이 역할로 승격됩니다. 이 필터는 예약된 AD/LDAP 동기화 중에는 평가되지 않으며, Enable Synchronizing SAML Accounts With AD/LDAP가 활성화되어 있더라도 SAML로 인증하는 사용자에게는 적용되지 않습니다. SAML로 인증하는 사용자의 시스템 관리자를 지정하려면 SAML Admin Attribute 설정을 사용하세요.
Admin Filter가 제거되면, 현재 로그인한 사용자는 다음 로그인 시까지 관리자 역할을 유지합니다.
이 설정은 Mattermost에 게스트 액세스 권한이 있는 외부 사용자를 검색할 때 적용할 AD/LDAP 필터를 입력받습니다. 쿼리로 선택된 사용자만 게스트로 Mattermost에 액세스할 수 있습니다. | - 시스템 구성 경로: Authentication > AD/LDAP |
- config.json 설정: LdapSettings > GuestFilter |
자세한 내용은 게스트 계정을 참조하세요. | - 환경 변수: MM_LDAPSETTINGS_GUESTFILTER
이 속성은 objectGUID 또는 entryUUID처럼 변하지 않는 고유한 값을 가져야 합니다. 변경하기 전에 사용 중인 환경에서 이러한 속성을 사용할 수 있는지 확인하세요.
문자열 입력.
시스템 구성 경로: Authentication > AD/LDAP
config.json 설정: LdapSettings > IdAttribute
환경 변수: MM_LDAPSETTINGS_IDATTRIBUTE
Note
사용자의 ID 속성이 변경되면 이전 계정과 연결되지 않은 새 Mattermost 계정이 만들어집니다. 사용자가 로그인한 후에 이 필드를 변경해야 하는 경우 mmctl ldap idmigrate 명령을 사용하세요.
Note
ID 속성 값은 입력된 그대로 일치 여부를 판단하며, Mattermost는 대소문자 정규화를 적용하지 않습니다. PostgreSQL의 기본 대소문자 구분 콜레이션에서는 대소문자가 바뀌면 새 사용자로 취급되어 별도의 계정이 만들어집니다. AD/LDAP 서버가 이 속성을 일관된 대소문자로 반환하는지 확인하세요.
이 속성은 UI에서 사용자를 식별합니다. 예를 들어 Username Attribute가 john.smith로 설정된 경우 @john을 입력하면 @john.smith가 자동 완성 옵션으로 표시되고, @john.smith가 포함된 메시지를 게시하면 해당 사용자에게 알림이 전송됩니다.
일반적으로 Login ID Attribute와 동일하지만 다른 속성에 매핑할 수도 있습니다.
이 속성은 AD/LDAP 그룹 동기화가 활성화된 경우에만 사용되며 필수입니다. 자세한 내용은 AD/LDAP 그룹 동기화 문서를 참조하세요.
Note
그룹 ID 속성 값은 입력된 그대로 일치 여부를 판단하며, Mattermost는 대소문자 정규화를 적용하지 않습니다. PostgreSQL의 기본 대소문자 구분 콜레이션에서는 대소문자가 바뀌면 Mattermost가 이전에 동기화된 그룹을 더 이상 인식하지 못하고 연결되지 않은 새 그룹으로 취급합니다. AD/LDAP 서버가 이 속성을 일관된 대소문자로 반환하는지 확인하세요.
true: Mattermost가 구성된 Mattermost 사용자 속성(예: FirstName, Position, Email)을 AD/LDAP의 값으로 업데이트합니다. v10.9부터 Mattermost는 로그인 중에 연결된 LDAP 서버에 사용자가 존재하는지 확인합니다. 사용자가 LDAP 서버에 존재하지 않으면 로그인에 실패합니다.
false: (기본값) SAML로 인증된 Mattermost 사용자와 AD/LDAP의 동기화를 비활성화합니다. Mattermost v10.9부터 Mattermost는 로그인 중에 연결된 LDAP 서버에 사용자가 존재하는지 확인하지 않습니다.
환경 변수: MM_SAMLSETTINGS_ENABLESYNCWITHLDAPINCLUDEAUTH
Note
- LDAP 동기화가 활성화되지 않은 경우 이 설정은 false여야 합니다. 이 설정을 true에서 false로 변경하면 덮어쓰기가 비활성화됩니다. - 덮어쓰기가 활성화된 경우 SAML ID는 LDAP ID와 일치해야 합니다. - 자세한 내용은 AD/LDAP Setup을 참조하세요.
(선택 사항) 이 설정은 SAML 사용자를 Mattermost 사용자와 바인드하는 데 사용하는 SAML 어설션 속성을 결정합니다.
문자열 입력.
시스템 구성 경로: Authentication > SAML 2.0
config.json 설정: SamlSettings > IdAttribute
환경 변수: MM_SAMLSETTINGS_IDATTRIBUTE
Note
ID 속성 값은 원문 그대로 비교됩니다 - Mattermost는 대소문자 정규화를 적용하지 않습니다. PostgreSQL의 기본 대소문자 구분 데이터 정렬(collation)에서는 대소문자 표기가 변경되면 새로운 사용자로 처리되어 별도의 계정이 생성됩니다. 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
사용자 API 엔드포인트로 https://people.googleapis.com/v1/people/me?personFields=names,emailAddresses,nicknames,metadata를 권장합니다. 그렇지 않으면 API 서버에서 사용할 수 있는 경우 HTTP 또는 HTTPS를 사용하여 config.json에 사용자 지정 엔드포인트를 입력하세요.
인증 엔드포인트로 https://login.microsoftonline.com/common/oauth2/v2.0/authorize를 권장합니다. 그렇지 않으면 서버에서 사용할 수 있는 경우 http 또는 https를 사용하여 config.json에 사용자 지정 엔드포인트를 입력하세요.
토큰 엔드포인트로 https://login.microsoftonline.com/common/oauth2/v2.0/token을 권장합니다. 그렇지 않으면 서버에서 사용할 수 있는 경우 http 또는 https를 사용하여 config.json에 사용자 지정 엔드포인트를 입력하세요.
- 환경 변수: MM_OFFICE365SETTINGS_USEPREFERREDUSERNAME
Note
preferred_username 클레임을 사용할 수 있도록 하려면 Azure Portal의 App registrations > Token configuration 에서 선택적 클레임으로 추가하세요. 설정 세부 정보는 Entra ID Single Sign-On을 참조하세요.
게스트 청구는 채널 접근에 따라 달라집니다. 정확히 하나의 활성 채널에 있는 게스트는 단일 채널 게스트로 처리되며 기본 유료 시트 수에 포함되지 않습니다. 라이선스된 시트와 1:1 비율까지 무료입니다. 여러 활성 채널에 있는 게스트는 계속해서 청구 목적상 활성화된 사용자로 계산됩니다. 다이렉트 메시지와 그룹 메시지는 게스트가 단일 채널 게스트로 계산되는지 여부에 영향을 미치지 않습니다. 활성 채널만 청구를 위한 게스트 채널 접근에 포함됩니다. 보관된 채널은 제외됩니다. 자세한 내용은 게스트 계정 문서를 참조하세요.
셀프 호스팅 Mattermost 배포를 관리하는 시스템 관리자는 아래 표에 설명된 대로 config.json 파일을 편집할 수 있습니다. 아래 각 구성 값에는 JSON 인식 도구를 사용하여 프로그래밍 방식으로 config.json 파일에서 값에 접근할 수 있는 JSON 경로가 포함되어 있습니다. 예를 들어, EnableUserCreation 값은 TeamSettings 아래에 있습니다.
jq와 같은 도구를 사용하는 경우 cat config/config.json | jq '.TeamSettings.EnableUserCreation'을 입력합니다.
config.json 파일을 수동으로 편집할 때는 TeamSettings와 같은 객체를 찾은 뒤 그 안에서 EnableUserCreation 키를 찾으세요.
LDAP 및 SAML 사용자는 이 구성 설정의 활성화 여부와 관계없이 LDAP 또는 SAML 사용자 자격 증명으로 로그인하여 Mattermost 계정을 항상 생성할 수 있습니다.
Mattermost v10.9부터 꺾쇠 괄호로 묶인 이메일 주소(예: [billy@example.com](mailto:billy@example.com))는 거부됩니다. 문제를 방지하려면 모든 사용자 이메일이 일반 주소 형식(예: billy@example.com)을 준수하는지 확인하세요. 또한, 이 제품 변경 사항에 맞게 Mattermost 사용자 데이터를 사전에 감사하고 업데이트하는 조치를 취하는 것을 강력히 권장합니다. 영향을 받는 사용자는 Mattermost 접근 또는 사용자 프로필 관리에 문제가 생길 수 있습니다. mmctl user email을 사용하여 이러한 사용자 이메일을 수동으로 업데이트할 수 있습니다.
이 설정은 새 계정 또는 팀을 만드는 데 사용할 수 있는 이메일 주소 도메인을 제한합니다. | - 시스템 구성 경로: Authentication > Signup | 제한이 작동하려면 이메일 인증 필수를 | - config.json 설정: TeamSettings > RestrictCreationToDomainstrue로 반드시 설정해야 합니다. 이 설정은 이메일 로그인에만 영향을 줍니다. | - 환경 변수: MM_TEAMSETTINGS_RESTRICTCREATIONTODOMAINS |
- 로그인 페이지에서 사용자에게 이메일 로그인 옵션만 단일하게 제공하려면, 사용자명으로 로그인 활성화 구성 설정이 false로 설정되어 있는지 확인하세요. - Mattermost v10.9부터 꺾쇠 괄호로 묶인 이메일 주소(예: [billy@example.com](mailto:billy@example.com))는 거부됩니다. 문제를 방지하려면 모든 사용자 이메일이 일반 주소 형식(예: billy@example.com)을 준수하는지 확인하세요. 또한, 이 제품 변경 사항에 맞게 Mattermost 사용자 데이터를 사전에 감사하고 업데이트하는 조치를 취하는 것을 강력히 권장합니다. 영향을 받는 사용자는 Mattermost 접근 또는 사용자 프로필 관리에 문제가 생길 수 있습니다. mmctl user email을 사용하여 이러한 사용자 이메일을 수동으로 업데이트할 수 있습니다.
System Console에서 Authentication > MFA로 이동하여 다음 구성 설정에 접근하세요.
자체 사설 네트워크 내에 Mattermost를 배포하고 모바일 액세스를 위해 VPN 클라이언트를 사용하여 기존 프로토콜로 Mattermost를 보호하는 것을 권장합니다. 기존 보안 프로토콜을 우회하여 사설 네트워크 외부에서 Mattermost를 실행하려는 경우, Mattermost 액세스를 위한 다중 인증 서비스를 별도로 추가하는 것을 권장합니다.
true: AD/LDAP 또는 이메일 주소로 로그인하는 사용자가 계정에 | - 시스템 구성 경로: Authentication > MFA | 다중 인증을 추가할 수 있습니다. | - config.json 설정: ServiceSettings > EnableMultifactorAuthentication > false
false: (기본값) 다중 인증을 비활성화합니다. | - 환경 변수: MM_SERVICESETTINGS_ENABLEMULTIFACTORAUTHENTICATION |
System Console의 AD/LDAP 동기화 설정은 임의의 호스트에 대한 연결 가능 여부와 가용성을 확인하는 데 사용될 수 있습니다. 이 점이 우려되는 시스템 관리자는 사용자 지정 관리자 역할을 사용하여 이러한 설정을 수정할 수 있는 권한을 제한할 수 있습니다. 자세한 내용은 위임된 세분화 관리) 문서를 참조하세요.
System Console의 AD/LDAP 동기화 설정은 임의의 호스트에 대한 연결 가능 여부와 가용성을 확인하는 데 사용될 수 있습니다. 이 점이 우려되는 시스템 관리자는 사용자 지정 관리자 역할을 사용하여 이러한 설정을 수정할 수 있는 권한을 제한할 수 있습니다. 자세한 내용은 위임된 세분화 관리) 문서를 참조하세요.
이 설정은 사용자 객체를 검색할 때 적용되는 일반 구문 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 트리 부분에 대한 읽기 전용 액세스 권한을 가져야 합니다.
이 설정은 선택된 사용자를 시스템 관리자로 지정하는 AD/LDAP 필터를 입력받습니다. 사용자는 다음 AD/LDAP 로그인 시 이 역할로 승격됩니다. 이 필터는 예약된 AD/LDAP 동기화 중에는 평가되지 않으며, Enable Synchronizing SAML Accounts With AD/LDAP가 활성화되어 있더라도 SAML로 인증하는 사용자에게는 적용되지 않습니다. SAML로 인증하는 사용자의 시스템 관리자를 지정하려면 SAML Admin Attribute 설정을 사용하세요.
Admin Filter가 제거되면, 현재 로그인한 사용자는 다음 로그인 시까지 관리자 역할을 유지합니다.
이 설정은 Mattermost에 게스트 액세스 권한이 있는 외부 사용자를 검색할 때 적용할 AD/LDAP 필터를 입력받습니다. 쿼리로 선택된 사용자만 게스트로 Mattermost에 액세스할 수 있습니다. | - 시스템 구성 경로: Authentication > AD/LDAP |
- config.json 설정: LdapSettings > GuestFilter |
자세한 내용은 게스트 계정을 참조하세요. | - 환경 변수: MM_LDAPSETTINGS_GUESTFILTER
이 속성은 objectGUID 또는 entryUUID처럼 변하지 않는 고유한 값을 가져야 합니다. 변경하기 전에 사용 중인 환경에서 이러한 속성을 사용할 수 있는지 확인하세요.
문자열 입력.
시스템 구성 경로: Authentication > AD/LDAP
config.json 설정: LdapSettings > IdAttribute
환경 변수: MM_LDAPSETTINGS_IDATTRIBUTE
Note
사용자의 ID 속성이 변경되면 이전 계정과 연결되지 않은 새 Mattermost 계정이 만들어집니다. 사용자가 로그인한 후에 이 필드를 변경해야 하는 경우 mmctl ldap idmigrate 명령을 사용하세요.
Note
ID 속성 값은 입력된 그대로 일치 여부를 판단하며, Mattermost는 대소문자 정규화를 적용하지 않습니다. PostgreSQL의 기본 대소문자 구분 콜레이션에서는 대소문자가 바뀌면 새 사용자로 취급되어 별도의 계정이 만들어집니다. AD/LDAP 서버가 이 속성을 일관된 대소문자로 반환하는지 확인하세요.
이 속성은 UI에서 사용자를 식별합니다. 예를 들어 Username Attribute가 john.smith로 설정된 경우 @john을 입력하면 @john.smith가 자동 완성 옵션으로 표시되고, @john.smith가 포함된 메시지를 게시하면 해당 사용자에게 알림이 전송됩니다.
일반적으로 Login ID Attribute와 동일하지만 다른 속성에 매핑할 수도 있습니다.
이 속성은 AD/LDAP 그룹 동기화가 활성화된 경우에만 사용되며 필수입니다. 자세한 내용은 AD/LDAP 그룹 동기화 문서를 참조하세요.
Note
그룹 ID 속성 값은 입력된 그대로 일치 여부를 판단하며, Mattermost는 대소문자 정규화를 적용하지 않습니다. PostgreSQL의 기본 대소문자 구분 콜레이션에서는 대소문자가 바뀌면 Mattermost가 이전에 동기화된 그룹을 더 이상 인식하지 못하고 연결되지 않은 새 그룹으로 취급합니다. AD/LDAP 서버가 이 속성을 일관된 대소문자로 반환하는지 확인하세요.
true: Mattermost가 구성된 Mattermost 사용자 속성(예: FirstName, Position, Email)을 AD/LDAP의 값으로 업데이트합니다. v10.9부터 Mattermost는 로그인 중에 연결된 LDAP 서버에 사용자가 존재하는지 확인합니다. 사용자가 LDAP 서버에 존재하지 않으면 로그인에 실패합니다.
false: (기본값) SAML로 인증된 Mattermost 사용자와 AD/LDAP의 동기화를 비활성화합니다. Mattermost v10.9부터 Mattermost는 로그인 중에 연결된 LDAP 서버에 사용자가 존재하는지 확인하지 않습니다.
환경 변수: MM_SAMLSETTINGS_ENABLESYNCWITHLDAPINCLUDEAUTH
Note
- LDAP 동기화가 활성화되지 않은 경우 이 설정은 false여야 합니다. 이 설정을 true에서 false로 변경하면 덮어쓰기가 비활성화됩니다. - 덮어쓰기가 활성화된 경우 SAML ID는 LDAP ID와 일치해야 합니다. - 자세한 내용은 AD/LDAP Setup을 참조하세요.
(선택 사항) 이 설정은 SAML 사용자를 Mattermost 사용자와 바인드하는 데 사용하는 SAML 어설션 속성을 결정합니다.
문자열 입력.
시스템 구성 경로: Authentication > SAML 2.0
config.json 설정: SamlSettings > IdAttribute
환경 변수: MM_SAMLSETTINGS_IDATTRIBUTE
Note
ID 속성 값은 원문 그대로 비교됩니다 - Mattermost는 대소문자 정규화를 적용하지 않습니다. PostgreSQL의 기본 대소문자 구분 데이터 정렬(collation)에서는 대소문자 표기가 변경되면 새로운 사용자로 처리되어 별도의 계정이 생성됩니다. 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
사용자 API 엔드포인트로 https://people.googleapis.com/v1/people/me?personFields=names,emailAddresses,nicknames,metadata를 권장합니다. 그렇지 않으면 API 서버에서 사용할 수 있는 경우 HTTP 또는 HTTPS를 사용하여 config.json에 사용자 지정 엔드포인트를 입력하세요.
인증 엔드포인트로 https://login.microsoftonline.com/common/oauth2/v2.0/authorize를 권장합니다. 그렇지 않으면 서버에서 사용할 수 있는 경우 http 또는 https를 사용하여 config.json에 사용자 지정 엔드포인트를 입력하세요.
토큰 엔드포인트로 https://login.microsoftonline.com/common/oauth2/v2.0/token을 권장합니다. 그렇지 않으면 서버에서 사용할 수 있는 경우 http 또는 https를 사용하여 config.json에 사용자 지정 엔드포인트를 입력하세요.
- 환경 변수: MM_OFFICE365SETTINGS_USEPREFERREDUSERNAME
Note
preferred_username 클레임을 사용할 수 있도록 하려면 Azure Portal의 App registrations > Token configuration 에서 선택적 클레임으로 추가하세요. 설정 세부 정보는 Entra ID Single Sign-On을 참조하세요.
게스트 청구는 채널 접근에 따라 달라집니다. 정확히 하나의 활성 채널에 있는 게스트는 단일 채널 게스트로 처리되며 기본 유료 시트 수에 포함되지 않습니다. 라이선스된 시트와 1:1 비율까지 무료입니다. 여러 활성 채널에 있는 게스트는 계속해서 청구 목적상 활성화된 사용자로 계산됩니다. 다이렉트 메시지와 그룹 메시지는 게스트가 단일 채널 게스트로 계산되는지 여부에 영향을 미치지 않습니다. 활성 채널만 청구를 위한 게스트 채널 접근에 포함됩니다. 보관된 채널은 제외됩니다. 자세한 내용은 게스트 계정 문서를 참조하세요.