前のトピック: 組織の更新次のトピック: 組織キャッシュのリフレッシュ

CA Risk Authentication Web サービス開発者ガイド › 組織の管理 › 組織ステータスの更新

組織ステータスの更新

RiskMinder データベース内の組織のステータスを更新するには、updateOrgStatus 操作を使用します。

このセクションでは、組織ステータスを更新するための以下の手順について説明します。

注： 組織ステータスを更新した後、その変更を有効にするにはシステム キャッシュをリフレッシュする必要があります。 システム キャッシュをリフレッシュする方法の詳細については、「組織キャッシュのリフレッシュ」を参照してください。

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

組織ステータスを更新するには、updateOrgStatusRequest メッセージを使用します。 以下の表に、このリクエスト メッセージの要素のリストを示します。

要素

必須

説明

status

はい

データベース内の組織のステータス。

  • INITIAL
    組織がまだアクティブ化されていないため、操作で使用できないことを示します。
  • ACTIVE
    組織が正常に作成されてアクティブ化されていることを示します。 組織に対して任意の操作を実行できます。
  • INACTIVE
    組織が非アクティブ化されていることを示します。 操作を実行するには、まず組織をアクティブ化する必要があります。
  • DELETED
    組織が削除されていて、これ以上使用できないことを示します。

OrgName

はい

組織を識別する一意の名前。

clientTxId

いいえ

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

Web サービスの起動

組織ステータスを更新する方法

  1. （オプション） updateOrgStatus 操作のヘッダに認証および許可の詳細を含めます。 ヘッダ要素の詳細については、「Web サービス セキュリティの管理」を参照してください。
  2. upateOrgStatusRequest 要素を使用して、この表に記載されている組織ステータスを更新します。
  3. upateOrgStatusRequest メッセージを使用して、前の手順で指定した詳細に従って入力メッセージを作成します。
  4. ArcorUserRegistryMgmtSvc サービスの updateOrgStatus 操作を呼び出して、組織ステータスを更新します。

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

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

updateOrgStatusResponse レスポンス メッセージでは、SOAP エンベロープ ヘッダでトランザクション識別子および認証トークンが返されます。 これらの要素については以下の表で説明します。 操作が正常に実行されると、SOAP 本文で成功のメッセージが返されます。 エラーがある場合は、エラー レスポンスが返されます。 SOAP エラー メッセージの詳細については、付録「例外コードおよびエラー コード」を参照してください。

要素

説明

udsTransactionID

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

authToken

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

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