前のトピック: ユーザ属性値の取得次のトピック: デバイス ID および DeviceDNA の収集


ユーザ属性の検証

ユーザの LDAP 属性を使用して、(LDAP リポジトリにマップされている)組織のユーザを認証できます。 この認証を実行するには、performQnAVerification 操作を使用する必要があります。 このセクションでは、この操作に関連する以下の手順について説明します。

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

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

要素

必須

説明

username

はい

属性を検証するユーザの一意の識別子。

orgname

はい

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

attributes/attribute

はい

検証する必要がある属性の名前(attrName)および値(attrValue)。

ignorecase

はい

入力で渡された属性値とディレクトリ サービスに格納されている値で、大文字と小文字を区別する必要があるかどうかを指定します。

  • 0: 大文字と小文字を区別する必要があることを表します。
  • 1: 入力値の大文字と小文字の区別が無視されることを表します。

clientTxId

いいえ

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

Web サービスの起動

LDAP 属性を使用してユーザを認証する方法

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

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

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

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

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

要素

説明

ヘッダ要素

udsTransactionID

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

authToken

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

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

本文要素

QnAResponseAttribute/name

検証された属性の名前。

QnAResponseAttribute/result

検証結果。

  • MATCHED
  • NOT_MATCHED
  • NOT_VERIFIED
  • NOT_FOUND