วิธิติดตั้งและใช้งาน Bitwarden CLI บน macOS เพื่อจัดการ Secrets อย่างปลอดภัย

Bitwarden CLI เป็นเครื่องมือบรรทัดคำสั่งที่ช่วยให้คุณจัดการรหัสผ่านและ Secrets บน macOS ได้อย่างปลอดภัยโดยไม่ต้องเปิด UI ของแอปพลิเคชัน การใช้ CLI ทำให้ง่ายต่อการรวมเข้ากับสคริปต์หรือ pipeline CI/CD ที่ต้องการความเร็วและความมั่นคง

Overview — Overview

Bitwarden CLI ให้คุณทำงานกับ vault ได้ครบวงจร ทั้งการล็อกอิน, จัดเก็บค่า secret, ดึงค่า, แก้ไข และลบ โดยอาศัยการเข้ารหัสแบบ end‑to‑end บนเครื่องของคุณ

• ปลอดภัย – ข้อมูลทั้งหมดถูกเข้ารหัสก่อนส่งไปยังเซิร์ฟเวอร์
• ยืดหยุ่น – สามารถเรียกใช้จาก Terminal, สคริปต์ Bash หรือ CI pipeline
• ไม่มี UI – ลด overhead ของการเปิดแอปและเหมาะกับ headless environment

**Tip: ควรตั้งค่า `BW_SESSION` เป็นตัวแปรสภาพแวดล้อมเพื่อหลีกเลี่ยงการพิมพ์รหัสผ่านหลายครั้งในแต่ละคำสั่ง

Installation — Installation

Prerequisites — Prerequisites

• macOS 10.15 ขึ้นไป (รองรับทั้ง Intel และ Apple Silicon)
• Homebrew ติดตั้งแล้ว (`/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"`)
• การเชื่อมต่ออินเทอร์เน็ตเพื่อดาวน์โหลดไบนารี

Install Bitwarden CLI — Install Bitwarden CLI

• **ขั้นตอนที่ 1: เปิด Terminal แล้วรันคำสั่ง `brew install bitwarden-cli`
• **ขั้นตอนที่ 2: ตรวจสอบเวอร์ชันด้วย `bw --version` ควรแสดงเลขเวอร์ชันล่าสุด

**Tip: หากใช้ Apple Silicon ให้ตรวจสอบว่า Homebrew ติดตั้งใน `/opt/homebrew` เพื่อให้ได้ไบนารีสถาปัตยกรรม ARM

Configuration — Configuration

ก่อนใช้งานต้องทำการล็อกอินและปลดล็อค vault ก่อนทุกครั้ง

• **ขั้นตอนที่ 1: ล็อกอินด้วย `bw login <email>` ระบบจะขอให้ใส่ Master Password
• **ขั้นตอนที่ 2: ปลดล็อค vault ด้วย `bw unlock --raw` คำสั่งนี้จะคืนค่า token แบบ raw
• **ขั้นตอนที่ 3: เก็บ token ไว้ในตัวแปรสภาพแวดล้อม `export BW_SESSION=<token>` เพื่อให้คำสั่งต่อไปใช้ได้โดยอัตโนมัติ

**Tip: เพิ่มบรรทัด `export BW_SESSION=$(bw unlock --raw)` ลงไฟล์ `~/.zshrc` หรือ `~/.bash_profile` จะทำให้ทุกเทอร์มินัลมี session ที่พร้อมใช้งาน

Managing Secrets — Secrets Management

Store a Secret — Store a Secret

• ใช้คำสั่ง `bw create item login --name "<ชื่อ>" --login.username "<username>" --login.password "<password>"` เพื่อสร้างรายการใหม่ใน vault

Retrieve a Secret — Retrieve a Secret

• ดึงข้อมูลด้วย `bw get password <item-id>` หรือใช้ `bw get item <item-id> | jq -r '.login.password'` เพื่อนำค่ามาใช้งานต่อ

Update a Secret — Update a Secret

• แก้ไขโดยดึง JSON ของรายการเดิม `bw get item <id> > tmp.json` แล้วแก้ไขฟิลด์ที่ต้องการ จากนั้นอัปโหลดใหม่ด้วย `bw edit item <id> tmp.json`

Delete a Secret — Delete a Secret

• ลบรายการด้วย `bw delete item <id>` ระบบจะถามยืนยันก่อนทำลบจริง

**Tip: อย่าใช้ชื่อ item ซ้ำซ้อน หากต้องการเวอร์ชันเก็บหลายค่าให้เพิ่ม suffix เช่น “API‑Key‑prod”

Automation Example — Automation Example

สมมติว่าต้องดึง API key ไปใช้ในสคริปต์ Deploy

• สร้างไฟล์ `deploy.sh`

```bash #!/bin/bash export BW_SESSION=$(bw unlock --raw) API_KEY=$(bw get password "<item-id>") curl -X POST -H "Authorization: Bearer $API_KEY" https://api.example.com/deploy ```

• เพิ่มสิทธิ์ทำงาน `chmod +x deploy.sh`
• ตั้งค่าให้ CI pipeline (เช่น GitHub Actions) รันสคริปต์โดยใช้ secret `BW_PASSWORD` เพื่อเข้าสู่ระบบ Bitwarden

Tip: ควรกำหนด `BW_PASSWORD` ใน CI ให้เป็น encrypted secret** เท่านั้น ไม่ควรเก็บในโค้ด

Security Best Practices — Best Practices

• Never store Master Password หรือ BW_SESSION ไว้ในไฟล์สาธารณะ
• ใช้ hardware security key (YubiKey) สำหรับการ MFA เพิ่มความแข็งแรงให้ login
• ตั้งค่า session timeout สั้นลง (`bw config set lockTimeout <minutes>`) เพื่อให้ token หมดอายุเร็วขึ้นเมื่อไม่ได้ใช้งาน

**Warning: หาก BW_SESSION ถูกบันทึกไว้ใน `.bash_history` จะทำให้ผู้ที่เข้าถึงเครื่องได้เห็น token อย่างง่าย

Troubleshooting — Troubleshooting

• **คำสั่ง `bw: command not found` – ตรวจสอบว่า Homebrew ได้เพิ่มไดเรกทอรี `/usr/local/bin` หรือ `/opt/homebrew/bin` ไปยัง `$PATH` แล้วหรือยัง
• การล็อกอินล้มเหลว – ตรวจสอบว่าบัญชี Bitwarden มี MFA ที่เปิดใช้งานและใส่รหัส OTP ถูกต้อง
• Token หมดอายุบ่อย – ใช้ `bw unlock --raw` ทุกครั้งที่เริ่มสคริปต์หรือเพิ่ม `export BW_SESSION=$(bw unlock --raw)` ในไฟล์ตั้งค่าเชลล์

Summary — Summary

• ติดตั้ง Bitwarden CLI ด้วย Homebrew (`brew install bitwarden-cli`)
• ล็อกอินและปลดล็อค vault เพื่อให้ได้ `BW_SESSION` ที่ต้องเก็บเป็น environment variable
• ใช้คำสั่ง `bw create`, `bw get`, `bw edit`, `bw delete` จัดการ Secrets ทั้งสร้าง, ดึง, แก้ไข และลบ
• ผสานกับสคริปต์หรือ CI/CD เพื่อทำ automation อย่างปลอดภัยโดยไม่ต้องเปิด UI

สิ่งที่ควรจำ

• รักษา Master Password ไว้เป็นความลับสูงสุด
• ใช้ BW_SESSION เป็นตัวแปรชั่วคราวและไม่บันทึกในไฟล์คอนฟิกสาธารณะ
• ตรวจสอบ MFA และตั้งค่า session timeout เพื่อลดโอกาสการโจมตี

ด้วยขั้นตอนเหล่านี้ คุณสามารถจัดการ Secrets บน macOS ด้วย Bitwarden CLI ได้อย่างรวดเร็ว ปลอดภัยและพร้อมใช้งานในทุกกระบวนการพัฒนา.