안면인증 API 연동 가이드: 촬영·위변조 판별·얼굴 매칭 결과 처리

트렌드
2026-10-21

안면인증 API 연동은 어떤 순서로 진행하나요?

안면인증 API 연동은 비교 기준이 되는 얼굴을 정하고, 고객 얼굴을 촬영한 뒤 위변조 판별을 거쳐 얼굴 매칭을 요청하고, 그 결과를 통과·재촬영·추가 확인으로 나눠 처리하는 순서로 진행합니다. 연동에서 가장 시간이 드는 부분은 API 호출 자체보다 결과 처리입니다. 위변조 의심이 나왔을 때, 매칭 점수가 기준에 조금 못 미칠 때, 촬영 품질이 낮을 때 각각 어떻게 할지 정하지 않으면 정상 고객이 반복해서 실패하거나 위변조 시도가 통과할 수 있습니다. 이 글은 안면인증 API를 서비스에 붙이는 개발·기획 담당자가 연동 준비, 단계별 구현, 결과 처리, 테스트를 어떻게 진행하는지 정리합니다. 안면인증 API의 개념은 비대면 얼굴인증 API란? 글에서 다루고, 이 글은 연동과 결과 처리에 집중합니다.

‍

연동 전에 무엇을 준비하나요?

연동을 시작하기 전에 다음 네 가지를 정해 두면 개발 중에 구조를 다시 바꾸는 일이 줄어듭니다.

비교 기준이 되는 얼굴

안면인증은 지금 촬영한 얼굴을 무엇과 비교할지부터 정해야 합니다. 비대면 가입이나 계좌 개설이라면 신분증의 얼굴 사진이 기준이 되고, 이미 가입한 고객의 재인증이라면 가입 때 확인을 마친 결과가 기준이 됩니다. 기준 얼굴을 어디서 가져오고 얼마나 보관하는지에 따라 개인정보 처리 방식도 달라집니다.

‍

API 키와 테스트·운영 환경

API 키는 서버에만 보관하고 앱이나 웹 화면 코드에 넣지 않습니다. 테스트용과 운영용 키와 요청 주소를 나눠 관리하고, 연동 문서에서 위변조 판별 결과와 매칭 결과가 각각 어떤 값으로 오는지, 오류는 어떤 코드로 구분되는지 먼저 정리해 둡니다.

결과 저장 구조

요청마다 고유번호를 붙이고, 그 아래 위변조 판별 결과, 매칭 결과, 최종 판정, 처리 일시를 단계별로 저장합니다. 얼굴 이미지는 저장하지 않거나 보관 기간을 최소한으로 정하고, 서비스에는 결과와 일시를 남기는 방식이 개인정보 처리 면에서 유리합니다.

생체정보 처리 동의

얼굴 이미지는 민감한 정보이므로, 왜 얼굴을 촬영하는지와 이미지를 어떻게 처리하는지 촬영 전에 알리고 동의를 받는 화면을 준비합니다. 동의 화면은 법무·개인정보 담당자와 함께 문구를 확정합니다.

‍

단계별로 어떻게 구현하나요?

준비가 끝나면 다음 다섯 단계로 구현합니다. 구체적인 요청 항목과 응답 형식은 제공사의 연동 문서를 따릅니다.

1단계: 얼굴 촬영 화면

화면에 얼굴 가이드를 띄우고, 얼굴이 가이드 안에 들어오면 촬영합니다. 너무 어둡거나 얼굴이 가려졌거나 흔들린 이미지는 서버로 보내기 전에 바로 다시 찍게 하면 불필요한 요청이 줄어듭니다. 모자나 마스크를 벗어 달라는 안내는 촬영 직전에 짧게 보여줍니다.

2단계: 위변조 판별 요청

촬영한 얼굴이 실제 사람인지, 사진이나 화면, 마스크를 비춘 것인지 판별을 요청합니다. 위변조 판별을 통과하지 못한 이미지로는 얼굴 매칭을 요청하지 않습니다. 위변조 판별 결과는 매칭 결과와 따로 저장해 두어야, 나중에 실패 원인이 위변조 의심이었는지 얼굴 불일치였는지 구분할 수 있습니다.

‍

‍

3단계: 얼굴 매칭 요청

위변조 판별을 통과한 얼굴과 기준 얼굴을 함께 보내 같은 사람인지 매칭을 요청합니다. 신분증 사진이 기준이라면 신분증 촬영 단계에서 추출한 얼굴 영역을 그대로 씁니다.

4단계: 결과 판정

위변조 판별 결과와 매칭 결과를 함께 보고 통과, 재촬영, 추가 확인 중 하나로 판정합니다. 판정 규칙은 코드 여러 곳에 흩어 두지 말고 서버 한 곳에서 관리해야, 기준을 바꿀 때 빠뜨리는 곳이 생기지 않습니다.

5단계: 결과 저장과 이미지 삭제

판정 결과와 일시를 요청 고유번호 아래 저장하고, 얼굴 이미지는 정해진 기준에 따라 바로 지웁니다. 판정 결과를 다음 단계(가입 완료, 계좌 개설, 거래 승인 등)에 넘길 때는 결과만 넘기고 이미지는 넘기지 않습니다. 같은 고객이 짧은 시간 안에 다시 인증하는 경우를 위해, 통과 결과의 유효 시간을 정해 두는 것도 좋습니다.

알체라 eKYC로 연동하면

알체라 eKYC의 얼굴 인증은 촬영된 사진에서 얼굴을 검출해 위변조 여부를 판별하고 신분증 사진과 매칭해 동일인 여부를 확인하며, 신분증 OCR·진위확인·사본판별과 같은 흐름으로 API 연동할 수 있습니다. RGB 카메라 기반으로 iBeta 얼굴 위변조 탐지(PAD) 평가를 통과했고, 신분증 OCR 정확도는 98.47%, 사본판별 정확도는 99%입니다. 알체라 eKYC는 고객사 110곳, 누적 1,430만 회 인증, 제1금융권 70%가 사용하고 있습니다.

‍

결과는 어떻게 처리하나요?

안면인증 API 결과 처리는 위변조 판별, 매칭 결과, 촬영 품질을 나눠 보고 각각 다른 다음 단계로 보내는 것이 핵심입니다.

위변조 의심 결과

위변조 의심이 나오면 매칭으로 넘기지 않습니다. 정상 고객이 조명이나 화면 반사 때문에 의심 판정을 받는 경우도 있으므로, 처음에는 재촬영을 한 번 허용하고, 같은 결과가 반복되면 진행을 멈추고 추가 확인으로 넘깁니다. 고객에게는 위변조 판정 이유를 구체적으로 알려주지 않고, 밝은 곳에서 직접 다시 촬영해 달라고만 안내합니다.

매칭 결과와 기준값

매칭 결과는 제공사에 따라 일치 여부로 오거나 점수로 옵니다. 점수로 받는다면 통과 기준값을 서비스가 정해야 하며, 기준을 너무 높게 잡으면 정상 고객이 실패하고 너무 낮게 잡으면 다른 사람이 통과할 수 있습니다. 업무 위험도에 따라 기준값을 다르게 두고, 기준에 조금 못 미치는 구간은 바로 실패로 처리하지 않고 재촬영으로 보내는 방법도 있습니다. 예를 들어 회원가입 단계와 고액 거래 승인 단계는 같은 고객이라도 서로 다른 기준값을 쓸 수 있습니다.

‍

 

재촬영 안내

재촬영은 실패 이유에 맞춰 안내합니다. 어두우면 밝은 곳으로, 얼굴이 가려졌으면 모자나 마스크를 벗도록, 각도가 틀어졌으면 화면을 정면으로 보도록 바로 따라 할 수 있는 문장으로 씁니다. 재촬영 횟수는 정해 두고, 넘기면 다른 확인 방법으로 안내합니다.

추가 확인으로 넘기기

재촬영 횟수를 넘긴 고객이나 위변조 의심이 반복된 시도는 담당자 검토, 영상통화, 다른 본인 확인 수단 같은 추가 확인으로 넘깁니다. 추가 확인 결과도 사유와 함께 기록해 두면, 이후 기준값을 조정하는 근거로 쓸 수 있습니다. 추가 확인으로 넘어간 고객이 결국 정상 고객으로 확인된 비율이 높다면 기준값이 너무 엄격하다는 신호이고, 위변조로 확인된 비율이 높다면 기준을 유지하거나 더 엄격하게 둘 근거가 됩니다.

‍

운영 전에 무엇을 테스트하나요?

운영에 적용하기 전에 다음 상황을 일부러 만들어 판정과 안내, 기록이 제대로 남는지 확인합니다.

테스트할 시나리오

  1. 밝은 곳에서 본인 얼굴로 한 번에 통과하는 경우
  2. 어두운 곳이나 역광에서 촬영해 재촬영 안내가 나오는 경우
  3. 다른 사람의 사진을 화면에 띄워 비추는 경우
  4. 오래된 신분증 사진과 대조하는 경우
  5. 재촬영 횟수를 넘겨 추가 확인으로 넘어가는 경우
  6. 응답이 늦어 결과를 조회로 확인하는 경우

‍

운영 지표

운영을 시작하면 위변조 의심 비율, 매칭 실패 비율, 재촬영 비율, 추가 확인으로 넘어간 비율을 나눠 봅니다. 기기 종류와 시간대별로도 나눠 보면 특정 카메라나 야간 조명에서만 생기는 문제를 빨리 찾을 수 있습니다. 재촬영 비율이 갑자기 늘었다면 촬영 화면 안내 문구나 앱 업데이트 이후 카메라 설정이 바뀌지 않았는지도 함께 확인합니다.

기준 변경 기록

매칭 기준값이나 재촬영 횟수를 바꿀 때는 변경 일시와 이유를 남기고, 바꾼 전후로 정상 고객의 실패율과 위변조 차단 결과를 비교합니다. 한 번에 여러 기준을 바꾸면 어떤 변경이 결과에 영향을 줬는지 알 수 없으므로, 기준은 하나씩 바꿉니다.

‍

정리: 안면인증 API 연동 기준

  • 안면인증 API 연동은 기준 얼굴 정하기, 얼굴 촬영, 위변조 판별, 얼굴 매칭, 결과 판정과 저장 순서로 진행합니다.
  • 위변조 판별을 통과하지 못한 이미지로는 매칭을 요청하지 않고, 판정 규칙은 서버 한 곳에서 관리합니다.
  • 결과는 통과, 재촬영, 추가 확인으로 나누고, 매칭 기준값은 업무 위험도에 따라 정합니다.
  • 얼굴 이미지는 최소한으로 보관하고 결과와 일시만 다음 단계로 넘기며, 운영 중에는 위변조 의심·매칭 실패·재촬영 비율을 봅니다.

‍