Discover

Get Started

Developers

Industries

Integrate Kaspersky KES Antivirus

개요

파일 전송 시 Kaspersky KES으로 파일을 검사(스캔)하여 위협을 차단·탐지하려면 Kaspersky KES 백신 연동을 설정할 수 있습니다.

연동을 완료하면 설정한 검사 시점(Scan timing)에 파일을 검사하고, 위협이 탐지되면 지정한 처리 방식(On detection)에 따라 전송을 차단하거나 경고합니다. 검사 대상은 검사 범위(Scan scope)로 지정합니다.

전체 과정은 ① 자격 증명 확인 → ② 제품에서 연동 설정 두 단계로 진행됩니다.

준비 사항

시작하기 전에 다음 사항을 확인하세요.

항목설명
Kaspersky KES파일 검사에 사용할 Kaspersky KES 환경과 API 접근 권한이 필요합니다.
API 자격 증명API Token이 필요합니다.
네트워크제품이 설치된 환경에서 Kaspersky API 엔드포인트로의 외부 HTTPS(443) 통신이 허용되어야 합니다.

자격 증명 확인

Kaspersky KES로 파일을 검사하려면 API Token이 필요합니다.

Step 1. API Token 발급

관리 콘솔의 API 접근 설정에서 API Token을 발급하거나 확인하고 복사합니다.

이 값은 비밀번호와 같아, 값을 아는 사람은 검사 API에 접근할 수 있으므로 공개 저장소나 외부 문서에 노출되지 않도록 주의합니다. 유출된 경우 해당 값을 폐기하고 새로 발급합니다.

13_1

확인 사항

✔ API Token을 발급했습니다.

Kaspersky KES 연동 설정

확인한 자격 증명을 입력하고 검사 옵션을 지정합니다.

Security 설정 창을 열면 아래와 같은 화면이 표시됩니다.

13_2

Step 1. API Token 입력

API Token 항목에 자격 증명 확인에서 발급한 토큰을 입력합니다.

Step 2. Scan timing 선택

Scan timing에서 파일을 언제 검사할지 선택합니다.

옵션설명
Before transfer at source전송 전, 원본(소스)에서 파일을 검사합니다.
After transfer at target전송 후, 대상(타깃)에서 파일을 검사합니다.
Bothway전송 전 원본과 전송 후 대상 양쪽에서 검사합니다.

Step 3. On detection 선택

On detection에서 위협이 탐지되었을 때의 처리 방식을 선택합니다.

옵션설명
Block transfer위협이 탐지되면 전송을 차단합니다.
Alert only전송은 진행하되 경고만 발생시킵니다.
Admin confirm관리자 확인을 거쳐 처리합니다.

Step 4. Scan scope 선택

Scan scope에서 검사할 대상 범위를 선택합니다.

옵션설명
All files전송되는 모든 파일을 검사합니다.
Executable files only실행 파일만 검사합니다.
Custom exceptions사용자가 지정한 예외 규칙에 따라 검사합니다.

Step 5. 설정 저장

입력을 마쳤으면 Add를 클릭하여 연동을 저장합니다.

확인 사항

✔ API Token이 입력되었습니다.

✔ Scan timing, On detection, Scan scope가 선택되었습니다.

연동 확인

설정이 정상적으로 동작하는지 확인합니다.

Step 1. 테스트 파일 전송

실제 파일을 전송하여 검사가 수행되는지 확인합니다. 검사 동작은 백신 표준 테스트 파일(EICAR)처럼 안전한 테스트 파일로 확인할 수 있습니다.

13_3

Step 2. 처리 결과 확인

설정한 처리 방식(On detection)대로 동작하는지 확인합니다. (예: Block transfer이면 전송 차단, Alert only이면 경고 발생)

13_4

확인 사항

✔ 파일 검사가 수행되었습니다.

✔ 설정한 처리 방식대로 동작합니다.

설정 완료

설정을 저장하면 연동이 적용됩니다. 이후 전송되는 파일이 지정한 시점·범위로 검사되며, 위협이 탐지되면 지정한 방식으로 처리됩니다.

문제 해결 (Troubleshooting)

검사가 정상적으로 동작하지 않는 경우 아래 항목을 확인하세요.

문제확인 사항
검사가 수행되지 않음API Token이 정확한지, 앞뒤 공백·누락이 없는지 확인
인증 오류가 발생함API Token이 유효한지, 폐기·재발급되지 않았는지 확인
위협이 탐지되어도 차단되지 않음On detection이 Block transfer로 설정되어 있는지 확인
특정 파일이 검사되지 않음Scan scope 설정(All files / Executable files only / Custom exceptions)을 확인
전송이 느려짐Scan timing이 Bothway이면 양방향 검사로 시간이 더 소요될 수 있음 (필요 시 조정)
폐쇄망에서 연동 실패Kaspersky API 엔드포인트(443) 아웃바운드 통신이 허용되는지 확인