API 金鑰

API 金鑰讓指令碼和 CI 可以使用 REST API。在 帳號設定 → API 金鑰 中建立。

• 金鑰以 zv_pat_ 開頭，只顯示一次。請像對待密碼一樣對待它。
• 每個金鑰都有權限，並且可以只限部分專案。只給金鑰完成任務所需的權限。
• 任何金鑰都不能修改你的帳號（電子郵件、密碼、金鑰）、建立其他金鑰，或者操作帳單、購買或團隊成員。
• 有效期可以選 30、90 或 365 天，或者永不過期。列表中顯示每個金鑰最近一次使用的時間；不再需要的金鑰請刪除。

curl -H "Authorization: Bearer $ZENAVO_API_KEY" https://zenavo.app/api/projects

權限

權限	可以	不可以	相當於
唯讀	檢視專案、服務、部署、任務、日誌、伺服器和用量	檢視設定的值（環境變數、連線資訊），修改任何內容	最多是觀察者
部署	另外還可以部署、回滾、重啟和恢復服務，編輯專案設定（包括環境變數），上傳原始碼，新增生成的網域，建立備份	開啟 shell 或執行指令，讀取或修改檔案和資料庫中的資料，下載或還原備份，建立、刪除、遷移或停止專案，修改伺服器或防火牆	最多是成員
完全存取	API 金鑰能做的一切，權限與你自己的角色相同	帳單，購買或續費伺服器，邀請或移除成員，建立、刪除或轉移團隊	你的角色

金鑰在團隊中的權限永遠不會超過你的角色：觀察者建立的部署金鑰仍然只是觀察者。在權限功能推出之前建立的金鑰和以前一樣擁有 完全存取。金鑰權限不允許的請求會返回 403。

日誌中可能包含你的服務輸出的任何內容。如果服務把機密列印了出來，唯讀金鑰也能看到。

限定金鑰只能存取部分專案

選擇 僅限部分專案 並勾選專案。之後這個金鑰看不到其他任何內容：專案和任務列表只顯示這些專案，其他專案返回 404，專案以外的內容（伺服器、團隊設定、成員）返回 403。即使擁有完全存取權限，它也不能刪除、複製、遷移或轉移這些專案。對於 AI 智慧體或 CI 任務，這是最安全的選擇。

專案限制在每次請求時都會與你的角色一起檢查，所以你離開團隊後，金鑰也會失去對專案的存取。

CLI 登入

CLI 的 zenavo auth login 會為 CLI 建立一個金鑰，不需要你手動複製。終端機會顯示一個程式碼；在控制台開啟 /device，輸入程式碼並批准。請確認裝置名稱和網路是你自己的：只批准你剛剛親自請求的程式碼。批准操作會記錄在你的安全活動中。這個金鑰名為 CLI on <hostname>，90 天后過期，並顯示在金鑰列表中。

批准頁面會顯示 CLI 請求的權限。你可以批准更少的權限（例如用唯讀代替部署），並限定部分專案；但永遠不能給它超過請求的權限。不請求權限的舊版 CLI 會獲得完全存取。