Tópico anterior: AssinaturaPróximo tópico: Processo de criptografia/assinatura para a solicitação do SOAP

Web Services › Operador Chamar método SOAP assíncrono › Parâmetros de entrada › Segurança do WS › Parâmetros comuns da Segurança do WS › Criptografia

Criptografia
Adicionar criptografia

Criptografa a solicitação de SOAP e adiciona uma nova chave simétrica criptografada ao cabeçalho de <wsse:Security> da solicitação de SOAP. O CA Process Automation usa uma chave simétrica para criptografar o conteúdo da solicitação do SOAP. O certificado (chave pública), fornecida no armazenamento de chaves, criptografa a própria chave simétrica e a inclui no cabeçalho <wsse:Security>. Se esse campo for selecionado, todos os campos de Parâmetros de criptografia serão ativados.

Parâmetros de criptografia

Os parâmetros a seguir definem a criptografia:

Alias de chave pública

Define o alias do certificado (chave pública) que deve ser usado para criptografar a chave simétrica no armazenamento de chaves.

Algoritmo de conversão em formato canônico

Define o método de conversão em formato canônico usado para serializar os dados antes de aplicar a criptografia. Deixe esse campo em branco para usar uma serialização padrão.

Algoritmo de criptografia simétrica

Especifica o tipo de algoritmo simétrico para criptografar os dados.

Valores:
  • Tripledes-cbc: usar DES triplo. Esse método usa uma chave com 8 bytes - 24 bits.
  • aes128-cbc: usar AES com uma chave de 128 bits.
  • aes192-cbc: usar AES com uma chave de 192 bits.
  • aes256-cbc: usar AES com uma chave de 256 bits.

Padrão: AES128

Observação: se definir este parâmetro como aes192-cbc ou aes256-cbc, o seguinte erro pode ocorrer:

Tamanho de chave inválido ou parâmetros padrão.

Se esse erro ocorrer, faça download dos seguintes arquivos de diretiva de jurisdição de força ilimitada do JCE (Java Cryptography Extension - Extensão de Criptografia Java) no site da Oracle:

  • US_export_policy.jar
  • local_policy.jar

Substitua os jars existentes com o mesmo nome em C:path_to_JRE_used_by_PAM\lib\security pelos novos.

Criptografar a chave simétrica?

Criptografa a chave simétrica com a qual os dados foram criptografados. O produto, em seguida, inclui a chave no cabeçalho de <wsse:security><xenc:EncryptedKey>.

Algoritmo de criptografia de chave simétrica

Define o algoritmo de compilação que deve ser usado para criptografar a chave simétrica. Esse parâmetro é aplicável somente se a chave precisar ser criptografada.

Padrão: RSA15.

Tipo de identificador de chave pública'

Especifica o identificador de chave que configura os elementos de identificação (chave pública) do certificado no elemento <xenc:EncryptedKey>. O receptor usa a chave privada que corresponde a esse certificado (chave pública) para descriptografar a chave simétrica. O produto, em seguida, usa a chave simétrica para criptografar a solicitação de SOAP.

Valores:
  • 1 (Token de segurança binário): o produto adiciona <wsse:SecurityTokenReference> ao elemento <xenc:EncryptedKey>. O elemento <xenc:EncryptedKey> usa um fragmento de URI em um elemento <wsse:Reference> para fazer referência ao certificado (chave pública). O fragmento de URI faz referência à chave pública. O produto inclui a chave pública como dados binários no elemento <wsse:BinarySecurityToken> de cabeçalho de <wsse:Security>.
  • 2 (Nome do emissor e número de série): o produto adiciona <wsse:SecurityTokenReference> ao elemento <xenc:EncryptedKey>. O elemento <xenc:EncryptedKey> usa um elemento <ds:X509Data><ds:X509:IssuerSerial> para fazer referência ao certificado (chave pública). Esse elemento identifica de maneira exclusiva um certificado por seu nome de emissor X.509 e seu número de série.
  • 3 (Identificador de certificado X509): o produto adiciona <wsse:SecurityTokenReference> ao elemento <xenc:EncryptedKey>. O elemento <xenc:EncryptedKey> usa um elemento <wsse:KeyIdentifier ValueType="oasis-200401-wss-x509-token-profile-1.0#X509v3"> para fazer referência ao certificado (chave pública).
  • 4 (Identificador de assunto principal): o produto adiciona <wsse:SecurityTokenReference> ao elemento <xenc:EncryptedKey>. O elemento <xenc:EncryptedKey> usa um elemento <wsse:KeyIdentifier ValueType="#oasis-200401-wss-x509-token-profile-1.0#X509SubjectKeyIdentifier"> para fazer referência ao certificado (chave pública).
  • 8 (Identificador de SHA1 de impressão digital): o produto adiciona <wsse:SecurityTokenReference> ao elemento <xenc:EncryptedKey>. O elemento <xenc:EncryptedKey> usa um elemento <wsse:KeyIdentifier ValueType="#oasis-wss-soap-message-security-1.1#ThumbprintSHA1"> para fazer referência ao certificado (chave pública).

Padrão: 0. O operador usa o identificador de chave padrão (Nome do emissor e número de série) da implementação.

Parts para criptografar

Especifica as partes da solicitação do SOAP a serem criptografadas. Clique em Adicionar parâmetro para inserir uma ID de segurança (ID do WSU) ou uma combinação de Nome/espaço para nome do elemento a ser criptografado.

Valores:
  • ID do WSU: define o atributo wsu:id do elemento a ser criptografado. Você pode adicionar wsu:id como um atributo de um elemento na solicitação SOAP, além de poder especificar seu próprio valor. Por exemplo: 
       <token wsu:id="123"> </token>

    A instrução a seguir mostra a definição do espaço para nome do WSU:

       xmlns:wsu=http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd
  • Nome: define o nome do elemento a ser criptografado.
  • Espaço para nome: define o URI do espaço para nome (não o nome local do espaço para nome) do elemento a ser criptografado. Por exemplo: 
       http://www.ca.com/pam
  • Codificação: selecione Conteúdo para criptografar o conteúdo do elemento ou Elemento para criptografar todo o elemento.

Observação: deixe esse campo em branco para criptografar o conteúdo do corpo da solicitação do SOAP. Se você especificar a ID do WSU, o produto ignora os valores Nome e Espaço para nome.

Assinatura primeiro?

Especifica se é necessário aplicar a assinatura antes de criptografar os dados. Esse parâmetro é útil se o produto criptografar e assinar os mesmos dados na solicitação do SOAP.

Descriptografar e validar assinatura da resposta SOAP

Especifica se é necessário descriptografar o conteúdo da resposta do SOAP (se aplicável) e valida a assinatura. Quando essa opção é selecionada, o produto ativa o parâmetro Senha da chave privada de descriptografia.

Senha da chave privada de descriptografia

Define a senha para acessar a chave privada de descriptografia no armazenamento de chaves. Use essa senha para acessar a chave privada a ser usada para descriptografar uma resposta do SOAP criptografada.