vcert python

這個開源項目是社區支持的。要報告問題或分享想法，請使用問題；而且，如果您有解決問題的建議，請也包括這些詳細信息。此外，請使用拉動請求來貢獻實際的錯誤修復或建議的增強功能。我們歡迎並感謝所有貢獻。有問題還是想與我們的團隊討論一些東西？加入我們的Slack ！

VCERT PYTHON

VCERT PYTHON是一個Python庫和SDK，旨在通過使用Venafi Trust Protection Platform或Venafi作為服務來簡化機器身份（也稱為SSL/TLS證書和密鑰）的密鑰生成和註冊。

該實現基於原始GO庫，https://github.com/venafi/vcert。

相容性

啟動版0.14.0 VCERT-PYTHON僅支持Python 3.6或更高

使用最新版本的信任保護平台對VCERT版本進行了測試。最新的VCERT版本應與信任保護平台17.3或更高版本兼容，以基於其消耗的API方法的子集。

安裝

使用PIP獲取庫：
pip install vcert

您還可以從GitHub安裝最新版本：
pip install https://github.com/Venafi/vcert-python/archive/master.zip

如果安裝失敗會收集依賴，請確保您的python setuptools是最新的。運行以下命令以升級到最新版本的Setuptools。 pip install setuptools -U

用法示例

有關程序化使用的代碼示例，請在 /示例中查看文件。

• 對於信任保護平台， zone格式是帶有或不帶有“ ved policy”前綴（例如“ ved policy cudtrantes vcert vcert”或簡單地“證書 vcert”的策略的DN））
• 對於Venafi作為服務， zone格式是UTAGE PREDICT應用程序的名稱，也是由單個Backslash字符界定給其界定的發行模板的API別名（例如“我的應用程序我的CIT”）

使用信任保護平台使用的先決條件

1. 具有“證書：管理，撤銷”範圍的身份驗證令牌的用戶帳戶（即20.1截至20.1訪問“ Venafi VCERT SDK” API應用程序或已獲得WebSDK訪問
2. 一個文件夾（區域），其中已授予用戶以下權限：查看，讀取，寫作，創建，撤銷（用於撤銷操作）和私有密鑰讀取（用於生成CSR時的拾取操作）
3. 應用於指定的文件夾：
   1. CA模板該信任保護平台將用於註冊VCERT提交的證書請求
   2. 組織單位（OU），組織（O），城市（L），州（ST）和國家（C）的主體DN值
   3. 管理類型未鎖定或鎖定為“註冊”
   4. 證書籤名請求（CSR）一代未鎖定或鎖定到“服務生成的CSR”
   5. 在應用程序上生成鍵/CSR，未鎖定或鎖定為“否”
   6. （建議）禁用自動續訂設置為“是”
   7. （建議）將密鑰強度設置為2048或更高
   8. （建議）適當分配的域白名單政策

CA模板由策略分配的要求遵循了長期存在的Venafi最佳實踐，這也滿足了我們的設計目標，以使VCERT用戶的證書請求過程保持簡單。如果您需要使用請求指定CA模板的能力，則可以使用TPP REST API，但請告知這與Venafi建議有關。

將Venafi用作服務的先決條件

1. VENAFI作為服務REST API可在https://api.venafi.cloud或https://api.venafi.eu（如果您有EU帳戶）中訪問，從該系統執行VCERT。
2. 您已經成功註冊了Venafi作為服務帳戶，至少已授予“資源所有者”角色，並知道您的API密鑰。
3. CA帳戶和發行模板存在並已配置：
   1. 推薦的設置值：
      1. 組織單位（OU）
      2. 組織（O）
      3. 城市/地區（L）
      4. 州/省（ST）
      5. 國家（C）
   2. 發布規則：
      1. （建議）將通用名稱和主題替代名稱限製到您組織允許的域
      2. （建議）將密鑰長度限制在2048年或更高
      3. （建議）不允許私鑰再利用
4. 存在一個應用程序中的應用程序，您知道應用程序名稱。
5. 發行模板已分配給應用程序，您知道其API別名。

為VCERT做出貢獻

Venafi歡迎開發人員社區的貢獻。

1. 將其分配到您的帳戶（https://github.com/venafi/vcert-python/fork）
2. 克隆您的叉子（ git clone [email protected]:youracct/vcert-python.git ）
3. 創建一個功能分支（ git checkout -b your-branch-name ）
4. 實施並測試您的更改
5. 提交您的更改（ git commit -am 'Added some cool functionality' ）
6. 推到分支機構（ git push origin your-branch-name ）
7. 創建一個新的拉請請求（https://github.com/youracct/vcert-python/pull/new/your-your-branch-name）

注意：在使用VCERT-PYTHON開發時，如果您使用VirtualEnv在開發模式下使用pip install --editable vcert-python庫來安裝VCERT-PYTHON庫會很有幫助。參見https://packaging.python.org/guides/installing-using-pip-and-virtual-envorirnments/

版本歷史記錄

在這裡檢查版本歷史記錄

執照

版權所有©Venafi，Inc。保留所有權利。

VCERT是根據Apache許可證的2.0版獲得許可的。有關完整許可文本，請參見LICENSE 。

請直接向[email protected]進行問題/評論。