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

• 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: 새 developer 앱을 생성한 후 생성됩니다.
• Client Secret: 새 developer 앱을 생성한 후 생성됩니다.

새 developer 앱을 생성하고 자격 증명을 설정하려면:

1. LinkedIn에 로그인하고 이 링크를 선택하여 새 developer 앱 생성합니다.
2. 앱에 n8n integration과 같은 App name을 입력합니다.
3. LinkedIn Page에 LinkedIn Company Page를 입력하거나 Create a new LinkedIn Page 링크를 사용하여 즉시 생성합니다. 자세한 내용은 앱을 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으로 입력합니다.

스코프 및 권한에 대한 자세한 내용은 LinkedIn API에 대한 접근 얻기를 참조하세요.

Lead Sync API 사용#

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

사전 요구 사항#

• LinkedIn developer 앱(위 단계를 사용하여 생성)
• developer 앱과 연결된 회사 LinkedIn 계정
• Lead Sync API 제품 접근(별도 신청 필요)
• 공개적으로 접근 가능한 HTTPS 웹훅 URL(n8n 워크플로 웹훅 URL)

설정 과정#

1. 위 Community Management OAuth2 또는 OAuth2 섹션의 단계에 따라 LinkedIn developer 앱을 생성합니다.
2. 회사 계정 연결: LinkedIn에 회사 LinkedIn 계정을 developer 앱과 연결하도록 요청을 제출합니다. LinkedIn Developer Portal을 통해 수행됩니다.
3. Lead Sync API 접근 요청:
   • LinkedIn developer 앱에서 Products 탭으로 이동합니다.
   • Lead Sync API 제품에 대한 접근을 요청합니다.
4. 권한 구성: 앱에 r_marketing_leadgen_automation 권한이 있는지 확인합니다. 이를 통해:
   • 인증된 멤버의 광고 양식 및 유기적 양식에 접근
   • 양식 응답(리드) 접근
   • 리드 알림(웹훅) 관리
5. n8n에서 웹훅 설정:
   • n8n에서 Webhook trigger 노드로 워크플로를 생성합니다.
   • n8n에서 웹훅 URL을 복사합니다(HTTPS여야 함).
   • 웹훅 URL은 추가 인증 요구 사항 없이 POST 요청을 수락하고 공개적으로 접근 가능해야 합니다.
6. challenge 요청 처리:
   • LinkedIn에 웹훅을 등록할 때 LinkedIn은 challengeCode 쿼리 매개변수가 있는 GET 요청을 보냅니다.
   • n8n 워크플로는 3초 이내에 다음을 포함하는 JSON 페이로드로 응답해야 합니다:
     • challengeCode: LinkedIn이 보낸 코드
     • challengeResponse: 앱의 Client Secret을 키로 사용하는 challenge 코드의 HMAC-SHA256 해시
   • 응답 형식 예시:

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

7. 리드 알림 구독 생성:
   • leadNotifications API를 사용하여 웹훅 구독을 생성합니다.
   • 다양한 수준에서 구독을 생성할 수 있습니다:
     • Owner level: 조직 또는 후원 계정 하의 모든 양식에 대한 알림 수신
     • Form level: 특정 양식에 대한 알림만 수신
     • Associated entity level: 특정 항목(광고, 이벤트 등)에 첨부된 양식에 대한 알림 수신
   • 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: 회사 페이지에서 수집된 리드
• EVENT: 이벤트 페이지에서 수집된 리드
• ORGANIZATION_PRODUCT: 조직 제품 페이지에서 수집된 리드

웹훅 유효성 검사#

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

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

보안#

알림이 LinkedIn에서 왔는지 확인하려면:

1. POST 요청의 X-LI-Signature 헤더를 확인합니다.
2. 이 헤더에는 앱의 Client Secret을 사용하여 계산된 JSON 인코딩 POST 본문의 HMAC-SHA256 해시가 포함되어 있습니다.
3. 같은 해시를 사용자 측에서 계산하고 일치하는지 확인합니다.
4. 서명이 일치하지 않는 이벤트는 모두 삭제합니다.

자세한 내용은 LinkedIn의 Lead Sync API 문서와 웹훅 유효성 검사 가이드를 참조하세요.

OAuth2 사용#

이전 LinkedIn 앱 및 사용자 계정에만 이 방법을 사용합니다.

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

• Organization Support: 켜면 자격 증명이 w_organization_social 스코프를 사용하여 조직으로 게시할 권한을 요청합니다.
  • 이 옵션을 사용하려면 앱을 LinkedIn의 Community Management App Review 프로세스를 통과시켜야 합니다.
• Legacy: 켜면 자격 증명이 최신 profile 및 email 스코프 대신 r_liteprofile 및 r_emailaddress의 레거시 스코프를 사용합니다.

n8n을 셀프 호스팅하는 경우 새 developer 앱을 생성하여 처음부터 OAuth2를 구성해야 합니다:

1. LinkedIn에 로그인하고 이 링크를 선택하여 새 developer 앱 생성합니다.
2. 앱에 n8n integration과 같은 App name을 입력합니다.
3. LinkedIn Page에 LinkedIn Company Page를 입력하거나 Create a new LinkedIn Page 링크를 사용하여 즉시 생성합니다. 자세한 내용은 앱을 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으로 입력합니다.

스코프 및 권한에 대한 자세한 내용은 LinkedIn API에 대한 접근 얻기를 참조하세요.