alpamon이 서버 접속에 관해 수집하는 정보와 수집하지 않는 정보
alpamon은 Alpacon을 거치지 않고 서버에 접속할 수 있는 경로를 찾습니다. 로그인 가능한 계정, SSH 키, 신뢰하는 인증 기관, 비밀번호 로그인, sudo 권한이 여기에 포함됩니다. alpamon은 서버의 계정 및 SSH 설정을 읽고 확인한 내용을 담은 보고서를 Alpacon에 보냅니다. 이 페이지에서는 보고서에 포함되는 정보와 포함되지 않는 정보, 보고서가 전달되는 곳을 설명합니다.
alpamon은 비밀번호 해시, 개인 키, 키와 인증서 본문, 설정 파일 각 줄의 원문, sudo 명령어 인자, 명령어 기록을 전송하지 않습니다. SSH 키 주석의 앞 128자와 수집 대상 옵션 값은 입력된 그대로 전송합니다. SSH 키 주석이나 수집 대상 옵션 값에 시크릿을 넣지 마세요.
보고서를 보내는 서버
alpamon 2.9.0 이상을 실행하는 모든 Linux 서버는 보고서를 보냅니다. macOS나 Windows 서버는 보고서를 보내지 않으며, 이전 버전의 에이전트는 보낼 수 없습니다. 서버의 에이전트를 확인하거나 업그레이드하려면 서버 관리에 설명된 에이전트 카드를 쓰세요.
alpamon은 서버를 등록한 직후와 이후 한 시간마다 서버 정보를 읽습니다. 서버의 작업 세션이 끝나거나 서버에 직접 로그인한 기록이 남을 때도 Alpacon이 다시 읽도록 요청합니다. 따라서 세션 중 추가한 키는 몇 분 안에 보고서에 나타납니다. 이전 보고서와 달라진 내용이 없으면 alpamon은 보고서를 다시 보내지 않고 체크섬만 보냅니다.
보고서에 포함되는 정보
계정과 비밀번호
/etc/passwd에 있는 각 계정에 대해 다음 정보를 수집합니다.
- 계정: 사용자 이름, UID, 셸, 해당 셸의 로그인 허용 여부, 계정이 속한 그룹의 이름
- 비밀번호 상태: 계정에 비밀번호가 설정되어 있는지, 비밀번호가 잠겨 있는지, 비밀번호가 비어
있는지, 비밀번호가 아예 없는지에 관한 정보. alpamon이 서버에서
/etc/shadow를 읽어 상태를 판단하고, 비밀번호 해시는 서버에서 버리며 전송하지 않음 - 비밀번호 관련 날짜: 같은
/etc/shadow항목에 기록된 마지막 비밀번호 변경일, 계정 만료일, 비활성 기간 - 홈 디렉터리: alpamon의 읽기 가능 여부와 디렉터리 권한이 SSH 서버의 소유권 및 권한 검사를 통과하는지 여부. 디렉터리 내용은 나열하지 않음
SSH 키
SSH 서버가 쓰는 각 authorized_keys 파일에 대해 다음 정보를 수집합니다.
- 파일: 경로, 소유자, 권한, 키로 읽을 수 없는 줄의 수
- 각 키: SHA-256 지문, 형식(예:
ssh-ed25519), 비트 단위 크기, 키 뒤에 붙은 주석(최대 128자로 잘라냄). 키 자체는 보내지 않고 키에서 계산한 지문만 보냄 - 키 옵션: 키가 있는 줄에 적힌
no-pty,command등의 옵션 이름. 옵션 값 중에서는 키 접속을 허용하는 출발지를 나타내는from=,expiry-time=,cert-authority줄의principals=값만 보냄. 강제 실행 명령어인command=나environment=설정 등 나머지 옵션 값은 모두 버림
인증서와 기타 신뢰 설정
- 사용자 인증서 CA: SSH 서버가 사용자 인증서 서명에 신뢰하는 각 CA의 지문, 종류, 크기
- 프린시펄 파일: 계정이 허용하는 프린시펄 이름과 각 항목의 옵션 이름 및
from=값 - Kerberos 신뢰 설정: SSH 서버가 Kerberos 또는 GSSAPI 로그인을 허용할 때만 각 계정의
.k5login에 있는 프린시펄을 수집함 - 호스트 기반 신뢰 설정: SSH 서버가 호스트 기반 로그인을 허용하거나
.rhosts파일을 무시하지 않을 때만 각 계정의.rhosts와.shosts,/etc/hosts.equiv와/etc/ssh/shosts.equiv에 있는 호스트와 사용자 쌍을 수집함
SSH 서버 설정
alpamon은 SSH 서버가 실제로 쓰는 설정을 출력하는 sshd -T를 실행합니다. 이 가운데 누가 어떤
방식으로 로그인할 수 있는지를 결정하는 설정만 남깁니다:
- 허용된 로그인 방식: 비밀번호, 키보드 대화형 인증, 공개 키, Kerberos와 GSSAPI, 호스트 기반 인증, 빈 비밀번호, root 로그인
AuthenticationMethods, 허용되는 키 및 CA 서명 알고리즘, 서버가 키·프린시펄·신뢰하는 CA·폐기된 키를 찾는 위치StrictModes,IgnoreRhosts,IgnoreUserKnownHosts및AllowUsers,DenyUsers,AllowGroups,DenyGroups목록
각 Match 블록의 조건과 그 안에 있는 같은 설정도 읽고, 실행 중인 SSH 서버가 검사한 설정을 쓰는지
확인합니다. 키나 프린시펄을 명령어에서 가져오는 경우(AuthorizedKeysCommand,
AuthorizedPrincipalsCommand), 명령어의 경로와 실행 계정만 전송하며 인자는 전송하지 않습니다. 그
밖의 설정은 모두 제외합니다.
sudo 허용 내역
alpamon은 sudoers 파일과 그 파일이 포함하는 파일을 읽어 각 계정에 허용된 작업을 파악합니다. 허용 항목마다 다음 정보를 수집합니다:
- 항목이 나온 파일과 계정에 직접 적용되는지, 그룹을 통해 적용되는지
- 명령어를 실행할 때 쓰는 사용자 계정
- 모든 명령어를 허용하는지, 제한된 목록만 허용하는지 여부. 목록이 제한된 경우 명령어 경로와 규칙의 인자 제한 여부를 전송하며 명령어 인자는 제외함
- 비밀번호가 필요한지 여부(
NOPASSWD)
alpamon은 파일만 읽습니다. sudo나 visudo는 실행하지 않습니다.
마지막 터미널 로그인
각 계정에 대해 lastlog 또는 wtmp에 기록된, 터미널을 연 마지막 로그인의 시각과 터미널, 로그에
기록된 원격 호스트, 기록 출처인 로그를 수집합니다. 더 오래된 로그인과 두 로그에 있는 다른 기록은
전송하지 않습니다.
서버 외부에서 관리하는 정보
계정, 그룹, 키 또는 sudo 규칙을 LDAP, SSSD, Kerberos, 키 조회 명령어 등 서버 외부에서 가져오는 경우 보고서에는 출처를 명시합니다. 명령어가 출처라면 경로와 실행 계정을 명시합니다. 그 출처가 반환할 내용은 조회하지 않습니다.
보고서에서 제외하는 정보와 포함될 수 있는 명령어 경로
보고서에는 명령어의 전체 값이나 인자를 담지 않습니다. 위에서 설명한 허용 범위에 따라 sudo 명령어와 키나 프린시펄을 가져오는 외부 명령어의 경로는 보고서에 포함될 수 있습니다.
- 비밀번호 해시. alpamon이 서버에서 비밀번호 필드를 식별해 제외함
- 개인 키 파일의 내용.
- 공개 키와 인증서의 본문. 지문, 종류, 크기만 수집함
- 파일 내용.
/etc/shadow,authorized_keys, SSH 설정, sudoers 및 그 밖의 파일에서 원문 행을 수집하지 않으며,lastlog나wtmp의 원본 레코드도 수집하지 않음. alpamon이 해석하지 못하는 행은 개수만 세고 전송하지 않음 - SSH 키의 강제 실행 명령어 및 환경 변수 옵션 값 (옵션 이름은 보고서에 포함될 수 있음)
- 명령어 기록. 셸 기록 파일을 읽지 않음
- 위 목록에 없는 SSH 설정.
alpamon이 정보를 읽어도 서버의 내용은 바뀌지 않습니다. 보고서를 만들 때 실행하는 프로그램은
sshd -T뿐입니다. sudo를 실행하거나 PAM을 호출하지 않으며, 읽는 파일에 아무것도 쓰지 않습니다.
alpamon이 정보를 읽지 못하는 경우
보고서에는 alpamon이 계정, 비밀번호, 키, 인증서, 그 밖의 신뢰 정보, sudo, SSH 서버 설정, 터미널 로그인 기록을 각각 얼마나 읽었는지 표시됩니다. 각 영역의 상태는 확인됨, 일부 확인됨, 알 수 없음 중 하나이며, 읽을 수 없는 파일, 읽는 도중 변경된 파일, alpamon이 해석할 수 없는 sudoers 규칙, 서버 외부에서 관리되는 정보원 등의 이유도 함께 표시됩니다.
보고서에서는 alpamon이 읽지 못한 영역을 비어 있는 것으로 표시하지 않으며, 일부 확인됨 또는 알 수 없음 상태와 그 이유를 함께 보여줍니다.
로그인 경로 분석은 SSH로 접속하는 방법만 다룹니다. 보고서에는 SSH 사용 여부와 관계없이 sudo 허용 내역과 각 계정의 마지막 터미널 로그인도 포함됩니다. SSH 분석에서 모든 항목이 확인됨으로 표시되면 alpamon이 점검한 설정의 SSH 접속 정보를 모두 읽었다는 뜻입니다. 서버에 다른 로그인 경로가 있을 수 있습니다.
보고서를 볼 수 있는 사람
보고서는 Alpacon의 워크스페이스에 저장됩니다. 워크스페이스 멤버는 콘솔이나 API에서 보고서를 확인할 수 없습니다.
보관 기간
Alpacon은 서버 보고서에 키, sudo 허용 항목, 그 밖의 접속 경로가 포함되는 동안 각 항목의 기록을
보관합니다. 보고서에서 접속 경로가 사라진 뒤에도 그 기록은 최소한 워크스페이스의 보관 기간 동안
남아 있습니다. 함께 저장된 키 주석, from= 값, 프린시펄 이름에도 같은 기준이 적용됩니다. 기본 보관
기간은 Free 30일, Essentials 120일, Enterprise 365일입니다. 워크스페이스에 적용할 보관 기간을
별도로 약정했다면 그 기간을 따릅니다. Alpacon은 보관 기간이 지나도 이 기록을 자동으로 삭제하지
않습니다. 계정 기록에도 같은 보관 규칙이 적용됩니다.
플랜과 보관 기간을 참고하세요.
보고서 끄기
이 보고서를 끄는 설정은 없습니다. 직접 로그인 탐지 설정과 관계없이 지원되는 에이전트가 설치된 모든 Linux 서버에서 실행됩니다.
보안팀 안내
/etc/shadow와 sudoers를 매시간 읽는 동작이 엔드포인트 탐지(EDR)의 자격 증명 접근 규칙에 걸릴 수
있습니다. 보고서가 계속 작동하도록 규칙 전체를 끄는 대신 alpamon의 경로와 패키지를 허용 목록에
추가하세요.
실행 프로세스
- 바이너리:
alpamonsystemd 서비스가 실행하는/usr/bin/alpamon; 이 서비스는 root로 실행됨 - 패키지: AlpacaX 패키지 리포에서 제공하는
alpamondeb 또는 rpm 패키지. 설치하거나 업그레이드할 때 패키지 관리자가 GPG 키로 해당 리포를 확인함. 파일이 패키지에 속하는지 확인하려면dpkg -S /usr/bin/alpamon또는rpm -qf /usr/bin/alpamon을 실행해야 함. GitHub Releases의 각 릴리스에도 SHA-256 체크섬 파일이 게시됨
실행하는 명령어 한 가지
alpamon은 보고서를 위해 자식 프로세스 하나를 시작합니다. /usr/sbin/sshd -T를 실행하며, sshd가
/usr/bin에 설치된 경우에는 /usr/bin/sshd -T를 실행합니다. sshd는 이 두 경로 중 하나에서만
실행하고 PATH나 셸을 거치지 않습니다. 명령어는 /에서 시작하며 환경 변수는
PATH=/usr/sbin:/usr/bin:/sbin:/bin과 LC_ALL=C만 설정합니다. 5초 안에 끝나지 않으면 중지합니다.
alpamon이 직접 읽는 파일과 디렉터리
- 계정:
/etc/passwd,/etc/group,/etc/shells,/etc/nsswitch.conf,/etc/shadow를 읽음.nsswitch.conf가 systemd를 쓰는 경우에는/var/lib/systemd/home,/etc/userdb,/run/userdb,/run/host/userdb,/usr/local/lib/userdb,/usr/lib/userdb의 파일 이름도 나열함 - SSH:
/etc/ssh/sshd_config와 이 파일이 포함하는 파일을 읽음. 각 계정의 홈 디렉터리에서는 SSH 서버가 쓰도록 설정된 파일을 읽음. 기본값은~/.ssh/authorized_keys와~/.ssh/authorized_keys2이며, principals 파일이 있으면 함께 읽음. 신뢰할 사용자 CA 파일이 설정된 경우에도 읽음 - Sudo:
/etc/sudo.conf, 파일이 있으면/etc/sudoers-rs,sudo.conf에 지정된 sudoers 파일(기본값/etc/sudoers), sudoers 파일이 포함하는 모든 파일과 디렉터리(예:/etc/sudoers.d)를 읽음 - 로그인:
/var/log/wtmp와/var/log/wtmp.1의 최신 기록,/var/log/lastlog에 있는 각 계정의 기록을 읽음 - 신뢰 파일: SSH 설정상 적용되는 경우에만 읽음. Kerberos의 경우
/etc/krb5.conf와 각 계정의.k5login을 읽고, 호스트 기반 로그인에는 각 계정의.rhosts와.shosts,/etc/hosts.equiv,/etc/ssh/shosts.equiv를 읽음 - 실행 중인 프로세스:
/proc/stat와 각 프로세스의/proc/<pid>/stat를 읽고, 실행 중인 SSH 서버에 한해서만status와cmdline을 읽음. 이를 바탕으로 실행 중인 SSH 서버가 어떤 설정을 쓰는지 확인함
몇몇 경로는 내용을 읽지 않고 존재 여부만 확인합니다. 확인 대상은 sshd 바이너리,
/etc/systemd/system/sockets.target.wants/ 아래의 ssh.socket 및 sshd.socket 링크,
/var/lib/wtmpdb/wtmp.db, /var/lib/lastlog/lastlog2.db입니다.
alpamon은 위에 나열한 파일을 수정하지 않습니다. 개인 키 파일을 직접 읽거나 키를 전송하지 않습니다. 자식
프로세스인 sshd -T는 설정을 검사할 때 SSH 호스트 개인 키 파일을 열 수 있습니다. 파일 접근 감사 로그에는
alpamon이 시작한 sshd 프로세스가 이 파일을 연 것으로 기록될 수 있습니다.
실행 시점
- 최대 5분 차이가 나는 시각에 매시간 실행됨
- 서버 등록 직후 실행됨
- Alpacon의 요청이 있을 때 실행됨. 서버의 작업 세션이 끝나거나 서버에 직접 로그인한 기록이 남은 후 요청함. Alpacon은 서버당 5분에 한 번까지만 요청함
파일이 변경되었는지와 관계없이 읽을 때마다 위 파일을 다시 엽니다.