# API 키, 워크플로우 ID, 웹훅 시크릿은 어디에서 찾나요?

Source: https://help.didit.me/ko/integration/api-key-workflow-id-and-webhook-secret
Updated: 2026-11-12

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 인증](https://docs.didit.me/getting-started/api-authentication)을 참고하세요 |

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

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

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

## 설정 확인하기

1. **환경 맞추기**

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

2. **값을 서버 설정에 넣기**

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

3. **세션 만들기**

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

4. **테스트 이벤트 보내기**

   **개발자 → 웹훅**에서 엔드포인트를 열고 **테스트 이벤트 전송**을 누릅니다. 서버는 서명 시크릿으로 서명을 확인하고 2xx로 응답해야 합니다. 아무것도 도착하지 않으면 [웹훅이 도착하지 않을 때](https://help.didit.me/ko/integration/webhook-troubleshooting)를 참고하세요.

## 관련 문서

- [API 키 관리](https://help.didit.me/ko/account-organization/api-keys)
- [웹훅으로 인증 결과 받기](https://help.didit.me/ko/integration/webhooks-basics)
- [인증 워크플로우 만들기](https://help.didit.me/ko/workflows/build-a-verification-workflow)
- docs.didit.me의 [API 인증](https://docs.didit.me/getting-started/api-authentication)