메인 콘텐츠로 건너뛰기
노코드로 KYC 인증 워크플로 만들기 (전체 튜토리얼) 전문 - Didit Academy 영상 3/10, 18:54. YouTube에서 보기. 각 단락은 영상의 해당 시점으로 연결됩니다.
2026년 11월 1일부로 요금이 변경되었습니다. 업무용 이메일로 가입한 조직에 제공되던 월 500건의 무료 검사가 월 $10 크레딧으로 바뀌었습니다. 영상은 이전 요금 기준입니다.

​
워크플로란 무엇인가

00:03 이 영상에서는 코드를 한 줄도 쓰지 않고 처음부터 완전한 인증 흐름을 만들어 보겠습니다. 워크플로는 쉽게 말해 인증을 위한 레시피입니다. 어떤 검사를 어떤 순서로 실행할지 정하는 것이죠. 보통 이런 작업은 엔지니어의 몫이지만, Didit에서는 직접 시각적으로 구성할 수 있습니다. 구성하면서 가격이 바뀌는 것도 바로 확인할 수 있고, 준비가 되면 언제든 실서비스에 배포할 수 있습니다. 00:28 직접 만들어 보고 싶다면 didit.me에 방문해 무료로 가입한 뒤, 몇 분 안에 첫 워크플로를 완성해 보세요. 자, 모든 인증 흐름이 시작되는 곳부터 살펴보겠습니다. 바로 이곳입니다.

​
워크플로 목록과 워크플로 ID

00:39 구성 탭 아래에 있는 워크플로 목록입니다. 이 계정에 현재 있는 워크플로가 모두 여기 보이고, 각 워크플로의 유형도 확인할 수 있습니다. KYC와 KYB가 있고, 간단형과 그래프형이 있습니다. 워크플로마다 포함된 검사와 기능을 모두 볼 수 있고, 가격 차이도 확인할 수 있습니다. 즉, 검사 하나만 하고 완료하지 않은 사용자의 가격과 전체 흐름을 끝까지 완료한 사용자의 가격 차이를 보여 줍니다. 워크플로마다 링크도 있습니다. 01:09 세션을 수동으로 추가할 수도 있고, 워크플로 ID를 복사할 수도 있습니다. 복제, 이름 변경, 보관 등 평소 쓰던 기능도 모두 있습니다. 여기 보이는 것이 이 워크플로의 ID입니다. 같은 워크플로의 여러 버전은 모두 이 ID로 실행됩니다. 그래서 워크플로를 수정해도 코드나 앱에서 바꿀 것이 전혀 없습니다. 워크플로는 결국 인증을 위한 레시피라고 생각하면 가장 간단합니다. 어떤 검사를 어떤 순서로 실행할지, 어떤 규칙을 따를지를 정하는 것이죠. 앞서 말씀드렸듯이 워크플로에는 두 가지 구조가 있습니다.

​
간단형 워크플로와 그래프형 워크플로

01:40 앞서 말씀드린 대로 간단형과 그래프형이 있습니다. 간단형 흐름은 검사 한 개 또는 몇 개로 구성되며 분기가 전혀 없습니다. 조건 로직도 없습니다. 설정이 빠르고 대부분의 경우에 충분합니다. 모듈만 고르면 끝입니다. 이 예시 워크플로를 보시면, 왼쪽에서 모듈을 선택하면 순서대로 자동 배치되는 것을 볼 수 있습니다. 이제 그래프형 워크플로를 살펴보겠습니다.

​
분기가 있는 그래프형 워크플로

02:05 그래프 기반 워크플로를 클릭해 들어가 보면 마지막에 분기가 있는 것이 보입니다. 그래서 사용자를 인증 흐름의 어느 지점으로 보낼지 더 세밀하게 정할 수 있습니다. 이 워크플로에는 분기 지점이 여러 개 있습니다. 웹훅 호출도 포함할 수 있고, 필요하다면 복잡도를 조금 더 높일 수도 있습니다. 02:30 참고로 KYB 워크플로도 구조는 똑같고 검사 종류만 다릅니다. 이제 검사를 추가하려면 여기서 넣으면 됩니다. 사용자 작업 중 하나를 가져오거나, 백그라운드 검사를 설정할 수 있습니다. 사용자 화면에는 보이지 않는 검사들입니다.

​
템플릿으로 새 워크플로 만들기

02:51 새 워크플로 버튼을 누르기만 하면 됩니다. 여기 몇 가지 옵션이 있습니다. KYC와 KYB가 있죠. KYC를 누르겠습니다. 앞서 보여 드린 것처럼 간단형과 고급형이 있는데, 두 가지를 모두 보여 드리겠습니다. 간단형을 누르면 다양한 업종의 템플릿이 많이 있습니다. 각 템플릿의 비용도 볼 수 있습니다. 연령 제한, 이메일 인증이 있습니다. 03:19 생체 인증, 보험, 의료 등 여러 가지가 있습니다. 이번에는 기업 확인(KYB)을 고급형, 즉 그래프형으로 사용해 보겠습니다. 여기에도 다양한 템플릿, 즉 레시피가 있습니다. 예를 들어 고위험 국가 KYB를 바로 설정할 수 있습니다. 여기서 아무것도 끌어다 놓을 필요가 없습니다. 이미 만들어져 있으니까요.

​
각 노드에서 검사 선택하기

03:48 여기 노드마다 드롭다운이 있습니다. 원하는 검사를 그냥 고르면 됩니다. 여기처럼 바꿀 수도 있고, 등기 검사를 넣을 수도 있습니다. 무엇이든 원하는 대로 고르면 됩니다. 신분증 인증, 라이브니스 감지, 얼굴 대조, AML, 주소 증명. Didit이 KYB와 KYC에 제공하는 모든 검사를 이 노드들 안에서 사용할 수 있습니다. 여기에 검사를 하나 더 추가하고 싶다면, 예를 들어 AML 스크리닝을 추가하고 싶다면 이렇게 넣을 수 있습니다. 탭과 규칙은 잠시 후에 살펴보겠지만, 이 워크플로에는 방금 AML 스크리닝을 추가해 두었습니다. KYC 그래프 워크플로에 들어가 보면 대부분 신분증 인증으로 시작합니다. 가장 일반적인 검사이기 때문입니다.

​
신분증 인증 노드 살펴보기

04:33 이것이 신분증 인증 노드입니다. 신분증 인증에도 월 500건의 무료 검사가 제공되며, 라이브니스 감지와 얼굴 대조에도 각각 동일하게 제공됩니다. 그런데 이 신분증 인증은 카드에서 글자만 읽어 오는 것 이상의 일을 합니다. 문서가 진짜인지 증명하고, 보안 요소를 확인하고, 변조 여부를 살피고, 글꼴과 레이아웃을 읽습니다. 그다음 이름, 생년월일, 문서 번호, 만료일 등 모든 필드를 추출하며, 이 작업은 어떤 언어든 OCR로 처리하고 14,000개 이상의 지원 문서 유형 전체에 적용됩니다. 그러니까 이것은 단순한 텍스트 읽기가 아닙니다. 먼저 진위를 확인하고, 그다음에 데이터를 추출하는 과정입니다. 이제 이 모듈 중 하나를 설정해 보겠습니다.

​
라이브니스 모드와 각 모드의 비용

05:15 라이브니스 모듈을 보면 몇 가지 라이브니스 모드가 있습니다. 패시브 모드는 셀피를 사용해 라이브니스를 감지합니다. 플래시 모드는 동적 조명 패턴으로 라이브니스를 확인해 실제 사용자의 얼굴인지 판별합니다. 3D 동작 모드는 눈 깜빡임이나 고개 돌리기 같은 동작과 함께 조명을 확인합니다. 패시브 라이브니스 검사는 매달 500 무료 크레딧이 제공되며, 그 이후에는 검사 건당 10센트입니다. 플래시 모드와 3D 동작 모드는 검사 건당 15센트입니다. 무료 계정에는 포함된 무료 검사가 없습니다. 그럼 규칙 탭에서

​
규칙: 임계값, 중복 얼굴, 다중 얼굴

05:56 이 설정으로 모듈이 필수인지 선택 사항인지를 정합니다. 규칙 탭에는 여러 옵션이 있습니다. 이를 통해 검사의 민감도를 설정할 수 있습니다. 허용 수준을 지정할 수 있으며, 라이브니스 점수가 70 미만이면 검토 중으로 보냅니다. 필요하면 이 값을 바꿀 수 있습니다. 거부 기준도 같은 방식입니다. 중복 얼굴 설정도 있습니다. 사용자의 얼굴이 이전에 승인된 세션의 얼굴과 일치하면 어떻게 진행할지 정합니다. 승인, 검토, 거부 중에서 선택합니다. 인종에 따라 유사도 임계값을 맞출 수도 있습니다. 인종별로 중복 검사의 민감도를 설정할 수 있다는 뜻입니다. 마지막으로 라이브니스 이미지에서 여러 얼굴이 감지되었을 때 취할 동작을 정의할 수 있습니다. 라이브니스 점수 계산에는 항상 가장 큰 얼굴이 사용됩니다. 이 동작도 여기에서 설정할 수 있습니다. 고급 탭으로 가 보면

​
고급 설정과 품질 임계값

06:56 고급 탭에는 몇 가지 옵션이 있습니다. 얼굴 프라이버시 모드, 최대 라이브니스 시도 횟수가 있습니다. 최대 시도 횟수는 단일 인증 세션 안에서 사용자가 라이브니스 검사를 다시 시도할 수 있는 횟수입니다. 얼굴 품질 임계값도 있습니다. 이 설정이 무엇을 하는지 확실하지 않다면 여기 있는 정보 버튼에 마우스를 올려 보면 됩니다. 얼굴 품질은 이미지의 선명도, 해상도, 날카로움을 측정합니다. 07:20 흐림, 픽셀화, 조명 부족 때문에 품질이 낮은 이미지가 나올 수 있습니다. 그래서 얼굴 품질 점수를 기준으로 임계값을 설정할 수 있습니다. 휘도 임계값도 있습니다. 허용 밝기 범위를 설정할 수 있으며, 밝기가 그 범위보다 낮으면 검토나 거부로 보낼 수 있습니다. 마지막으로, 이 중 어느 것도 원하는 설정과 맞지 않으면 직접 사용자 지정 규칙을 만들 수 있습니다.

​
반환 데이터와 GDPR

07:47 반환 데이터 탭에서는 GDPR 등을 위해 인증 결과에서 제외하려는 데이터 항목을 선택할 수 있습니다. 각 모듈의 검사 가격도 확인할 수 있으며, 그다음 맨 위에서

​
워크플로 요금 계산 방식

08:00 여기에서 총 가격을 확인할 수 있습니다. 요금이 어떻게 계산되는지 차근차근 설명하겠습니다. 각 노드마다 고유한 가격이 있고, 워크플로마다 총비용이 조금씩 다를 수 있기 때문입니다. 실제로 실행된 단계에 대해서만 요금을 냅니다. 각 단계는 개별적으로 과금됩니다. 지원자가 검사 도중에 중단하면 그때까지 거친 몇 개의 검사에 대해서만 요금이 청구됩니다. 그래서 하단에 20센트에서 43센트 사이의 범위가 표시됩니다. 이것이 범위입니다. 지원자가 첫 단계만 거치고 나가면 비용은 20센트입니다. 워크플로를 끝까지 완료하면 43센트입니다. 가운데에는 이 워크플로에 포함된 모든 모듈이 표시됩니다. 매달 제공되는 크레딧도 여기서 확인할 수 있습니다. 무료 크레딧을 모두 사용하고 500건의 검사가 끝나면 그 이후부터 요금이 청구됩니다. 추가할 수 있는 가장 강력한 모듈 중 하나는 카메라 검사가 아닙니다. 그것은

​
정부 등록부 기반 데이터베이스 검증

09:05 데이터베이스 검증입니다. 이를 추가해 보겠습니다. 이것은 배경 검사입니다. 이 데이터베이스 검증 검사가 무엇을 하는지 살펴보겠습니다. 전 세계 공식 정부 등록부와 데이터베이스에 연결되기 때문입니다. 이 검사는 사용자 데이터를 공식 출처와 대조한 뒤, 등록부가 보유한 추가 필드로 정보를 보강합니다. 국가별로 실행할 등록부와 출처를 선택할 수 있습니다. 각 서비스마다 고유한 가격이 표시됩니다. 예를 들어 캐나다에는 여러 서비스가 있고, 등록부마다 가격이 다릅니다. 독일처럼 특정 국가를 보고 싶다면 독일에서 사용할 수 있는 검사를 확인하고 필요에 따라 선택할 수 있습니다. 09:59 이 데이터베이스 검증은 대시보드에서만 실행할 수 있는 것이 아닙니다. 자체 백엔드에서 Didit API를 통해 직접 호출할 수도 있습니다. 다른 모듈과 마찬가지로 규칙, 고급, 반환 데이터 설정이 있습니다. 여기에서 규칙을 설정할 수 있습니다. 부분 일치를 클릭하면 전체 일치가 어떤 모습인지 볼 수 있습니다. 예를 들어 성명과 신분증 번호가 등록부에서 모두 일치하면 전체 일치입니다. 부분 일치는 신분증 번호만 일치하는 경우일 수 있습니다. 그다음 워크플로 안에서 부분 일치를 어떻게 처리할지 정할 수 있습니다. 검토로 보낼지, 거부할지, 승인할지 선택합니다. 그래서 이 워크플로에는 분기 처리가 있습니다. 우리는

​
AML 분기 및 조건부 로직

10:36 AML 위험 점수에 따라 AML 분기를 설정할 수 있습니다. AML은 자금세탁방지의 약자입니다. 아래쪽을 보시면 이 AML 위험 점수에 대한 분기가 이미 구성되어 있습니다. 위험 점수가 70을 넘으면 거부하도록 설정할 수 있고, 여기를 클릭하면 조건부 로직을 확인할 수 있습니다. 보이시죠? 이 부분은 원하는 대로 설정할 수 있습니다. 분기 1과 분기 2가 있고, 그 밖의 모든 경우에는 세션이 승인됩니다. 예를 들어 이 그룹에 속한 사람은 분기 2로 보내집니다. 그러면 추가 정보를 요청할 수 있습니다. 예를 들어 주소 증명을 요청할 수 있습니다. 이렇게 하면 다소 위험해 보이는 사람에게 추가 정보를 요청해서, 이 사람을 승인할지 거부할지 판단하는 데 도움을 받을 수 있습니다. 여기 있는 또 다른 노드는 상태 노드입니다. 이미 추가되어 있지만, 워크플로 끝에 추가해서 최종 결과가 무엇이 될지 결정할 수 있습니다. 그럼 또 다른

​
webhook 노드

11:40 워크플로에 포함할 수 있는 노드 중 하나는 웹훅 노드입니다. 이 흐름은 인증 도중에 자체 시스템에 요청을 보내고 데이터를 받아올 수 있으며, 이 노드가 그 역할을 합니다. endpoint를 호출해 데이터를 가져오고, webhook이 응답할 때까지 기다립니다. 여기에는 post webhook이 있습니다. JSON payload를 변경할 수 있고, 다른 payload를 보낼 수도 있습니다. 이것들은 세션 필드를 전송하는 요청에 매핑하는 키-값 쌍입니다. 응답으로 돌아오는 필드는 다음 분기에서 테스트할 변수가 됩니다. 따라서 Didit 검사와 자체 위험 데이터를 하나의 워크플로 안에서 결합하게 됩니다. 마지막으로 하단에서 헤더를 포함할 수 있습니다. 여기에도 키-값 쌍이 있고, 기본 인증도 설정할 수 있습니다. webhook 호출에서 기대할 수 있는 모든 설정이 여기에 있습니다. Didit은

​
그래프 검증 및 오류

12:28 워크플로를 만드는 동안 그래프를 계속 검증합니다. 노드가 잘못 구성되었거나 경로가 끊어져 있으면 정확히 어디인지 알려 줍니다. 하단을 클릭해 보겠습니다. 플로우에 오류가 두 개 있다고 나옵니다. 분기 1의 규칙이 불완전하다고 나옵니다. 워크플로 안에서 무엇을 고쳐야 하는지 알려 줍니다. 이 오류가 해결되기 전까지는 워크플로를 게시할 수 없습니다. 예를 들어 새로 만든 워크플로에 오류가 있다면 그 워크플로는 게시할 수 없습니다. 개별 노드 외에

​
워크플로 설정: 재시도, 만료, 콜백 URL

12:58 워크플로 상단의 설정 탭에서는 단일 검사가 아니라 워크플로 전체에 적용되는 설정을 확인할 수 있습니다. 워크플로 이름이 있고, 흐름이 끝나면 Didit이 사용자를 리디렉션하는 주소인 콜백 URL이 있습니다. 사용자가 데스크톱에서 계속 진행하도록 하려면 데스크톱 접근을 허용할 수 있습니다. 재시도 횟수도 변경할 수 있습니다. 이는 하나의 인증 세션 안에서 사용자가 이전 시도에 실패했을 때 문서 촬영을 다시 시도할 수 있는 횟수입니다. 세션 만료 설정도 있습니다. 완료되지 않은 세션이 자동으로 만료되기 전까지 얼마나 유효한지를 정합니다. 이 설정은 새로 만든 세션에 적용됩니다. 그리고 재시도 기간이 있습니다. 재시도가 허용되는 일수입니다. 그러므로

​
워크플로 화이트 라벨

13:43 이 워크플로 안에서 위쪽 버튼을 클릭해 커스터마이징 탭으로 이동할 수 있습니다. 화이트 라벨은 워크플로 자체에 직접 연결되어 있습니다. 이 탭에서 인증 흐름의 모습을 조정할 수 있습니다. 색상, 브랜딩, 이메일, 도메인 등 모든 것을 바꿀 수 있습니다. 여기 목업에서는 모바일과 데스크톱에서 각각 어떻게 보일지 확인할 수 있습니다. 14:13 다양한 언어로도 테스트할 수 있습니다. 예를 들어 프랑스어로 바꾸면 모든 검사가 프랑스어로 표시됩니다. 브랜딩을 켜면 커스터마이징 탭에서 설정한 내용이 적용되고, 끄면 적용되지 않습니다. 또한 다른 경로를 선택했을 때 사용자에게 무엇이 전송되는지도 확인할 수 있습니다. 사용자는 경로 선택 모듈을 보지 않지만, 다음 단계에서 무슨 일이 일어날지 시각적으로 확인하는 데 도움이 됩니다. 거부되면 인증 거부됨, 인증 검토 중 또는 인증 완료 상태를 확인할 수 있습니다. 상단에는 링크 복사 기능도 있습니다

​
공유 링크와 사용하지 말아야 할 경우

14:58 상단의 링크를 복사한 다음 새 탭을 열어 링크로 이동하면 사용자가 보게 될 화면을 확인할 수 있습니다. 코드를 전혀 연결하지 않고 흐름만 누군가에게 전달하고 싶을 때가 있습니다. 링크 복사 기능이 바로 그 역할을 합니다. 이 워크플로의 바로 사용할 수 있는 호스팅 URL을 복사합니다. 이는 빠른 테스트나 수동 전송에 유용하지만, 연동에 권장되는 방법은 아닙니다. 프로덕션에서는 SDK나 API를 통해 사용자마다 세션을 생성하고 공급업체 데이터를 함께 전달하면 됩니다. 그래야 webhook과 SDK로 실시간 결과를 받을 수 있습니다. 따라서 링크 복사는 테스트와 이벤트에 적합하고, 프로덕션에 배포할 것은 정식 세션입니다. 그럼

​
버전 기록과 롤백

15:41 화면 상단에 버전 기록이 있습니다. 여기서 이전 버전을 확인하고, 복원하거나 내용을 볼 수 있습니다. 이 워크플로를 편집하면 그 수정 내용은 게시된 기록 위쪽에 초안으로 표시됩니다. 좋은 점은 게시하는 새 버전마다 워크플로 ID가 그대로 유지된다는 것입니다. 백엔드는 항상 같은 ID를 호출하고, 호출은 기록에 따라 가장 최근에 만든 워크플로로 자동 전달됩니다. 따라서 안심하고 반복해서 개선할 수 있고, 필요하면 언제든 이전 버전으로 롤백할 수 있습니다. 예를 들어 여기 있는 이 워크플로는 새로 만든 것이라 초안 모드입니다. 워크플로를 변경하면 초안 상태가 되므로 게시해야 합니다. 그럼 이제

​
워크플로 게시하기

16:24 게시를 누르면 됩니다. 이 워크플로는 게시해야만 실제로 적용됩니다. 게시하면 그래프에 오류가 없는지 검증합니다. 짜잔, 링크를 복사하면 이 워크플로가 바로 적용되어 사용할 수 있습니다. 이제 연동 화면을 살펴보겠습니다.

​
SDK, API 키, 설정 프롬프트로 연동하기

16:37 연동 방법은 여러 가지입니다. 원하는 대상 SDK, 예를 들어 React Native, iOS, React 또는 Next.js를 선택한 다음 워크플로를 고르면 됩니다. 이 예시에서는 고위험 국가 검토 워크플로를 선택했습니다. API 키도 선택할 수 있습니다. 워크플로나 연동마다 다른 API 키를 사용할 수 있으니 원하는 대로 구성하면 됩니다. 또는 webhook을 선택할 수도 있습니다. 판정 결과를 알림으로 받고 싶다면 webhook을 여기에 넣으면 됩니다. 가장 쉬운 연동 방법은 프롬프트를 복사해서 Claude Code나 Codex에 붙여넣는 것입니다. 17:12 이 프롬프트가 워크플로를 연동해 줍니다. 앱에 아직 Didit를 연동하지 않았더라도, 이 프롬프트에 워크플로를 앱에서 실행하는 데 필요한 모든 내용이 들어 있습니다. 사실 이렇게까지 할 필요도 없습니다.

​
MCP 서버로 워크플로 만들기

17:27 Didit MCP 서버를 설치하기만 하면 됩니다. 자연어로 흐름을 설명하면 워크플로를 만들고 앱에 자동으로 연동해 줍니다. 원하는 작업을 말하면 그대로 실행합니다. MCP 설정 방법은 다른 영상에서 자세히 다루겠습니다. MCP는 Model Context Protocol의 약자로, Claude Code, Cursor, Codex 등의 도구에서 자연어로 Didit를 활용해 개발할 수 있게 해 주는 프로토콜입니다. 그럼 이제 커스터마이징을 간단히 살펴보겠습니다. 17:57 공개 이름과 개인정보 처리방침 URL을 입력합니다. 브랜딩 설정에서는 색상을 바꿀 수 있습니다. 웹사이트에서 로고와 색상을 자동으로 가져올 수도 있는데, 이 기능은 매우 유용하고 간편합니다. 여기 아래에서 로고를 업로드할 수 있습니다. 제가 이미 색상을 설정해 두었습니다. 이 색상이 인증 흐름에 어떻게 보이는지 확인하려면 이 스위치를 켜면 됩니다. 그러면 인증 흐름에 화이트 라벨 브랜딩이 적용되는 모습을 볼 수 있습니다. 지금은 다시 끄겠습니다. 맞춤 이메일을 설정할 수도 있습니다. 이때 필요한 정보를 입력해야 합니다. 그다음 인증 단계로 넘어가면 DNS 정보를 확인하고 도메인에 연결하면 됩니다. 서브도메인을 사용하려는 경우도 같은 방식입니다. 이렇게 하면 이 워크플로 전체를 자체 브랜드와 자체 도메인으로 호스팅할 수 있습니다. 따라서 사용자가 인증을 원활하게 진행할 수 있는 매끄러운 프로세스가 됩니다.
마지막 수정일 2026년 11월 7일