このセクションでは、ユーザ情報を更新するための以下の手順について説明します。
RiskMinder データベース内のユーザ情報を更新するには、updateUserRequest メッセージを使用します。 以下の表に、このリクエスト メッセージの要素のリストを示します。
|
要素 |
必須 |
説明 |
|---|---|---|
|
userId/orgName |
いいえ |
ユーザが属する組織の名前です。 注： 組織名が渡されない場合、その操作ではデフォルトの組織が使用されます。 |
|
userID/userName |
はい |
システムでユーザを識別するための一意の識別子。 |
|
userId/userRefId |
いいえ |
1 人のユーザが実行したさまざまな操作を追跡するために参照用として使用される識別子。 |
|
dateCreated |
いいえ |
システムでユーザが作成された日時のタイムスタンプ。 |
|
dateModified |
いいえ |
ユーザの詳細が最後に変更された日時のタイムスタンプ。 |
|
emailId |
いいえ |
登録する必要があるユーザの電子メール ID。 デフォルトの修飾子は EMAILID です。 注： 1 人のユーザに複数の電子メール ID を設定する場合は、このエントリを繰り返すことができ、設定した電子メール タイプに基づいた修飾子を使用します。 |
|
telephoneNumber |
いいえ |
登録する必要があるユーザの電話番号。 デフォルトの修飾子は TELEPHONE です。 注： 1 人のユーザに複数の電話番号を設定する場合は、このエントリを繰り返すことができ、設定した電話タイプに基づいた修飾子を使用します。 |
|
firstName |
いいえ |
ユーザの名。 |
|
middleName |
いいえ |
ユーザのミドル ネーム。 |
|
lastName |
いいえ |
ユーザの姓。 |
|
pam |
いいえ |
RiskMinder で保護されているリソースにユーザがアクセスしようとした場合に、ユーザに表示される個人保証メッセージ（PAM）。 |
|
pamImageURL |
いいえ |
RiskMinder で保護されているリソースにユーザがアクセスしようとした場合に、ユーザに表示される 画像が含まれる URL。 |
|
image |
いいえ |
ユーザ自身を識別するためにユーザがアップロードする画像。 |
|
status |
いいえ |
ユーザのステータスです。以下の値になります。
|
|
customAttribute |
いいえ |
名前と値のペアで渡す追加のユーザ情報。
|
|
startLockTime |
いいえ |
ユーザを非アクティブにする日時のタイムスタンプ。 |
|
endLockTime |
いいえ |
非アクティブ ユーザをアクティブにする日時のタイムスタンプ。 |
|
account/accountType |
はい
account 要素が定義されている場合のみ。 |
アカウント ID を修飾し、アカウント ID の使用に関する追加コンテキストを指定する属性。 |
|
account/accountID |
いいえ |
ユーザ名に追加してユーザを識別するために使用される代替識別子。 アカウント ID はアカウントとも呼ばれます。 |
|
account/accountStatus |
いいえ |
アカウントのステータス。
|
|
account/accountIDAttribute |
いいえ |
システムでユーザを識別するために使用される代替識別子。 注： 1 人のユーザに対して渡すことができるアカウント ID は 3 つまでです。 |
|
account/dateCreated |
いいえ |
アカウント ID が作成された日時のタイムスタンプ。 注： createUser 操作には適用されません。 |
|
account/dateModified |
いいえ |
アカウント ID が最後に変更された日時のタイムスタンプ。 注： createUser 操作には適用されません。 |
|
account/accountCustomAttribute |
いいえ |
名前と値のペアで渡す追加のアカウント情報
|
|
updateUserFlags/updateImage |
いいえ |
ユーザ画像を変更できるかどうかを示すフラグ。 サポートされている値は以下のとおりです。
|
|
clientTxId |
いいえ |
呼び出し元アプリケーションが含めることができる一意のトランザクション識別子。 この識別子は、関連するトランザクションの追跡に役立ちます。 |
RiskMinder データベース内のユーザを更新する方法
この操作では、トランザクション識別子および認証トークンが含まれる updateUserResponse メッセージが返されます。 レスポンス メッセージの詳細については、以下のセクションを参照してください。
updateUserResponse レスポンス メッセージでは、SOAP エンベロープ ヘッダでトランザクション識別子および認証トークンが返されます。 これらの要素については以下の表で説明します。 操作が正常に実行されると、SOAP 本文で成功のメッセージが返されます。 エラーがある場合は、エラー レスポンスが返されます。 SOAP エラー メッセージの詳細については、「例外コードおよびエラー コード」を参照してください。
|
要素 |
説明 |
|---|---|
|
udsTransactionID |
UDS を使用して実行されたトランザクションの一意の識別子。 |
|
authToken |
Web サービスにアクセスするための認証情報の検証が成功した場合に返される認証トークン。 このトークンによって、その Web サービスへの後続のアクセスでは認証情報を提示する必要がなくなります。 デフォルトでは、認証トークンは 1 日間有効で、その後は認証が再度必要になります。 |
|
Copyright © 2014 CA Technologies.
All rights reserved.
|
|