Argomento precedente: FirmaArgomento successivo: Processo di crittografia/firma per la richiesta SOAP

Servizi Web › Operatore Richiama metodo SOAP › Parametri di input › WS-Security › Parametri WS-Security comuni › Crittografia

Crittografia
Aggiungi crittografia

Crittografa la richiesta SOAP e aggiunge una nuova chiave simmetrica crittografata all'intestazione <wsse:Security> della richiesta SOAP. CA Process Automation utilizza una chiave simmetrica per crittografare il contenuto della richiesta SOAP. Il certificato (chiave pubblica), fornito nel keystore, crittografa la chiave simmetrica stessa e la include nell'intestazione <wsse:Security>. Se questo campo è selezionato, tutti i campi in Parametri di crittografia sono abilitati.

Parametri di crittografia

I parametri seguenti definiscono la crittografia:

Alias chiave pubblica

Definisce l'alias del certificato (chiave pubblica) con cui crittografare la chiave simmetrica nel keystore.

Algoritmo di canonizzazione

Definisce il metodo di canonizzazione utilizzato per la serializzazione dei dati prima di applicare la crittografia. Lasciare vuoto questo campo per utilizzare una serializzazione standard.

Algoritmo di crittografia simmetrico

Specifica il tipo di algoritmo simmetrico con cui crittografare i dati.

Valori:
  • Tripledes-cbc: utilizzare il DES triplo. Questo metodo utilizza una chiave la cui lunghezza è compresa tra 8 e 24 bit.
  • aes128-cbc: utilizzare l'AES con una chiave a 128 bit.
  • aes192-cbc: utilizzare l'AES con una chiave a 192 bit.
  • aes256-cbc: utilizzare l'AES con una chiave a 256 bit.

Impostazione predefinita: AES128

Nota: Se si imposta questo parametro su aes192-cbc o su aes256-cbc, può verificarsi l'errore seguente:

Dimensione chiave o parametri predefiniti non validi.

Se si verifica questo errore, scaricare i file Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy dal sito Web di Oracle:

  • US_export_policy.jar
  • local_policy.jar

Sostituire i file .jar esistenti con lo stesso nome in C:path_to_JRE_used_by_PAM\lib\security con i nuovi file.

Crittografare la chiave simmetrica?

Crittografa la chiave simmetrica con cui sono stati crittografati i dati. La chiave viene così inclusa nell'intestazione <wsse:security><xenc:EncryptedKey>.

Algoritmo di crittografia a chiave simmetrica

Definisce l'algoritmo con cui crittografare la chiave simmetrica. Questo parametro è applicabile solo se è necessario crittografare la chiave.

Impostazione predefinita: RSA15

Tipo di ID chiave pubblica

Specifica l'ID chiave per l'impostazione degli elementi di identificazione del certificato (chiave pubblica) nell'elemento <xenc:EncryptedKey>. Il destinatario utilizza la chiave privata che corrisponde a questo certificato (chiave pubblica) per decrittografare la chiave simmetrica. Viene utilizzata quindi la chiave simmetrica per decrittografare la richiesta SOAP.

Valori:
  • 1 (Token di sicurezza binario): <wsse:SecurityTokenReference> viene aggiunto all'elemento <xenc:EncryptedKey>. L'elemento <xenc:EncryptedKey> utilizza un frammento URI in un elemento <wsse:Reference> per fare riferimento al certificato (chiave pubblica). Il frammento di URI fa riferimento alla chiave pubblica. La chiave pubblica viene inclusa come dati binari nell'elemento <wsse:BinarySecurityToken> dell'intestazione <wsse:Security>.
  • 2 (Nome autorità di rilascio e numero di serie): <wsse:SecurityTokenReference> viene aggiunto all'elemento <xenc:EncryptedKey>. L'elemento <xenc:EncryptedKey> utilizza un elemento <ds:X509Data><ds:X509:IssuerSerial> per fare riferimento al certificato (chiave pubblica). Questo elemento identifica esclusivamente un certificato in base al nome dell'emittente X.509 e al numero di serie.
  • 3 (ID di certificato X509): <wsse:SecurityTokenReference> viene aggiunto all'elemento <xenc:EncryptedKey>. L'elemento <xenc:EncryptedKey> utilizza un elemento <wsse:KeyIdentifier ValueType="oasis-200401-wss-x509-token-profile-1.0#X509v3"> per fare riferimento al certificato (chiave pubblica).
  • 4 (ID chiave soggetto): <wsse:SecurityTokenReference> viene aggiunto all'elemento <xenc:EncryptedKey>. L'elemento <xenc:EncryptedKey> utilizza un elemento <wsse:KeyIdentifier ValueType="#oasis-200401-wss-x509-token-profile-1.0#X509SubjectKeyIdentifier"> per fare riferimento al certificato (chiave pubblica).
  • 8 (ID SHA1 di identificazione personale): <wsse:SecurityTokenReference> viene aggiunto all'elemento <xenc:EncryptedKey>. L'elemento <xenc:EncryptedKey> utilizza un elemento <wsse:KeyIdentifier ValueType="#oasis-wss-soap-message-security-1.1#ThumbprintSHA1"> per fare riferimento al certificato (chiave pubblica).

Impostazione predefinita: 0. L'operatore utilizza l'ID chiave predefinito (nome dell'emittente e numero di serie) dall'implementazione.

Parti da crittografare

Specifica le parti della richiesta SOAP da crittografare. Fare clic su Aggiungi parametro per inserire un ID di sicurezza (ID utente dei servizi Web) o una combinazione Nome/Spazio dei nomi dell'elemento da crittografare.

Valori:
  • ID utente dei servizi Web: definisce l'attributo wsu:id dell'elemento da crittografare. È possibile aggiungere wsu:id come attributo di un elemento nella richiesta SOAP e specificare il proprio valore. Ad esempio: 
       <token wsu:id="123"> </token>

    L'istruzione seguente mostra la definizione dello spazio dei nomi WSU:

       xmlns:wsu=http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd
  • Nome: definisce il nome dell'elemento da crittografare.
  • Spazio dei nomi: definisce l'URI dello spazio dei nomi (non il nome locale dello spazio dei nomi) dell'elemento da crittografare. Ad esempio: 
       http://www.ca.com/pam
  • Codifica: selezionare Contenuto per crittografare il contenuto dell'elemento o Elemento per crittografare l'intero elemento.

Nota: lasciare vuoto questo campo per crittografare il contenuto del corpo della richiesta SOAP. Se si specifica l'ID utente dei servizi Web, vengono ignorati i valori per Nome e Spazio dei nomi.

Immettere prima la firma?

Specifica se applicare la firma prima di crittografare i dati. Questo parametro è utile se vengono crittografati e firmati gli stessi dati nella richiesta SOAP.

Decrittografa e valida la firma della risposta SOAP

Specifica se decrittografare il contenuto della risposta SOAP e convalidare la firma (se applicabile). Quando si seleziona questa opzione, viene abilitato il parametro Password della chiave privata di decrittografia.

Password della chiave privata di decrittografia

Definisce la password con cui accedere alla chiave privata di decrittografia nel keystore. Utilizzare questa password per accedere alla chiave privata con cui si esegue la decrittografia di una risposta SOAP crittografata.