Hitachi

Cosminexus V11 アプリケーションサーバ 機能解説 セキュリティ管理機能編


19.2 KDCGFで始まるメッセージ

Webサービスセキュリティ機能で出力されるKDCGF0001からKDCGF9999までのメッセージについて説明します。

KDCGFで始まるメッセージは,SOAPFault形式で出力されます。SOAPFault形式のメッセージには,次に示す四つの項目があります。

FaultCode

FaultCodeが出力されます。FaultCodeは,名前空間URIとローカル部で構成されます。KDCGFで始まるメッセージのFaultCodeの名前空間URIには,「{http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd}」が出力されます。ローカル部には,エラーの要因を示す文字列が出力されます。

FaultCodeの値は,次の方法で取得できます。

  • サーバ側の場合

    SOAP 1.1の場合は,SOAP Faultメッセージのfaultcode要素からFaultCodeを取得できます。

    SOAP 1.2の場合は,SOAP Faultメッセージのsoapenv12:Subcode要素(soapenv12:Code要素の子要素)に含まれるsoapenv12:Value要素からFaultCodeを取得できます。なお,soapenv12:Code要素のsoapenv12:Vaule要素の値は,soapenv12:Senderです。

  • クライアント側の場合

    SOAP通信基盤が提供するC4Faultクラス,またはJAX-WS機能が提供するjavax.xml.ws.soap.SOAPFaultExceptionクラスを使用してFaultCodeを取得できます。

SOAP通信基盤が提供するAPIの仕様については,マニュアル「アプリケーションサーバ SOAPアプリケーション開発の手引」の「13. SOAP通信基盤が提供するAPI」を参照してください。

JAX-WS機能でフォルトをバインディングする方法については,マニュアル「アプリケーションサーバ Webサービス開発ガイド」の「10.2 JAX-WSエンジンの動作」を参照してください。

FaultString

メッセージIDおよびメッセージの本文が出力されます。メッセージIDの見方については,「19.1 メッセージの記述形式」を参照してください。

FaultStringは次の方法で取得できます。

  • サーバ側の場合

    SOAP 1.1の場合は,SOAP Faultメッセージのfaultstring要素からFaultStringを取得できます。

    SOAP 1.2の場合は,SOAP Faultメッセージのsoapenv12:Reason要素のsoapenv12:Text要素からFaultStringを取得できます。

  • クライアント側の場合

    SOAP通信基盤が提供するC4Faultクラス,またはJAX-WS機能が提供するjavax.xml.ws.soap.SOAPFaultExceptionクラスを使用してFaultStringを取得できます。

FaultActor

Faultの生成者が出力されます。

FaultActorは次の方法で取得できます。

  • サーバ側の場合

    SOAP 1.1の場合は,SOAP Faultメッセージのfaultactor要素からFaultActorを取得できます。

    SOAP 1.2の場合は,SOAP Faultメッセージのsoapenv12:Role要素からFaultActorを取得できます。

  • クライアント側の場合

    SOAP通信基盤が提供するC4Faultクラス,またはJAX-WS機能が提供するjavax.xml.ws.soap.SOAPFaultExceptionクラスを使用してFaultActorを取得できます。

FaultDetails

Faultの詳細が出力されます。

FaultDetailsは次の方法で取得できます。

  • サーバ側の場合

    SOAP 1.1の場合は,SOAP Faultメッセージのdetail要素からFaultDetailsを取得できます。

    SOAP 1.2の場合は,SOAP Faultメッセージのsoapenv12:Detail要素からFaultDetailsを取得できます。

  • クライアント側の場合

    SOAP通信基盤が提供するC4Faultクラス,またはJAX-WS機能が提供するjavax.xml.ws.soap.SOAPFaultExceptionクラスを使用してFaultDetailsを取得できます。