에이전트 설치
네트워크의 호스트와 무선 AP를 자동으로 수집하도록 보안링스 에이전트를 설치하고 승인합니다
에이전트는 조직 네트워크의 한 호스트에 설치되어, 네트워크 안의 호스트(서버·PC)와 무선 AP를 자동으로 찾아 자산으로 등록하고 호스트 보안 점검을 수행합니다. 웹사이트만 점검한다면 에이전트는 필요하지 않습니다.
에이전트 설치는 ① 다운로드 → ② 설치·토큰 입력 → ③ 관리자 승인 순서로 진행됩니다. 승인까지 마쳐야 에이전트가 온라인 상태가 되어 자산 수집과 점검을 시작합니다.
준비 사항
에이전트를 설치할 호스트는 다음 요구사항을 만족해야 합니다. 네트워크 안에서 항상 켜져 있는 호스트 한 대에 설치하기를 권장합니다.
| 항목 | 요구사항 |
|---|---|
| 운영체제 | Windows 10 이상 / Windows Server 2016 이상 |
| CPU | 1 Core 이상 |
| 메모리 | 2GB 이상 |
| 디스크 | 100MB 이상 여유 공간 |
| 네트워크 | 인터넷 연결(HTTPS 443 포트) |
1. 다운로드
왼쪽 메뉴에서 에이전트 관리 → 다운로드 및 설치로 이동합니다.
다운로드 버튼을 눌러 Windows 에이전트 설치 파일(.exe)을 내려받습니다. 설치할 호스트에서 직접 내려받는 것이 편합니다.
같은 화면의 설치 토큰을 복사해 둡니다. 설치 중에 이 토큰을 입력합니다.
설치 토큰은 조직 안의 모든 호스트에 동일하게 사용하는 조직 공용 토큰입니다. 여러 호스트에 설치할 때 호스트마다 새 토큰을 만들 필요가 없습니다. 토큰이 유출되었다면 토큰 재발급으로 새로 발급할 수 있으며, 재발급하면 기존 토큰은 즉시 무효화됩니다(이미 등록된 에이전트는 영향을 받지 않습니다).
2. 설치와 토큰 입력
내려받은 설치 파일을 관리자 권한으로 실행합니다. Windows 사용자 계정 컨트롤(UAC) 창("이 앱이 디바이스를 변경하도록 허용하시겠습니까?")이 나타나면 예를 누릅니다.
설치 마법사의 안내에 따라 설치 경로 등을 확인하고 설치를 완료합니다.
설치가 끝나면 에이전트 설정 화면이 자동으로 열립니다. 앞서 복사한 설치 토큰을 붙여넣고 등록 요청을 제출합니다.
등록 요청이 제출되면 에이전트는 승인 대기 상태가 됩니다. 이 상태에서는 아직 자산 수집·점검을 하지 않고 연결 상태만 주기적으로 알립니다.
설치 토큰을 잘못 입력하면 등록 요청이 제출되지 않습니다. 다운로드 화면의 토큰을 다시 복사해 붙여넣으세요. 토큰 앞뒤에 공백이 들어가지 않도록 주의합니다.
3. 관리자 승인
에이전트가 등록을 요청하면 조직 관리자가 승인해야 활성화됩니다.
포털에서 에이전트 관리 → 등록 요청으로 이동합니다.
대기 중 탭에서 방금 설치한 호스트의 등록 요청을 확인합니다. 호스트명·IP·MAC·OS·버전으로 어떤 호스트인지 식별할 수 있습니다.
요청이 맞으면 승인을 누릅니다. 승인하면 에이전트가 생성되고, 잠시 후 온라인 상태로 전환됩니다.
확인되지 않은 요청은 거부할 수 있습니다. 거부할 때 사유를 남길 수 있습니다.
승인 직후에는 에이전트가 서버와 정식 연결을 맺느라 잠깐 시간이 걸릴 수 있습니다. 목록에서 상태가 온라인으로 바뀌면 준비가 끝난 것입니다.
에이전트 상태
설치·승인 이후 에이전트 상태는 화면에서 다음과 같이 확인합니다.
- 승인 대기 — 등록 요청은 제출되었으나 아직 승인 전입니다. 등록 요청 화면의 대기 중 탭에서 관리합니다.
- 온라인 — 정상적으로 연결되어 자산 수집과 점검을 수행할 수 있습니다.
- 오프라인 — 호스트가 꺼져 있거나 네트워크가 끊겨 서버와 연결되지 않은 상태입니다.
- 업데이트 필요 — 새 에이전트 버전이 나온 상태입니다. 에이전트는 자동으로 업데이트되므로 대개 별도 조치가 필요 없습니다.
- 기능 제한 — 업데이트가 오래(약 14일 이상) 이뤄지지 않아 일부 기능이 제한된 상태입니다.
- 연결 차단 — 업데이트가 매우 오래(약 30일 이상) 이뤄지지 않아 서버 연결이 차단된 상태입니다.
승인이 끝나 온라인이 된 에이전트는 네트워크의 호스트·무선 자산을 자동으로 수집합니다. 상태 확인과 자동 업데이트·오프라인·재설치·제거 등 설치 이후 운영은 에이전트 관리하기에서 자세히 다룹니다.
자주 막히는 부분
- 관리자 권한이 없어 설치가 안 됩니다 — 설치 파일을 마우스 오른쪽 버튼으로 눌러 관리자 권한으로 실행하거나, 관리자 계정으로 로그인해 설치하세요. UAC 창에서 예를 눌러야 설치가 진행됩니다.
- 등록 요청이 서버에 도착하지 않습니다 — 호스트가 인터넷에 연결되어 있고, 사내 방화벽에서 보안링스 서버로 나가는 HTTPS(443) 연결이 허용되어야 합니다. 방화벽에 등록할 정확한 주소는 포털 안내 또는 관리자에게 확인하세요.
- 설치 토큰이 유효하지 않다고 합니다 — 다운로드 화면의 토큰을 다시 복사해 붙여넣으세요. 토큰을 재발급했다면 이전 토큰은 무효이므로 새 토큰을 사용해야 합니다.
- 이미 설치되어 있습니다 — 한 호스트에는 에이전트를 한 번만 설치합니다. 다시 설치하려면 기존 에이전트를 제거한 뒤 설치하세요.
- 승인 대기에서 넘어가지 않습니다 — 등록 요청은 조직 관리자만 승인할 수 있습니다. 본인이 관리자가 아니라면 관리자에게 등록 요청 승인을 요청하세요.
설치한 다음
에이전트가 온라인이 되면 다음으로 넘어갑니다.
- 네트워크·호스트 자산 수집 — 에이전트가 발견한 호스트·무선 AP를 자산으로 등록합니다.
- 웹사이트 등록 — 웹사이트는 에이전트 없이 직접 등록합니다.