FileRisk, 파일 악성코드 검사 API

왜 만들었나

파일이 오가는 서비스라면 올라온 파일이 안전한지 확인해야 합니다. 그런데 상용 검사 엔진은 비용이 크고, 외부 검사 서비스에 파일을 넘기면 고객의 파일이 어디에 남는지 알 수 없습니다. 검사 서비스가 또 하나의 위험이 되어서는 안 됩니다.

그래서 파일을 남기지 않는 구조로 검사 API를 만들었습니다. 웹사이트 업로드, 파일 스토리지, 이메일 첨부, 사내 단말, 문서 수집 파이프라인, 업무 시스템까지 파일을 API로 보낼 수 있는 곳이면 어디든 붙습니다. BITBOX CLOUD의 파일 검사에도 같은 API를 씁니다.

무엇을 할 수 있나

세 단계 연동

검사를 요청해 업로드 주소를 받고, 그 주소로 파일을 올리고, 판정을 받습니다. 파일이 이미 저장소에 있으면 서명 URL만 넘겨 FileRisk가 직접 가져가게 할 수 있습니다. 같은 파일이 반복해서 들어오면 SHA-256 해시만 보내 업로드 없이 판정을 받습니다. 결과는 조회 API로 보거나 서명된 웹훅으로 받습니다.

여섯 가지 판정과 근거

정상, 악성, 의심, 검사 불가, 오류, 형식 검증됨. 어떤 엔진이 무엇을 보고 판단했는지 근거 목록과 엔진·시그니처 버전을 함께 돌려주므로 결과를 그대로 기록하고 설명할 수 있습니다. 검사 시간이 넘거나 엔진에 문제가 생기면 정상이 아니라 오류로 알리고, 암호 압축처럼 안을 확인할 수 없는 파일은 검사 불가로 구분합니다.

여러 층의 검사

• 악성코드 시그니처. 알려진 악성코드를 찾고 시그니처는 자동으로 갱신됩니다.
• 탐지 룰. 웹셸과 악성 스크립트를 찾고 걸린 룰을 근거로 남깁니다.
• 형식 위장 탐지. 확장자와 실제 형식이 다른 파일, 이중 확장자, 이미지 안에 숨긴 코드, 스크립트가 든 SVG를 찾습니다.
• 압축 구조 검사. zip, gzip, bzip2, xz, tar를 직접 풀어 압축 폭탄과 깊은 중첩을 확인합니다.
• 대용량 미디어 형식 검증. 100MB를 넘는 동영상·음성 원본은 필요한 구간만 검사해 파일 구조가 형식과 맞는지 확인합니다.
• 해시 캐시. 이미 검사한 파일은 업로드 없이 바로 판정을 받습니다.

믿고 맡길 수 있는 검사

• 파일을 보관하지 않습니다. 검사가 끝나면 바로 삭제하고 판정과 근거만 남깁니다. 탐지된 파일을 외부로 내보내는 기능도 없습니다.
• 파일 본문은 API 서버를 거치지 않고 검사 서버로 직접 전송됩니다.
• 오류를 정상으로 넘기지 않습니다. 확인하지 못한 파일은 검사 불가나 오류로 알립니다.
• 공개하기 전에 정상 파일 수십만 개로 오탐과 검사 시간을 점검했습니다.

시작하기

무료 요금제로 바로 연동해 보고, 검사량에 맞춰 요금제를 올리면 됩니다. API 문서와 OpenAPI 명세를 공개하고 있습니다.