데이터 액세스¶
데이터 액세스는 멤버 역할에 따라 로그, RUM, APM, 메트릭, 이벤트 등 데이터의 가시 범위를 제한하고, 필드 마스킹 또는 정규 표현식을 통해 민감한 정보를 보호하는 데 사용합니다.
구성하기 전에 다음 세 가지 유형의 권한과 규칙을 구분해야 합니다.
- 역할 쿼리 권한: 멤버가 해당 유형의 데이터를 쿼리할 수 있는지 결정합니다. 자세한 내용은 권한 목록을 참고하세요.
- 데이터 액세스 범위: 멤버가 이미 보유한 쿼리 권한을 기반으로, 데이터 유형, 인덱스, 서비스, 애플리케이션, 메트릭, 이벤트 소스 및 필터 조건을 통해 조회 가능한 데이터를 한정합니다.
- 마스킹 설정: 반환되는 데이터에서 민감한 필드 또는 정규 표현식과 일치하는 내용을 마스킹합니다.
역할에 데이터 액세스 규칙을 연결해도 해당 역할이 원래 보유하지 않은 데이터 쿼리 권한이 부여되지는 않습니다. 데이터 범위와 마스킹의 적용 방식은 역할 시나리오 및 쿼리 권한을 함께 참고하여 판단해야 합니다.
관리 > 데이터 액세스 페이지에서 다음 두 가지 방법으로 새 규칙 생성을 시작할 수 있습니다.
페이지 좌측 상단의 규칙 생성 버튼을 클릭하여 생성을 시작합니다.
현재 페이지에 기존 액세스 규칙이 있는 경우, 해당 규칙 오른쪽 작업의 아이콘을 클릭하여 기존 규칙을 복제한 후 생성할 수 있습니다.
구성 시작¶
- 데이터 유형을 선택합니다. 로그, APM, RUM, 메트릭 및 이벤트를 지원합니다.
- 현재 규칙의 이름을 정의합니다.
- 현재 규칙의 설명을 입력합니다.
- 현재 규칙을 적용할 워크스페이스 사이트를 선택합니다.
-
선택한 데이터 유형에 따라 해당하는 인덱스, 서비스, 애플리케이션, 메트릭 또는 이벤트 소스를 선택합니다.
-
현재 규칙 하에서 데이터의 액세스 범위를 정의합니다.
-
마스킹할 단일 또는 여러 필드를 추가합니다.
-
정규 표현식을 활용하여 필드 내용 중 민감한 정보를 마스킹합니다.
-
현재 액세스 규칙을 적용할 단일 또는 여러 멤버 역할을 선택합니다. 시스템 내 기본 역할 및 사용자 정의 역할을 포함합니다.
- 저장합니다.
구성 시 유의 사항¶
데이터 액세스 범위 정의¶
데이터 범위는 현재 규칙에서 조회를 허용하는 데이터를 정의합니다. 이 규칙이 적용되면 반환 결과는 해당 필터 조건을 충족해야 하며, 여러 역할 또는 여러 규칙이 동시에 연결된 경우 아래의 권한 병합 방식을 함께 고려하여 최종 가시 범위를 판단해야 합니다.
태그/속성으로 필터를 구성할 수 있으며, 정방향 필터, 역방향 필터, 부분 일치, 역방향 부분 일치, 존재 및 미존재를 지원합니다.
서로 다른 필드 간에는 기본적으로 모두 (AND) 가 적용되며, 하나 이상 (OR) 으로 전환할 수도 있습니다.
| 논리 관계 | 매칭 방식 | 예시 |
|---|---|---|
| 모두 (AND), 기본값 | 각 필드의 필터 조건을 동시에 충족 | host = [host1, host2] AND service = [service1, service2] |
| 하나 이상 (OR) | 어느 하나의 필드 필터 조건을 충족 | host = [host1, host2] OR service = [service1, service2] |
위 예시에서 host = [host1, host2]는 host가 host1 또는 host2임을 의미합니다. 단일 규칙 내부의 AND/OR 설정과 여러 규칙 간의 병합 관계는 각각 판단해야 합니다.
정규 표현식 마스킹¶
액세스 규칙을 설정할 때 데이터 범위를 이미 정의했더라도, 민감하거나 불필요한 정보의 유출을 방지하기 위한 추가 조치가 필요합니다. 이때 마스킹 필드 또는 정규 표현식을 활용하여 데이터를 추가로 처리함으로써 데이터 보호를 강화할 수 있습니다.
구성 페이지에서는 단일 마스킹 필드를 직접 추가하는 것 외에도, 로그 message 내의 특정 부분을 추가로 마스킹해야 하는 경우(예: token 또는 IP 정보를 표시하지 않음) 정규 표현식을 추가하여 요구 사항을 충족할 수 있습니다.
- 여러 정규 표현식을 구성할 수 있으며, 하나의 액세스 규칙에는 최대 10개의 표현식을 구성할 수 있습니다.
- 특정 정규 표현식을 비활성화하거나 활성화할 수 있으며, 이후 적용 및 미리보기는 활성화된 정규 표현식에 따라서만 마스킹을 적용합니다.
- 여기에서 특정 정규 표현식을 직접 편집하거나 삭제할 수 있습니다.
- 드래그하여 정규 표현식의 위치를 이동할 수 있으며, 데이터가 이 마스킹 규칙에 매칭되면 위에서 아래 순서대로 정규 표현식을 적용하여 마스킹을 처리합니다.
- 여기에서 정규 표현식을 직접 생성할 수 있습니다.
팝업 창에서 필요한 정보를 입력합니다.
규칙에 적용을 체크하면 해당 규칙이 정규 표현식 아래에 바로 추가됩니다.
역할 시나리오 및 쿼리 권한¶
단순한 경우¶
특정 멤버가 Read-only와 같이 하나의 역할만 보유한다고 가정합니다. 규칙을 해당 역할에 적용하면, 멤버는 기존 데이터 쿼리 권한을 기반으로 규칙에 따라 쿼리 범위가 한정되고 마스킹이 적용됩니다.
적용 역할로 "전체"를 선택하면 해당 규칙은 Owner를 제외한 모든 역할에 적용되며, Administrator도 포함됩니다.
역할별 적용 방식은 다음과 같습니다.
| 역할과 규칙 연결 상황 | 데이터 액세스 규칙의 적용 방식 |
|---|---|
| Owner | 데이터 액세스 규칙의 제한을 받지 않습니다. |
| Administrator가 규칙에 연결됨 | 연결된 규칙에 따라 데이터 범위가 제한되고 마스킹이 적용됩니다. |
| Administrator가 규칙에 연결되지 않음 | 기존 권한 범위 내에서 데이터를 조회할 수 있으며, "데이터 액세스 범위 제한" 스위치의 영향을 받지 않습니다. |
| 기타 멤버가 규칙과 매칭됨 | 해당 데이터 쿼리 권한을 보유한 전제하에, 규칙에 따라 데이터 범위가 제한되고 마스킹이 적용됩니다. |
| 기타 멤버가 어떤 규칙과도 매칭되지 않음 | 규칙에 해당하는 데이터 조회 허용 여부는 "데이터 액세스 범위 제한" 스위치에 따라 결정됩니다. 활성화하면 이러한 멤버는 규칙에 해당하는 데이터를 조회할 수 없습니다. |
적용 중인 규칙이 한정하는 데이터 범위 내에서 멤버는 쿼리 필터 조건을 계속 추가할 수 있으며, 가시 범위를 초과한 쿼리는 데이터를 반환하지 않습니다.
다중 역할 권한 적용¶
동일한 멤버가 여러 역할을 보유한 경우, 최종적으로 조회 가능한 데이터 범위는 각 역할이 조회 가능한 범위의 합집합입니다.
따라서 멤버의 실제 가시 범위를 판단할 때는 해당 멤버의 모든 역할과 연결된 규칙을 함께 확인해야 하며, 그중 하나의 규칙만으로 결론을 내려서는 안 됩니다.
다중 규칙 권한 제어¶
동일한 역할에 여러 데이터 액세스 규칙을 연결할 수 있습니다. 구성 시 다음 두 가지 병합 관계를 각각 판단해야 합니다.
- 단일 규칙 내부: 서로 다른 필드 간에는 해당 규칙에서 선택한 "모두 (AND)" 또는 "하나 이상 (OR)"으로 조합하며, 기본값은 AND입니다.
- 여러 규칙 간: 데이터 범위를 OR로 병합합니다. 즉, 멤버는 어느 한 규칙에서 허용하는 데이터를 조회할 수 있습니다.
예를 들어, 규칙 1과 규칙 2가 모두 "모두 (AND)"를 사용하는 경우:
- 규칙 1:
host = [호스트1, 호스트2] AND service = [서비스1, 서비스2] - 규칙 2:
host = [호스트3, 호스트4] AND source = [소스1, 소스2]
동일한 역할에 위 두 규칙을 연결하면 가시 데이터 범위는 다음과 같습니다.
(host = [호스트1, 호스트2] AND service = [서비스1, 서비스2]) OR (host = [호스트3, 호스트4] AND source = [소스1, 소스2])
데이터 범위 병합 및 마스킹
데이터 범위는 합집합으로 병합되며, 마스킹 설정은 반환 데이터에 그대로 적용됩니다. 동일한 역할에 여러 규칙이 연결된 경우, 그중 하나의 규칙에 마스킹이 구성되어 있으면 연결된 모든 규칙이 반환하는 데이터가 해당 마스킹 설정의 영향을 받습니다.
역할 관리에서 연결 유지¶
데이터 액세스 규칙에서 적용 역할을 선택하는 것 외에도, 관리 > 역할 관리에서 역할에 연결된 데이터 액세스 규칙을 통합적으로 확인하고 유지 관리할 수 있습니다.
- 역할 목록의 데이터 액세스 규칙 열은 현재 역할에 연결된 규칙 수를 표시합니다.
- 숫자를 클릭하거나 마우스를 올리면 오른쪽 드로어에서 규칙을 검색하고 페이지 단위로 선택하여 연결을 저장할 수 있으며, 데이터 액세스 페이지로 이동하여 구성을 계속할 수도 있습니다.
- 이 진입점은 역할과 규칙의 연결만 유지 관리하며, 규칙의 데이터 범위, 필터 조건, 데이터 유형 또는 마스킹 설정은 수정하지 않습니다.
- 규칙 저장이 완료되면 역할 목록의 연결 수가 동기화되어 업데이트됩니다.
이 연결의 조회와 편집은 각각 역할 조회, 데이터 액세스 조회 및 데이터 액세스 관리 권한의 제어를 받습니다. 자세한 설명은 역할 관리를 참고하세요.
구성 예시¶
- 본 워크스페이스의 인덱스
rp70을 선택합니다. - 데이터 범위에서 모두 (AND) 를 선택하고
host:cn-hangzhou.172.**.**및service:kodo두 가지 필터 조건을 추가합니다. - 여기에서는 마스킹 필드를 설정하지 않고 정규 표현식
tkn_[\da-z]*를 추가하여 매칭되는token내용을 마스킹합니다. - 현재 규칙을 워크스페이스의
Read-only역할에 연결합니다. - 저장을 클릭합니다. 필요한 경우 좌측 하단의 미리보기를 클릭하여 마스킹 효과를 확인할 수 있습니다.
이 규칙을 통해 Read-only 멤버는 로그 인덱스 rp70에서 위 host 및 service 조건을 동시에 충족하는 데이터를 조회할 수 있으며, 정규 표현식과 매칭되는 token 내용은 구성에 따라 마스킹됩니다.
멤버가 다른 역할을 함께 보유하거나 해당 역할에 다른 데이터 액세스 규칙이 연결되어 있는 경우, 최종 가시 범위는 다중 역할 및 다중 규칙의 병합 방식을 함께 고려하여 판단해야 합니다.
사용 사례¶
이미 적용 중인 데이터 액세스 규칙을 기반으로, 규칙에 해당하는 멤버가 수신하는 스냅샷 데이터는 해당 멤버의 권한 규칙에 따라 자동으로 필터링됩니다. 스냅샷에 포함된 데이터가 멤버의 액세스 권한을 초과하더라도 시스템이 먼저 필터링하므로, 최종적으로 멤버는 자신의 액세스 규칙에 부합하는 데이터만 조회할 수 있습니다.
목록 관리¶
- 규칙에 연결된 인덱스, 쿼리 조건, 마스킹 여부, 연결된 역할 수 및 멤버 수 등의 정보를 확인할 수 있으며, 역할 관리에서 역할별로 연결 규칙을 확인하고 유지 관리할 수도 있습니다.
- 나와 관련된 규칙만 표시: 기본값은 "비활성화"이며 모든 규칙을 표시합니다. 활성화하면 현재 역할과 관련된 규칙만 표시합니다.
- 규칙 활성화/비활성화: 활성화하면 규칙이 데이터 범위 제한과 마스킹에 참여합니다. 비활성화하면 해당 규칙은 더 이상 적용되지 않습니다. 멤버가 실제로 조회할 수 있는 데이터는 여전히 역할 권한, 다른 적용 중인 규칙 및 "데이터 액세스 범위 제한" 설정을 함께 고려하여 판단해야 합니다.
- 편집: 규칙의 이름, 설명, 바인딩된 인덱스, 필터 조건 및 권한 부여 역할을 수정할 수 있습니다.
- 복제: 현재 규칙을 빠르게 복사합니다.
- 작업 감사: 규칙과 관련된 작업을 기록합니다.
- 삭제: 현재 규칙을 삭제합니다.
- 일괄 작업: 여러 규칙의 일괄 활성화, 비활성화 및 삭제를 지원합니다.





