이 자격 증명을 사용하여 다음 노드를 인증할 수 있습니다:

• LinkedIn

사전 요구 사항#

• LinkedIn 계정을 만드세요.
• LinkedIn Company Page를 만드세요.

지원되는 인증 방법#

• Community Management OAuth2: 신규 LinkedIn 사용자이거나 새 LinkedIn 앱을 만드는 경우 이 방법을 사용하세요.
• OAuth2: 이전 LinkedIn 앱 및 사용자 계정에는 이 방법을 사용하세요.

관련 자료#

이 서비스에 대한 자세한 내용은 LinkedIn의 Community Management API 문서를 참고하세요.

이 자격 증명은 API 버전 202404와 함께 작동합니다.

Community Management OAuth2 사용하기#

신규 LinkedIn 사용자이거나 새 LinkedIn 앱을 만드는 경우 이 방법을 사용하세요.

이 자격 증명을 구성하려면 LinkedIn 계정, LinkedIn Company Page, 그리고 다음이 필요합니다:

• Client ID: 새 개발자 앱을 만든 후 생성됩니다.
• Client Secret: 새 개발자 앱을 만든 후 생성됩니다.

새 개발자 앱을 만들고 자격 증명을 설정하려면:

1. LinkedIn에 로그인하고 이 링크를 선택하여 새 개발자 앱을 만드세요.
2. 앱의 App name을 입력합니다(예: n8n integration).
3. LinkedIn Page에는 LinkedIn Company Page를 입력하거나, Create a new LinkedIn Page 링크를 사용하여 즉석에서 만드세요. 자세한 내용은 Associate an App with a LinkedIn Page를 참고하세요.
4. App logo를 추가합니다.
5. Legal agreement에 동의하는 체크박스를 선택합니다.
6. Create app을 선택합니다.
7. 그러면 Products 탭이 열립니다. 앱에서 사용하고자 하는 제품/API를 선택하세요. LinkedIn 노드가 작동하려면 다음을 포함하고 구성해야 합니다:
   • Share on LinkedIn
   • Sign In with LinkedIn using OpenID Connect
   • Advertising API(개인 계정이 아닌 조직 계정으로 사용하는 경우)
8. 필요한 제품에 대한 액세스를 요청한 후 Auth 탭을 엽니다.
9. Client ID를 복사하여 n8n 자격 증명에 입력합니다.
10. Primary Client Secret의 Copy 아이콘을 선택합니다. 이를 n8n 자격 증명의 Client Secret으로 입력합니다.

범위 및 권한에 대한 자세한 내용은 Getting Access to LinkedIn APIs를 참고하세요.

Lead Sync API 사용하기#

LinkedIn의 Lead Sync API를 사용하면 웹훅을 통해 LinkedIn 광고 및 유기적 폼(Company Page, 이벤트, 제품)의 리드 폼 응답을 n8n 워크플로로 동기화할 수 있습니다. 이 방법은 더 많은 설정과 LinkedIn 승인이 필요합니다.

사전 요구 사항#

• LinkedIn 개발자 앱(위 단계로 생성)
• 개발자 앱에 연결된 회사 LinkedIn 계정
• Lead Sync API 제품에 대한 액세스(별도 신청 필요)
• 공개적으로 액세스 가능한 HTTPS 웹훅 URL(n8n 워크플로 웹훅 URL)

설정 절차#

1. LinkedIn 개발자 앱 만들기: 위의 Community Management OAuth2 또는 OAuth2 섹션의 단계를 따르세요.
2. 회사 계정 연결하기: 회사 LinkedIn 계정을 개발자 앱에 연결해 달라는 요청을 LinkedIn에 제출하세요. 이 작업은 LinkedIn Developer Portal을 통해 진행됩니다.
3. Lead Sync API 액세스 요청하기:
   • LinkedIn 개발자 앱에서 Products 탭으로 이동합니다.
   • Lead Sync API 제품에 대한 액세스를 요청합니다.
4. 권한 구성하기: 앱에 r_marketing_leadgen_automation 권한이 있는지 확인하세요. 이 권한을 사용하면 다음이 가능합니다:
   • 인증된 회원의 광고 폼 및 유기적 폼에 액세스
   • 폼 응답(리드)에 액세스
   • 리드 알림(웹훅) 관리
5. n8n에서 웹훅 설정하기:
   • n8n에서 Webhook 트리거 노드가 포함된 워크플로를 만듭니다.
   • n8n에서 웹훅 URL을 복사합니다(HTTPS여야 함).
   • 웹훅 URL은 공개적으로 액세스 가능해야 하며, 별도의 인가 요구 사항 없이 POST 요청을 수락해야 합니다.
6. 챌린지 요청 처리하기:
   • 웹훅을 LinkedIn에 등록하면 LinkedIn이 challengeCode 쿼리 매개변수와 함께 GET 요청을 보냅니다.
   • n8n 워크플로는 3초 이내에 다음을 포함하는 JSON 페이로드로 응답해야 합니다:
     • challengeCode: LinkedIn이 보낸 코드
     • challengeResponse: 앱의 Client Secret을 키로 사용하여 챌린지 코드를 HMAC-SHA256으로 해시한 값
   • 응답 형식 예시:

     {
       "challengeCode": "890e4665-4dfe-4ab1-b689-ed553bceeed0",
       "challengeResponse": "27b1d19678542072a7f1d0ce845d0c78cec22567f413697e25648f44fa3d1514"
     }
     

7. 리드 알림 구독 만들기:
   • leadNotifications API를 사용하여 웹훅 구독을 만듭니다.
   • 다양한 레벨에서 구독을 만들 수 있습니다:
     • Owner 레벨: 조직 또는 스폰서 계정 아래의 모든 폼에 대한 알림 수신
     • Form 레벨: 특정 폼에 대해서만 알림 수신
     • Associated entity 레벨: 특정 엔티티(광고, 이벤트 등)에 연결된 폼에 대한 알림 수신
   • API 호출 예시:

     POST https://api.linkedin.com/rest/leadNotifications
     {
       "webhook": "https://your-n8n-instance.com/webhook/linkedin-leads",
       "owner": {"organization": "urn:li:organization:123456"},
       "leadType": "SPONSORED"
     }
     

8. 리드 폼 응답 가져오기:
   • 웹훅 알림이 설정되면 새 리드가 제출될 때 알림을 받게 됩니다.
   • leadFormResponses API를 사용하여 실제 리드 데이터를 가져오세요:

     GET https://api.linkedin.com/rest/leadFormResponses?owner=(organization:urn%3Ali%3Aorganization%3A123456)&leadType=(leadType:SPONSORED)&q=owner
     

리드 유형#

LinkedIn은 동기화할 수 있는 여러 유형의 리드를 지원합니다:

• SPONSORED: 스폰서 광고에서 수집된 리드
• COMPANY: Company Page에서 수집된 리드
• EVENT: 이벤트 페이지에서 수집된 리드
• ORGANIZATION_PRODUCT: 조직 제품 페이지에서 수집된 리드

웹훅 검증#

LinkedIn은 2시간마다 웹훅 엔드포인트를 주기적으로 재검증합니다. 검증이 3회 연속 실패하면 엔드포인트가 차단되고 더 이상 이벤트가 전송되지 않습니다. 웹훅이 다음을 충족하는지 확인하세요:

• 3초 이내에 챌린지 요청에 응답
• 모든 알림에 대해 2xx HTTP 상태 코드 반환
• HTTPS 사용(HTTP URL은 지원되지 않음)
• 인증 요구 사항 없이 공개적으로 액세스 가능

보안#

알림이 LinkedIn에서 온 것인지 확인하려면:

1. POST 요청의 X-LI-Signature 헤더를 확인합니다.
2. 이 헤더에는 앱의 Client Secret을 사용하여 계산된, JSON으로 인코딩된 POST 본문의 HMAC-SHA256 해시가 담겨 있습니다.
3. 동일한 방식으로 해당 측에서 해시를 계산하여 일치하는지 확인합니다.
4. 서명이 일치하지 않는 이벤트는 폐기합니다.

자세한 내용은 LinkedIn의 Lead Sync API 문서와 Webhook Validation 가이드를 참고하세요.

OAuth2 사용하기#

이전 LinkedIn 앱 및 사용자 계정에만 이 방법을 사용하세요.

모든 사용자는 다음을 선택해야 합니다:

• Organization Support: 이 옵션을 켜면 자격 증명이 w_organization_social 범위를 사용하여 조직으로 게시할 수 있는 권한을 요청합니다.
  • 이 옵션을 사용하려면 LinkedIn의 Community Management App Review 절차를 거쳐 앱을 승인받아야 합니다.
• Legacy: 이 옵션을 켜면 자격 증명이 최신 profile 및 email 범위 대신 r_liteprofile 및 r_emailaddress에 대한 레거시 범위를 사용합니다.

n8n을 셀프 호스팅하는 경우, 새 개발자 앱을 만들어 OAuth2를 처음부터 구성해야 합니다:

1. LinkedIn에 로그인하고 이 링크를 선택하여 새 개발자 앱을 만드세요.
2. 앱의 App name을 입력합니다(예: n8n integration).
3. LinkedIn Page에는 LinkedIn Company Page를 입력하거나, Create a new LinkedIn Page 링크를 사용하여 즉석에서 만드세요. 자세한 내용은 Associate an App with a LinkedIn Page를 참고하세요.
4. App logo를 추가합니다.
5. Legal agreement에 동의하는 체크박스를 선택합니다.
6. Create app을 선택합니다.
7. 그러면 Products 탭이 열립니다. 앱에서 사용하고자 하는 제품/API를 선택하세요. LinkedIn 노드가 제대로 작동하려면 다음을 포함해야 합니다:
   • Share on LinkedIn
   • Sign In with LinkedIn using OpenID Connect
8. 필요한 제품에 대한 액세스를 요청한 후 Auth 탭을 엽니다.
9. Client ID를 복사하여 n8n 자격 증명에 입력합니다.
10. Primary Client Secret의 Copy 아이콘을 선택합니다. 이를 n8n 자격 증명의 Client Secret으로 입력합니다.

범위 및 권한에 대한 자세한 내용은 Getting Access to LinkedIn APIs를 참고하세요.