Como instalar um certificado SSL no Axway API Gateway

Neste guia, você aprenderá como instalar um certificado SSL no Axway API Gateway. Se você ainda não solicitou um certificado, a primeira parte mostra como gerar um código CSR e enviá-lo à Autoridade Certificadora.

Gerar o código CSR para o Axway API Gateway

Antes que uma Autoridade Certificadora possa emitir seu certificado, você precisa de um CSR (Certificate Signing Request). Você tem duas opções:

• A maneira mais rápida é usar nosso Gerador de CSR para criar o CSR e a chave privada automaticamente.
• Alternativamente, gere o CSR você mesmo com o utilitário OpenSSL. Siga nosso tutorial passo a passo sobre como gerar um CSR no Ubuntu.

OpenSSL cria um arquivo .csr e um arquivo .key. Mantenha ambos em segurança. Abra o arquivo .csr com um editor de texto simples, como o Bloco de Notas, e copie todo o seu conteúdo, incluindo as linhas BEGIN CERTIFICATE REQUEST e END CERTIFICATE REQUEST, para o campo correspondente durante o pedido do seu SSL. Mantenha o arquivo .key privado: você precisará dele para instalar o certificado posteriormente.

Instalar um certificado SSL no Axway API Gateway

Depois de enviar o CSR, a Autoridade Certificadora valida seu pedido e envia por e-mail os arquivos do certificado, geralmente em um arquivo ZIP. Baixe e extraia-o em seu computador. Você deve ter seu certificado de servidor principal, um ou mais certificados CA/intermediários e a chave privada criada com o CSR.

No Axway API Gateway, você gerencia os certificados com o Policy Studio. O processo tem três partes: importar o certificado e a chave para o armazenamento de certificados, importar o CA/intermediário para que a cadeia seja confiável, e depois atribuir o certificado à interface HTTPS e implantar.

Etapa 1: Abra o armazenamento de certificados no Policy Studio

Inicie o Policy Studio e conecte-se à sua instância do API Gateway. Na árvore de configuração à esquerda, expanda Environment Configuration, depois selecione Certificates and Keys > Certificates. Esta tela lista os certificados X.509 e as chaves confiáveis pelo API Gateway.

Etapa 2: Importe seu certificado e chave privada

Na tela Certificates, clique em Create/Import. A caixa de diálogo Configure Certificate and Private Key será aberta. Use a aba X.509 Certificate para carregar seu certificado de servidor:

• Se seu certificado e chave privada estiverem em arquivos separados, clique em Import Certificate e navegue até o arquivo do certificado.
• Se seu certificado e chave privada estiverem no mesmo arquivo (por exemplo, um pacote PKCS#12 .p12/.pfx ou um arquivo PEM combinado), clique em Import Certificate + Key e navegue até esse arquivo.

Verifique se o seletor de formato corresponde ao seu arquivo (geralmente .pem, ou .der para arquivos binários). Se você importou apenas o certificado, mude para a aba Private Key, clique em Import Private Key e navegue até seu arquivo .key. Digite a senha da chave se o arquivo estiver protegido.

Tempo de design vs tempo de execução: o Policy Studio mantém dois armazenamentos. O certificado que você importa aqui vai para a configuração gerenciada pelo Policy Studio. Quando você implanta na Etapa 4, essa configuração é enviada para o armazenamento de tempo de execução usado pelo API Gateway ativo, para que o gateway possa apresentar o certificado aos clientes.

Etapa 3: Importe o certificado CA/intermediário

Os clientes confiam no seu certificado somente quando a cadeia completa está presente. Importe todos os certificados CA/intermediários fornecidos pela sua Autoridade Certificadora para o mesmo armazenamento. Na tela Certificates, clique novamente em Create/Import, depois, na aba X.509 Certificate, clique em Import Certificate e selecione cada arquivo intermediário. Se seus intermediários forem fornecidos dentro de um keystore Java, use o botão Keystore em vez disso, depois selecione as entradas e clique em Import to Trusted certificate store.

Etapa 4: Atribua o certificado à interface HTTPS e implante

Importar um certificado apenas o armazena, mas o gateway não o servirá até que você o atribua a uma interface HTTPS. Na árvore do Policy Studio, expanda sua instância do API Gateway e abra o nó Listeners, depois a interface HTTPS que deseja proteger (por exemplo, a interface do API Manager na porta 8075, ou a interface do API Gateway Manager na porta 8090). Clique com o botão direito na interface HTTPS e escolha Edit. Na aba Network, clique no botão X.509 Certificate e selecione o certificado que você importou.

Clique em OK para confirmar, depois clique em Deploy na barra de ferramentas para enviar a configuração atualizada ao API Gateway em execução. Após a implantação ser concluída, o gateway apresenta seu certificado nessa interface.

Assim que a implantação for concluída, faça um teste rápido e verifique se há erros ou vulnerabilidades no seu novo certificado SSL. Nosso SSL Checker analisa sua instalação e informa a cadeia, a validade e o suporte a protocolos em segundos.

Perguntas Frequentes