前のトピック: クレデンシャルの有効期間のリセット次のトピック: Q&A 設定の取得


カスタム属性のリセット

クレデンシャルに関連付けられたカスタム属性をリセットできます。 ResetCredentialNotes 操作では、認証情報のカスタム属性をリセットできます。

このセクションでは、以下の手順について説明します。

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

カスタム属性をリセットするには、ResetCredentialNotesRequestMessage を使用します。 認証情報と関連付けられたカスタム属性をリセットするための入力要素は、「認証情報の作成」セクションで説明されている入力要素と同じです。 各要素の詳細については、「認証情報の作成」セクションに記載されている表を参照してください。

Web サービスの起動

ユーザ認証情報のカスタム属性をリセットする方法

  1. オプション) SOAP ヘッダまたは ResetCredentialNotes 操作の additionalInput 要素に認証および許可の詳細を含めます。 これらの詳細については、「Web サービス セキュリティの管理」の章を参照してください。
  2. userName および orgName 要素を使用して、認証情報のカスタム属性をリセットする必要があるユーザの詳細を取得します。
  3. 属性をリセットする必要がある認証情報のタイプに応じた <CredentialName>Input 要素を使用して認証情報を取得します。

    必要な入力はクレデンシャルごとに異なります。 たとえば、パスワード認証と ArcotID PKI 認証ではパスワードが必要ですが、Q&A 認証情報では質問とそれに対応する回答が必要です。

  4. オプション)プラグインを実装する場合は、additionalInput 要素タイプを呼び出して追加入力を指定します。

    このタイプでは、追加情報を名前と値のペアとして設定します。

  5. ResetCredentialNotesRequestMessage を使用して、前の手順で取得した詳細に従って入力メッセージを作成します。
  6. ArcotWebFortIssuanceSvc サービスの ResetCredentialNotes 操作を呼び出して、認証情報のカスタム属性をリセットします。

    この操作では、認証情報およびトランザクションの詳細を含む ResetCredentialNotesResponseMessage のインスタンスが返されます。

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

成功したトランザクションでは、ResetCredentialNotesResponseMessage レスポンス メッセージに、CreateCredentialResponseMessage レスポンス メッセージで返される要素に関する情報を含む表で説明されている要素が返されます。 これらの要素は SOAP本文に含まれます。 エラーがある場合、エラー レスポンスは SOAP 本文に含まれます。 SOAP エラー メッセージの詳細については、付録「エラー コード」を参照してください。