Credentials สำหรับ HTTP Request

การรับรอง HTTP Request การรับรอง HTTP Request การรับรอง HTTP Request การรับรอง HTTP Request การรับรอง HTTP Request

คุณสามารถใช้ credentials เหล่านี้เพื่อตรวจสอบสิทธิ์ node ต่อไปนี้:

• HTTP Request

ข้อกำหนดเบื้องต้น

คุณต้องใช้วิธีการรับรองที่ต้องการโดยแอปหรือบริการที่คุณต้องการสอบถาม

หากคุณต้องการรับรองการรับรองด้วยใบรับรอง SSL โปรดติดต่อที่: ให้ใบรับรอง SSL สำหรับข้อมูลที่คุณต้องการ

วิธีการรับรองความถูกต้องที่รองรับ

• ประเภทการรับรองที่กำหนดไว้
• ฐาน auth (ประเภทการรับรองทั่วไป)
• Auth ที่กำหนดเอง (ประเภทการรับรองทั่วไป)
• Digest auth (ประเภทการรับรองทั่วไป)
• Header auth (ประเภทการรับรองทั่วไป)
• ประเภทการรับรองแบบดั้งเดิม (Bareer auth)
• OAuth1 (ประเภทการรับรองทั่วไป)
• OAuth2 (ประเภทการรับรองทั่วไป)
• Query auth (ประเภทการรับรองทั่วไป)
• คำอธิบายที่กำหนดเองที่เรียบง่าย (ประเภทการรับรองทั่วไป)

อ้างถึง การรับรอง HTTP สำหรับข้อมูลเพิ่มเติมเกี่ยวกับประเภทการรับรองทั่วไป

ประเภทการรับรองที่กำหนดไว้ (Predefined credential types)

n8n แนะนำให้ใช้ประเภทการรับรองที่กำหนดไว้ล่วงหน้าทุกครั้งที่มีประเภทการรับรองที่มีอยู่สำหรับบริการที่คุณต้องการเชื่อมต่อ มีวิธีที่ง่ายต่อการตั้งค่าและการจัดการการรับรองเมื่อเทียบกับการกำหนดค่าการรับรองทั่วไป

คุณสามารถใช้ ประเภทการรับรองที่กำหนดไว้ การดำเนินการที่กำหนดเองกับบาง APIs ที่ n8n มี node สำหรับแพลตฟอร์ม ตัวอย่างเช่น n8n มี node Asana และสนับสนุนการใช้การรับรอง Asana ของคุณใน node HTTP Request Custom API actions for existing nodes สำหรับข้อมูลเพิ่มเติม

ใช้ประเภทการรับรองที่กำหนดเอง

ใช้ประเภทการรับรองที่กำหนดไว้ล่วงหน้า:

1. เปิด HTTP Request หรือ GraphQL หรือเพิ่มหนึ่งใหม่ใน workflow ของคุณ
2. ใน Authentication ให้เลือก Predefined Credential Type.
3. ใน Credential Type , เลือก API ที่คุณต้องการใช้
4. ใน หนังสือรับรองสำหรับ <API name> คุณสามารถ:
   1. เลือกใบรับรองที่มีอยู่สำหรับแพลตฟอร์มนี้หากมี
   2. เลือก Create New สร้างใบรับรองใหม่

อ้างถึง Custom API actions for existing nodes สำหรับข้อมูลเพิ่มเติม

การใช้การรับรองความถูกต้องขั้นพื้นฐาน

ใช้การรับรองทั่วไปนี้หากแอปหรือบริการของคุณสนับสนุนการรับรองพื้นฐาน

ในการกำหนดค่าการรับรองนี้ให้เข้าสู่:

• ที่ Username คุณใช้เพื่อเข้าถึงแอปหรือบริการ HTTP Request ของคุณจะถูกเป้าหมาย
• ที่ Password มันไปกับชื่อผู้ใช้นี้

การใช้ Digest Auth

ใช้การรับรองทั่วไปนี้หากแอปหรือบริการของคุณสนับสนุนการรับรองทางเดินอาหาร

ในการกำหนดค่าการรับรองนี้ให้เข้าสู่:

• ที่ Username คุณใช้เพื่อเข้าถึงแอปหรือบริการ HTTP Request ของคุณจะถูกเป้าหมาย
• ที่ Password มันไปกับชื่อผู้ใช้นี้

ใช้ Header Auth

ใช้การรับรองทั่วไปนี้หากแอปหรือบริการของคุณสนับสนุนการรับรองหัว

ในการกำหนดค่าการรับรองนี้ให้เข้าสู่:

• หัวหน้า Name คุณต้องผ่านแอปหรือบริการคำขอ HTTP ของคุณจะถูกเป้าหมาย
• ที่ Value สำหรับหัวหน้า

อ่านเพิ่มเติมเกี่ยวกับ หัวหน้า HTTP

ใช้วัสดุ Auth

ใช้การรับรองทั่วไปนี้หากแอปหรือบริการของคุณสนับสนุนการรับรองผู้ถือ ประเภทการรับรองนี้เป็นเพียงการรับรองหัวที่มีการรับรอง Name ตั้งค่าเป็น Authorization และ Value ตั้งค่าเป็น Bearer <token>.

ในการกำหนดค่าการรับรองนี้ให้เข้าสู่:

• ที่ Bearer Token คุณต้องผ่านแอปหรือบริการคำขอ HTTP ของคุณจะถูกเป้าหมาย

อ่านเพิ่มเติมเกี่ยวกับ การรับรองการรับรอง .

ใช้ OAuth1

ใช้การรับรองทั่วไปนี้หากแอปหรือบริการของคุณสนับสนุนการรับรอง OAuth1

ในการกำหนดค่าการรับรองนี้ให้เข้าสู่:

• อ Authorization URL : ยังเป็นที่รู้จักกันในชื่อผู้รับอนุญาตทรัพยากร URI. URL นี้มักจะสิ้นสุดใน /oauth1/authorize n8n ส่งใบรับรองชั่วคราวที่นี่เพื่อกระตุ้นผู้ใช้ที่จะเสร็จสิ้นการรับรอง
• อ Access Token URL : นี่คือ URI ที่ใช้สำหรับคำขอเริ่มต้นสำหรับการรับรองชั่วคราว URL นี้มักจะสิ้นสุดใน /oauth1/request หรือ /oauth1/token.
• A Consumer Key : ยังเป็นที่รู้จักกันเป็นคีย์ลูกค้าเช่นชื่อผู้ใช้ นี่ระบุว่า oauth_consumer_key ใช้สำหรับโทรศัพท์
• A Consumer Secret : ยังเป็นที่รู้จักกันเป็น Client Secret เช่นรหัสผ่าน
• A Request Token URL : นี่คือ URI ที่ใช้ในการเปลี่ยนจากการรับรองชั่วคราวไปยังการรับรองอายุการใช้งานยาวนานหลังจากได้รับอนุญาต URL นี้มักจะสิ้นสุดใน /oauth1/access.
• เลือก Signature Method การใช้ auth handshake. นี้ระบุว่า oauth_signature_method ใช้สำหรับโทร. ตัวเลือกรวมถึง:
  • HMAC-SHA1
  • HMAC-SHA256
  • HMAC-SHA512

สำหรับการบูรณาการ OAuth1 ส่วนใหญ่คุณจะต้องกำหนดแอปบริการหรือการบูรณาการเพื่อสร้างค่าสำหรับส่วนใหญ่ของฟิลด์เหล่านี้ OAuth Redirect URL ใน n8n ในฐานะ URL หรือ URI เพื่อบริการดังกล่าว

อ่านเพิ่มเติมเกี่ยวกับ โซน1 และ OAuth1 ใบอนุญาตไหล .

การใช้ OAuth2

ใช้การรับรองทั่วไปนี้หากแอปหรือบริการของคุณสนับสนุนการรับรอง OAuth2

ความต้องการในการตั้งค่าใบรับรองนี้ขึ้นอยู่กับ Grant Type เลือก คำอธิบาย OAuth Grant ประเภท สำหรับข้อมูลเพิ่มเติมเกี่ยวกับแต่ละประเภทของเงินทุน

สำหรับการบูรณาการ OAuth2 ส่วนใหญ่คุณจะต้องกำหนดแอปบริการหรือการบูรณาการ OAuth Redirect URL ใน n8n ในฐานะ URL หรือ URI เพื่อบริการดังกล่าว

อ่านเพิ่มเติมเกี่ยวกับ OAuth2 .

ประเภทใบอนุญาตรหัส (Authorization Code grant type)

ใช้ประเภทใบอนุญาตรหัสเพื่อแลกเปลี่ยนรหัสอนุญาตสำหรับ token การไหลของ auth ใช้ URL ที่นำไปสู่ลูกค้า จากนั้นแอพลิเคชันจะได้รับรหัสอนุญาตจาก URL และใช้มันเพื่อขอรหัสอนุญาต คำขอรหัสการรับรอง สำหรับข้อมูลเพิ่มเติม

ในการกำหนดค่าการรับรองนี้เลือก Authorization Code เป็น Grant Type.

จากนั้นเข้าสู่:

• อ Authorization URL
• อ Access Token URL
• A Client ID : ID หรือชื่อผู้ใช้เพื่อเข้าสู่ระบบด้วย
• A Client Secret : ความลับหรือรหัสผ่านที่ใช้ในการเข้าสู่ระบบด้วย
• ทางเลือก: เข้าสู่ 1 หรือมากกว่า Scope s สำหรับใบรับรอง หากไม่ได้ระบุใบรับรองใบรับรองใบรับรองใบรับรองใบรับรองใบรับรองใบรับรองใบรับรองใบรับรอง
• ทางเลือก: บริการบางอย่างต้องมี parameter การสอบถามเพิ่มเติม หากบริการของคุณทำให้เพิ่มไว้เป็น Auth URI Query Parameters.
• อ Authentication ประเภท: เลือกตัวเลือกที่เหมาะสมที่สุดกับกรณีการใช้งานของคุณ ตัวเลือกรวมถึง:
  • Header : ส่งใบรับรองเป็นหัว Auth ฐาน
  • Body : ส่งใบรับรองไปยังร่างกายของคำขอ
• ทางเลือก: เลือกว่าจะ Ignore SSL Issues หากเปิดใช้งาน n8n จะเชื่อมต่อแม้ว่าการยืนยัน SSL จะไม่ประสบความสำเร็จ

ประเภทใบรับรองของลูกค้า (Client Credentials grant type)

ใช้ประเภทการรับรองของลูกค้าเมื่อแอพพลิเคชันขอให้ token การเข้าถึงทรัพยากรของพวกเขาเองไม่ใช่โดยผู้ใช้ การรับรองลูกค้า สำหรับข้อมูลเพิ่มเติม

ในการกำหนดค่าการรับรองนี้เลือก Client Credentials เป็น Grant Type.

จากนั้นเข้าสู่:

• อ Access Token URL : URL ที่จะตีเพื่อเริ่มต้นการไหลของ OAuth2 โดยปกติ URL นี้จบลงใน /token.
• A Client ID : ID หรือชื่อผู้ใช้ที่จะใช้ในการเข้าสู่ระบบกับลูกค้า
• A Client Secret : ความลับหรือรหัสผ่านที่ใช้ในการเข้าสู่ระบบกับลูกค้า
• ทางเลือก: เข้าสู่ 1 หรือมากกว่า Scope s สำหรับการรับรอง ส่วนใหญ่ของบริการไม่สนับสนุนการรับรองสำหรับประเภทการรับรองของลูกค้าเท่านั้นที่ป้อนการรับรองที่นี่ถ้าคุณทำ
• อ Authentication ประเภท: เลือกตัวเลือกที่เหมาะสมที่สุดกับกรณีการใช้งานของคุณ ตัวเลือกรวมถึง:
  • Header : ส่งใบรับรองเป็นหัว Auth ฐาน
  • Body : ส่งใบรับรองไปยังร่างกายของคำขอ
• ทางเลือก: เลือกว่าจะ Ignore SSL Issues หากเปิดใช้งาน n8n จะเชื่อมต่อแม้ว่าการยืนยัน SSL จะไม่ประสบความสำเร็จ

ประเภทการอนุมัติ PKCE (PKCE grant type)

หลักฐานสำหรับการแลกเปลี่ยนรหัส (PKCE) ประเภทการอนุญาตคือการขยายตัวของรหัสการอนุมัติเพื่อป้องกันการโจมตีของรหัส CSRF และรหัสการอนุมัติ

ในการกำหนดค่าการรับรองนี้เลือก PKCE เป็น Grant Type.

จากนั้นเข้าสู่:

• อ Authorization URL
• อ Access Token URL
• A Client ID : ID หรือชื่อผู้ใช้เพื่อเข้าสู่ระบบด้วย
• A Client Secret : ความลับหรือรหัสผ่านที่ใช้ในการเข้าสู่ระบบด้วย
• ทางเลือก: เข้าสู่ 1 หรือมากกว่า Scope s สำหรับใบรับรอง หากไม่ได้ระบุใบรับรองใบรับรองใบรับรองใบรับรองใบรับรองใบรับรองใบรับรองใบรับรองใบรับรอง
• ทางเลือก: บริการบางอย่างต้องมี parameter การสอบถามเพิ่มเติม หากบริการของคุณทำให้เพิ่มไว้เป็น Auth URI Query Parameters.
• อ Authentication ประเภท: เลือกตัวเลือกที่เหมาะสมที่สุดกับกรณีการใช้งานของคุณ ตัวเลือกรวมถึง:
  • Header : ส่งใบรับรองเป็นหัว Auth ฐาน
  • Body : ส่งใบรับรองไปยังร่างกายของคำขอ
• ทางเลือก: เลือกว่าจะ Ignore SSL Issues หากเปิดใช้งาน n8n จะเชื่อมต่อแม้ว่าการยืนยัน SSL จะไม่ประสบความสำเร็จ

ใช้คำถาม auth

ใช้การรับรองทั่วไปนี้หากแอปหรือบริการของคุณสนับสนุนการรับรองผ่านเป็น parameter คำถามหลัก/มูลค่าเดียว (สำหรับ parameter คำถามหลายคำถามใช้ ปริมาณ .)

ในการกำหนดค่าการรับรองนี้ให้เข้าสู่:

• คีย์คำถาม parameter หรือ Name
• parameter คำถาม Value

ใช้ custom auth

ใช้การรับรองทั่วไปนี้หากแอปหรือบริการของคุณสนับสนุนการรับรองผ่านเป็น parameter คำถามหลัก/มูลค่าหลายหรือคุณต้องการความยืดหยุ่นมากขึ้นกว่าตัวเลือก Authทั่วไปอื่น ๆ

ที่ Custom Auth การรับรองคาดหวังข้อมูล JSON เพื่อกำหนดการรับรองของคุณ คุณสามารถใช้ headers, qs, body หรือผสม. ตรวจสอบตัวอย่างด้านล่างเพื่อเริ่มต้น

ส่งหัวข้อสอง (Sending two headers)

{
	"headers": {
		"X-AUTH-USERNAME": "username",
		"X-AUTH-PASSWORD": "password"
	}
}

Body

{
	 "body" : {
		"user": "username",
		"pass": "password"
	}
}

คำถาม string (Query string)

{
	"qs": { 
		"appid": "123456",
		"apikey": "my-api-key"
	}
}

ส่งหัวและคำถาม string (Sending header and query string)

{
	"headers": {
		"api-version": "202404"
	},
	"qs": {
		"apikey": "my-api-key"
	}
}

ใช้คำอธิบายที่กำหนดเองที่เรียบง่าย

ความพร้อมใช้งานของคุณสมบัติ (Feature availability)

Simplified Custom Auth สามารถใช้ได้จาก n8n 2.35.0 ในรุ่นเก่าใช้ การรับรองความถูกต้องที่กำหนดเอง แทน

ใช้การรับรองทั่วไปนี้หากแอปหรือบริการของคุณคาดหวังว่าค่ารับรองคงที่ในหัวข้อ parameter คำถามหรือหน่วยคำขอและคุณต้องการให้ค่าที่ลับแยกจากคำขอการรับรอง

การใช้งานง่าย Custom Auth เช่น การรับรองความถูกต้องที่กำหนดเอง : JSON ที่ n8n รวมไปสู่คำขอใด ๆ ที่ใช้ใบรับรอง ความแตกต่างคือ JSON เป็นรูปแบบที่ประกอบด้วย {{placeholder}} ตัวทำเครื่องหมายแทนที่ความลับของตัวเอง รูปแบบการรับรองแสดงสนามหนึ่งต่อผู้ถือสถานที่และ n8n จะแทนที่แต่ละเครื่องหมายด้วยค่าของสนามเมื่อส่งคำขอ

ส่วนแบ่งนี้มีดังนั้น n8n Assistant สามารถเตรียมส่วนการตั้งค่าสำหรับคุณ เมื่อ n8n ผู้ช่วย สร้าง workflow สำหรับบริการที่ไม่มีการรับรอง n8n ที่กำหนดเอง มันสร้างประเภทการรับรองนี้: มันเตรียมตัวอย่าง fields และ URL การทดสอบจากเอกสาร API ของบริการ และคุณเพียงแค่ใส่ค่าที่ลับลงในแบบฟอร์ม นอกจากนี้ยังบันทึกโฮสต์ API ของบริการเพื่อให้ n8n เท่านั้นให้การรับรองไปยังช่องที่เรียกว่าบริการเดียวกัน

คุณยังสามารถตั้งค่าใบรับรองด้วยตัวเอง เลือก การตั้งค่า Edit (Edit setup) ใน modal credential และเข้าสู่:

• อ โฮมเพลต (Auth template) : JSON n8n เชื่อมต่อกับคำขอใด ๆ ที่ใช้ใบรับรองนี้ คุณสามารถใช้ headers, qs, body , หรือผสม, กับ a {{placeholder}} แท็กที่ใดที่ค่าที่ลับหรือบัญชีเฉพาะไป ไม่ใส่ค่าจริงในตัวอย่างเอง
• ที่ Fields การตั้งค่าสำหรับแต่ละผู้ถือสถานที่: A Label ไม่ว่าค่าคือ Secret (ม้วน) หรือ ภาษาไทย (Plain text) ไม่ว่ามันเป็น Required และตัวเลือก Hint ทำความสะอาดค่าที่คาดหวังเช่นรูปแบบของมัน
• ทางเลือก: A Test URL : GET endpoint n8n เรียกใช้พร้อมข้อมูลยืนยันตัวตน เพื่อตรวจว่า credentials ใช้งานได้เมื่อคุณบันทึก เลือก endpoint ที่ไม่มีผลข้างเคียงและไม่ก่อให้เกิดงานที่มีค่าใช้จ่าย เช่น endpoint สำหรับอ่านข้อมูลบัญชีหรือโปรไฟล์ หมายเลข GET endpoint n8n เรียกใช้พร้อมข้อมูลยืนยันตัวตน เพื่อตรวจว่า credentials ใช้งานได้เมื่อคุณบันทึก เลือก endpoint ที่ไม่มีผลข้างเคียงและไม่ก่อให้เกิดงานที่มีค่าใช้จ่าย เช่น endpoint สำหรับอ่านข้อมูลบัญชีหรือโปรไฟล์
• ทางเลือก: รหัสสถานะที่ยอมรับ (Accepted status codes) : รหัสสถานะที่จะได้รับการรักษาเป็นความสำเร็จพร้อมกับคำตอบ 2xx เมื่อทดสอบการรับรองเช่น 403 สำหรับบริการที่กลับ 403 สำหรับกุญแจที่ถูกต้องที่มีเป้าหมายที่ จำกัด
• ทางเลือก: A Documentation URL : หน้าผู้ให้บริการที่คุณสร้างหรือคัดลอกความลับ มันไม่ปรากฏในแบบฟอร์มการรับรอง n8n ผู้ช่วยใช้มันเพื่อแนะนำคุณไปยังหน้าที่ถูกต้อง

จากนั้นกลับไปที่แบบฟอร์มและป้อนค่าสำหรับแต่ละฟิลด์ n8n แก้ไขค่าหลังจากบันทึก

ส่งคีย์ API ในหัว (Sending an API key in a header)

รูปแบบที่ส่ง token ผู้ถือ:

{
	"headers": {
		"Authorization": "Bearer {{api_key}}"
	}
}

รูปแบบการรับรองแสดงสนามเดียวสำหรับ api_key เมื่อ node ส่งคำขอ n8n เปลี่ยนเครื่องหมายด้วยค่าของฟิลด์ซึ่งนำไปสู่หัว Authorization: Bearer <your-api-key>.

หากฟิลด์ที่ต้องการว่างเปล่าคำขอจะล้มเหลวด้วยข้อผิดพลาดแทนที่จะส่งเครื่องหมายอย่างแท้จริงไปยังบริการ หากฟิลด์ที่เลือกว่างเปล่า n8n จะลบรายการรูปแบบที่ใช้จากคำขอ

ให้ใบรับรอง SSL

คุณสามารถส่งใบรับรอง SSL ด้วยคำขอ HTTP ของคุณ สร้างใบรับรอง SSL เป็นใบรับรองที่แยกต่างหากสำหรับการใช้งานโดย node:

1. ใน node HTTP Request Settings แปลง SSL Certificates.
2. บน Parameters แท็บเพิ่มใบรับรอง SSL ที่มีอยู่ Credential for SSL Certificates หรือสร้างใหม่

เพื่อกำหนดการรับรอง SSL ของคุณคุณจะต้องเพิ่ม:

• ใบรับรองหน่วยงาน CA แพคเกจ
• ที่ Certificate (CRT): อาจปรากฏขึ้นเป็นหลักสาธารณะขึ้นอยู่กับผู้ที่ได้รับ CA ของคุณและวิธีการที่พวกเขากำหนดค่า cert
• ที่ Private Key (คีย์ )
• ทางเลือก: ถ้า Private Key มีการเข้ารหัสเข้าสู่ A Passphrase สำหรับคีย์ส่วนตัว

หากใบรับรอง SSL ของคุณอยู่ในไฟล์เดียว (เช่น A .pfx ไฟล์) คุณจะต้องเปิดไฟล์เพื่อคัดลอกรายละเอียดจากมันเพื่อแทรกในฟิลด์ที่เหมาะสม:

• เข้าร่วมคีย์สาธารณะ / CRT ในขณะที่ Certificate
• ป้อน Private Key /คีย์ในพื้นที่นี้