前のトピック: ディレクトリ サービス属性の使用次のトピック: ユーザ属性値の取得


ユーザ属性の取得

ディレクトリ サービスでユーザ情報を格納するために使用される属性は getQnAAttributes 操作を使用して読み取ることができます。 このセクションでは、この操作に関連する以下の手順について説明します。

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

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

要素

必須

説明

orgName

はい

取得するユーザ属性が属する LDAP 組織の名前。

clientTxId

いいえ

呼び出し元アプリケーションが含めることができる一意のトランザクション識別子。 この識別子は、関連するトランザクションの追跡に役立ちます。

Web サービスの起動

ユーザ属性を取得する方法

  1. (オプション) getQnAAttributes 操作のヘッダに認証および許可の詳細を含めます。 ヘッダ要素の詳細については、「Web サービス セキュリティの管理」を参照してください。
  2. getQnAAttributesRequest 要素を使用して、この表に記載されている組織情報を収集します。
  3. QnAAttributesRequest メッセージを使用して、前の手順で指定した詳細に従って入力メッセージを作成します。
  4. ArcorUserRegistrySvc サービスの getQnAAttributes 操作を呼び出して、LDAP 組織のユーザ属性を取得します。

    この操作では、トランザクション識別子、認証トークン、およびユーザ属性が含まれる QnAAttributesResponse メッセージが返されます。 レスポンス メッセージの詳細については、以下のセクションを参照してください。

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

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

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

要素

説明

ヘッダ要素

udsTransactionID

UDS を使用して実行されたトランザクションの一意の識別子。

authToken

Web サービスにアクセスするための認証情報の検証が成功した場合に返される認証トークン。 このトークンによって、その Web サービスへの後続のアクセスでは認証情報を提示する必要がなくなります。

デフォルトでは、認証トークンは 1 日間有効で、その後は認証が再度必要になります。

本文要素

LDAP で設定されているユーザ属性。