계정 | 로그프레소 소나 사용자 인터페이스 설명서

계정

개요

계정은 로그프레소 소나에 사용자를 등록하고 관리하는 기능을 제공합니다. 모든 사용자는 자신의 계정에 주어진 역할과 접근 권한이 부여된 데이터의 범위 안에서 웹 콘솔과 REST API를 이용할 수 있습니다.

계정 역할

계정 역할은 다음과 같습니다.

클러스터 관리자

로그프레소 소나의 모든 기능을 사용할 수 있는 최상위 역할입니다. 웹 인스톨러의 클러스터 관리자 등록 단계에서 만든 첫 계정이 이 역할을 갖습니다. 다음 작업은 클러스터 관리자만 할 수 있습니다.

시스템 메뉴의 클러스터, 성능 모니터, 라이선스, 메일 서버, 소명 템플릿, 쿼리 모니터, 감사 로그, 시스템 로그, 인증서, 패키지 사용
파서, 로그 스키마, 수집 모델의 추가, 수정, 삭제
클러스터 관리자와 관리자 역할의 계정 관리

기본 설치에서는 정책 > 시나리오 분류 메뉴도 클러스터 관리자에게만 표시됩니다.

관리자

클러스터 관리자 전용 작업을 제외한 모든 기능을 사용할 수 있는 역할입니다. 모든 티켓 분류와 테이블에 접근할 수 있고, 파서, 로그 스키마, 수집 모델은 조회할 수 있습니다. 시스템 메뉴에서는 센트리, 테이블, SSO, 접속 프로파일, 차단 연동, AI 프롬프트를 사용할 수 있습니다. 계정은 사용자와 대시보드 게시 역할의 계정을 추가, 수정, 삭제할 수 있고, 자신의 계정 정보도 수정할 수 있습니다.

사용자

보안 운영에 필요한 기능을 사용하는 역할입니다. 티켓과 테이블은 계정에 권한이 부여된 티켓 분류와 테이블에만 접근할 수 있습니다(계정의 권한 설정 참고). 수집과 시스템 메뉴는 사용할 수 없습니다. 자세한 권한은 계정 권한 일람표를 참고하세요.

대시보드 게시

대시보드를 외부에 게시할 때 쓰는 역할입니다. 게시한 대시보드를 표시하는 데 필요한 데이터만 조회할 수 있습니다. 게시 절차는 대시보드 문서의 관리 메뉴에서 대시보드 게시 항목을 참고하세요.

MFA

계정으로 로그인할 때 MFA를 적용해 보안을 강화할 수 있습니다. Email 또는 OTP 방식을 지원합니다. OTP는 Google Authenticator 또는 RFC 6238을 만족하는 OTP 앱이라면 무엇을 사용해도 무방합니다.

API 키

로그프레소 REST API를 이용하려면 API 키가 필요합니다. API 키는 계정 단위로 생성됩니다. API 키는 계정에 할당된 역할에 따라 허용된 권한을 갖습니다. 대시보드 게시 역할로 계정을 만들면 서버가 계정 생성과 동시에 API 키를 자동으로 발급합니다.

계정 목록 조회/검색

클러스터 관리자와 관리자는 계정 > 계정 화면에서 계정 목록을 조회할 수 있습니다. 사용자 계정은 계정 목록을 조회할 수 없습니다.

계정 목록의 각 열은 다음과 같습니다.

로그인 이름: 로그프레소 소나에 로그인할 때 사용하는 아이디
부서: 사용자의 소속 부서
성명: 사용자의 실제 이름
역할: 계정에 부여된 역할 (클러스터 관리자, 관리자, 사용자, 대시보드 게시)
수정일: 계정 정보를 마지막으로 수정한 날짜와 시각 (yyyy-MM-dd HH:mm:ss 형식)
MFA: MFA 적용 여부. 적용 또는 미적용 배지로 표시됩니다.

목록은 로그인 이름 오름차순으로 표시됩니다.

계정 목록에서 특정한 계정을 찾으려면 도구 모음에 있는 검색 도구를 사용하세요. 검색 도구는 로그인 이름, 부서, 성명, 직급, 전화, 휴대전화에서 입력한 단어가 포함된 계정을 찾아서 보여줍니다. 검색어를 공백으로 나누어 여러 낱말을 입력하면 모든 낱말이 들어 있는 계정만 찾습니다. 검색 도구는 대소문자를 구분합니다.

도구 모음의 아이콘을 클릭하면 목록을 파일로 내려받고, 아이콘을 클릭하면 목록을 새로 고칩니다.

계정 추가

새 계정을 추가하려면,

계정 > 계정에서 도구 모음에 있는 추가를 클릭하세요.
계정 추가 패널에서 공통 설정, 보안 설정, 그룹, 권한 속성을 입력하거나 선택하세요. 라벨에 * 표시가 있는 항목은 필수 입력 칸입니다.
입력하거나 선택한 속성이 올바른지 검토하고 우측 상단에 있는 저장을 클릭하세요.

저장하지 않고 패널을 닫으려면 패널 왼쪽 위의 를 클릭하거나 Esc 키를 누르세요. 저장하지 않은 변경이 있으면 변경사항 확인 대화상자가 열리며, 확인을 클릭하면 바꾼 내용을 버리고 닫습니다.

이후 내용은 계정의 설정에 필요한 정보들에 대한 설명입니다.

공통 설정

계정의 일반적인 고유 설정 항목들입니다.

로그인 이름: 로그프레소 소나에 로그인할 때 사용하는 아이디. 로그인 이름은 영문 대소문자와 숫자, 마침표(.), 밑줄(_), 하이픈(-)만 사용할 수 있습니다(첫 글자에는 하이픈을 사용할 수 없음). (필수, 최대 255자)

Caution

로그인 이름으로 admin, administrator, manager, root, logpresso, sonar, siem, maestro, xdr는 사용할 수 없습니다. 대소문자는 구분하지 않습니다.
언어: 로그프레소 소나에 로그인한 후 웹 콘솔에 적용할 언어. 한국어, 영어, 일본어 중에서 선택하세요.
암호, 암호 확인: 로그인할 때 인증에 사용할 암호. 암호와 암호 확인란에 동일하게 입력하세요. 암호는 시스템에 설정된 암호 정책을 충족해야 합니다. 기본 정책은 9자 이상이며 영문, 숫자, 특수문자를 각각 포함하고 같은 문자를 3회 연속 사용할 수 없습니다. (신규 생성 시 필수) 인증 모드가 외부 인증 전용이면 이 입력란이 나타나지 않습니다.
성명: 사용자의 실제 이름 (필수, 최대 50자)
부서: 사용자의 소속 부서 (최대 50자)
직급: 사용자의 직급 정보 (최대 20자)
이메일: 로그프레소 소나가 보내는 메일을 수신할 이메일 주소 (필수, 최대 255자)
전화: 사용자의 전화 번호 (최대 50자)
휴대전화: 사용자의 휴대전화 번호. 로그프레소 소나가 사용자에게 SMS를 전송하도록 설정되어 있을 때, 계정에 등록된 휴대전화번호를 이용할 수 있습니다. (최대 50자)
역할: 계정의 역할을 선택하세요(기본값: 사용자). 클러스터 관리자는 클러스터 관리자, 관리자, 사용자, 대시보드 게시 가운데에서 선택할 수 있고, 관리자는 사용자와 대시보드 게시 가운데에서만 선택할 수 있습니다. 자신의 역할은 바꿀 수 없습니다.
시작 메뉴: 웹 콘솔에 로그인한 계정의 세션에서 시작 페이지로 사용할 화면. 지정하지 않으면 기본 시작 화면으로 이동합니다.

보안 설정

계정의 각종 보안 설정 항목들입니다. 보안 설정은 그 계정을 편집할 수 있을 때만 표시됩니다. 클러스터 관리자는 모든 계정의 보안 설정을, 관리자는 사용자·대시보드 게시 역할 계정의 보안 설정을 편집할 수 있습니다. 관리자가 자신의 계정을 열면 보안 설정이 표시되지 않습니다.

인증 모드

계정의 인증에 적용할 서버를 선택(기본값: 모든 인증 서버 사용)

모든 인증 서버 사용: 서버에 설정된 모든 인증 서버에서 로그인 이름과 일치하는 계정의 인증을 시도합니다. 먼저 서버에 등록된 로컬 계정 인증을 시도하고, 2차적으로 외부 인증 서버에 인증을 시도합니다. 로컬 계정과 외부 인증 서버의 로그인 이름은 동일해야 합니다.
외부 인증 전용: 외부 인증 서버가 제공하는 인증 정보를 이용해 계정을 인증합니다.

세션 유휴 동작

사용자가 계정으로 로그인한 세션을 일정 시간 동안 사용하지 않을 때 세션에 적용할 정책. 없음, 세션 잠금, 로그아웃 중에서 선택하세요(기본값: 없음). 세션 잠금, 로그아웃을 선택한 경우 적용되는 기본 유휴 시간은 60초입니다. 유휴 시간은 60-604,800초(1주일) 사이의 값을 지정할 수 있습니다.

암호 재사용 방지

사용자가 로그인 암호를 변경할 때 이전 암호를 사용할 수 없도록 하는 정책. 서버는 계정에 사용된 암호의 해시값을 지정된 개수만큼 기억하고 재사용을 차단합니다(기본값: 1, 유효 범위: 0-23).

암호 만료기간

암호 지정 후 사용할 수 있는 기간. 기본값(365일), 사용자 정의, 기한 없음 중에서 선택하세요. 인증 모드가 외부 인증 전용일 때는 표시되지 않습니다.

기본값: 365일
사용자 정의: 7일이 기본값으로 주어지고, 7-3,650일 사이에서 설정할 수 있습니다.
기한 없음: 암호의 만료 기한을 지정하지 않습니다.

서버는 암호 만료 7일 전부터 로그인하거나 세션 잠금을 해제할 때 만료까지 남은 일수를 알리는 암호 변경 팝업을 띄웁니다. 이때는 나중에 변경을 눌러 변경을 미룰 수 있습니다.

만료일이 지나면 나중에 변경이 사라지고, 암호를 변경해야 계속 사용할 수 있습니다.

계정 잠금 기준

연속 로그인 실패 횟수. 지정한 횟수만큼 사용자가 계정으로 로그인에 실패하면 계정을 잠그고 로그인을 차단합니다(기본값: 5, 유효 범위: 0-5). 0을 지정하면 계정 잠금을 적용하지 않습니다.

계정 잠금 기간

사용자의 계정 잠금을 적용할 기간. 기본값은 10분, 최댓값은 100,000,000분(약 190년)입니다. (유효 범위: 1-100,000,000분)

IP 접근 제어

계정으로 로그인할 수 있는 IP 주소를 제한할 때 사용됩니다. IPv4 주소를 입력하고 Enter 키를 누르세요. 서버 설정에 따라 최대 입력 개수가 달라지며, 기본값은 최대 2개입니다. 비워 두면 어느 IP 주소에서나 로그인할 수 있습니다.

MFA

MFA 적용 방식(기본값: 사용 안 함). 사용 안 함, Email, OTP 중에서 선택하세요.

사용 안 함: MFA를 사용하지 않습니다.
Email: 이메일로 인증 코드를 전송하여 2단계 인증을 수행합니다. 이메일 서버 설정이 되어 있어야 사용할 수 있습니다.
OTP: Google Authenticator 또는 RFC 6238을 만족하는 OTP 앱을 사용합니다.

계정 사용자가 MFA를 이용해 로그인하는 방법은 2단계 인증(2FA)을 참고하세요.

동시 쿼리 검색 수

쿼리 메뉴에서 쿼리를 실행할 때 검사하는 동시 실행 한도(유효 범위: 1-999). 쿼리 메뉴와 피벗·이벤트 화면에서 실행 중인 그 사용자의 쿼리를 세며, 대시보드 위젯이나 REST API로 실행한 쿼리는 세지 않습니다. 값을 비워 두면 개수를 제한하지 않습니다.

쿼리 결과 건수 제한

사용자가 쿼리 메뉴에서 선택할 수 있는 최대 결과 건수. 무제한, 최대 1만 건, 최대 10만 건, 최대 100만 건 중에서 선택하세요(기본값: 무제한).

그룹

계정 그룹에서는 계정을 계정 그룹에 할당할 수 있습니다. 역할이 클러스터 관리자나 관리자인 계정은 이 칸에 모두 허용이 표시되고 계정 그룹을 할당할 수 없습니다. 이런 계정을 구성원으로 넣으려면 계정 그룹에서 추가하세요.

계정에 그룹을 할당하려면,

계정 그룹 입력란을 클릭하면 계정 그룹 목록이 나타납니다. 검색어를 입력하면 이름 또는 설명에 그 문자열이 들어 있는 계정 그룹만 남습니다(대소문자를 구분하지 않음). 할당할 계정 그룹을 클릭하세요.
하나 이상의 계정 그룹에 할당하려면 위에서 수행한 작업을 반복하세요.
할당한 계정 그룹에서 계정을 제거하려면 계정 그룹 이름 오른쪽의 제거 아이콘을 클릭하세요. 제거한 내용은 저장을 클릭해야 반영됩니다.

권한

권한은 계정에 권한을 부여할 티켓 분류와 테이블을 선택할 수 있습니다. 화면의 필드 이름은 각각 티켓과 테이블입니다. 계정에 부여된 역할이 사용자 또는 대시보드 게시일 때, 권한이 부여된 티켓 분류와 테이블에 대해서만 접근할 수 있습니다. 클러스터 관리자와 관리자는 모든 티켓 및 테이블에 접근할 수 있으며, 이 화면에도 개별 선택 대신 모두 허용이라고 표시됩니다.

티켓: 계정으로 조회할 수 있는 티켓 분류. 기본적으로 아무 티켓 분류도 선택되어 있지 않습니다. 계정에 접근을 허용할 티켓 분류만 선택하세요.
테이블: 계정으로 조회할 수 있는 테이블. 기본적으로 아무 테이블도 선택되어 있지 않습니다. 계정에 접근을 허용할 테이블만 선택하세요.

계정 수정

계정의 암호와 같은 속성을 수정하거나, 계정이 잠겨서 잠금을 해제하려면,

목록에서 수정할 계정이 있는 행을 클릭하세요.

관리자가 클러스터 관리자나 다른 관리자 계정의 행을 클릭하면 계정 정보가 읽기 전용으로 표시되고 저장이 나타나지 않습니다.
계정 수정 패널에서 정보를 수정한 후 저장을 클릭하세요. 수정할 속성에 대한 설명은 계정 추가를 참고하세요.

이후 내용은 계정 수정 패널에서 수행할 수 있는 작업들입니다.

사용자별 검색량 제어

클러스터 관리자와 관리자는 보안 설정에서 사용자별로 동시에 실행할 수 있는 쿼리 수와 쿼리 결과 건수의 한도를 지정할 수 있습니다. 두 항목은 계정 추가 패널에도 함께 나타나며, 보안 설정이 표시되는 계정에서만 나타납니다.

한도가 설정된 사용자가 쿼리 메뉴에서 쿼리를 실행하면, 서버가 현재 실행 중인 쿼리 수와 한도를 비교해 한도에 이르렀으면 안내 메시지를 표시하고 실행을 막습니다. 대시보드나 REST API로 실행한 쿼리는 이 한도에 포함되지 않습니다.

MFA 상태 조회/초기화

MFA 방식이 OTP인 계정은 보안 설정의 MFA 항목 아래에 다음과 같이 인증 장치 등록 상태와 초기화가 표시됩니다. Email 방식이거나 MFA를 사용하지 않는 계정은 MFA 선택 상자만 보입니다. 계정 사용자가 자신의 MFA 인증 장치를 설정하고 로그인하는 방법은 2단계 인증(2FA)을 참고하세요.

인증 장치: MFA 인증 장치의 등록 여부. 등록 안 됨(노란색)으로 표시된 경우, 계정 사용자가 아직 MFA를 설정하지 않았음을 나타냅니다. 이 상태에서 사용자가 로그인을 시도하면 MFA 설정 화면으로 연결됩니다.; 등록됨(녹색)으로 표시된 경우, 계정에 인증 장치가 등록되어 사용자가 MFA로 인증할 준비가 되었음을 나타냅니다.
초기화: 계정 사용자가 MFA 인증 장치를 분실했거나 변경이 필요한 경우, 로그인 화면에서 관리자에게 MFA 초기화를 요청할 수 있습니다. 사용자의 MFA 초기화 요청은 관리자에게 등록된 메일 계정으로 전송됩니다. 등록된 MFA 인증 장치 정보를 제거하려면 초기화를 클릭한 뒤 OTP 초기화 대화상자에서 확인을 클릭하세요. 사용자는 다음 로그인 때 인증 장치를 다시 등록합니다. 자신의 계정을 초기화하면 초기화 직후 로그아웃됩니다.

API 키 발급/삭제

로그프레소 REST API를 사용하려면 계정과 계정에 발급된 API 키가 필요합니다. API 키를 발급하려면 공통 설정의 API 키 항목에 있는 발급을 클릭하세요. API 키 항목은 계정 수정 패널에만 있으며, 발급·재발급·삭제는 저장을 누르지 않아도 바로 적용됩니다.

다음 그림은 API 키가 생성된 화면 스크린샷입니다.

클립보드로 복사: 생성된 API 키 오른쪽에 있는 아이콘을 클릭하면 클립보드에 API 키가 복사됩니다.
재발급: 재발급을 클릭하면 API 키 재발급 대화상자가 열립니다. 확인을 클릭하면 새 키가 발급되고 이전 키는 더 이상 사용할 수 없습니다.
삭제: 삭제를 클릭하면 API 키 삭제 대화상자가 열립니다. 확인을 클릭하면 키가 삭제됩니다.

로그인 실패 초기화 및 계정 잠금 해제

사용자가 연속으로 로그인에 실패하면 다음 그림과 같이 로그인 실패 현황에 실패한 로그인 횟수를 보여줍니다.

연속 실패 횟수가 계정 잠금 기준에 이르면 다음 그림과 같이 잠금 해제 시각을 함께 보여줍니다.

로그인 실패 횟수를 초기화하거나 계정 잠금을 해제하려면 로그인 실패 현황에 있는 초기화를 클릭하세요.

휴면 해제

관리자가 전역 옵션으로 휴면 전환 기간을 설정한 경우, 일정 기간 동안 로그인하지 않은 계정은 휴면 상태로 전환됩니다. 계정 수정 패널에서 마지막 로그인 시각을 확인할 수 있으며, 계정이 휴면 상태이면 해제 버튼이 표시됩니다. 계정 휴면을 해제하려면 해제를 클릭하세요.

권한 조회/변경

계정 사용자가 접근할 수 있는 티켓과 테이블 외에 계정이 이용할 수 있는 접속 프로파일을 확인할 수 있습니다.

티켓 및 테이블 권한은 이 패널에서 변경할 수 있지만 유저 프로파일과 그룹 프로파일은 접속 프로파일 공통 설정에서 변경할 수 있습니다.

유저 프로파일: 접속 프로파일의 계정 공유 설정에 계정이 포함되어 있을 때, 해당 접속 프로파일의 이름이 목록으로 표시됩니다.
그룹 프로파일: 접속 프로파일의 그룹 공유 설정에 계정이 속한 계정 그룹이 포함되어 있을 때, 해당 접속 프로파일의 이름이 목록으로 표시됩니다.

MFA 일괄 설정

1개 이상의 계정에 MFA를 일괄적으로 활성화/비활성화하거나 인증 방식을 변경하려면,

목록에서 MFA를 설정할 계정 정보가 있는 행의 체크박스를 선택하세요.
도구 모음에서 원하는 작업을 선택하세요.
- 인증 방식 변경: 선택한 계정의 MFA 방식을 변경합니다. 드롭다운에서 이메일 또는 OTP를 선택하면 해당 방식으로 MFA가 활성화됩니다. 이메일 방식은 이메일 서버가 설정되어 있어야 합니다.
- MFA 활성화: 선택한 계정의 MFA를 활성화합니다. MFA 방식이 지정된 계정에만 적용되므로, 방식이 없는 계정은 먼저 인증 방식 변경으로 방식을 지정하세요.
- MFA 비활성화: 선택한 계정의 MFA를 비활성화합니다.
권한이 없거나 조건에 맞지 않아 바꾸지 못한 계정은 실패 대화상자에 표시됩니다.

계정 삭제

계정을 삭제하려면,

목록에서 삭제할 계정 정보가 있는 행의 체크박스를 선택하세요.
도구 모음에서 삭제를 클릭하세요.
계정 삭제 대화상자에서 삭제할 계정 목록을 확인한 후 삭제를 클릭하세요. 삭제하지 않으려면 취소를 클릭하세요.

계정을 삭제하면 계정만 삭제되고, 삭제된 계정과 관련된 데이터는 유지됩니다.

삭제된 계정이 소유하던 대시보드, 데이터셋, 탐지 룰, 행위 프로파일, 리포트 그룹·템플릿 등의 리소스는 삭제되지 않으며, 소유권이 남아 있는 클러스터 관리자·관리자 역할 계정 가운데 가장 먼저 추가된 계정으로 이전되어 계속 관리할 수 있습니다.

티켓과 같이 소유권이 이전되지 않는 이력성 데이터의 경우, 이후 조회 및 감사를 위해 이전 소유자의 정보를 함께 보존합니다.

자신의 계정은 삭제할 수 없고, 관리자는 클러스터 관리자와 다른 관리자 계정을 삭제할 수 없습니다. 선택한 계정 가운데 삭제할 수 없는 계정이 있으면 나머지만 삭제하고 안내 메시지를 표시합니다.

암호 정책

암호 정책은 로컬 계정의 암호가 충족해야 하는 길이와 복잡도 규칙을 정의하며, 계정마다 따로 두지 않고 시스템 전체에 하나로 적용됩니다. 서버는 계정을 생성하거나 암호를 변경·재설정할 때 정책을 검사합니다. 암호 정책은 로컬 암호를 쓰는 계정, 즉 인증 모드가 모든 인증 서버 사용인 계정에 적용됩니다.

별도로 설정하지 않아도 다음 기본 정책이 적용됩니다.

9자 이상
영문, 숫자, 특수문자를 각각 1자 이상 포함
같은 문자를 3회 연속 사용 금지
로그인 이름을 포함할 수 없음

관리자는 로그프레소 셸에서 다음 전역 옵션으로 정책을 변경할 수 있습니다.

옵션	설명	기본값	유효 범위
min_password_len	암호 최소 길이	9	3-100자
max_password_len	암호 최대 길이	100	최소 길이 초과, 100 이하
password_complexity	복잡도 규칙(쉼표로 구분)	digit,special,no_repeat=3	아래 규칙 참고

password_complexity에 지정할 수 있는 규칙은 다음과 같습니다.

upper: 영문 대문자를 1자 이상 포함
digit: 숫자를 1자 이상 포함
special: 특수문자를 1자 이상 포함
no_repeat=N: 같은 문자를 N회 연속 사용 금지(N은 2-5, 기본값 3)

복잡도 규칙과 무관하게 암호에는 영문자가 항상 1자 이상 포함되어야 합니다.

예를 들어 최소 12자, 최대 20자, 영문 대문자·숫자·특수문자 필수 사용, 같은 문자 4회 연속 사용 금지 정책은 다음과 같이 설정합니다.

sonar.setGlobalOption min_password_len 12
sonar.setGlobalOption max_password_len 20
sonar.setGlobalOption password_complexity upper,digit,special,no_repeat=4

설정한 옵션을 해제하려면 sonar.unsetGlobalOption [옵션 이름]을 실행하세요. 옵션에 잘못된 값이나 허용 범위를 벗어난 값을 지정하면 서버가 유효 범위 안으로 보정하거나 기본값을 사용합니다.