個人保証メッセージの取得

ユーザに対して設定されている PAM を読み取るには、getPAM 操作を使用する必要があります。このセクションでは、ユーザの PAM の取得に関する以下のトピックについて説明します。

以下の表に、getPAMRequest メッセージの要素のリストを示します。

要素	必須	説明
UserId/orgName	いいえ	ユーザが属する組織の名前です。注：組織名が渡されない場合、その操作ではデフォルトの組織が使用されます。
UserId/userName	はい	システムでユーザを識別するための一意の識別子。
UserId/userRefId	いいえ	1 人のユーザが実行したさまざまな操作を追跡するために参照用として使用される識別子。
clientTxId	いいえ	呼び出し元アプリケーションが含めることができる一意のトランザクション識別子。この識別子は、関連するトランザクションの追跡に役立ちます。

ユーザの PAM を取得する方法

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

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

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

要素	説明

ヘッダ要素
udsTransactionID	UDS を使用して実行されたトランザクションの一意の識別子。
authToken	Web サービスにアクセスするための認証情報の検証が成功した場合に返される認証トークン。このトークンによって、その Web サービスへの後続のアクセスでは認証情報を提示する必要がなくなります。デフォルトでは、認証トークンは 1 日間有効で、その後は認証が再度必要になります。
本文要素
UserId/orgName	ユーザが属する組織の名前です。
UserId/userName	システムでユーザを識別するための一意の識別子。
UserId/userRefId	1 人のユーザが実行したさまざまな操作を追跡するために参照用として使用される識別子。
PAM	AuthMinder で保護されているリソースにユーザがアクセスしようとした場合に、ユーザに表示される個人保証メッセージ（PAM）。
pamImageURL	AuthMinder で保護されているリソースにユーザがアクセスしようとした場合に、ユーザに表示される画像が含まれる URL。