Download do vcert - download do código-fonte do vcert

vcert

Outro código-fonte

v5.7.2 Minor Enhancements and Bug

Baixar

Este projeto de código aberto é apoiado pela comunidade. Para relatar um problema ou compartilhar uma ideia, use Issues ; e se você tiver uma sugestão para corrigir o problema, inclua esses detalhes também. Além disso, use solicitações pull para contribuir com correções de bugs reais ou melhorias propostas. Acolhemos e agradecemos todas as contribuições. Tem dúvidas ou deseja discutir algo com nossa equipe? Junte-se a nós no Slack !

VCert

VCert é uma biblioteca Go, SDK e utilitário de linha de comando projetado para simplificar a geração de chaves e o registro de identidades de máquinas (também conhecidas como certificados e chaves SSL/TLS) que atendem à política de segurança corporativa usando a Venafi Trust Protection Platform ou Venafi Control Plane ou Venafi Firefly.

Consulte VCert CLI para Venafi Trust Protection Platform ou VCert CLI para Venafi Control Plane ou VCert CLI para Venafi Firefly para começar a usar o utilitário de linha de comando.

Compatibilidade

As versões VCert são testadas usando a versão mais recente da Trust Protection Platform. A funcionalidade geral da versão mais recente do VCert deve ser compatível com Trust Protection Platform 17.3 ou superior. Campos personalizados e rastreamento de instância exigem TPP 18.2 ou superior, e autenticação de token requer TPP 20.1 ou superior.

Configuração do desenvolvedor

Configure seu ambiente Go de acordo com https://golang.org/doc/install.
Verifique se a variável de ambiente GOPATH está definida corretamente

Baixe o código fonte:

go get github.com/Venafi/vcert/v5

ou pré Go 1.13

git clone https://github.com/Venafi/vcert.git $GOPATH /src/github.com/Venafi/vcert/v5

Vá para 1.11 com módulos go habilitados ou vá para 1.13 e superior, certifique-se de clonar fora de $GOPATH/src

git clone https://github.com/Venafi/vcert.git

Crie os utilitários de linha de comando para Linux, macOS e Windows:
```
make build
```

Usando VCert para integrar Venafi ao seu aplicativo

Para exemplos de código de uso programático, revise os arquivos na pasta de exemplos.

Parte comum

No seu arquivo main.go , faça as seguintes declarações de importação:

 import (
    "github.com/Venafi/vcert/v5"
    "github.com/Venafi/vcert/v5/pkg/certificate"
    "github.com/Venafi/vcert/v5/pkg/endpoint"
)

Crie um objeto de configuração do tipo &vcert.Config que especifique os detalhes da conexão Venafi. As soluções normalmente são projetadas para obter esses detalhes de um cofre de segredos, arquivo .ini, variáveis de ambiente ou parâmetros de linha de comando.

Certificado de inscrição

Instancie um cliente chamando o método NewClient da classe vcert com o objeto de configuração.
Componha um objeto de solicitação de certificado do tipo &certificate.Request .
Gere um par de chaves e um CSR para a solicitação de certificado chamando o método GenerateRequest do cliente.
Envie a solicitação passando o objeto de solicitação de certificado para o método RequestCertificate do cliente.
Use o ID da solicitação para retirar o certificado usando o método RetrieveCertificate do cliente.

Novo ouvinte TLS para domínio

Chame o método vcert.Config NewListener com uma lista de domínios como argumentos. Por exemplo ("test.example.com:8443", "example.com")
Use net.Listener obtido como argumento para http.Serve integrado ou outros servidores https.

As amostras estão em um estado onde você pode construí-las/executá-las usando os seguintes comandos (depois de definir as variáveis de ambiente discutidas posteriormente):

go build -o cli ./example
go test -v ./example -run TestRequestCertificate

Pré-requisitos para uso com Trust Protection Platform

Uma conta de usuário que recebeu acesso WebSDK
Uma pasta (zona) onde o usuário recebeu as seguintes permissões: View , Read , Write , Create , Revoke (para a ação de revogação) e Private Key Read (para a ação de retirada quando o CSR é gerado pelo serviço)
Política aplicada à pasta que especifica:
1. Modelo de CA que a Trust Protection Platform usará para registrar solicitações de certificado enviadas pela VCert
2. Valores de DN do assunto para Unidade Organizacional (OU), Organização (O), Cidade (L), Estado (ST) e País (C)
3. Tipo de gerenciamento não bloqueado ou bloqueado para 'Inscrição'
4. Geração de solicitação de assinatura de certificado (CSR) desbloqueada ou não bloqueada para 'CSR gerado pelo serviço'
5. Gerar chave/CSR em aplicativo não bloqueado ou bloqueado como 'Não'
6. (Recomendado) Desative a renovação automática definida como 'Sim'
7. (Recomendado) Força da chave definida como 2048 ou superior
8. (Recomendado) Política de lista de permissões de domínio atribuída adequadamente

O requisito para que o modelo de CA seja atribuído por política segue uma prática recomendada de longa data da Venafi, que também atendeu ao nosso objetivo de design de manter o processo de solicitação de certificado simples para usuários do VCert. Se você precisar especificar o modelo CA com a solicitação, poderá usar as APIs REST TPP, mas esteja ciente de que isso vai contra as recomendações da Venafi.

Testes com Plataforma de Proteção de Confiança e Plano de Controle Venafi

Testes unitários:

make test

Os testes de integração para Trust Protection Platform e Venafi Control Plane exigem acesso a esses produtos. Variáveis de ambiente são usadas para especificar configurações necessárias, incluindo credenciais. A chave da API Venafi Control Plane e os fragmentos do valor da zona (ou seja, Application Name Issuing Template API Alias ) estão prontamente disponíveis na interface da web.

 export TPP_URL=https://tpp.venafi.example/vedsdk
export TPP_USER=tpp-user
export TPP_PASSWORD=tpp-password
export TPP_ZONE= ' somesuggested_policy '
export TPP_ZONE_RESTRICTED= ' somelocked_policy '
export TPP_ZONE_ECDSA= ' someecdsa_policy '

make tpp_test

 export CLOUD_URL=https://api.venafi.cloud/v1
export CLOUD_APIKEY=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
export CLOUD_ZONE= ' My ApplicationPermissive CIT '
export CLOUD_ZONE_RESTRICTED= ' Your ApplicationRestrictive CIT '

make cloud_test

Os testes de utilitários de linha de comando usam arquivos de recursos do Cucumber e Aruba.

Para executar testes para todos os recursos em paralelo:
```
make cucumber
```
Para executar testes apenas para um recurso específico:
```
make cucumber FEATURE=./features/basic/version.feature
```
Os recursos disponíveis são:
- basic
- config
- enroll
- format
- gencsr
- renew
- revoke

Quando executados, esses testes serão executados em seu próprio contêiner Docker usando a versão Ruby do Cucumber.
A execução de teste concluída reportará o número de cenários de teste e etapas que foram aprovadas, reprovadas ou ignoradas.

Funcionalidade do manual

Para obter explicações detalhadas sobre o manual e como ele é construído, verifique aqui: Readme Playbook

Contribuindo para VCert

Venafi agradece contribuições da comunidade de desenvolvedores.

Fork para sua conta (https://github.com/Venafi/vcert/fork)

Clone seu garfo:

git clone [email protected]:youracct/vcert.git

Crie uma ramificação de recursos:
```
git checkout -b your-branch-name
```
Implemente e teste suas mudanças

Confirme suas alterações:

git commit -am ' Added some cool functionality '

Empurre para o galho
```
git push origin your-branch-name
```
Crie uma nova solicitação pull em https://github.com/youracct/vcert/pull/new/your-branch-name