vcert python

Este projeto de código aberto é apoiado pela comunidade. Para relatar um problema ou compartilhar uma ideia, use problemas ; E se você tiver uma sugestão para corrigir o problema, inclua esses detalhes também. Além disso, use solicitações de tração para contribuir com correções de bug reais ou aprimoramentos propostos. Congratulamo -nos com e apreciamos todas as contribuições. Tem perguntas ou deseja discutir algo com nossa equipe? Junte -se a nós no Slack !

VCERT Python

O VCERT Python é uma biblioteca Python e SDK projetada para simplificar a geração de chaves e a inscrição de identidades de máquinas (também conhecidas como certificados e teclas SSL/TLS) que cumprem a política de segurança corporativa usando a plataforma de proteção de confiança da Venafi ou venefi como serviço.

Esta implementação é baseada na biblioteca Go original, https://github.com/venafi/vcert.

Compatibilidade

Versão inicial 0.14.0 VCERT-Python suporta apenas o Python 3.6 ou superior

As versões do VCERT são testadas usando a versão mais recente da plataforma de proteção de confiança. A versão mais recente do VCERT deve ser compatível com a plataforma de proteção de confiança 17.3 ou superior, com base no subconjunto de métodos de API que consome.

Instalação

Obtenha a biblioteca usando PIP:
pip install vcert

Você também pode instalar a versão mais recente do GitHub:
pip install https://github.com/Venafi/vcert-python/archive/master.zip

Se a instalação falhar na coleta de dependências, verifique se o seu Python SetupTools está atualizado. Execute o seguinte comando para atualizar para a versão mais recente do setupTools. pip install setuptools -U

Exemplo de uso

Para amostras de código de uso programático, revise os arquivos em /exemplos.

• Para a plataforma de proteção de confiança, o formato zone é o DN de uma política com ou sem o prefixo " Ved Policy" (por exemplo, Ved Policy Certificates Vcert "ou simplesmente" certificados vcert ")
• Para Venafi como um serviço, o formato zone é o nome de um aplicativo Fatageredict e o alias da API de um modelo de emissão atribuído a ele delimitado por um único caractere de barra de barra

Pré -requisitos para usar com a plataforma de proteção de confiança

1. Uma conta de usuário que possui um token de autenticação com o escopo "Certificado: Gerenciar, Revogar" (ou seja, acesso ao aplicativo da API "VENAFI VCERT SDK" a partir de 20.1) ou foi concedido acesso ao WebSDK Acesso
2. Uma pasta (zona) em que o usuário recebeu as seguintes permissões: veja, leia, escreva, crie, revogue (para a ação de revogar) e lida de chave privada (para a ação de coleta quando a RSE for gerada pelo serviço)
3. Política aplicada à pasta que especifica:
   1. Modelo CA que a plataforma de proteção de confiança usará para inscrever solicitações de certificado enviadas pelo VCERT
   2. Assunto Valores de DN para Unidade Organizacional (OU), Organização (O), Cidade (L), Estado (ST) e País (C)
   3. Tipo de gerenciamento não bloqueado ou bloqueado na 'inscrição'
   4. Geração de solicitação de assinatura de certificado (RSE) não bloqueada ou bloqueada em 'Serviço gerado por CSR'
   5. Gerar chave/recesso de CSR no aplicativo não bloqueado ou bloqueado em 'não'
   6. (Recomendado) Desativar a renovação automática definida como 'sim'
   7. (Recomendado) a força dos bits -chave definida como 2048 ou superior
   8. (Recomendada) Política de Whitelisting de domínio apropriadamente atribuída

O requisito para que o modelo da CA seja atribuído pela Política segue uma prática recomendada de longa data da Venafi, que também atingiu nosso objetivo de design para manter o processo de solicitação de certificado simples para os usuários do VCERT. Se você precisar da capacidade de especificar o modelo da CA com a solicitação, poderá usar as APIs REST TPP, mas seja aconselhado isso às recomendações da Venafi.

Pré -requisitos para usar com Venafi como um serviço

1. A API VENAFI AS UM SERVIÇO REST é acessível em https://api.venafi.cloud ou https://api.venafi.eu (se você tiver uma conta da UE) do sistema em que o VCERT será executado.
2. Você se registrou com sucesso para uma conta Venafi como uma conta de serviço, recebeu pelo menos a função "Proprietário do Recurso" e conhece sua chave da API.
3. Existe uma conta de CA e um modelo de emissão e foram configurados com:
   1. Valores de configurações recomendados para:
      1. Unidade Organizacional (OU)
      2. Organização (O)
      3. Cidade/localidade (L)
      4. Estado/Província (ST)
      5. País (c)
   2. Emitindo regras que:
      1. (Recomendado) Limita o nome comum e o nome do sujeito a domínios que são permitidos pela sua organização
      2. (Recomendado) restringe o comprimento da chave a 2048 ou superior
      3. (Recomendado) não permite reutilização de chave privada
4. Existe um aplicativo onde você está entre os proprietários e conhece o nome do aplicativo.
5. Um modelo de emissão é atribuído ao aplicativo e você conhece o alias da API.

Contribuindo para o VCERT

A Venafi recebe contribuições da comunidade de desenvolvedores.

1. Garote-o na sua conta (https://github.com/venafi/vcert-python/fork)
2. Clone o seu garfo ( git clone [email protected]:youracct/vcert-python.git )
3. Crie um ramo de recursos ( git checkout -b your-branch-name )
4. Implementar e testar suas mudanças
5. Comprometa suas mudanças ( git commit -am 'Added some cool functionality' )
6. Empurre para o ramo ( git push origin your-branch-name )
7. Crie uma nova solicitação de tração (https://github.com/youracct/vcert-python/pull/new/your-ranch-name)

NOTA: Enquanto se desenvolve com o VCERT-Python, é útil se você estiver usando um VirtualEnv para instalar a biblioteca VCERT-Python a partir da fonte no modo de desenvolvimento com pip install --editable . Consulte https://packaging.python.org/guides/installing-using-pip-and-virtual-ensonments/

Histórico da versão

Verifique o histórico da versão aqui

Licença

Copyright © Venafi, Inc. Todos os direitos reservados.

O VCERT é licenciado sob a licença Apache, versão 2.0. Consulte LICENSE para o texto completo da licença.

Por favor, direcione perguntas/comentários para [email protected].