OpenID Connect 싱글 사인온

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

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

Mattermost는 GitLab, Google Apps, Entra ID에 대한 OpenID Connect를 지원합니다. OpenID Connect를 사용하면 Keycloak, Atlassian Crowd, Apple, Microsoft, Salesforce, Auth0, Ory.sh, Facebook, Okta, OneLogin, Azure AD를 비롯한 여러 서비스의 로그인 정보를 팀 생성, 계정 생성, 사용자 로그인을 위한 싱글 사인온(SSO) 서비스로 사용할 수 있습니다.

다음 절차에 따라 OpenID Connect를 사용하는 서비스 공급자를 설정하세요.

1단계: OpenID Connect 애플리케이션 생성

  1. 서비스 공급자의 문서에 따라 OpenID Connect 애플리케이션을 생성합니다. 대부분의 OpenID Connect 서비스 공급자는 모든 리디렉션 URI를 사전 승인하도록 요구합니다.
  2. 해당 필드에 {your-mattermost-url}/signup/openid/complete를 입력합니다. 예: http://domain.com/signup/openid/complete
  3. Discovery Endpoint, Client ID, Client Secret 값을 복사해 임시 위치에 붙여 넣어 둡니다. Mattermost를 설정할 때 이 값들을 입력하게 됩니다.

2단계: OpenID Connect SSO를 위한 Mattermost 설정

  1. Mattermost에 로그인한 뒤 System Console > Authentication > OpenID Connect(시스템 콘솔 > 인증 > OpenID Connect)로 이동합니다.
  2. 서비스 공급자로 OpenID Connect (Other)를 선택합니다.
  3. Discovery Endpoint를 입력합니다.
  4. Client ID를 입력합니다.
  5. Client Secret을 입력합니다.
  6. Mattermost 로그인 페이지에 표시할 OpenID Connect 항목의 Button Name과 Button Color를 지정합니다.
  7. Save를 선택합니다.
  8. 변경 사항을 적용하려면 Mattermost 서버를 재시작합니다.
참고
  • Mattermost가 사용자 인증에 OpenID Connect를 사용하도록 설정된 경우, 이름, 성, 사용자 이름은 Mattermost API로 변경할 수 없습니다. 이 속성들은 OpenID Connect가 권위 있는 소스여야 합니다.
  • 관리자는 OpenID 토큰의 preferred_username 클레임을 Mattermost 사용자 이름으로 사용하도록 설정할 수 있습니다. System Console > Authentication > OpenID Connect의 공급자 설정에서 Use preferred username 옵션을 활성화하세요. 자세한 내용은 인증 설정을 참고하세요.
  • Discovery Endpoint 설정은 임의 호스트의 연결 가능 여부와 가용성을 확인하는 데 악용될 수 있습니다. 이 점이 우려되는 시스템 관리자는 맞춤 관리자 역할을 사용해 해당 설정의 변경 권한을 제한할 수 있습니다. 자세한 내용은 위임형 세분화 관리 문서를 참고하세요.

자주 묻는 질문

OpenID에서 LDAP 속성이나 그룹을 사용하려면 어떻게 하나요?

현재 LDAP 데이터는 OpenID와 호환되지 않습니다. 사용자의 팀, 채널, 그룹, 속성 관리를 LDAP에 의존하고 있다면, OpenID로 로그인한 사용자에 대해서는 이를 자동으로 처리할 수 없습니다. 사용자마다 LDAP 동기화가 필요하다면 로그인 공급자로 SAML이나 LDAP를 사용하는 것을 권장합니다. Keycloak처럼 일부 OpenID 공급자는 SAML을 대신 사용할 수 있습니다.