FR 설정 — FIDOX 콘솔 가이드

식별 검색 범위 (searchScope)

identify(1:N 검색) 시 얼굴을 검색하는 범위를 지정합니다.

옵션	설명
channel (기본)	현재 채널에 등록된 얼굴만 검색합니다.
client	같은 고객사(client)의 모든 채널에 등록된 얼굴을 통합 검색합니다.

register 시 수신한 얼굴 이미지 원본의 보관 기간을 설정합니다. 보존된 이미지는 FR 로그 상세에서 조회할 수 있으며, 만료 시 매일 새벽 자동 삭제됩니다.

옵션	설명
none (기본)	이미지를 저장하지 않습니다(즉시 삭제). 개인정보 최소 수집 원칙에 부합합니다.
30d	30일간 보존 후 자동 삭제.
90d	90일간 보존.
1y	1년간 보존.
unlimited	삭제하지 않고 무기한 보존.

생체정보(원본 이미지) 보존은 개인정보보호법에 따라 정보 주체의 별도 동의가 필요합니다.none 이외의 값을 사용할 때는 requireConsent도 함께 활성화하고 사용자에게 명시적 동의를 받으세요.

register / verify / identify API 요청 시 consent 파라미터를 필수로 요구합니다. 누락 또는 false 전달 시 요청이 거부됩니다.

옵션	설명
true	모든 호출에 consent=true 필수. 개인정보보호법상 별도 동의 의무를 시스템 차원에서 강제합니다.
false (기본)	consent 파라미터 없이도 요청이 허용됩니다. 규제 대상(eKYC·금융 등)에서는 반드시 true로 설정하세요.

register 호출 시 동일 채널에 유사한 얼굴이 이미 등록되어 있는지 1:N 식별을 선행해 중복 등록을 방지합니다.

옵션	설명
true	이미 등록된 얼굴과 임계값 이상으로 유사하면 register 요청을 거부합니다. 1인 1계정·중복 가입 방지에 사용합니다.
false (기본)	중복 등록을 허용합니다. 동일인이 여러 userCode로 등록될 수 있습니다.

다음 항목은 채널 설정 화면에서 노출되지 않습니다.

옵션	설명
라이브니스 (withLiveness)	채널 옵션이 아닌 요청별 파라미터입니다. verify/identify 호출 시 withLiveness=true를 함께 보내면 실물 검증이 수행됩니다.
임계값 (threshold)	엔진별 매칭 임계값. 운영팀이 관리하는 admin-only 항목으로, 사용자 콘솔에서는 변경할 수 없습니다(기본 0.7).
엔진 (engine)	현재 단일 엔진(mangosteen)이 운영 중이며 admin-only로 관리됩니다.

임계값·엔진 조정이 필요하면 고객지원으로 문의하세요. 라이브니스는 코드에서 호출 옵션으로 켜고 끌 수 있습니다.