Este documento fornece informações sobre como configurar o perfil de publicação Apache para que seja possível instalar e publicar certificados no servidor.
Requisitos
- Um servidor Apache com parâmetros SSL ativados.
- Um certificado SSL gerado e assinado por uma CA. Mais informações em Como criar uma requisição e Como assinar uma requisição.
- Uma credencial local no servidor Apache com permissões de leitura e escrita nos seguintes diretórios:
/etc/ssl/certs//etc/ssl/private/
- Uma credencial cadastrada no Segura™ com o endereço IP ou domínio do servidor Apache. Mais informações sobre como configurar uma credencial no Segura™ em Como configurar uma credencial no Segura™.
Configurar o Apache
Para configurar o Apache, veja os passos a seguir:
- No Segura™, na barra de navegação, passe o mouse sobre o Menu de produtos e selecione Certificate Manager.
- No menu lateral, selecione Publicações > Perfis de publicação.
- Clique no botão de ações e selecione Apache.
- Na aba Configurações, preencha os seguintes campos:
- No campo Nome do perfil *, insira o nome do perfil.
- No campo Username da credencial, insira o nome da credencial.
- (Opcional): Marque a opção Utilizar uma credencial cadastrada para acessar todos os dispositivos, e, no campo Credencial de acesso cadastrada do sistema, selecione uma credencial de acesso cadastrada no Segura™.
- Clique em Continuar.
- Na aba Apache, preencha os seguintes campos:
- No campo Site, insira o nome do arquivo de configuração do servidor Apache. Por exemplo:
default-ssl.conf. Esse campo não é usado na publicação: o Segura® usa apenas o campo Caminho do arquivo de configuração. - No campo Caminho do arquivo de configuração, insira o caminho completo do arquivo de configuração. Por exemplo:
/etc/apache2/sites-available/default-ssl.conf. - No campo Porta, insira a porta em que o Apache serve o certificado. O padrão é
443. O Segura® usa essa porta apenas para a verificação pós-publicação.
- No campo Site, insira o nome do arquivo de configuração do servidor Apache. Por exemplo:
- Clique em Continuar.
- Na aba Dispositivos, selecione o servidor Apache.
- O dispositivo deve ter sido cadastrado no Segura™.
- A coluna Network Connector mostra Sim ou Não, dependendo se o dispositivo tem seu próprio agente Network Connector configurado.
- Na aba Revisão, verifique todas as informações inseridas nas abas anteriores e clique em Salvar.
Verificação pós-publicação
Depois de instalar o certificado, o Segura® se conecta ao servidor na porta informada no campo Porta e compara o fingerprint do certificado apresentado pelo servidor com o fingerprint do certificado publicado:
- Se os fingerprints forem iguais, a publicação é concluída com sucesso.
- Se os fingerprints forem diferentes, a publicação falha com o erro
Falha na comparação dos fingerprints. - Se o Segura® não conseguir se conectar ao servidor, a publicação ainda termina com sucesso. O log de execução registra que não foi possível se comunicar com o servidor naquela porta.
A verificação se conecta apenas via TLS 1.2. Através de um Network Connector, ela se conecta a 127.0.0.1:<porta> no servidor, sem SNI. Em uma conexão direta, ela se conecta ao hostname do dispositivo.
Use apenas um site SSL por arquivo de configuração e porta. O Segura® altera apenas a primeira diretiva SSLCertificateFile não comentada do arquivo de configuração. Com vários virtual hosts SSL na mesma porta, a verificação através de um Network Connector não alcança o virtual host que serve o novo certificado, e a publicação falha com o erro Falha na comparação dos fingerprints, mesmo que o novo certificado esteja em uso.
Comportamento do Network Connector
A publicação no Apache utiliza o Network Connector configurado no dispositivo tanto para a instalação quanto para a verificação pós-publicação. O log de execução mostra a rota utilizada em cada etapa: Network Connector: <agent> para a instalação, e TLS verification via Network Connector ou TLS verification: direct connection to <host>:<port> para a verificação.