속성 관리
Mattermost v12.0요약
Mattermost v12.0부터 속성 관리에서 속성을 한 번 정의한 다음, 해당 속성을 사용할 수 있는 리소스를 선택합니다. 여기에서 정의한 속성은 속성 기반 접근 제어(ABAC) 정책에서 참조하는 속성입니다(예: user.attributes.department).
사용 가능 플랜: Enterprise, Enterprise Advanced
Mattermost v12.0부터 속성 관리에서 속성을 한 번 정의한 다음, 해당 속성을 사용할 수 있는 리소스를 선택합니다. Department나 Clearance 같은 속성은 표시 이름, 이름, 유형, 옵션, 선택적인 AD/LDAP 또는 SAML 소스로 이루어진 단일 정의를 가지며, 이 정의는 속성이 적용되는 모든 리소스가 공유합니다. Attribute Management는 이전 릴리즈에서 사용하던 사용자 속성 페이지를 대체합니다. v12.0 이전 서버는 사용자 속성을 참조하세요.
여기에서 정의한 속성은 속성 기반 접근 제어(ABAC) 정책에서 참조하는 속성입니다(예: user.attributes.department).
Attribute Management를 열려면 System Console > System Attributes > Attribute Management로 이동합니다. 시스템 관리자만 속성을 만들거나 편집하거나 삭제할 수 있습니다.
v12.0으로 업그레이드: 기존 사용자 속성#
Enterprise 또는 Enterprise Advanced 라이선스가 있는 Mattermost v12.0 서버가 처음 시작될 때, 기존 사용자 속성이 각각 Attribute Management에서 사용자에게 적용되는 속성으로 변환됩니다. 이 변환은 한 번만 실행되며 되돌릴 수 없습니다.
변환 후에는 다음과 같습니다.
- 사용자 속성의 이름, ID, 사용자 값은 변경되지 않으므로
user.attributes.<name>을 참조하는 기존 ABAC 정책은 계속 작동합니다. - 옵션, 표시 여부, 값을 설정할 수 있는 대상, AD/LDAP 또는 SAML 매핑이 그대로 이어집니다.
- 기존 이름이 유효한 속성 이름이 아니거나 이미 다른 속성에서 사용 중이면, 새 정의에는 조정된 이름이 부여됩니다. 사용자 속성은 원래 이름을 유지하므로 정책에는 영향이 없습니다.
- 플러그인이 만든 속성과 보호된 속성은 변환되지 않습니다.
서버가 시작될 때 라이선스가 없으면 변환은 건너뛰며, 이후 라이선스를 적용하고 재시작할 때 실행됩니다.
속성 검토#
Attribute Management 페이지에는 모든 속성이 표시 이름 기준 알파벳순으로 나열됩니다. 속성 검색을 사용하여 표시 이름, 이름 또는 유형으로 필터링합니다. 행을 선택하면 속성을 편집할 수 있습니다.
| 칼럼 | 표시 내용 |
|---|---|
| 속성 | 표시 이름입니다. |
| 유형 | 텍스트 또는 선택과 같은 속성 유형입니다. |
| 적용 대상 | 사용자나 채널처럼 속성을 사용하는 리소스입니다. |
| 소스 | 값의 출처입니다: 여기서 관리, AD/LDAP, SAML 또는 속성을 소유한 플러그인의 이름입니다. |
| 옵션 | 옵션의 수이며, 미리 정해진 값이 없는 유형은 자유 텍스트로 표시됩니다. |
분류 표시에서 사용하는 분류 속성은 정의가 읽기 전용입니다로 표시됩니다. 해당 행에서 분류 표시 열기를 선택하여 Classification Markings 페이지에서 수준을 관리합니다.
플러그인이 만들고 소유한 속성은 Attribute Management에서 읽기 전용이며, 플러그인이 설치되어 있는 동안에는 삭제할 수 없습니다. 플러그인을 제거한 후에는 해당 속성을 삭제할 수 있습니다.
속성 만들기#
- 새 속성을 선택합니다.
- 정의 섹션에서 다음 세부 정보를 입력합니다.
- 표시 이름: 관리자와 사용자에게 보이는 레이블입니다. 최대 40자입니다.
- 고유 이름: 표시 이름에서 생성됩니다. 편집을 선택하여 변경합니다. 이 이름은 접근 제어 정책과 연동에서 사용하는 내부 식별자이며 고유해야 합니다. 문자 또는 밑줄로 시작해야 하고 문자, 숫자, 밑줄만 포함할 수 있습니다. 예약된 CEL 단어는 사용할 수 없습니다:
true,false,null,in,as,break,const,continue,else,for,function,if,import,let,loop,package,namespace,return,var,void,while. - 유형: 다음 중 하나를 선택합니다.
- 텍스트: 각 리소스에 직접 입력하는 값입니다.
- 전화번호: 전화번호입니다.
- URL: 웹 주소입니다.
- 선택: 옵션 목록에서 선택한 단일 값입니다.
- 다중 선택: 옵션 목록에서 선택한 하나 이상의 값입니다.
- 순위 지정: 각 옵션이 다른 옵션보다 높거나 낮은 순위를 갖는 정렬된 목록에서 선택한 단일 값입니다(예: Public, Secret, Top Secret). 옵션이 정렬되어 있으므로 접근 제어 정책은 순위 지정 속성을 임계값과 비교할 수 있습니다. 예를 들어 보안 등급이 최소 Secret 이상인 경우입니다.
- 계층형: 부모와 자식으로 구성된 값이며, 값당 부모는 최대 100개, 깊이는 최대 100단계입니다.
PropertyFieldGraph기능 플래그가 활성화되어 있고 속성을 만들 때만 사용할 수 있습니다. 계층형 속성은 다른 유형으로 변환할 수 없습니다.
- 옵션: 선택, 다중 선택, 순위 지정 속성의 경우 각 옵션을 입력하고 Enter 또는 Tab을 누릅니다. 옵션을 제공하는 외부 소스에 연결된 속성이 아닌 한 옵션이 하나 이상 필요합니다. 옵션은 최대 64자이며 고유해야 합니다. 옵션을 선택하면 이름을 바꾸거나, 다른 위치로 옮기거나, 제거할 수 있습니다. 순위 지정 속성의 옵션은 가장 낮은 순위부터 가장 높은 순위 순으로 표시되며, 옵션을 선택하여 순위를 변경합니다.
- 선택적으로 속성을 외부 소스에 연결합니다.
- 적용 대상 섹션에서 리소스 추가를 선택하고 속성이 적용되는 리소스를 선택합니다.
- 저장을 선택합니다.
속성은 총 200개까지 정의할 수 있으며, 이 중 사용자에게 적용할 수 있는 속성은 최대 20개입니다.
속성을 AD/LDAP 또는 SAML에 연결#
속성의 사용자 값을 Mattermost에서 관리하는 대신 ID 공급자(IdP)에서 동기화합니다. AD/LDAP 또는 SAML 동기화가 이미 구성되어 있어야 합니다. 자세한 내용은 AD/LDAP 그룹 또는 SAML 2.0을 참조하세요.
- 정의 섹션에서 외부 소스에 연결을 선택한 다음 AD/LDAP 또는 SAML을 선택합니다.
- 값을 동기화할 AD/LDAP 디렉터리 또는 SAML 응답의 속성 이름을 입력한 다음 저장합니다.
같은 속성에 AD/LDAP와 SAML을 모두 연결할 수 있습니다. 연결된 소스는 동기화 대상에 나열됩니다.
Mattermost v12.1부터 선택 및 다중 선택 속성은 연결해도 유형이 유지됩니다.
- 선택 속성은 ID 공급자가 보내는 첫 번째 값을 저장하고, 다중 선택 속성은 사용자가 속한 각 그룹처럼 모든 값을 저장합니다.
- 동기화가 옵션을 관리합니다. 동기화가 보내는 새 값은 옵션으로 추가되며 최대 500개까지입니다. 더 이상 어떤 사용자나 채널도 갖고 있지 않은 옵션은, 속성이 연결되기 전에 추가된 옵션을 포함하여 제거됩니다. 속성이 연결되어 있는 동안에는 Mattermost에서 옵션을 추가하거나, 이름을 바꾸거나, 제거할 수 없습니다.
- 옵션은 사용자에게 동기화된 값에서 가져오므로 속성은 사용자에게 적용되어야 합니다. 연결된 선택 또는 다중 선택 속성은 사용자에게 적용되기 전에는 저장할 수 없습니다.
- 외부 소스를 연결해도 텍스트, 전화번호, URL, 선택, 다중 선택 속성의 유형은 유지됩니다. 그 외의 유형은 텍스트로 변경됩니다. v12.1 이전에는 연결하면 모든 유형이 텍스트로 변경됩니다.
- 속성이 리소스에 적용되어 있는 동안에는 유형을 변경할 수 없으므로, 유형이 유지되는 속성에만 외부 소스를 연결할 수 있습니다.
- 외부 소스에서 동기화된 값은 사용자에게만 적용되며, 사용자는 Mattermost에서 이 값을 편집할 수 없습니다. 사용자 리소스 설정에서 관리 주체에 소스가 표시됩니다.
- ID 공급자가 사용자의 값을 더 이상 보내지 않으면 다음 동기화에서 Mattermost의 해당 사용자에게서 그 값이 제거됩니다. 길이 제한을 초과하는 값이나 500개 옵션 제한을 넘는 옵션이 필요한 값처럼 Mattermost가 저장할 수 없는 값도 같은 방식으로 사용자의 이전 값을 제거하므로, 오래된 값이 접근 제어 정책을 계속 충족하는 일은 없습니다.
속성이 적용되는 리소스 선택#
추가하는 각 리소스에는 고유한 설정이 있습니다. 리소스를 선택하면 설정이 펼쳐지고, 리소스 제거를 선택하면 리소스가 제거됩니다.
사용자#
- 프로필 표시: 속성이 사용자 프로필에 표시되는지 여부를 제어합니다: 항상, 값이 있을 때(기본값) 또는 숨김.
- 값을 설정할 수 있는 대상: 멤버는 사용자가 자신의 값을 직접 설정할 수 있으며 시스템 관리자도 값을 변경할 수 있습니다. 시스템 관리자는 값을 시스템 관리자와 ID 공급자 동기화로 제한합니다.
접근 제어 정책에 사용되는 속성은 시스템 관리자가 설정하거나 ID 공급자에서 동기화해야 합니다. 사용자는 이 값을 직접 변경할 수 없으므로 스스로 접근 권한을 부여할 수 없습니다. 기본적으로 ABAC 규칙은 사용자가 직접 설정할 수 있는 속성을 제외하며, EnableUserManagedAttributes가 활성화된 경우는 예외입니다. 자세한 내용은 사용자 속성을 참조하세요.
개별 사용자의 값을 보거나 업데이트하려면 사용자 속성 관리를 참조하세요.
채널#
사용 가능 플랜: Enterprise Advanced
채널은 ChannelAttributes 기능 플래그가 활성화된 경우에만 사용할 수 있습니다. 관리자만 채널 값을 설정할 수 있습니다.
- 값 변경: 채널의 값을 설정한 후 어떻게 변경할 수 있는지 제어합니다.
- 언제든지 변경 가능(기본값)
- 높이기만 가능, 낮출 수 없음(순위 지정 속성만 해당)
- 낮추기만 가능, 높일 수 없음(순위 지정 속성만 해당)
- 설정 후 변경 불가
- 표시 위치: 채널에서 값이 표시되는 위치입니다: 헤더, 채널 정보 또는 배너. 둘 이상의 위치를 선택할 수 있습니다. 값은 항상 채널 정보에 표시됩니다.
- 필수: 활성화하면 채널을 만들기 전에 이 속성의 값이 있어야 합니다.
ChannelAttributesRequired기능 플래그도 활성화된 경우에만 사용할 수 있습니다.
속성 편집#
속성의 행을 선택하거나 더 보기 > 속성 편집을 선택하고, 변경한 다음 저장을 선택합니다.
- 속성이 리소스에 적용되어 있는 동안에는 고유 이름과 유형을 변경할 수 없습니다. 변경하려면 모든 리소스를 제거하고 저장해야 하며, 이 경우 속성에 저장된 모든 값이 영구적으로 삭제됩니다. 이후에 리소스를 다시 추가해도 해당 값은 복원되지 않습니다. 리소스를 제거하기 전에 유지해야 하는 값을 기록해 두어 다시 설정할 수 있도록 하세요.
- 표시 이름을 변경하면 해당 리소스의 레이블이 별도로 사용자 지정되지 않은 경우 새 이름이 속성을 사용하는 각 리소스에도 적용됩니다.
- 옵션 변경은 속성을 사용하는 모든 리소스에 적용됩니다.
적용 대상에서 리소스를 제거하면 해당 리소스에서 속성에 저장된 모든 값이 영구적으로 삭제됩니다. Mattermost는 제거 후 저장으로 확인하도록 요청합니다. 이 작업은 실행 취소할 수 없습니다.
속성 삭제#
- 속성의 행에서 더 보기 > 속성 삭제를 선택합니다.
- 삭제를 선택하여 확인합니다.
속성을 삭제하면 해당 정의가 영구적으로 제거되며 실행 취소할 수 없습니다. 속성이 아직 리소스에 적용되어 있는 동안에는 삭제할 수 없습니다. 속성을 편집하여 적용 대상에서 모든 리소스를 제거하고 저장한 다음 삭제하세요.
속성 접근 모드#
Attribute Management에서 만든 속성은 public 접근 모드를 사용하므로, 해당 속성을 참조하는 정책을 편집하는 모든 관리자에게 값이 표시됩니다. 플러그인은 제한된 접근 모드로 속성을 만들 수 있습니다. 자세한 내용은 속성 접근 모드를 참조하세요.