에이전트 관리하기
설치한 에이전트의 상태를 확인하고 자동 업데이트·오프라인·재설치·제거 등 운영을 관리합니다
에이전트를 설치하고 승인한 뒤에는 에이전트 화면에서 각 호스트의 상태를 확인하고 운영을 관리합니다. 처음 설치·승인하는 방법은 에이전트 설치를 참고하세요.
에이전트 목록 보기
왼쪽 메뉴에서 자산관리 → 에이전트 관리 → 에이전트 목록을 열면 조직에 등록된 에이전트가 목록으로 표시됩니다. 목록 위쪽에는 전체·온라인·오프라인·주의 개수가 요약됩니다.

각 행에서는 다음 정보를 확인합니다.
| 항목 | 설명 |
|---|---|
| 호스트명 | 에이전트가 설치된 호스트 이름 |
| IP | 호스트의 네트워크 주소 |
| OS | 운영체제 종류와 버전 |
| 버전 | 현재 설치된 에이전트 버전 |
| 상태 | 연결·운영 상태 (아래 에이전트 상태 참고) |
| 보안 점수 | 해당 호스트의 최근 점검 보안 점수 |
| 마지막 연결 | 서버와 마지막으로 통신한 시각 |
행을 누르면 해당 에이전트의 상세 화면으로 이동해 시스템 정보와 버전, 업데이트 상태를 자세히 볼 수 있습니다.
에이전트 상태 이해하기
에이전트는 다음 여섯 가지 상태 중 하나로 표시됩니다.
기능 제한과 연결 차단은 에이전트가 너무 오래 업데이트되지 않았을 때 단계적으로 적용됩니다. 평소 온라인 상태로 두면 에이전트가 자동으로 최신 버전을 유지하므로 이 상태에 이르지 않습니다.
자동 업데이트
에이전트는 새 버전이 배포되면 스스로 내려받아 설치합니다. 관리자가 포털에서 업데이트를 직접 실행할 필요는 없습니다.
- 새 버전이 나오면 상태가 잠시 업데이트 필요로 표시되었다가, 에이전트가 업데이트를 마치면 다시 온라인이 됩니다.
- 업데이트는 백그라운드에서 진행되며, 실패하면 자동으로 여러 번 재시도합니다.
- 상세 화면에서는 현재 버전과 최신 버전을 비교해 보여주며, 업데이트가 실패한 경우 그 원인(네트워크 오류·권한 부족·디스크 부족·프로세스 실행 중 등)과 해결 안내를 함께 표시합니다.
업데이트가 계속 실패해 기능 제한이나 연결 차단까지 진행되면, 해당 호스트의 인터넷 연결·디스크 여유 공간·관리자 권한을 점검하세요. 그래도 해결되지 않으면 재설치를 권장합니다.
오프라인 대응
에이전트가 일정 시간 서버와 통신하지 못하면 상태가 오프라인으로 바뀝니다. 오프라인 상태의 호스트는 자산 수집과 점검을 수행하지 못합니다.
다음을 차례로 확인하세요.
- 호스트가 켜져 있고 네트워크에 연결되어 있는지
- 사내 방화벽에서 보안링스 서버로 나가는 HTTPS(443) 연결이 허용되는지
- 호스트에서 에이전트 서비스가 실행 중인지
원인이 해소되면 에이전트가 자동으로 다시 연결되어 온라인으로 돌아옵니다. 목록의 마지막 연결 시각으로 언제부터 끊겼는지 가늠할 수 있습니다.
에이전트 관리 작업
에이전트 상세 화면 아래쪽 관리 작업에서는 다음 작업을 할 수 있습니다. 이 작업에는 조직 관리자 권한이 필요합니다.
- 시크릿 회전 — 해당 에이전트의 연결 자격(시크릿)을 새로 발급합니다. 자격이 유출되었거나 재설정이 필요할 때 사용합니다.
- 비활성화 — 에이전트의 연결을 차단하고 자격을 폐기합니다. 더 이상 사용하지 않을 호스트를 막을 때 사용합니다.
- 삭제 — 포털에서 에이전트 등록을 완전히 삭제합니다.
포털의 삭제는 서버에서 에이전트 등록 정보를 지우는 것이며, 호스트에 설치된 에이전트 프로그램 자체를 제거하지는 않습니다. 호스트의 프로그램까지 없애려면 아래 에이전트 제거를 따르세요.
재설치
에이전트가 정상 동작하지 않아 다시 설치해야 한다면, 기존 에이전트를 제거한 뒤 새로 설치합니다.
호스트에서 에이전트를 제거합니다.
포털 에이전트 관리 → 다운로드 및 설치 화면에서 설치 파일과 설치 토큰을 다시 받습니다. 필요하면 토큰을 재발급합니다.
에이전트 설치 절차대로 다시 설치하고 승인합니다.
포털에는 원격으로 재설치를 지시하는 기능이 없습니다. 재설치는 호스트에서 직접 수행합니다.
에이전트 제거
호스트에서 에이전트를 완전히 제거하려면 Windows의 프로그램 추가/제거를 사용합니다.
호스트에서 설정 → 앱 → 설치된 앱(또는 제어판의 프로그램 및 기능)을 엽니다.
목록에서 보안링스 에이전트를 찾아 제거를 실행합니다.
제거하면 에이전트가 저장한 자격 정보·로그·설정이 함께 정리됩니다.
제거한 뒤 포털에서도 해당 에이전트 등록을 정리하려면 상세 화면에서 삭제합니다.
에이전트가 수집한 호스트·무선 AP 자산은 에이전트를 제거해도 자산 목록에 남습니다. 더 이상 필요 없는 자산은 자산 목록 관리에서 정리하세요.
관련 문서
- 에이전트 설치 — 처음 설치·승인 절차
- 네트워크·호스트 자산 수집 — 온라인 에이전트로 자산 수집
- 에이전트 문제 해결 — 설치·연결 문제 대응