การนำทาง
บริการลงนามโค้ดระยะไกลมีเครื่องมือไคลเอนต์หลากหลาย ระบบ Provider อินเทอร์เฟซสำหรับนักพัฒนา และวิธีการผสานรวมอัตโนมัติ
หากคุณไม่แน่ใจว่าควรเลือกวิธีใด สามารถเริ่มจากสถานการณ์การใช้งานด้านล่างนี้ได้
วิธีเลือกวิธีการผสานรวม
| สถานการณ์การใช้งาน | วิธีที่แนะนำ |
|---|---|
| ใช้เครื่องมือบรรทัดคำสั่งอย่างเป็นทางการเพื่อลงนามไฟล์ EXE, DLL, MSI เป็นต้น โดยตรง | เครื่องมือไคลเอนต์ |
| ติดตั้งไคลเอนต์การลงนามโค้ดผ่าน Homebrew บน macOS | เครื่องมือไคลเอนต์ |
| เครื่องมือ Windows เช่น Microsoft SignTool, Visual Studio, MSBuild จำเป็นต้องใช้คีย์ส่วนตัวระยะไกลโดยตรง | Windows Provider |
| จำเป็นต้องรองรับแอปพลิเคชัน Windows CryptoAPI / CSP แบบดั้งเดิม | Windows Provider |
ใช้ jarsigner เพื่อลงนามไฟล์ Java JAR | การผสานรวม Java |
| ลงนามโค้ดอัตโนมัติใน GitHub Actions | เครื่องมือ CI/CD และเครื่องมือ build |
| ใช้ Electron Builder เพื่อลงนามแอปพลิเคชัน Windows อัตโนมัติ | เครื่องมือ CI/CD และเครื่องมือ build |
| ใช้ Advanced Installer เพื่อสร้างและลงนามแพ็กเกจการติดตั้ง | CI/CD กับเครื่องมือ build |
| พัฒนาไคลเอนต์เองหรือเรียกใช้บริการลงนามระยะไกลโดยตรง | การผสานรวม API |
| ตรวจสอบจำนวนครั้งการลงนาม เซิร์ฟเวอร์ timestamp และข้อมูลสาธารณะอื่น ๆ | เอกสารอ้างอิง |
เครื่องมือไคลเอนต์
เหมาะสำหรับผู้ใช้ที่ต้องการใช้ไคลเอนต์อย่างเป็นทางการของ sslTrus เพื่อลงนามโค้ดโดยตรง
เนื้อหาหลักประกอบด้วย:
- SignTool CLI:ลงนามไฟล์โดยตรงผ่าน command line
- ตรวจสอบโควตาการลงนาม:ตรวจสอบจำนวนครั้งการลงนามคงเหลือและทั้งหมดของใบรับรอง
- อัปเดตไคลเอนต์:ตรวจสอบและติดตั้งเวอร์ชันล่าสุด
- Homebrew:ติดตั้ง CLI หรือไคลเอนต์เดสก์ท็อปบน macOS
Windows Provider
เหมาะสำหรับ Microsoft SignTool, Visual Studio, MSBuild, เครื่องมือแพ็กเกจการติดตั้ง และซอฟต์แวร์อื่น ๆ ที่รองรับ Windows Cryptography API
มี Provider ให้เลือกสองแบบ:
- KSP (Key Storage Provider):อิงตาม Windows CNG เหมาะสำหรับกระบวนการลงนามบน Windows สมัยใหม่
- CSP (Cryptographic Service Provider):อิงตาม CryptoAPI แบบดั้งเดิม เหมาะสำหรับแอปพลิเคชันที่ต้องการความเข้ากันได้กับ CSP
คีย์ส่วนตัวสำหรับการลงนามจะถูกเก็บไว้ใน HSM บนคลาวด์ตลอดเวลา Provider ในเครื่องมีหน้าที่ส่งคำขอลงนามไปยังบริการลงนามโค้ดระยะไกล
การผสานรวม Java
เหมาะสำหรับสถานการณ์การลงนามโค้ด Java
ผ่าน Java Provider ที่ sslTrus มอบให้ คุณสามารถใช้เครื่องมือ jarsigner มาตรฐานเพื่อลงนามไฟล์ JAR จากระยะไกล
CI/CD กับเครื่องมือ build
เหมาะสำหรับสถานการณ์ที่ต้องผสานการลงนามโค้ดเข้ากับกระบวนการ build, release หรือแพ็กเกจอัตโนมัติ
ปัจจุบันมี:
- GitHub Actions
- Electron Builder
- Advanced Installer
วิธีการผสานรวม CI/CD หรือเครื่องมือ build อื่น ๆ จะมีเพิ่มเติมในหน้านี้ในภายหลัง
ดู CI/CD กับเครื่องมือ build →
การผสานรวม API
เหมาะสำหรับนักพัฒนาที่ต้องการพัฒนาไคลเอนต์ลงนามโค้ดเองหรือผสานความสามารถการลงนามระยะไกลเข้ากับระบบที่มีอยู่
API การลงนามโค้ดระยะไกลรองรับ:
- ส่ง digest ที่ต้องการลงนามและรับผลลัพธ์การลงนาม
- รายงานสถานะการประมวลผลการลงนามขั้นสุดท้ายของไคลเอนต์
ผู้เรียกใช้รับผิดชอบการคำนวณ digest ของไฟล์ การจัดการโครงสร้างลายเซ็น และการเขียนผลลัพธ์การลงนามขั้นสุดท้ายในเครื่อง
เอกสารอ้างอิง
ส่วนนี้ให้ข้อมูลอ้างอิงทั่วไปที่ใช้ได้กับวิธีการผสานรวมหลายรูปแบบ ได้แก่:
- คำอธิบายการคำนวณจำนวนครั้งการลงนาม: อธิบายวิธีคำนวณจำนวนครั้งการลงนามในสถานการณ์ต่างๆ เช่น CLI, KSP, CSP, Jarsigner, Electron และแพ็กเกจติดตั้ง
- เซิร์ฟเวอร์ประทับเวลา: แนะนำ Authenticode, RFC 3161 และบริการประทับเวลาการลงนามโค้ดที่ใช้บ่อย