API 키는 개발자의 API 키에, 워크플로우 ID는 워크플로우 페이지에, 웹훅 서명 시크릿은 개발자의 웹훅에서 엔드포인트별로 확인합니다.

간단한 답변

콘솔에서 세 가지 값이 필요합니다. API 키는 개발자 → API 키에서 만듭니다. 워크플로우 ID는 워크플로우 페이지에서 복사합니다. 웹훅 서명 시크릿은 개발자 → 웹훅에서 엔드포인트마다 있으며, 표시로 언제든 다시 확인할 수 있습니다. 세 값 모두 같은 애플리케이션과 같은 환경(라이브 또는 샌드박스)에서 가져오세요.

스타터 앱이나 AI가 생성한 프로젝트에는 DIDIT_API_KEY, DIDIT_WORKFLOW_ID, DIDIT_WEBHOOK_SECRET 같은 환경 변수가 나열되어 있는 경우가 많습니다. 이 이름은 해당 앱의 것이며 Didit이 대신 설정해 주지 않습니다. 아래 표에서 각 값을 어디서 얻는지 확인하세요.

#각 값의 위치

값얻는 곳알아둘 점
API 키개발자 → API 키에서 키 생성(모든 애플리케이션에는 기본 키도 있습니다)전체 시크릿은 키를 만들거나 교체할 때 한 번만 표시되므로 그때 시크릿 관리자에 복사하세요. 라이브 애플리케이션과 샌드박스 애플리케이션은 키가 다르며, 샌드박스 키로는 라이브 인증이 만들어지지 않습니다. x-api-key 헤더에 담아 서버에서만 보내세요
워크플로우 ID신원 확인 → 워크플로우: 행의 메뉴를 열고 워크플로우 ID 복사를 선택(미리보기 패널에도 같은 버튼이 있습니다)워크플로우는 애플리케이션마다 자체 ID가 있습니다. 워크플로우를 복사하면 새 ID가 부여됩니다
웹훅 서명 시크릿개발자 → 웹훅에서 엔드포인트를 열고 서명 시크릿의 표시를 누름애플리케이션이 아니라 엔드포인트마다 시크릿 하나입니다. 표시하려면 본인 확인을 거치며, 60초 안에 시크릿이 다시 숨겨집니다. 필요할 때마다 다시 표시할 수 있습니다
API 기본 URL콘솔에는 없음: docs.didit.me에 명시되어 있습니다https://verification.didit.me가 인증 API(세션, 워크플로우, 목록, 웹훅)를 제공하며 x-api-key 헤더로 인증합니다. API 인증을 참고하세요
참고

API 키와 서명 시크릿은 서로 다른 값입니다. API 키는 Didit에 대한 호출을 인증하고, 서명 시크릿은 웹훅이 실제로 Didit에서 왔는지 확인하게 해 줍니다. 하나를 다른 하나 대신 사용하면 401 또는 서명 불일치가 발생합니다.

#웹훅 서명 시크릿을 다시 볼 수 있나요?

네. 개발자 → 웹훅을 열고 엔드포인트를 연 다음 표시를 누르세요. 본인 확인을 하면 시크릿이 최대 60초간 표시됩니다. 표시가 회색으로 비활성화되어 있다면 접근 권한이 있는 팀원에게 요청하거나 지원팀에 문의하세요. 새 시크릿이 필요하면 교체하세요. 이전 시크릿은 24시간 동안 계속 작동합니다. 자세한 내용은 웹훅으로 인증 결과 받기를 참고하세요.

#설정 확인하기

  1. 환경 맞추기

    먼저 콘솔에서 애플리케이션과 라이브 또는 샌드박스 환경을 선택한 다음, 거기서 키와 워크플로우 ID를 복사하고 웹훅 엔드포인트를 만드세요. 샌드박스 키에 라이브 워크플로우 ID를 쓰는 것이 401 또는 403의 흔한 원인입니다.

  2. 값을 서버 설정에 넣기

    서버 측 시크릿으로 저장하세요. API 키나 서명 시크릿을 프런트엔드 코드, 공개 저장소, 모바일 앱에 넣지 마세요.

  3. 세션 만들기

    키와 워크플로우 ID로 https://verification.didit.me의 세션 생성 엔드포인트를 호출합니다. 401은 키가 잘못되었거나 만료되었거나 철회되었다는 뜻이고, 워크플로우에 대한 403은 보통 키가 다른 애플리케이션의 것이라는 뜻입니다. API 오류를 참고하세요.

  4. 테스트 이벤트 보내기

    개발자 → 웹훅에서 엔드포인트를 열고 테스트 이벤트 전송을 누릅니다. 서버는 서명 시크릿으로 서명을 확인하고 2xx로 응답해야 합니다. 아무것도 도착하지 않으면 웹훅이 도착하지 않을 때를 참고하세요.

#관련 문서

아직 해결되지 않았나요? 담당자와 이야기하세요.

조직 ID와 문의할 세션 ID를 함께 보내 주세요.

지원팀에 문의