アプリケーションプログラミングインターフェイスガイド> 組み込み手順> 手順リファレンス> EncryptElement
 
EncryptElement
証明書または公開鍵で暗号化された対称鍵を使用して、指定されたSOAPエンベロープ内のエレメントを暗号化します。
elementName引数は、メッセージ内のどのエレメントを暗号化するかを決定します。通常、この手順は、SOAPメッセージのヘッダーまたは本文のいずれかを暗号化するために使用されます。
このメソッドは、WS-SecurityアーティファクトをSOAPenvelopeのヘッダーに追加します。
アーティファクトは、アクターによって識別されるSOAPヘッダーに追加され、引数を理解する必要があります。 SOAPメッセージに、指定されたアクターとmustUnderstandvaluesを持つSOAPヘッダーが含まれていない場合、ヘッダーが作成されます。
EncryptionAlgorithmは、暗号化の方法を決定します。ほとんどの場合、デフォルト値(AES_128)で十分です。 AES_192やAES_256などのより強力な暗号化アルゴリズムでは、無制限のJava Cryptography Extension(JCE)ポリシーファイルをサーバーのJVMにインストールする必要があります。
ロケーション
/lib/services/
Inputs(入力)
envelope:SOAPエンベロープ。 NULLではない可能性があります。
actor:処理するWSSecurityヘッダーを決定します。 NULLの可能性があります。
mustUnderstand:受信者がこのヘッダーを理解する必要があるかどうかを示します。 NULLの場合、mustUnderstandのデフォルトはTRUEです。
elementName:暗号化するエンベロープ内のエレメントの名前。 NULLの場合、elementNameのデフォルトは{http://schemas.xmlsoap.org/soap/envelope/}Bodyです。
EncryptionAlgorithm:データの暗号化に使用される対称暗号化アルゴリズム。 NULL、TRIPLE_DES、AES_128、AES_192、AES_256の場合があります。 NULLの場合、encryptionAlgorithmのデフォルトはAES_128です。
certificateAlias:エレメントの暗号化に使用される対称鍵の暗号化に使用する鍵ストア内の証明書または公開鍵の別名。 NULLではない可能性があります。
keyStore:シリアル化されたJavaキーストア。 NULLの可能性があります。
keyStoreType:キーストアのタイプ。 JKSまたはPKCS12である必要があります。 NULLではない可能性があります。
keyStorePassword:キーストアとその中のすべての秘密キーのパスワード。パスワードがない場合は、NULLまたは空になる可能性があります。
出力
envelope:暗号化されたエレメントと生成されたWSSecurityアーティファクトをSOAPヘッダーに含むSOAPエンベロープ。
例外
IllegalArgumentException:いずれかの引数が無効な場合。
SecurityException:エレメントを暗号化できなかった場合。