ศูนย์คู่มือ Ruk-Com PaaS

คู่มือการพัฒนา Deploy และดูแล Application บน Platform

RUK-COM PAAS / ACCOUNT & PRICING

จัดการ Personal Access Token

คู่มือนี้เรียบเรียงสำหรับ Ruk-Com PaaS หน้าจอและตัวเลือกอาจแตกต่างตามเวอร์ชันและสิทธิ์ของบัญชี

ตรวจสอบ Environment, Region, สิทธิ์บัญชี และสำรองค่าปัจจุบันก่อนดำเนินการกับระบบจริง

คู่มือภาษาไทย

คำสั่ง ชื่อเมนู Parameter และค่าตัวอย่างในกรอบ Code คงรูปแบบตามระบบเพื่อให้คัดลอกและตรวจสอบได้ถูกต้อง

Image 38: personal access tokens logo

โทเค็นการเข้าถึงส่วนบุคคลเป็นอีกทางเลือกหนึ่งในการตรวจสอบสิทธิ์คำขอ API ใน Platform ซึ่งเมื่อเปรียบเทียบกับวิธีการตาม Session เริ่มต้นแล้วจะให้ความคล่องตัวและความน่าเชื่อถือที่มากกว่า

ข้อดีของโทเค็นสามารถเน้นได้ดังต่อไปนี้:

  • สามารถสร้างโทเค็นได้หลายรายการพร้อมกันเพื่อรองรับงานที่แตกต่างกัน
  • การรับรองความถูกต้องที่ง่ายขึ้นด้วยโทเค็น (ไม่จำเป็นต้องดำเนินการร้องขอเพิ่มเติมเพื่อรับ Session) ช่วยให้มั่นใจได้ว่าฐานรหัสมีขนาดเล็กลงและตอบสนองเร็วขึ้นเมื่อใช้ Script อัตโนมัติ
  • ข้อมูลรับรองของคุณ (การเข้าสู่ระบบและรหัสผ่าน) จะไม่ถูกเปิดเผยภายใน Script
  • โทเค็นสามารถตรวจสอบสิทธิ์ฟังก์ชันบัญชีได้เพียงบางส่วนดังนั้นคุณจึงสามารถแบ่งปันกับเพื่อนร่วมงานและผู้ช่วยบุคคลที่สามได้โดยไม่สร้างการละเมิดความปลอดภัย
  • โทเค็นสามารถเสริมด้วยวันหมดอายุหรือเพิกถอนด้วยตนเองได้ตลอดเวลา

Platform นี้มอบ Interface แบบเห็นภาพที่ใช้งานได้เต็มรูปแบบสำหรับการจัดการโทเค็นโดยตรงใน Dashboard ซึ่งทำให้เป็นวิธีที่ดีกว่าในการตรวจสอบความถูกต้องของการผสานรวม API ใดๆ (โดยเฉพาะในบัญชีที่มีการรับรองความถูกต้องด้วยสองปัจจัยเปิดใช้งาน):

การจัดการโทเค็นการเข้าถึง

ด้านล่างนี้เราจะดูภาพรวมกระบวนการจัดการโทเค็นการเข้าถึงส่วนบุคคลโดยใช้ UI Dashboard:

  1. ไปที่การตั้งค่าส่วนโดยคลิกที่ปุ่มชื่อเดียวกันที่มุมขวาบนของ Dashboard

Image 40: user account settings2. ในกรอบที่เปิดอยู่ให้เลือกโทเค็นการเข้าถึงเพื่อดูรายการโทเค็นทั้งหมดในบัญชีแผงเครื่องมือเหนือรายการช่วยให้สามารถเข้าถึงปุ่มต่อไปนี้:

  • สร้าง- สร้างโทเค็นใหม่โดยระบุคำอธิบายวันหมดอายุและเลือกวิธี API ที่ต้องการ (ไม่ว่าจะจากชุดที่กำหนดไว้ล่วงหน้าหรือด้วยตนเอง)
  • แก้ไข- ปรับโทเค็นที่มีอยู่หรือสร้างใหม่ (เช่นตั้งชื่อใหม่ในขณะที่ยังคงรักษา Parameter อื่นๆทั้งหมดไว้)
  • สำเนา- สร้างโทเค็นใหม่โดยใช้ Parameter ของโทเค็นที่มีอยู่เป็นพื้นฐาน
  • ลบ- ลบโทเค็นที่เลือก
  • Refresh- แสดงการเปลี่ยนแปลงล่าสุดในรายการ

Image 41: access tokens settings3. ในขณะที่สร้างใหม่หรือปรับโทเค็นที่มีอยู่เฟรมต่อไปนี้จะปรากฏขึ้นอนุญาตให้ปรับได้:

  • คำอธิบาย- คำอธิบายที่กำหนดเองสำหรับโทเค็น
  • หมดอายุณ- วันที่ในวว-ดด-ปปปปรูปแบบโทเค็นนี้ใช้ได้จนถึง (สามารถสร้างใหม่ได้หลังจากหมดอายุ)
  • เอพีไอ- ชื่อของชุดคำขอ API: กำหนดไว้ล่วงหน้า (ขยายการเข้าถึง,Plugin IDE,ตลาด,Plugin Maven) หรือกำหนดเอง(โดยเลือกวิธีการด้วยตนเอง)
  • ใช้ค้นหาสนาม,ตรวจสอบแล้วเท่านั้นกรองและลิงก์ไปยัง APIเอกสาร(แสดงเมื่อวางเมาส์เหนือวิธีการเฉพาะ) เพื่อกำหนดค่าสิทธิ์ที่จำเป็นสำหรับโทเค็น

Image 42: generate access token4. การเปลี่ยนแปลงโทเค็นทั้งหมดในบัญชีจำเป็นต้องมีการยืนยันรหัสผ่านก่อนที่จะนำไปใช้

Image 43: password confirmation5. ถัดไปคุณจะเห็นค่าโทเค็นการเข้าถึงตรวจสอบให้แน่ใจว่าคุณได้บันทึกไว้ (ใช้ดาวน์โหลด/สำเนาปุ่ม) เนื่องจากจะไม่แสดงที่ใดก็ได้อีกต่อไป

Image 44: save access token

เคล็ดลับ:หากคุณลืมหรือสูญเสียค่าโทเค็นของคุณคุณสามารถสร้างค่าใหม่ได้โดยเข้าไปที่แก้ไขโทเค็นการเข้าถึงเฟรมแล้วคลิกลิงก์ที่เหมาะสมที่ด้านล่าง

Image 45: regenerate access tokenค่าเดิมไม่ถูกต้องดังนั้นควรอัปเดตการทำงานอัตโนมัติที่มีอยู่ด้วยโทเค็นนี้

  1. คุณสามารถลบไม่จำเป็นต้องใช้โทเค็นอีกต่อไป (ใช้กะและCtrlเพื่อเลือกหลายอัน) ด้วยปุ่มชื่อเดียวกันที่แผงเครื่องมือ

Image 46: remove access tokenยืนยันในป๊อปอัปและระบุรหัสผ่านเพื่อดำเนินการต่อ

ตอนนี้คุณรู้วิธีจัดการโทเค็นการเข้าถึงส่วนบุคคลในบัญชีแล้วและสามารถใช้ในคำขอ API ของคุณได้

การใช้โทเค็นการเข้าถึง

การใช้โทเค็นการเข้าถึงช่วยลดความยุ่งยากในการตรวจสอบสิทธิ์คำขอ API ลงอย่างมากเนื่องจากช่วยให้สามารถข้ามขั้นตอนการสร้าง Session และรับประกันความน่าเชื่อถือที่มากขึ้นเมื่อเทียบกับความถูกต้องในระยะสั้นของ Session

  1. เพียงดำเนินการตามวิธี API ที่จำเป็นโดยระบุของคุณโทเค็นภายในการประชุมParameter.

ตัวอย่างเช่นคุณสามารถหยุด Environmentโดยป้อน URL ต่อไปนี้ลงใน Browser:

สำเนา

https://app.${platformDomain}/1.0/environment/control/rest/stopenv?envName=${envName}&session=${token}

ที่นี่:

  • ${Platform Domain}-URL ของ Platform(ชื่อ Domain)
  • ${envName}- ชื่อของ Environment เป้าหมาย (เช่นโครงการของฉัน)
  • ${โทเค็น}- ค่าของโทเค็น (ตรวจสอบให้แน่ใจว่าได้รับอนุญาตสำหรับการดำเนินการที่เรียก)

Image 48: stop environment API request with tokenเพื่อการดำเนินการที่ประสบความสำเร็จคุณควรได้รับ“ผลลัพธ์”:0ในการตอบสนอง (ค่าที่ไม่ใช่ศูนย์หมายถึงข้อผิดพลาด)

  1. ตอนนี้หากคุณกลับไปที่ Dashboard คุณจะเห็น Environment ที่เหมาะสมหยุดลง

Image 49: stopped environmentแค่นั้นแหละ! การจัดการ API ด้วยโทเค็นนั้นง่ายมาก!