暗号化が設定されたユーザ属性の取得

CA Strong Authentication Web Services Guide › 設定管理 Web サービス › 暗号化が設定されたユーザ属性の取得

暗号化が設定されたユーザ属性の取得

組織の管理者は、ユーザ属性を暗号化された形式で格納することを選択できます。暗号化された形式で格納されるように設定された属性を取得するには、listConfiguredAttributesForEncryption 操作を使用する必要があります。

このセクションでは、暗号化が設定されているユーザ属性の取得に関する以下のトピックについて説明します。

リクエストメッセージの準備
Web サービスの起動
レスポンスメッセージの解釈

リクエストメッセージの準備

暗号化が設定されているユーザ属性を取得するには、listConfiguredAttributesForEncryptionRequest メッセージを使用します。以下の表に、このリクエストメッセージの要素のリストを示します。

要素	必須	説明
orgName	いいえ	ユーザ属性を取得する必要がある組織の名前。
clientTxId	いいえ	呼び出し元アプリケーションが含めることができる一意のトランザクション識別子。この識別子は、関連するトランザクションの追跡に役立ちます。

Web サービスの起動

暗号化が設定されたユーザ属性を取得する方法

（オプション） listConfiguredAttributesForEncryption 操作のヘッダに認証および許可の詳細を含めます。ヘッダ要素の詳細については、「Web サービスセキュリティの管理」の章を参照してください。
listConfiguredAttributesForEncryptionRequest 要素を使用して組織名を取得します。
listConfiguredAttributesForEncryptionRequest メッセージを使用して、前の手順で取得した詳細に従って入力メッセージを作成します。
ArcotConfigRegistrySvc サービスの listConfiguredAttributesForEncryption 操作を呼び出して、ユーザ属性を取得します。
この操作では、トランザクション識別子、認証トークン、およびユーザ属性が含まれる listConfiguredAttributesForEncryptionResponse メッセージが返されます。レスポンスメッセージの詳細については、以下のセクションを参照してください。

レスポンスメッセージの解釈

listConfiguredAttributesForEncryptionResponse レスポンスメッセージでは、SOAP エンベロープヘッダでトランザクション識別子および認証トークンが返されます。 SOAP 本文には、成功したトランザクションでは暗号化が設定されたユーザ属性が含まれ、エラーがある場合はエラーレスポンスが含まれます。

以下の表に、成功したトランザクションで返される要素に関する詳細情報を示します。エラーがある場合は、付録「エラーコード」を参照してください。

要素	説明

ヘッダ要素
udsTransactionID	UDS を使用して実行されたトランザクションの一意の識別子。
authToken	Web サービスにアクセスするための認証情報の検証が成功した場合に返される認証トークン。このトークンによって、その Web サービスへの後続のアクセスでは認証情報を提示する必要がなくなります。デフォルトでは、認証トークンは 1 日間有効で、その後は認証が再度必要になります。
本文要素
isGlobal	グローバルレベルでユーザ属性に暗号化を設定するかどうかを指定します。以下の値が使用可能です。 True：グローバルレベルでユーザ属性に暗号化が設定されていることを示します。 False：組織レベルでユーザ属性に暗号化が設定されていることを示します。
attribute	暗号化が設定されているユーザ属性の名前。