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의 경로와 패키지를 허용 목록에 추가하세요.

실행 프로세스

  • 바이너리: alpamon systemd 서비스가 실행하는 /usr/bin/alpamon; 이 서비스는 root로 실행됨
  • 패키지: AlpacaX 패키지 리포에서 제공하는 alpamon deb 또는 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분에 한 번까지만 요청함

파일이 변경되었는지와 관계없이 읽을 때마다 위 파일을 다시 엽니다.

관련 문서

최종 수정: