Chaves e certificados

Alguns aplicativos no Make exigem que você use chaves privadas ou públicas ou certificados para autenticação segura e proteção de dados. Você precisa adicioná-los no Scenario Builder, nas configurações do módulo do aplicativo que exige uma chave ou um certificado.

Chaves e chaveiros

As chaves são usadas pelo aplicativo Encryptor em seus módulos AES Encrypt (advanced), AES Decrypt (advanced), Create digital signature, Decrypt a PGP message e Encrypt a PGP message.

O aplicativo SSH também permite usar chaves privadas para criar a conexão.

Embora seja um tipo diferente de chave, o aplicativo HTTP também salva as credenciais fornecidas para fazer uma solicitação HTTP como um chaveiro para os tipos de autenticação API key e Basic Auth.

Adicionar uma chave

Você deve adicionar as chaves nas configurações do módulo quando um módulo do aplicativo exigir uma chave pública ou privada.

Vamos usar o módulo Encryptor > AES Encrypt (advanced) como exemplo. Para adicionar uma chave nele, você vai:

1. Crie um novo cenário ou abra um existente.
2. Adicione o módulo Encryptor > AES Encrypt (advanced).
3. No campo Key, clique em Create a keychain.
4. Na janela Add new keychain, insira sua chave e outros detalhes e clique em Create.

Depois de criá-la e salvar as configurações do módulo, a chave é salva na seção Keys. Lá, você pode gerenciar todas as chaves criadas.

Editar ou excluir uma chave

Esta seção se aplica somente a chaves e chaveiros.

Para editar uma chave:

1. Na barra lateral esquerda, clique em Credentials e alterne para Keys.
2. Clique nos three dots > Edit ao lado da chave ou do chaveiro necessário.
3. Você verá um formulário onde pode editar a chave e seus detalhes. Depois de fazer as edições, clique em Save.

O Make aplica as alterações salvas imediatamente. Após a confirmação, a chave é atualizada em todos os módulos onde é usada.

Para excluir uma chave:

1. Na barra lateral esquerda, clique em Credentials e alterne para Keys.
2. Clique nos three dots > Delete ao lado da chave ou do chaveiro necessário.
3. Em uma janela pop-up, clique em Delete para confirmar.

Se a chave for usada em cenário(s), um aviso aparecerá mostrando o(s) nome(s) do(s) cenário(s). Clique em OK para confirmar a exclusão.

Após a confirmação, a chave é excluída de todos os módulos onde é usada.

Certificados

Você pode usar certificados no aplicativo SSH e para configurar o SSO no Make.

Adicionar um certificado

Vamos usar o módulo SSH > Execute a command como exemplo. Para adicionar um certificado nele, você vai:

1. Crie um novo cenário ou abra um existente.
2. Adicione o módulo SSH > Execute a command.
3. Para um certificado:
   1. No campo Connection, clique em Create a connection.
   2. No campo Auth type da próxima janela, selecione Username and key.
   3. No campo Private key, clique em Extract.
   4. No campo Extract, escolha Certificate.
4. Faça upload do certificado, adicione a Password e clique em Save.
5. Em seguida, configure todos os campos do módulo.

Maneiras de inserir chaves e certificados

Há duas maneiras de inserir uma chave ou certificado:

• Inserção direta
• Extrair do arquivo (P12, PFX ou PEM)

Inserção direta

Com uma inserção direta, você apenas copia a chave e a cola no campo necessário. Por exemplo, para RSA PRIVATE KEY no módulo SSH > Execute a command:

OPENSSH PRIVATE KEY não é compatível. Ela precisa ser convertida com o seguinte comando no Terminal: ssh-keygen -p -m PEM -f <pathToTheKey>. No Windows, você pode usar o gerador de chaves PuTTy.

Extrair do arquivo (P12, PFX ou PEM)

Para extrair uma Private Key ou um Certificate, você precisa usar a função de extração de chave. Isso também permitirá extrair a chave de arquivos criptografados.

Os formatos de arquivo compatíveis são P12, PFX e PEM.

Vamos usar o módulo SSH > Execute a command como exemplo. Para extrair uma Private Key ou um Certificate, você vai:

1. Crie um novo cenário ou abra um existente.

2. Adicione o módulo SSH > Execute a command.

3. No campo Connection, clique em Create a connection.

4. No campo Auth type da próxima janela, selecione Username and key.

5. No campo Private key, clique em Extract.

6. No campo Extract, escolha Private key.

7. Clique no botão Choose File.

8. Navegue e clique em Open no arquivo necessário. Por exemplo, quando você cria uma instância EC2 baseada em Linux na AWS, você recebe as credenciais de login no arquivo PEM:

   [username@hostname aws]$ ls
   IMTExample.pem
   [username@hostname aws]$
   

   O arquivo contém a chave privada usada para se conectar à instância.

   A chave privada é lida do arquivo PEM:

   -----BEGIN RSA PRIVATE KEY-----
   MIIEpAIBAAKCAQEAz7F3k1q2x9K8JfN8u1wPp8Yk4Q2Lw3mA9bR1q2zZ+/QeR9Lh
   J3Kf4wQb7vR9kP2n4x1pQ2XhQ9L0vQj3F8tUzZxPnG1kZ0lMnU8BtR5KJ
   .........................................................
   4sZt3JmU7YwP8Qj3mNqP9jLw2yZk8NwQvH2Rr0YpM5Xk3tPw8mXl0QxNr0aY9uTn
   -----END RSA PRIVATE KEY-----
   

   Esta é uma chave privada que você extrairá de um arquivo PEM.

9. Depois de extrair o arquivo, insira a senha no campo respectivo, se necessário.

10. Clique em Save.

A chave privada será exportada do seu arquivo e usada para se conectar ao serviço necessário.