---
title: "alpamon이 서버 접속에 관해 수집하는 정보와 수집하지 않는 정보"
description: "alpamon이 Linux 서버의 접속 경로를 확인해 Alpacon에 보내는 보고서를 설명합니다. SSH 키 주석과 옵션 값의 전송 범위, 비밀번호 해시처럼 전송 대상에서 제외하는 항목을 확인할 수 있습니다. 보고서를 볼 수 있는 사람과 플랜별 기본 보관 기간도 안내합니다."
---

> Full documentation index: https://docs.alpacax.com/llms.ko.txt

# alpamon이 서버 접속에 관해 수집하는 정보와 수집하지 않는 정보

alpamon은 Alpacon을 거치지 않고 서버에 접속할 수 있는 경로를 찾습니다. 로그인 가능한 계정, SSH 키,
신뢰하는 인증 기관, 비밀번호 로그인, sudo 권한이 여기에 포함됩니다. alpamon은 서버의 계정 및 SSH
설정을 읽고 확인한 내용을 담은 보고서를 Alpacon에 보냅니다. 이 페이지에서는 보고서에 포함되는
정보와 포함되지 않는 정보, 보고서가 전달되는 곳을 설명합니다.

alpamon은 비밀번호 해시, 개인 키, 키와 인증서 본문, 설정 파일 각 줄의 원문, sudo 명령어 인자,
명령어 기록을 전송하지 않습니다. SSH 키 주석의 앞 128자와 수집 대상 옵션 값은 입력된 그대로
전송합니다. SSH 키 주석이나 수집 대상 옵션 값에 시크릿을 넣지 마세요.

## 보고서를 보내는 서버 [#which-servers]

alpamon 2.9.0 이상을 실행하는 모든 Linux 서버는 보고서를 보냅니다. macOS나 Windows 서버는 보고서를
보내지 않으며, 이전 버전의 에이전트는 보낼 수 없습니다. 서버의 에이전트를 확인하거나
업그레이드하려면 [서버 관리](/use/servers/manage/)에 설명된 에이전트 카드를 쓰세요.

alpamon은 서버를 등록한 직후와 이후 한 시간마다 서버 정보를 읽습니다. 서버의 작업 세션이 끝나거나
서버에 직접 로그인한 기록이 남을 때도 Alpacon이 다시 읽도록 요청합니다. 따라서 세션 중 추가한 키는
몇 분 안에 보고서에 나타납니다. 이전 보고서와 달라진 내용이 없으면 alpamon은 보고서를 다시 보내지
않고 체크섬만 보냅니다.

## 보고서에 포함되는 정보 [#what-it-contains]

### 계정과 비밀번호

`/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, 키 조회 명령어 등 서버 외부에서 가져오는 경우
보고서에는 출처를 명시합니다. 명령어가 출처라면 경로와 실행 계정을 명시합니다. 그 출처가 반환할
내용은 조회하지 않습니다.

## 보고서에서 제외하는 정보와 포함될 수 있는 명령어 경로 [#never-contains]

보고서에는 명령어의 전체 값이나 인자를 담지 않습니다. 위에서 설명한 허용 범위에 따라 sudo 명령어와 키나
프린시펄을 가져오는 외부 명령어의 경로는 보고서에 포함될 수 있습니다.

- **비밀번호 해시.** alpamon이 서버에서 비밀번호 필드를 식별해 제외함
- **개인 키 파일의 내용.**
- **공개 키와 인증서의 본문.** 지문, 종류, 크기만 수집함
- **파일 내용.** `/etc/shadow`, `authorized_keys`, SSH 설정, sudoers 및 그 밖의 파일에서 원문 행을
  수집하지 않으며, `lastlog`나 `wtmp`의 원본 레코드도 수집하지 않음. alpamon이 해석하지 못하는 행은
  개수만 세고 전송하지 않음
- **SSH 키의 강제 실행 명령어 및 환경 변수 옵션 값** (옵션 이름은 보고서에 포함될 수 있음)
- **명령어 기록.** 셸 기록 파일을 읽지 않음
- **위 목록에 없는 SSH 설정.**

alpamon이 정보를 읽어도 서버의 내용은 바뀌지 않습니다. 보고서를 만들 때 실행하는 프로그램은
`sshd -T`뿐입니다. `sudo`를 실행하거나 PAM을 호출하지 않으며, 읽는 파일에 아무것도 쓰지 않습니다.

## alpamon이 정보를 읽지 못하는 경우 [#coverage]

보고서에는 alpamon이 계정, 비밀번호, 키, 인증서, 그 밖의 신뢰 정보, sudo, SSH 서버 설정, 터미널
로그인 기록을 각각 얼마나 읽었는지 표시됩니다. 각 영역의 상태는 **확인됨**, **일부 확인됨**, **알 수
없음** 중 하나이며, 읽을 수 없는 파일, 읽는 도중 변경된 파일, alpamon이 해석할 수 없는 sudoers 규칙,
서버 외부에서 관리되는 정보원 등의 이유도 함께 표시됩니다.

보고서에서는 alpamon이 읽지 못한 영역을 비어 있는 것으로 표시하지 않으며, 일부 확인됨 또는 알 수
없음 상태와 그 이유를 함께 보여줍니다.

로그인 경로 분석은 SSH로 접속하는 방법만 다룹니다. 보고서에는 SSH 사용 여부와 관계없이 sudo 허용 내역과
각 계정의 마지막 터미널 로그인도 포함됩니다. SSH 분석에서 모든 항목이 확인됨으로 표시되면 alpamon이 점검한
설정의 SSH 접속 정보를 모두 읽었다는 뜻입니다. 서버에 다른 로그인 경로가 있을 수 있습니다.

## 보고서를 볼 수 있는 사람 [#who-can-see-it]

보고서는 Alpacon의 워크스페이스에 저장됩니다. 워크스페이스 멤버는 콘솔이나 API에서
보고서를 확인할 수 없습니다.

## 보관 기간 [#retention]

Alpacon은 서버 보고서에 키, sudo 허용 항목, 그 밖의 접속 경로가 포함되는 동안 각 항목의 기록을
보관합니다. 보고서에서 접속 경로가 사라진 뒤에도 그 기록은 최소한 워크스페이스의 보관 기간 동안
남아 있습니다. 함께 저장된 키 주석, `from=` 값, 프린시펄 이름에도 같은 기준이 적용됩니다. 기본 보관
기간은 Free 30일, Essentials 120일, Enterprise 365일입니다. 워크스페이스에 적용할 보관 기간을
별도로 약정했다면 그 기간을 따릅니다. Alpacon은 보관 기간이 지나도 이 기록을 자동으로 삭제하지
않습니다. 계정 기록에도 같은 보관 규칙이 적용됩니다.
[플랜과 보관 기간](/use/audit/governance/external-access/#plans)을 참고하세요.

## 보고서 끄기 [#turning-it-off]

이 보고서를 끄는 설정은 없습니다.
[직접 로그인 탐지](/use/audit/governance/external-access/#turn-on-detection) 설정과 관계없이
지원되는 에이전트가 설치된 모든 Linux 서버에서 실행됩니다.

## 보안팀 안내 [#security-teams]

`/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](https://github.com/alpacax/alpamon/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분에 한 번까지만 요청함

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

## 관련 문서

- [External access](/use/audit/governance/external-access/)
- [데이터 보안](/learn/security/data-security/)
- [Alpacon이 확인하는 것과 확인하지 않는 것](/learn/security/what-alpacon-checks/)

Source: https://docs.alpacax.com/ko/learn/security/what-alpamon-collects/
