การเอกสารสำหรับการรับรอง Salesforce ใช้รับรองเหล่านี้เพื่อรับรอง Salesforce ใน n8n, แพลตฟอร์มอัตโนมัติการทำงาน
คุณสามารถใช้ credentials เหล่านี้เพื่อตรวจสอบสิทธิ์ node ต่อไปนี้:
วิธีการรับรองความถูกต้องที่รองรับ
- เจดับบลิว
- OAuth2
ทรัพยากรที่เกี่ยวข้อง
อ้างถึง รายละเอียดผู้พัฒนาของ Salesforce สำหรับข้อมูลเพิ่มเติมเกี่ยวกับบริการ
ความพร้อมใช้งานของคุณสมบัติ (Feature availability)
Salesforce เก็บแอปพลิเคชันที่เชื่อมโยงในประโยชน์ของแอปพลิเคชันของลูกค้าภายนอก ตรวจสอบเอกสารของ Salesforce สำหรับระยะเวลาการ退休 ทั้งสองวิธีทำงานกับ n8n หากคุณสร้างการรวมใหม่ใช้แอปพลิเคชันของลูกค้าภายนอกแอปพลิเคชันที่เชื่อมโยงที่มีอยู่จะยังคงทำงาน
ใช้ JWT
หากต้องการกำหนดค่าข้อมูลประจำตัวนี้ คุณจะต้องมี พนักงานขาย บัญชีและ:
- ของคุณ Environment Type (การผลิตหรือ Sandbox)
- A Client ID : สร้างเมื่อคุณสร้างแอปของลูกค้าภายนอกหรือแอปที่เชื่อมต่อ
- พลังงานขายของคุณ Username
- A Private Key สำหรับใบรับรองดิจิตอลที่ลงทะเบียนด้วยตนเอง
สร้างแอปของลูกค้าภายนอก (แนะนำ) (Create an External Client App (recommended))
ในการตั้งค่าสิ่งแรกคุณจะสร้างกุญแจส่วนตัวและใบรับรองแล้วแอปลูกค้าภายนอก:
- ใน n8n ให้เลือกไฟล์ Environment Type สำหรับการเชื่อมต่อของคุณ เลือกตัวเลือกที่อธิบายสิ่งแวดล้อมของคุณได้ดีที่สุดจาก Production หรือ Sandbox.
- เข้าสู่ Salesforce ของคุณ Username.
- ลงชื่อเข้าสู่ระบบใน Salesforce ของคุณ
- คุณจะต้องมีกุญแจส่วนตัวและใบรับรองจากหน่วยงานการรับรอง ใช้กุญแจ / ใบรับรองของคุณเองหรือใช้ OpenSSL เพื่อสร้างกุญแจและใบรับรองดิจิตอลที่ลงทะเบียนด้วยตนเอง สร้างหลักส่วนตัวและเอกสารใบรับรองดิจิตอลที่ได้รับการลงทะเบียนด้วยตนเอง สำหรับคำแนะนำเกี่ยวกับการสร้างคีย์และใบรับรองของคุณเอง
- จาก Setup ใน Salesforce, enter
App Managerในกล่อง Quick Find จากนั้นเลือก App Manager. - ในหน้า App Manager เลือก New External Client App.
- ใส่ที่ต้องการ Basic Info สำหรับแอปของลูกค้าภายนอกของคุณรวมถึงแอป Name และ ที่อยู่อีเมลติดต่อ (Contact Email address).
- ภายใต้ API (Enable OAuth Settings) ให้เลือก Enable OAuth.
- ใน Callback URL กล่องเพิ่ม URL callback:
http://localhost:1717/OauthRedirect(หรือ URL ตัวอย่าง n8n ของคุณถ้าโฮสต์ตัวเอง) - ใน OAuth Scopes ประเภท, เลือกจุดเหล่านี้:
- เข้าถึงเต็มรูปแบบ (เต็มรูปแบบ) (Full access (full))
- การดำเนินการคำขอตลอดเวลา (refresh_token, offline_access) (Perform requests at any time (refresh_token, offline_access))
- ใน Flow Enablement ส่วน ให้เลือก Enable JWT Bearer Flow.
- เลือก Upload Files และอัปโหลดไฟล์ที่มีใบรับรองดิจิตอลของคุณเช่น
server.crt. - ภายใต้ OAuth Policies ตรวจสอบให้แน่ใจว่าการตั้งค่าต่อไปนี้คือ ไม่ตรวจสอบ (unchecked):
- Require Secret for Web Server Flow
- Require Secret for Refresh Token Flow
- ต้องการหลักฐานสำหรับการแลกเปลี่ยนรหัส (PKCE) การขยายตัวสำหรับการไหลการอนุมัติที่สนับสนุน
- เลือก Save แล้ว Continue.
- คัดลอก Consumer Key และเพิ่มมันไปยัง n8n การรับรองของคุณเป็น Client ID.
- ใส่เนื้อหาของไฟล์หลักส่วนตัวใน n8n เช่น Private Key.
ใช้ตัวแก้ไขหลายสายใน n8n
ใส่คีย์ส่วนตัวในรูปแบบคีย์ PEM มาตรฐาน:
-----BEGIN PRIVATE KEY----- KEY DATA GOES HERE -----END PRIVATE KEY-----
เกี่ยวกับ Salesforce แอปพลิเคชันของลูกค้าภายนอก เอกสารประกอบสำหรับข้อมูลเพิ่มเติม
Create a Connected App (legacy)
ความพร้อมใช้งานของคุณสมบัติ (Feature availability)
Salesforce จะลดลงแอปพลิเคชันที่เชื่อมต่อในประโยชน์ของแอปพลิเคชันของลูกค้าภายนอก ตรวจสอบเอกสารของ Salesforce สำหรับระยะเวลาการ退休 ใช้แอปพลิเคชันของลูกค้าภายนอกแทนสำหรับการรวมใหม่
ในการตั้งค่าสิ่งแรกคุณจะสร้างกุญแจส่วนตัวและใบรับรองแล้วแอปที่เชื่อมต่อ:
- ใน n8n ให้เลือกไฟล์ Environment Type สำหรับการเชื่อมต่อของคุณ เลือกตัวเลือกที่อธิบายสิ่งแวดล้อมของคุณได้ดีที่สุดจาก Production หรือ Sandbox.
- เข้าสู่ Salesforce ของคุณ Username.
- ลงชื่อเข้าสู่ระบบใน Salesforce ของคุณ
- คุณจะต้องมีกุญแจส่วนตัวและใบรับรองจากหน่วยงานการรับรอง ใช้กุญแจ / ใบรับรองของคุณเองหรือใช้ OpenSSL เพื่อสร้างกุญแจและใบรับรองดิจิตอลที่ลงทะเบียนด้วยตนเอง สร้างหลักส่วนตัวและเอกสารใบรับรองดิจิตอลที่ได้รับการลงทะเบียนด้วยตนเอง สำหรับคำแนะนำเกี่ยวกับการสร้างคีย์และใบรับรองของคุณเอง
- จาก Setup ใน Salesforce, enter
App Managerในกล่อง Quick Find จากนั้นเลือก App Manager. - ในหน้า App Manager เลือก New Connected App.
- ใส่ที่ต้องการ Basic Info สำหรับแอปพลิเคชันที่เชื่อมต่อของคุณรวมถึง Name และ ที่อยู่อีเมลติดต่อ (Contact Email address) เกี่ยวกับ Salesforce การตั้งค่าแอปพลิเคชันที่เชื่อมต่อพื้นฐาน เอกสารประกอบสำหรับข้อมูลเพิ่มเติม
- ตรวจสอบกล่อง Enable OAuth Settings.
- สำหรับ Callback URL , เข้า
http://localhost:1717/OauthRedirect. - ตรวจสอบกล่อง ใช้สัญญาณดิจิตอล (Use digital signatures).
- เลือก Choose File และอัปโหลดไฟล์ที่มีใบรับรองดิจิตอลของคุณเช่น
server.crt. - เพิ่มเหล่านี้ OAuth ปิด (OAuth scopes):
- เข้าถึงเต็มรูปแบบ (เต็มรูปแบบ) (Full access (full))
- การดำเนินการคำขอตลอดเวลา (refresh_token, offline_access) (Perform requests at any time (refresh_token, offline_access))
- เลือก Save แล้ว Continue . ที่ Manage Connected Apps หน้าควรเปิดไปยังแอปที่คุณสร้างใหม่
- ใน API (Enable OAuth Settings) ส่วน ให้เลือก Manage Consumer Details.
- คัดลอก Consumer Key และเพิ่มมันไปยัง n8n การรับรองของคุณเป็น Client ID.
- ใส่เนื้อหาของไฟล์หลักส่วนตัวใน n8n เช่น Private Key.
ใช้ตัวแก้ไขหลายสายใน n8n
ใส่คีย์ส่วนตัวในรูปแบบคีย์ PEM มาตรฐาน:
-----BEGIN PRIVATE KEY----- KEY DATA GOES HERE -----END PRIVATE KEY-----
ขั้นตอนเหล่านี้เป็นสิ่งที่จำเป็นในด้าน n8n Salesforce แนะนำให้ตั้งค่านโยบาย token อัพเดทนโยบายการประชุมและนโยบาย OAuth นอกจากนี้:
- ใน Salesforce, เลือก Back to Manage Connected Apps.
- เลือก Manage.
- เลือก Edit Policies.
- รีวิว The Refresh Token Policy field. Salesforce ขอแนะนำให้ใช้ token อายุการใช้งานใหม่หลังจาก 90 วัน
- ใน Session Policies ส่วน, Salesforce แนะนำการตั้งค่า Timeout Value 15 นาที
- ใน OAuth Policies ส่วน ให้เลือก ผู้ใช้ที่ได้รับการอนุมัติโดย Admin ได้รับการอนุมัติก่อนสำหรับผู้ใช้ที่ได้รับอนุญาต (Admin approved users are pre-authorized for permitted users) สำหรับ Permitted Users และเลือก OK.
- เลือก Save.
- เลือก Manage Profiles , เลือกโปรไฟล์ที่ได้รับอนุญาตก่อนที่จะใช้แอปที่เชื่อมต่อนี้และเลือก Save.
- เลือก Manage Permission Sets เลือกชุดอนุญาต สร้างชุดอนุญาตถ้าจำเป็น
เกี่ยวกับ Salesforce สร้างแอปที่เชื่อมต่อใน Org ของคุณ เอกสารประกอบสำหรับข้อมูลเพิ่มเติม
การใช้ OAuth2
หากต้องการกำหนดค่าข้อมูลประจำตัวนี้ คุณจะต้องมี พนักงานขาย บัญชี
คุณจะต้องเลือกของคุณ Environment Type เลือกระหว่าง Production และ Sandbox.
สร้างแอปของลูกค้าภายนอก (แนะนำ) (Create an External Client App (recommended))
ถ้าคุณเป็น โฮสติ้งด้วยตนเอง n8n คุณจะต้องตั้งค่า OAuth2 จาก scratch โดยการสร้างแอปของลูกค้าภายนอก:
- ใน n8n ให้เลือกไฟล์ Environment Type สำหรับการเชื่อมต่อของคุณ เลือกตัวเลือกที่อธิบายสิ่งแวดล้อมของคุณได้ดีที่สุดจาก Production หรือ Sandbox.
- เข้าสู่ Salesforce ของคุณ Username.
- ลงชื่อเข้าสู่ระบบใน Salesforce ของคุณ
- จาก Setup ใน Salesforce, enter
App Managerในกล่อง Quick Find จากนั้นเลือก App Manager. - ในหน้า App Manager เลือก New External Client App.
- ใส่ที่ต้องการ Basic Info สำหรับแอปของลูกค้าภายนอกของคุณรวมถึงแอป Name และ ที่อยู่อีเมลติดต่อ (Contact Email address).
- ภายใต้ API (Enable OAuth Settings) ให้เลือก Enable OAuth.
- ใน Callback URL กล่องเพิ่ม URL callback ของคุณ n8n OAuth (เช่น
https://your-n8n-instance.com/rest/oauth2-credential/callbackสำหรับ n8n Cloud นี้จะเป็นhttps://oauth.n8n.cloud/oauth2/callback). - ใน OAuth Scopes ประเภท, เลือกจุดเหล่านี้:
- เข้าถึงเต็มรูปแบบ (เต็มรูปแบบ) (Full access (full))
- การดำเนินการคำขอตลอดเวลา (refresh_token, offline_access) (Perform requests at any time (refresh_token, offline_access))
- ใน Flow Enablement ส่วน ให้เลือก Enable Authorization Code and Credentials Flow.
- ภายใต้ OAuth Policies ตรวจสอบให้แน่ใจว่าการตั้งค่าต่อไปนี้คือ ตรวจสอบ (checked):
- Require Secret for Web Server Flow
- Require Secret for Refresh Token Flow
- ต้องการหลักฐานสำหรับการแลกเปลี่ยนรหัส (PKCE) การขยายตัวสำหรับการไหลการอนุมัติที่สนับสนุน
- เลือก Save แล้ว Continue.
- คัดลอก Consumer Key และเพิ่มมันไปยัง n8n การรับรองของคุณเป็น Client ID.
- คัดลอก Consumer Secret และเพิ่มมันไปยัง n8n การรับรองของคุณเป็น Client Secret.
เกี่ยวกับ Salesforce แอปพลิเคชันของลูกค้าภายนอก เอกสารประกอบสำหรับข้อมูลเพิ่มเติม
Create a Connected App (legacy)
ความพร้อมใช้งานของคุณสมบัติ (Feature availability)
Salesforce จะลดลงแอปพลิเคชันที่เชื่อมต่อในประโยชน์ของแอปพลิเคชันของลูกค้าภายนอก ตรวจสอบเอกสารของ Salesforce สำหรับระยะเวลาการ退休 ใช้แอปพลิเคชันของลูกค้าภายนอกแทนสำหรับการรวมใหม่
ถ้าคุณเป็น โฮสติ้งด้วยตนเอง n8n คุณยังสามารถกำหนด OAuth2 โดยการสร้างแอปที่เชื่อมต่อ:
- ใน n8n ให้เลือกไฟล์ Environment Type สำหรับการเชื่อมต่อของคุณ เลือกตัวเลือกที่อธิบายสิ่งแวดล้อมของคุณได้ดีที่สุดจาก Production หรือ Sandbox.
- เข้าสู่ Salesforce ของคุณ Username.
- ลงชื่อเข้าสู่ระบบใน Salesforce ของคุณ
- จาก Setup ใน Salesforce, enter
App Managerในกล่อง Quick Find จากนั้นเลือก App Manager. - ในหน้า App Manager เลือก New Connected App.
- ใส่ที่ต้องการ Basic Info สำหรับแอปพลิเคชันที่เชื่อมต่อของคุณรวมถึง Name และ ที่อยู่อีเมลติดต่อ (Contact Email address) เกี่ยวกับ Salesforce การตั้งค่าแอปพลิเคชันที่เชื่อมต่อพื้นฐาน เอกสารประกอบสำหรับข้อมูลเพิ่มเติม
- ตรวจสอบกล่อง Enable OAuth Settings.
- สำหรับ Callback URL , เข้า
http://localhost:1717/OauthRedirect. - เพิ่มเหล่านี้ OAuth ปิด (OAuth scopes):
- เข้าถึงเต็มรูปแบบ (เต็มรูปแบบ) (Full access (full))
- การดำเนินการคำขอตลอดเวลา (refresh_token, offline_access) (Perform requests at any time (refresh_token, offline_access))
- ตรวจสอบให้แน่ใจว่าการตั้งค่าต่อไปนี้ไม่ได้ตรวจสอบ:
- ต้องการหลักฐานสำหรับการแลกเปลี่ยนรหัส (PKCE) การขยายตัวสำหรับการไหลการอนุมัติที่สนับสนุน
- Require Secret for Web Server Flow
- Require Secret for Refresh Token Flow
- เลือก Save แล้ว Continue . ที่ Manage Connected Apps หน้าควรเปิดไปยังแอปที่คุณสร้างใหม่
- ใน API (Enable OAuth Settings) ส่วน ให้เลือก Manage Consumer Details.
- คัดลอก Consumer Key และเพิ่มมันไปยัง n8n การรับรองของคุณเป็น Client ID.
- คัดลอก Consumer Secret และเพิ่มมันไปยัง n8n การรับรองของคุณเป็น Client Secret.
ขั้นตอนเหล่านี้เป็นสิ่งที่จำเป็นในด้าน n8n Salesforce แนะนำให้ตั้งค่านโยบายของ token และนโยบายการประชุมยัง:
- ใน Salesforce, เลือก Back to Manage Connected Apps.
- เลือก Manage.
- เลือก Edit Policies.
- รีวิว The Refresh Token Policy field. Salesforce ขอแนะนำให้ใช้ token อายุการใช้งานใหม่หลังจาก 90 วัน
- ใน Session Policies ส่วน, Salesforce แนะนำการตั้งค่า Timeout Value 15 นาที
เกี่ยวกับ Salesforce สร้างแอปที่เชื่อมต่อใน Org ของคุณ เอกสารประกอบสำหรับข้อมูลเพิ่มเติม
ปัญหาทั่วไป
ปัญหาการเชื่อมต่อเมื่อรับรองกับ Salesforce จาก n8n Cloud
หากคุณพบปัญหาการเชื่อมต่อเมื่อรับรองกับ Salesforce จาก n8n Cloud คุณอาจต้องเปิดใช้งานใบอนุญาตระบบที่เฉพาะเจาะจงในโปรไฟล์ผู้ใช้ Salesforce ของคุณ:
- ใน Salesforce, ไปยัง Setup.
- ใน Quick Find กล่อง, ค้นหา
Profiles. - เลือกโปรไฟล์ที่ใช้โดยผู้ใช้ที่เชื่อมต่อกับ n8n (เช่น Administrator System หรือโปรไฟล์ที่เกี่ยวข้อง)
- คลิก Edit หรือใช้ใหม่ Profile อินเตอร์เฟซถ้ามี
- โพสต์ Administrative Permissions ส่วน
- เปิดใช้งานกล่องตรวจสอบสำหรับ Approve Connected Apps for Non-Admins กล่องตรวจสอบนี้อาจปรากฏเช่นเดียวกับ การอนุมัติแอปที่เชื่อมต่อไม่ได้ติดตั้ง (Approve apps connected not installed) ขึ้นอยู่กับภาษา Salesforce หรือการแปลของคุณ
- คลิก Save.
อนุญาตนี้ไม่ได้เปิดใช้งานโดยเริ่มต้นแม้สำหรับโปรไฟล์ผู้ดูแลระบบและต้องเปิดใช้งานด้วยตนเอง ไม่มีอนุญาตนี้คุณอาจพบความผิดพลาดในการรับรองเมื่อพยายามเชื่อมต่อ n8n กับ Salesforce
