FR Settings

FR 설정

채널별 얼굴인식(Face Recognition) 동작을 세밀하게 조정합니다. 모든 설정은 채널 설정 → FR 탭에서 변경할 수 있습니다.

엔진 선택

register / verify / identify / compare 각각 독립적으로 엔진을 지정할 수 있습니다.

옵션설명
mangosteen기본 엔진. register는 복수 지정 가능합니다.
엔진을 변경하면 기존에 등록된 얼굴 벡터와 호환되지 않을 수 있습니다. 변경 후에는 전체 재등록을 권장합니다.

임계값 (threshold)

얼굴 유사도 점수가 이 값 이상이면 인증 성공으로 판단합니다. 기본값은 0.7입니다.

옵션설명
0.5 미만유사도 조건이 느슨합니다. 본인 인증 실패(FRR)는 줄지만 타인 인증 허용(FAR)이 높아집니다.
0.7 (기본)일반적인 출입통제·본인확인에 권장합니다.
0.8 이상엄격한 인증이 필요한 금융·의료 서비스에 적합합니다. 마스크·조명 변화에 취약할 수 있습니다.
임계값은 테스트 환경에서 충분히 검증 후 프로덕션에 적용하세요. 운영 중 값 변경은 즉시 반영됩니다.

라이브니스 검증 (liveness)

실물 얼굴 여부를 검증해 사진·영상을 이용한 스푸핑 공격을 방지합니다.

옵션설명
true라이브니스 검증 활성화. 실물 얼굴이 아니면 인증을 거부합니다. eKYC·금융 서비스에 권장합니다.
false (기본)라이브니스 검증 비활성화. 응답 속도가 빨라지지만 스푸핑에 취약합니다. 신뢰된 환경에서만 사용하세요.

중복 등록 방지 (duplicateCheck)

동일한 얼굴이 이미 채널에 등록되어 있으면 등록을 거부합니다.

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

검색 범위 (searchScope)

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

옵션설명
channel (기본)현재 채널에 등록된 얼굴만 검색합니다.
client계정 전체 채널에서 검색합니다.

이미지 보존 (imageRetention)

API 호출 시 수신한 얼굴 이미지를 암호화하여 보존하는 기간을 설정합니다. 보존된 이미지는 트랜잭션 로그에서 조회할 수 있습니다.

옵션설명
none (기본)이미지를 저장하지 않습니다. 개인정보 최소 수집 원칙에 부합합니다.
30d30일간 보존 후 자동 삭제합니다.
90d90일간 보존합니다.
1y1년간 보존합니다.
unlimited삭제하지 않고 무기한 보존합니다.
생체정보 보존은 개인정보보호법 및 신용정보법에 따른 별도 동의가 필요합니다.none 이외의 값을 설정할 때는 requireConsent도 함께 활성화하세요.