การยืนยันตัวตน
CLI ลงชื่อเข้าใช้ผ่านเบราว์เซอร์ของคุณ รหัสอุปกรณ์ หรือคีย์ API และในสคริปต์กับ CI จะอ่านข้อมูลรับรองจาก flag หรือตัวแปรสภาพแวดล้อม รัน polylane auth login เพื่อเลือกวิธีแบบโต้ตอบ หรือส่ง flag เพื่อข้ามตัวเลือก
วิธีลงชื่อเข้าใช้
| วิธี | คำสั่ง | คำอธิบาย |
|---|---|---|
| เบราว์เซอร์ | polylane auth login | สำหรับการใช้งานแบบโต้ตอบ CLI เปิดเบราว์เซอร์ของคุณ รับโทเค็นผ่าน callback บน localhost และรีเฟรชเมื่อโทเค็นหมดอายุ |
| รหัสอุปกรณ์ | polylane auth login --no-browser | สำหรับเครื่อง SSH และเครื่องที่ไม่มีหน้าจอ CLI พิมพ์ URL และรหัส เปิด URL บนอุปกรณ์ใดก็ได้ ป้อนรหัส แล้ว CLI จะ poll จนกว่าคุณอนุมัติ |
| คีย์ API | polylane auth login --api-key sk_xxxxx | สำหรับสคริปต์ CI และเอเจนต์ CLI ตรวจสอบความถูกต้องของคีย์และเก็บไว้พร้อม workspace เริ่มต้น |
หลังลงชื่อเข้าใช้ CLI แสดงว่าคุณเป็นใคร และหากคุณอยู่ในมากกว่าหนึ่ง workspace จะขอให้คุณเลือกค่าเริ่มต้น ซึ่งบันทึกเป็น workspace_id ใน ~/.polylane/config.json บังคับรีเฟรชโทเค็นด้วย polylane auth refresh
คีย์ API
สร้างคีย์ใต้ Settings > API Keys ด้วย Create an API key: ตั้งชื่อ เลือกสโคป และคัดลอกไว้ เพราะจะแสดงเพียงครั้งเดียว คีย์เริ่มด้วย sk_ ใน CI ให้ตั้ง POLYLANE_API_KEY ในสภาพแวดล้อมแทนการรันขั้นตอน login หรือส่ง flag ส่วนกลาง --api-key <key> ในการเรียกครั้งเดียว
ลำดับความสำคัญของข้อมูลรับรอง
เมื่อมีข้อมูลรับรองหลายรายการ CLI จะเลือกใช้ตามลำดับนี้:
- flag
--api-keyบนคำสั่งปัจจุบัน - ตัวแปรสภาพแวดล้อม
POLYLANE_API_KEY - ข้อมูลรับรอง OAuth ใน
~/.polylane/credentials.json api_keyใน~/.polylane/config.json
POLYLANE_API_KEY ที่ export ไว้จะชนะ ~/.polylane/credentials.json ที่ค้างอยู่เสมอ ดังนั้น CI runner ที่ตั้งตัวแปรนี้ไว้จะไม่หยิบโทเค็น OAuth ที่หลงเหลืออยู่ polylane auth status แสดงว่ากำลังใช้แหล่งใด
ตรวจสอบและสลับ
polylane auth status
polylane auth whoami
polylane auth logout
auth status แสดงวิธีที่ใช้อยู่ โทเค็นที่ปิดบังบางส่วน ผู้ใช้ และ workspace auth whoami แสดงผู้ใช้ปัจจุบัน auth logout เพิกถอนโทเค็น OAuth และล้างข้อมูลรับรองที่เก็บไว้หลังการยืนยัน ซึ่ง --yes ข้ามได้ หากต้องการสลับบัญชี ให้ออกจากระบบแล้วลงชื่อเข้าใช้ด้วยข้อมูลรับรองอีกชุด
ตัวแปรสภาพแวดล้อม
| ตัวแปร | คำอธิบาย |
|---|---|
POLYLANE_API_KEY | คีย์ API สำหรับการยืนยันตัวตนแบบไม่โต้ตอบ |
POLYLANE_WORKSPACE_ID | workspace เริ่มต้น (id แบบ ws_) |
POLYLANE_API_DOMAIN | แทนที่ hostname ของ API |
ใช้ตัวแปรเหล่านี้ในงาน CI และคอนเทนเนอร์ที่คุณไม่ต้องการเขียนลง ~/.polylane/ การกำหนดค่าแสดงรายการทั้งชุด
ที่เกี่ยวข้อง
- การกำหนดค่า: ลำดับความสำคัญทั้งหมด ทุกตัวแปรสภาพแวดล้อม และไฟล์บนดิสก์
- การเขียนสคริปต์: ผลลัพธ์ JSON exit code และ flag สำหรับ CI และเอเจนต์
- คีย์ API และ OAuth: สโคป การจัดการคีย์ และไคลเอนต์ OAuth