Versões comparadas
Chave
- Esta linha foi adicionada.
- Esta linha foi removida.
- A formatação mudou.
Índice:
Índice | ||
---|---|---|
|
Objetivo:
Este documento tem como objetivo auxiliar o usuário na configuração do ambiente RM, para que a comunicação com os serviços HTTP seja protegida com SSL e a comunicação do RM.exe com o Host através de certificado digital.
Instalação do Certificado no Servidor:
Um certificado digital pode ser adquirido através de uma autoridade certificadora (AC), são facilmente encontradas na web, mas também é possível gerar certificados digitais auto assinados.
Existem várias maneiras de se gerar um certificado digital auto assinado. Abaixo alguns links para ajuda e, em anexo, um certificado auto assinado que pode ser utilizado para cifrar a comunicação, lembrando que o recomendado é que seja adquirido um através de uma AC.
Aviso | ||||
---|---|---|---|---|
| ||||
É recomendável que a AC escolhida para gerar o certificado já esteja no diretório de autoridades confiáveis raiz, do gerenciamento de certificados do computador, pois desta forma não será necessário importar a AC em todas as máquinas clientes. |
Salve o certificado no servidor e instale-o conforme imagens abaixo:
Informações | ||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||
|
Registrando o Certificado na Porta Utilizada Pelos Serviços HTTP do HOST:
Aviso | ||||
---|---|---|---|---|
| ||||
Configuração necessária apenas para aqueles que forem habilitar segurança para os serviços HTTP. |
Passo a Passo:
- Utilizando o thumbprint copiado e o GUID, registre o certificado nas portas HTTP utilizadas pelo HOST. Por padrão o RM utiliza as portas 8050 para TCP e 8051 para HTTP, mas isso pode ser configurado.
- Abra o prompt de comando do Windows como administrador.
- Segue abaixo os comandos para registrar o certificado nas portas, e os dois exemplos reais.
Exemplos:
Informações | ||
---|---|---|
| ||
A sintaxe para aplicar as alterações deve seguir o modelo abaixo de acordo com as configurações do seu ambiente.
Maiores detalhes podem ser obtidos diretamente na documentação da Microsoft disponível no link https://msdn.microsoft.com/en-us/library/windows/desktop/cc307236(v=vs.85).aspx |
- netsh http add sslcert ipport=0.0.0.0:8051 certhash=b4def01ef76a1ff154faef805e6eafce3d411459 appid={df85028c-5054-44f8-9d01-5a07ddc0f7c0}
- netsh http add urlacl url=https://+:8051/ user="NT AUTHORITY\NETWORKSERVICE"
Informações | ||
---|---|---|
| ||
Para remover as regras aplicadas utilize os comandos com a sintaxe delete conforme exemplos abaixo.
|
Configurando o RM:
Para proteger apenas os serviços HTTP, ou seja, os Web Services e serviços REST expostos pelo HOST, basta habilitar o parâmetro abaixo no arquivo de configuração do HOST (RM.Host.Service.exe.config)
- <add key="EnableWSSecurity" value="true" />
Para proteger a comunicação entre o RM.exe e o HOST será necessário habilitar o parâmetro abaixo nos arquivos de configuração do RM.exe (RM.exe.config) e do HOST (RM.Host.Service.exe.config)
- <add key="EnableSecurity" value="true" />
Os parâmetros abaixo, do arquivo de configuração do HOST (RM.Host.Service.exe.config), devem ser ajustados de acordo com o a instalação do certificado para que o mesmo seja encontrado pelo RM.
CERTIFICATESTORELOCATION:
Local do Store onde está armazenado o certificado.
- Valores possíveis: CurrentUser, LocalMachine
- Valor padrão: LocalMachine
Exemplo: <add key="CERTIFICATESTORELOCATION" value="LocalMachine" />
CERTIFICATESTORENAME:
Store onde está armazenado o certificado.
- Valores possíveis: AddressBook, AuthRoot, CertificateAuthority, Disallowed, My, Root, TrustedPeople, TrustedPublisher
- Valor padrão: My
Exemplo: <add key="CERTIFICATESTORENAME" value="My" />
CERTIFICATEFINDTYPE:
Campo do certificado que será utilizado para realizar a pesquisa.
- Valores possíveis: FindByThumbprint, FindBySubjectName, FindBySubjectDistinguishedName, FindByIssuerName, FindByIssuerDistinguishedName, FindBySerialNumber, FindByTimeValid, FindByTimeNotYetValid, FindByTimeExpired, FindByTemplateName, FindByTemplateName, FindByApplicationPolicy, FindByCertificatePolicy, FindByExtension, FindByKeyUsage, FindBySubjectKeyIdentifier
- Valor padrão: FindBySubjectName
Exemplo: <add key="CERTIFICATEFINDTYPE" value="FindBySubjectName " />
CERTIFICATEFINDVALUE:
Campo do certificado que será utilizado para realizar a pesquisa.
- Valores possíveis: Qualquer texto sem caractteres especiais
- Valor padrão: TOTVS
Exemplo: <add key="CERTIFICATEFINDVALUE" value="TOTVS " />
Validando as Configurações:
Para validar as alterações pode-se verificar se existe uma resposta para o wsdl de algum serviço disponível.
Como exemplo acessamos a URL https://localhost:8051/wsdataserver/MEX?wsdl e obtemos sucesso na resposta.
Image Added
Informações | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||
|
Informações | ||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||
|