7.4. Referência do Conector SSL
Os conectores podem incluir os seguintes atributos de configuração SSL. Os comandos CLI fornecidos são designados a um managed domain usando o
default de perfil. Altere o nome do perfil para um que você deseje configurar, para o managed domain, ou omita a porção /profile=default do comando, para um servidor autônomo.
| Função | Descrição | Comando CLI |
|---|---|---|
| Nome |
O nome exibido do conector SSL.
|
/profile=default/subsystem=web/connector=HTTPS/ssl=configuration/:write-attribute(name=name,value=https)
|
| verify-client |
Configure para
true para solicitar uma corrente de certificado válido a partir do cliente antes de aceitar uma conexão. Configure para want caso deseje que a pilha SSL solicite um Certificado de cliente, mas não falhe caso não haja certificado algum. Determine para false (o default) para não requerer uma corrente de certificado a não ser que o cliente solicite um recurso protegido por uma restrição de segurança que usa a autenticação CLIENT-CERT.
|
/profile=default/subsystem=web/connector=HTTPS/ssl=configuration/:write-attribute(name=verify-client,value=want)
|
| verify-depth |
O número máximo de emissores de certificado intermediários verificados antes de decidir que os clientes não possuem um certificado válido. O valor default é
10.
|
/profile=default/subsystem=web/connector=HTTPS/ssl=configuration/:write-attribute(name=verify-depth,value=10)
|
| certificate-key-file |
O caminho de arquivo completo e o nome do arquivo keystore onde o certificado do servidor assinado é aplicado o store. Com a criptografia JSSE, este arquivo de certificado será apenas um, enquanto o OpenSSL usa diversos arquivos. O valor default é o arquivo
.keystore no diretório principal do usuário executando o JBoss Enterprise Application Plataform. Caso o seu keystoreType não usar um arquivo, determine o parâmetro para uma sequência vazia.
|
/profile=default/subsystem=web/connector=HTTPS/ssl=configuration/:write-attribute(name=certificate-key-file,value=../domain/configuration/server.keystore)
|
| certificate-file |
Caso você usar a criptografia OpenSSL, determine o valor deste parâmetro para o caminho do arquivo contendo o certificado do servidor.
|
/profile=default/subsystem=web/connector=HTTPS/ssl=configuration/:write-attribute(name=certificate-file,value=server.crt)
|
| senha |
A senha para ambos truststore e keystore. O valor default é
changeit, de forma que você precisa alterar isto para coincidir com a senha de seu keystore para sua configuração funcionar.
|
/profile=default/subsystem=web/connector=HTTPS/ssl=configuration/:write-attribute(name=password,value=changeit)
|
| protocolo |
A versão do protocolo SSL para uso. Os valores suportados incluem
SLv2, SSLv3, TLSv1, SSLv2+SSLv3 e ALL. O default é ALL.
|
/profile=default/subsystem=web/connector=HTTPS/ssl=configuration/:write-attribute(name=protocol,value=ALL)
|
| cipher-suite |
Uma lista de vírgula separada das cifras de criptografia que são permitidas. O default JVM para o JSSE contém cifras fracas que não devem ser usadas. A amostra lista apenas duas cifras possíveis, mas as amostras atuais provavelmente usarão mais.
|
/profile=default/subsystem=web/connector=HTTPS/ssl=configuration/:write-attribute(name=cipher-suite, value="TLS_RSA_WITH_AES_128_CBC_SHA,TLS_RSA_WITH_AES_256_CBC_SHA")
|
| key-alias |
O alias usado para o certificado do servidor no keystore. O valor default é
jboss.
|
/profile=default/subsystem=web/connector=HTTPS/ssl=configuration/:write-attribute(name=key-alias,value=jboss)
|
| truststore-type |
O tipo de truststore. Os diversos tipos de keystores estão disponíveis, incluindo o
PKCS12 e o default JKS do Java.
|
/profile=default/subsystem=web/connector=HTTPS/ssl=configuration/:write-attribute(name=truststore-type,value=jks)
|
| keystore-type |
O tipo do keystore. Diversos tipos de keystore estão disponíveis, incluindo o
PKCS12 e o default JKS do Java.
|
/profile=default/subsystem=web/connector=HTTPS/ssl=configuration/:write-attribute(name=keystore-type,value=jks)
|
| ca-certificate-file |
O arquivo contendo os certificados CA. Isto é o
truststoreFile, no caso do JSSE, e usa a mesma senha do keystore. O arquivo ca-certificate-file é usado para validar os certificados do cliente.
|
/profile=default/subsystem=web/connector=HTTPS/ssl=configuration/:write-attribute(name=certificate-file,value=ca.crt)
|
| ca-certificate-password |
A senha do Certificado para o
ca-certificate-file. Na amostra abaixo, substitua a senha pela própria senha mascarada.
|
/profile=default/subsystem=web/connector=HTTPS/ssl=configuration/:write-attribute(name=ca-certificate-password,value=MASKED_PASSWORD)
|
| ca-revocation-url |
O arquivo ou URL que contém a lista de revocação. Isto refere-se ao
crlFile para o JSSE ou o SSLCARevocationFile para o SSL.
|
/profile=default/subsystem=web/connector=HTTPS/ssl=configuration/:write-attribute(name=ca-revocation-url,value=ca.crl)
|
| session-cache-size |
O tamanho do cache SSLSession. O default é
0, que desativa do cache da sessão.
|
/profile=default/subsystem=web/connector=HTTPS/ssl=configuration/:write-attribute(name=session-cache-size,value=100)
|
| session-timeout |
O número de sessões antes de um SSLSession com cache expirar. O default é
86400 segundos, que é 24 horas.
|
/profile=default/subsystem=web/connector=HTTPS/ssl=configuration/:write-attribute(name=session-timeout,value=43200)
|