Stripe 자격 증명
n8n v2.34요약
이 자격 증명을 사용하여 다음 노드를 인증할 수 있습니다. n8n은 각 웹훅 엔드포인트마다 고유한 키인 Signature Secret(엔드포인트 시크릿이라고도 함)도 설정할 것을 강력히 권장합니다. 이 자격 증명을 구성하려면 Stripe 관리자 또는 개발자 계정이 필요합니다.
이 자격 증명을 사용하여 다음 노드를 인증할 수 있습니다.
지원되는 인증 방법#
- Secret key
n8n은 각 웹훅 엔드포인트마다 고유한 키인 Signature Secret(엔드포인트 시크릿이라고도 함)도 설정할 것을 강력히 권장합니다. 이를 통해 Stripe Trigger 노드가 수신 요청이 실제로 Stripe로부터 온 것인지 확인할 수 있습니다. 설정 단계는 수신 요청 검증을 참고하세요.
관련 자료#
이 자격 증명을 구성하려면 Stripe 관리자 또는 개발자 계정이 필요합니다. 서비스에 대한 자세한 내용은 Stripe API 문서를 참고하세요.
API 키를 생성하기 전에, 라이브 모드에서 생성할지 테스트 모드에서 생성할지 결정하세요. 두 모드에 대한 자세한 내용은 테스트 모드와 라이브 모드를 참고하세요.
라이브 모드 Secret 키#
라이브 모드에서 Secret key를 생성하려면 다음 단계를 따르세요.
- Stripe 개발자 대시보드를 열고 API Keys를 선택합니다.
- Standard Keys 섹션에서 Create secret key를 선택합니다.
n8n integration과 같은 Key name을 입력합니다.- Create를 선택합니다. 새 API 키가 표시됩니다.
- 키를 복사하여 n8n 자격 증명의 Secret Key에 입력합니다.
자세한 내용은 Stripe의 비밀 API 키 생성 문서를 참고하세요.
테스트 모드 Secret 키#
테스트 모드에서 Secret key를 사용하려면 기존 키를 복사해야 합니다.
- Stripe 테스트 모드 개발자 대시보드로 이동하여 API Keys를 선택합니다.
- Standard Keys 섹션에서 Secret key의 Reveal test key를 선택합니다.
- 키를 복사하여 n8n 자격 증명의 Secret Key에 입력합니다.
자세한 내용은 Stripe의 비밀 API 키 생성 문서를 참고하세요.
수신 요청 검증#
n8n 버전 2.25.7 및 2.26.2부터 Stripe Trigger 노드는 수신 웹훅 요청이 실제로 Stripe로부터 온 것인지 검증할 수 있습니다. n8n은 웹훅 URL을 아는 다른 사람이 위조된 이벤트를 워크플로에 보낼 수 없도록 Signature Secret을 설정할 것을 강력히 권장합니다.
n8n은 워크플로를 게시할 때 Stripe 웹훅 엔드포인트를 생성하고 관리해 주므로, 엔드포인트가 존재한 이후에 Signature Secret을 설정합니다.
- Stripe Trigger 노드로 워크플로를 구성하고 게시합니다. n8n이 Stripe 계정에 웹훅 엔드포인트를 생성합니다.
- Stripe 대시보드에서 Workbench > Webhooks로 이동합니다. 이전 버전 대시보드에서는 Developers > Webhooks로 이동합니다.
- n8n이 생성한 엔드포인트를 선택합니다.
Created by n8n for workflow ID: <workflow-id>설명과 n8n 프로덕션 웹훅 URL과 일치하는 웹훅 URL로 식별할 수 있습니다. - Signing secret 아래에서 Click to reveal을 선택하고 값을 복사합니다.
whsec_로 시작합니다. - n8n에서 Stripe 자격 증명을 열고, 값을 Signature Secret 필드에 붙여넣은 다음 저장합니다.
Stripe는 각 엔드포인트마다 고유한 서명 시크릿을 생성하며, 테스트 모드와 라이브 모드에 대해 별도의 시크릿을 생성합니다. 사용 중인 자격 증명에 해당하는 엔드포인트에서 시크릿을 복사하세요. 자세한 내용은 Stripe의 웹훅 문서를 참고하세요.
테스트 모드와 라이브 모드#
모든 Stripe API 요청은 테스트 모드 또는 라이브 모드 중 하나에서 이루어집니다. 각 모드는 자체 API 키를 가집니다.
테스트 모드는 시뮬레이션된 테스트 데이터에 접근할 때, 라이브 모드는 실제 계정 데이터에 접근할 때 사용합니다. 한 모드의 객체는 다른 모드에서 접근할 수 없습니다.
각 모드에서 무엇을 사용할 수 있는지, 그리고 각 모드를 언제 사용해야 하는지에 대한 자세한 내용은 API 키 | 테스트 모드와 라이브 모드를 참고하세요.
두 모드 모두를 위한 n8n 자격 증명
라이브 모드 키와 테스트 모드 키를 모두 사용하고 싶다면, 각 모드의 키를 별도의 n8n 자격 증명에 저장하세요.
키 접두사#
Stripe의 Secret key는 항상 sk_로 시작합니다.
- 라이브 키는
sk_live_로 시작합니다. - 테스트 키는
sk_test_로 시작합니다.
n8n은 Restricted keys(rk_ 접두사)로는 이 자격 증명을 테스트하지 않았습니다.
Publishable keys
n8n 자격 증명에 Publishable keys(pk_ 접두사)를 사용하지 마세요.