위임형 세분화 관리

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

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

Mattermost는 세분화된 권한과 시스템 콘솔(System Console) 접근 범위를 지정한 시스템 관리 역할을 만들고 맞춤 설정하는 기능을 지원합니다. 이를 통해 대규모 조직의 상급 관리자는 특정 관리자 역할로 전문화된 관리 업무를 위임하고 분산할 수 있습니다.

이러한 관리자 역할은 시스템 콘솔의 특정 영역과 관련 API 엔드포인트에 대한 세분화된 접근을 허용합니다. 이 역할을 사용하면 모든 시스템 관리 영역에 접근하지 않고도 특정 관리 업무를 수행할 수 있습니다. 이 시스템 역할은 사용자의 원래 역할이나 권한 스킴으로 구성된 사용자 권한을 결코 대체하지 않습니다.

주의

특정 시스템 콘솔 페이지에 대해 역할이 No Access 또는 Read Only로 설정되어 있더라도, 어느 한 시스템 콘솔 페이지에서 Can Edit을 부여하면 그 아래의 구성 엔드포인트(PUT /api/v4/config/patch)에 접근할 수 있게 됩니다. 즉 한 영역에서 쓰기 권한을 가진 사용자는 모든 영역의 구성 값을 수정할 수 있습니다. 관리자는 Can Edit 권한을 신중하게 부여해야 합니다.

사용 가능한 역할

시스템 관리자는 시스템 콘솔에서 다음 위임형 세분화 관리 역할을 구성할 수 있습니다. 각 역할에는 기본 권한 집합이 있으며 필요에 따라 조정할 수 있습니다.

  • System Manager: 여러 관리 영역에 대해 읽기/쓰기 권한을 갖도록 구성할 수 있는 역할입니다.
  • User Manager: 모든 사용자 관리 영역과 인증 영역에 대해 읽기/쓰기 권한을 갖도록 구성할 수 있는 역할입니다.
  • Custom Group Manager 맞춤 사용자 그룹을 생성·편집·복원·삭제할 수 있는 권한을 가진 역할입니다. System Console > Permissions > Edit Scheme > Custom Groups에서 All Members의 Custom Groups 권한을 제거한 경우, 개별 사용자에게 맞춤 그룹 관리 권한을 부여하는 데 이 역할을 사용할 수 있습니다.
  • Shared Channel Manager manage_shared_channels 권한을 가진 역할로, 할당된 사용자가 원격 서버와 이미 연결된 채널을 공유하거나 공유 해제할 수 있습니다.
  • Viewer: Viewer 역할은 시스템 콘솔의 모든 영역을 볼 수 있으며, 필요한 경우 쓰기 권한을 갖도록 구성할 수 있습니다.

사용자에게 시스템 역할이 할당되면 해당 역할에 기반해 시스템 콘솔과 그 아래 API 엔드포인트에 접근할 수 있습니다. 각 역할은 기본 권한 집합이 서로 다르며, 사용자가 접근하거나 볼 수 있는 범위는 할당된 역할에 따라 달라집니다.

아래 표는 각 역할의 기본 권한을 정리한 것입니다. 관리자는 이 설정을 꼼꼼히 검토하고 조직의 필요에 맞게 구성해야 합니다. 특히 Permissions 쓰기 권한은 위임형 세분화 관리자 역할을 제외한 모든 역할의 권한을 수정할 수 있게 하므로 각별히 주의해야 합니다.

시스템 역할읽기/쓰기 접근읽기 전용 접근
System Manager
  • User Management
    • Groups
    • Teams
    • Channels
    • Permissions
  • Environment
  • Site Configuration
  • Integrations
  • Edition/License
  • Reporting
  • Authentication
  • Plugins
User Manager
  • User Management
    • Groups
    • Teams
    • Channels
  • (User Management) Permissions
  • Authentication
Custom Group ManagerCustom User Groups해당 없음
Shared Channel ManagerShared Channels해당 없음
Viewer해당 없음
  • 시스템 콘솔의 모든 페이지

관리자 역할 할당

역할을 할당하는 방법은 두 가지입니다.

  1. 시스템 콘솔의 User Management > Delegated Granular Administration에서 할당합니다.
  2. mmctl 도구를 사용합니다. 로컬 또는 원격에서 모두 수행할 수 있습니다.
하려는 작업시스템 콘솔 사용mmctl 사용
역할 할당 System Console > User Management > Delegated Granular Administration > Assigned People로 이동합니다. mmctl permissions role assign [role_name] [username...]
사용자에게 System Manager 역할 부여
  1. System Console > User Management > Delegated Granular Administration으로 이동한 뒤 System Manager 역할을 선택합니다.
  2. Assigned People에서 Add People을 선택합니다.
  3. 사용자 이름을 검색해 선택한 뒤 Add를 선택해 해당 사용자에게 System Manager 역할을 부여합니다.
mmctl permissions role assign system_manager user-name
사용자 두 명에게 User Manager 역할 부여
  1. System Console > User Management > Delegated Granular Administration으로 이동한 뒤 User Manager 역할을 선택합니다.
  2. Assigned People에서 Add People을 선택합니다.
  3. 두 사용자를 검색해 선택한 뒤 Add를 선택해 해당 사용자들에게 User Manager 역할을 부여합니다.
mmctl permissions role assign system_user_manager user-name1 user-name2
사용자에게 Viewer 역할 부여
  1. System Console > User Management > Delegated Granular Administration으로 이동한 뒤 Viewer 역할을 선택합니다.
  2. Assigned People에서 Add People을 선택합니다.
  3. 사용자 이름을 검색해 선택한 뒤 Add를 선택해 해당 사용자에게 Viewer 역할을 부여합니다.
mmctl permissions role assign system_read_only_admin user-name
사용자 두 명에게 Custom Group Manager 역할 부여
  1. System Console > User Management > Delegated Granular Administration으로 이동한 뒤 Custom Group Manager 역할을 선택합니다.
  2. Assigned People에서 Add People을 선택합니다.
  3. 두 사용자를 검색해 선택한 뒤 Add를 선택해 해당 사용자들에게 Custom Group Manager 역할을 부여합니다.
  4. 기본적으로 모든 사용자는 맞춤 사용자 그룹을 만들 수 있습니다. Custom Group Manager 역할을 사용자에게 할당할 때는 System Console > User Management > Permissions > Edit Scheme으로 이동해 모든 사용자에게서 이 권한을 직접 제거해야 합니다. All Members에서 Create, Manage members, Edit, Delete를 포함한 Custom Groups 권한을 모두 해제하세요.
mmctl permissions role assign system_custom_group_admin user-name1 user-name2
사용자에게 Shared Channel Manager 역할 부여
  1. System Console > User Management > Delegated Granular Administration으로 이동한 뒤 Shared Channel Manager 역할을 선택합니다.
  2. Assigned People에서 Add People을 선택합니다.
  3. 사용자 이름을 검색해 선택한 뒤 Add를 선택해 해당 사용자에게 Shared Channel Manager 역할을 부여합니다.
mmctl permissions role assign system_shared_channel_manager user-name
사용자 한 명에게서 System Manager 역할 제거
  1. System Console > User Management > Delegated Granular Administration으로 이동한 뒤 System Manager 역할을 선택합니다.
  2. Assigned People에서 해당 사용자를 검색한 뒤 Remove를 선택합니다.
mmctl permissions role unassign system_manager bob-smith

관리자 역할의 권한 편집(고급)

시스템 관리자는 Custom Group Manager와 Shared Channel Manager 역할을 제외한 모든 시스템 역할에 대해, 시스템 콘솔의 다른 영역에 대한 읽기/쓰기 권한을 부여하거나 기본 권한을 포함한 읽기/쓰기 권한을 제거할 수 있습니다.

역할을 할당하는 방법은 두 가지입니다.

  1. 시스템 콘솔의 User Management > Delegated Granular Administration에서 할당합니다.
  2. mmctl 도구를 사용합니다. 로컬 또는 원격에서 모두 수행할 수 있습니다.
하려는 작업시스템 콘솔 사용mmctl 사용
역할 권한 편집
  1. System Console > User Management > Delegated Granular Administration으로 이동한 뒤 System Manager, User Manager 또는 Viewer 역할을 선택합니다.
  2. 각 권한 묶음에 대해 접근 수준을 Can edit, Read only, No access 중에서 선택합니다.
참고

하위 항목별로 접근 수준을 다르게 설정하면 해당 권한의 접근 수준이 Mixed Access로 표시됩니다.

mmctl permissions add [role_name] [permission...]
mmctl permissions reset system_read_only_admin
User Manager 역할을 가진 모든 사용자에게 시스템 콘솔 Authentication 섹션의 쓰기 권한 부여
  1. System Console > User Management > Delegated Granular Administration으로 이동한 뒤 User Manager 역할을 선택합니다.
  2. Privileges > Authentication에서 Can edit을 선택한 뒤 Save를 선택합니다.
mmctl permissions add system_user_manager sysconsole_write_authentication
User Manager 역할을 가진 모든 사용자에게 시스템 콘솔 Authentication 섹션의 읽기 전용 권한 부여
  1. System Console > User Management > Delegated Granular Administration으로 이동한 뒤 User Manager 역할을 선택합니다.
  2. Privileges > Authentication에서 Read only를 선택한 뒤 Save를 선택합니다.
mmctl permissions remove system_user_manager sysconsole_read_authentication
User Manager 역할을 가진 모든 사용자에게서 시스템 콘솔 Authentication 섹션의 쓰기 권한 제거
  1. System Console > User Management > Delegated Granular Administration으로 이동한 뒤 User Manager 역할을 선택합니다.
  2. Privileges > Authentication에서 No access를 선택한 뒤 Save를 선택합니다.
mmctl permissions remove system_user_manager sysconsole_write_authentication
역할을 기본 권한 집합으로 재설정 이 작업은 mmctl 도구로만 수행할 수 있습니다. mmctl permissions reset [role_name]
예를 들어 system_read_only_admin 역할의 권한을 재설정하려면 다음과 같이 실행합니다.
mmctl permissions reset system_read_only_admin

관리자 역할과 권한

역할

  • system_manager
  • system_user_manager
  • system_custom_group_admin
  • system_shared_channel_manager
  • system_read_only_admin

권한

시스템 콘솔 섹션권한
About
  • PERMISSION_SYSCONSOLE_READ_ABOUT_EDITION_AND_LICENSE
  • PERMISSION_SYSCONSOLE_WRITE_ABOUT_EDITION_AND_LICENSE
Reporting

System Statistics

  • PERMISSION_SYSCONSOLE_READ_REPORTING_SITE_STATISTICS
  • PERMISSION_SYSCONSOLE_WRITE_REPORTING_SITE_STATISTICS

Team Statistics

  • PERMISSION_SYSCONSOLE_READ_REPORTING_TEAM_STATISTICS
  • PERMISSION_SYSCONSOLE_WRITE_REPORTING_TEAM_STATISTICS

Server Logs

  • PERMISSION_SYSCONSOLE_READ_REPORTING_SERVER_LOGS
  • PERMISSION_SYSCONSOLE_WRITE_REPORTING_SERVER_LOGS
User Management

Users

  • PERMISSION_SYSCONSOLE_READ_USERMANAGEMENT_USERS
  • PERMISSION_SYSCONSOLE_WRITE_USERMANAGEMENT_USERS

Groups

  • PERMISSION_SYSCONSOLE_READ_USERMANAGEMENT_GROUPS
  • PERMISSION_SYSCONSOLE_WRITE_USERMANAGEMENT_GROUPS

Teams

  • PERMISSION_SYSCONSOLE_READ_USERMANAGEMENT_TEAMS
  • PERMISSION_SYSCONSOLE_WRITE_USERMANAGEMENT_TEAMS

Channels

  • PERMISSION_SYSCONSOLE_READ_USERMANAGEMENT_CHANNELS
  • PERMISSION_SYSCONSOLE_WRITE_USERMANAGEMENT_CHANNELS

Permissions

  • PERMISSION_SYSCONSOLE_READ_USERMANAGEMENT_PERMISSIONS
  • PERMISSION_SYSCONSOLE_WRITE_USERMANAGEMENT_PERMISSIONS
Environment

Web Server

  • PERMISSION_SYSCONSOLE_READ_ENVIRONMENT_WEB_SERVER
  • PERMISSION_SYSCONSOLE_WRITE_ENVIRONMENT_WEB_SERVER

Database

  • PERMISSION_SYSCONSOLE_READ_ENVIRONMENT_DATABASE
  • PERMISSION_SYSCONSOLE_WRITE_ENVIRONMENT_DATABASE

Elasticsearch

  • PERMISSION_SYSCONSOLE_READ_ENVIRONMENT_ELASTICSEARCH
  • PERMISSION_SYSCONSOLE_WRITE_ENVIRONMENT_ELASTICSEARCH

File Storage

  • PERMISSION_SYSCONSOLE_READ_ENVIRONMENT_FILE_STORAGE
  • PERMISSION_SYSCONSOLE_WRITE_ENVIRONMENT_FILE_STORAGE

Image Proxy

  • PERMISSION_SYSCONSOLE_READ_ENVIRONMENT_IMAGE_PROXY
  • PERMISSION_SYSCONSOLE_WRITE_ENVIRONMENT_IMAGE_PROXY

SMTP

  • PERMISSION_SYSCONSOLE_READ_ENVIRONMENT_SMTP
  • PERMISSION_SYSCONSOLE_WRITE_ENVIRONMENT_SMTP

Push Notification Server

  • PERMISSION_SYSCONSOLE_READ_ENVIRONMENT_PUSH_NOTIFICATION_SERVER
  • PERMISSION_SYSCONSOLE_WRITE_ENVIRONMENT_PUSH_NOTIFICATION_SERVER

High Availability

  • PERMISSION_SYSCONSOLE_READ_ENVIRONMENT_HIGH_AVAILABILITY
  • PERMISSION_SYSCONSOLE_WRITE_ENVIRONMENT_HIGH_AVAILABILITY

Rate Limiting

  • PERMISSION_SYSCONSOLE_READ_ENVIRONMENT_RATE_LIMITING
  • PERMISSION_SYSCONSOLE_WRITE_ENVIRONMENT_RATE_LIMITING

Logging

  • PERMISSION_SYSCONSOLE_READ_ENVIRONMENT_LOGGING
  • PERMISSION_SYSCONSOLE_WRITE_ENVIRONMENT_LOGGING

Session Lengths

  • PERMISSION_SYSCONSOLE_READ_ENVIRONMENT_SESSION_LENGTHS
  • PERMISSION_SYSCONSOLE_WRITE_ENVIRONMENT_SESSION_LENGTHS

Performance Monitoring

  • PERMISSION_SYSCONSOLE_READ_ENVIRONMENT_PERFORMANCE_MONITORING
  • PERMISSION_SYSCONSOLE_WRITE_ENVIRONMENT_PERFORMANCE_MONITORING

Developer

  • PERMISSION_SYSCONSOLE_READ_ENVIRONMENT_DEVELOPER
  • PERMISSION_SYSCONSOLE_WRITE_ENVIRONMENT_DEVELOPER
Site Configuration

Customization

  • PERMISSION_SYSCONSOLE_READ_SITE_CUSTOMIZATION
  • PERMISSION_SYSCONSOLE_WRITE_SITE_CUSTOMIZATION

Localization

  • PERMISSION_SYSCONSOLE_READ_SITE_LOCALIZATION
  • PERMISSION_SYSCONSOLE_WRITE_SITE_LOCALIZATION

Users and Teams

  • PERMISSION_SYSCONSOLE_READ_SITE_USERS_AND_TEAMS
  • PERMISSION_SYSCONSOLE_WRITE_SITE_USERS_AND_TEAMS

Notifications

  • PERMISSION_SYSCONSOLE_READ_SITE_NOTIFICATIONS
  • PERMISSION_SYSCONSOLE_WRITE_SITE_NOTIFICATIONS

Announcement Banner

  • PERMISSION_SYSCONSOLE_READ_SITE_ANNOUNCEMENT_BANNER
  • PERMISSION_SYSCONSOLE_WRITE_SITE_ANNOUNCEMENT_BANNER

Emoji

  • PERMISSION_SYSCONSOLE_READ_SITE_EMOJI
  • PERMISSION_SYSCONSOLE_WRITE_SITE_EMOJI

Posts

  • PERMISSION_SYSCONSOLE_READ_SITE_POSTS
  • PERMISSION_SYSCONSOLE_WRITE_SITE_POSTS

File Sharing and Downloads

  • PERMISSION_SYSCONSOLE_READ_SITE_FILE_SHARING_AND_DOWNLOADS
  • PERMISSION_SYSCONSOLE_WRITE_SITE_FILE_SHARING_AND_DOWNLOADS

Public Links

  • PERMISSION_SYSCONSOLE_READ_SITE_PUBLIC_LINKS
  • PERMISSION_SYSCONSOLE_WRITE_SITE_PUBLIC_LINKS

Notices

  • PERMISSION_SYSCONSOLE_READ_SITE_NOTICES
  • PERMISSION_SYSCONSOLE_WRITE_SITE_NOTICES
Authentication

Signup

  • PERMISSION_SYSCONSOLE_READ_AUTHENTICATION_SIGNUP
  • PERMISSION_SYSCONSOLE_WRITE_AUTHENTICATION_SIGNUP

Email

  • PERMISSION_SYSCONSOLE_READ_AUTHENTICATION_EMAIL
  • PERMISSION_SYSCONSOLE_WRITE_AUTHENTICATION_EMAIL

Password

  • PERMISSION_SYSCONSOLE_READ_AUTHENTICATION_PASSWORD
  • PERMISSION_SYSCONSOLE_WRITE_AUTHENTICATION_PASSWORD

MFA

  • PERMISSION_SYSCONSOLE_READ_AUTHENTICATION_MFA
  • PERMISSION_SYSCONSOLE_WRITE_AUTHENTICATION_MFA

AD/LDAP

  • PERMISSION_SYSCONSOLE_READ_AUTHENTICATION_MFA
  • PERMISSION_SYSCONSOLE_WRITE_AUTHENTICATION_MFA

SAML 2.0

  • PERMISSION_SYSCONSOLE_READ_AUTHENTICATION_SAML
  • PERMISSION_SYSCONSOLE_WRITE_AUTHENTICATION_SAML

OpenID Connect

  • PERMISSION_SYSCONSOLE_READ_AUTHENTICATION_OPENID
  • PERMISSION_SYSCONSOLE_WRITE_AUTHENTICATION_OPENID

Guest Access

  • PERMISSION_SYSCONSOLE_READ_AUTHENTICATION_GUEST_ACCESS
  • PERMISSION_SYSCONSOLE_WRITE_AUTHENTICATION_GUEST_ACCESS
Plugin
  • PERMISSION_SYSCONSOLE_READ_PLUGINS
  • PERMISSION_SYSCONSOLE_WRITE_PLUGINS
Integrations

Integration Management

  • PERMISSION_SYSCONSOLE_READ_INTEGRATIONS_INTEGRATION_MANAGEMENT
  • PERMISSION_SYSCONSOLE_WRITE_INTEGRATIONS_INTEGRATION_MANAGEMENT

Bot Accounts

  • PERMISSION_SYSCONSOLE_READ_INTEGRATIONS_BOT_ACCOUNTS
  • PERMISSION_SYSCONSOLE_WRITE_INTEGRATIONS_BOT_ACCOUNTS

GIF (Beta)

  • PERMISSION_SYSCONSOLE_READ_INTEGRATIONS_GIF
  • PERMISSION_SYSCONSOLE_WRITE_INTEGRATIONS_GIF

CORS

  • PERMISSION_SYSCONSOLE_READ_INTEGRATIONS_CORS
  • PERMISSION_SYSCONSOLE_WRITE_INTEGRATIONS_CORS
Compliance

Data Retention Policy

  • PERMISSION_SYSCONSOLE_READ_COMPLIANCE_DATA_RETENTION_POLICY
  • PERMISSION_SYSCONSOLE_WRITE_COMPLIANCE_DATA_RETENTION_POLICY

Compliance Export

  • PERMISSION_SYSCONSOLE_READ_COMPLIANCE_COMPLIANCE_EXPORT
  • PERMISSION_SYSCONSOLE_WRITE_COMPLIANCE_COMPLIANCE_EXPORT

Compliance Monitoring

  • PERMISSION_SYSCONSOLE_READ_COMPLIANCE_COMPLIANCE_MONITORING
  • PERMISSION_SYSCONSOLE_WRITE_COMPLIANCE_COMPLIANCE_MONITORING

Custom Terms of Service

  • PERMISSION_SYSCONSOLE_READ_COMPLIANCE_CUSTOM_TERMS_OF_SERVICE
  • PERMISSION_SYSCONSOLE_WRITE_COMPLIANCE_CUSTOM_TERMS_OF_SERVICE
Experimental

Features

  • PERMISSION_SYSCONSOLE_READ_EXPERIMENTAL_FEATURES
  • PERMISSION_SYSCONSOLE_WRITE_EXPERIMENTAL_FEATURES

Feature Flags

  • PERMISSION_SYSCONSOLE_READ_EXPERIMENTAL_FEATURE_FLAGS
  • PERMISSION_SYSCONSOLE_WRITE_EXPERIMENTAL_FEATURE_FLAGS

Bleve

  • PERMISSION_SYSCONSOLE_READ_EXPERIMENTAL_BLEVE
  • PERMISSION_SYSCONSOLE_WRITE_EXPERIMENTAL_BLEVE

자주 묻는 질문

User Manager나 System Manager가 관리자 모르게 관리자의 이메일이나 비밀번호를 재설정할 수 있나요?

이 역할들의 기본 권한으로는 불가능합니다. 관리자의 비밀번호나 이메일 주소를 재설정하는 권한은 시스템 관리자로 한정됩니다.

User Manager나 System Manager가 구성 파일에 접근할 수 있나요?

네. 다만 자신의 권한 범위 내에서만 실제 값을 읽고 값을 수정할 수 있습니다. 적절한 읽기 권한이 없으면 기본 키 값이 표시됩니다.

관리자 역할의 모든 동작이 로그로 남나요?

모든 관리자가 수행한 모든 변경 사항은 감사 로그에 포함됩니다.

System Manager가 자신의 권한을 변경하거나 역할을 상향할 수 있나요?

아니요. System Manager는 자신의 역할을 상향할 수 없으며 다른 구성원의 역할도 상향할 수 없습니다.

새 역할 중 시스템 콘솔 안의 API 키·비밀번호나 그 밖의 민감 정보(SMTP, AWS, Elastic Search 등)를 볼 수 있는 역할이 있나요?

아니요. 비밀번호 정보는 시스템 관리자에게만 보이며 다른 역할에는 가려져 표시됩니다.

System Console > Compliance에 대한 접근 권한이 명시적으로 부여된 역할만 컴플라이언스 보고서를 내려받을 수 있습니다.

새 역할 중 비공개 채널에 강제로 참여할 수 있는 역할이 있나요?

현재는 가능합니다. 다만 앞으로는 비공개 채널에 들어가고 있음을 알려 주는 안내를 추가해 이 동작을 개선할 예정입니다. 또한 비공개 채널 접근 권한을 제거할 수 있는 권한을 추가하는 것도 계획하고 있습니다.

새 역할을 만들거나 기존 역할을 복제할 수 있나요?

아니요. 다만 이 기능에 대한 의견을 적극적으로 수렴하고 있습니다.

LDAP 필터로 이 역할들을 할당할 수 있나요?

아니요. 다만 향후 개선 사항으로 검토하고 있습니다.

역할 이름을 바꿀 수 있나요?

향후 개발 과제로 검토하고 있습니다.

System Manager나 User Manager가 다른 관리자나 매니저를 강등하거나 비활성화할 수 있나요?

System Manager 또는 User Manager는 다른 System Manager나 User Manager를 강등하거나 비활성화할 수 있지만, 시스템 관리자는 강등하거나 비활성화할 수 없습니다.

System Manager나 User Manager가 관리자 역할을 할당하거나 해제할 수 있나요?

시스템 역할을 편집할 수 있는 권한은 시스템 관리자에게만 있습니다.