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]进行问题/评论。