前のトピック: ユーザ プロファイル情報の取得次のトピック: 追加の設定

CA Risk Authentication Web サービス開発者ガイド › 限定された管理タスクの実行 › 場所情報および接続情報の取得

場所情報および接続情報の取得

指定した IP アドレスを使用して接続詳細を確認するには、ArcotRiskFortAdminSvc サービス（ArcotRiskFortAdminWebService.wsdl で提供）を使用する必要があります。 このセクションでは、以下のトピックについて説明します。

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

指定した IP アドレスの詳細な接続情報を確認するには、getLocationAndConnectionInfoRequest メッセージを使用する必要があります。 以下の表に、このリクエスト メッセージの要素のリストを示します。

要素

必須

説明

ip

はい

詳細を確認するユーザの IP アドレス。

callerId

いいえ

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

Web サービスの起動

指定した IP アドレスの接続情報を確認する方法

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

    この操作では、操作のステータス、接続の詳細、および成功の結果が含まれる getLocationAndConnectionInfoResponse メッセージが返されます。 レスポンス メッセージの詳細については、以下のセクションを参照してください。

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

getLocationAndConnectionInfoResponse レスポンス メッセージでは、SOAP エンベロープ ヘッダで、操作のステータス、接続の詳細、および成功の結果が返されます。 これらの要素については以下の表で説明します。 操作が正常に実行されると、SOAP 本文で成功のメッセージが返されます。 エラーがある場合は、AdminFault レスポンスが返されます。 SOAP エラー メッセージの詳細については、付録「例外コードおよびエラー コード」を参照してください。

要素

説明

コード

操作のステータスです。

  • 0： 接続の詳細がデータベースから正常に取得されたことを示します。
  • 1： 操作が失敗したことを示します。

message

情報がデータベースから正常に取得されたかどうかを示す文字列が含まれています。

transactionID

一意のトランザクション識別子。

 

locationContext

接続および場所の詳細（city、cityCF、state、stateCF、country、countryCF、countryISOCode、postalCode、timeZone、longitude、latitude、aolFlag、connectionType、routingType、および lineSpeed で記述）

locationContext/
city

IP アドレスの送信元の都市。

locationContext/
cityCF

IP アドレスの送信元の都市コード。

locationContext/
state

IP アドレスの送信元の国（存在する場合）での第 1 レベルの行政区画。

locationContext/
stateCF

IP アドレスの送信元の行政区画コード。

locationContext/
country

IP アドレスの送信元の国。

locationContext/
countryCF

IP アドレスの送信元の国コード。

locationContext/
countryISOCode

IP アドレスの送信元の国の 2 文字の国コード（ISO 3166-1 での定義）。

locationContext/
postalCode

IP アドレスの送信元の郵便番号（ZIP コード）。

locationContext/
timeZone

IP アドレスの送信元のタイムゾーン。

locationContext/
longitude

IP アドレスの送信元の経度を表す浮動小数点数（正の数値は東経を表し、負の数値は西経を表します）。

locationContext/
latitude

IP アドレスの送信元の緯度を表す浮動小数点数（正の数値は北緯を表し、負の数値は南緯を表します）。

locationContext/
aolFlag

指定した IP アドレスが AOL ネットワークの一部かどうかを示します。

  • Y： 指定した IP アドレスを使用しているユーザは AOL サービスのメンバです。
  • N： 指定した IP アドレスを使用しているユーザは AOL サービスのメンバではありません。

locationContext/
connectionType

エンド ユーザのデバイスとそのインターネット サービス プロバイダ（ISP）の間のデータ接続のタイプ。

  • Satellite： ユーザと静止衛星の間の高速ブロードバンド リンク。
  • OCX： 基幹通信事業者で使用される OC-3 回線および OC-48 回線。
  • TX： T-3 回線タイプおよび T-1 回線タイプの旧式のリンク。
  • Frame Relay： TX の高速版。
  • Dialup： 56kbps で動作するモデム。
  • Cable： 主にケーブル テレビ会社によって提供されるケーブル モデム ブロードバンド回線。
  • DSL： ADSL、IDSL、および SDSL を含む、デジタル加入者線ブロードバンド回線。
  • ISDN： 専用のモデムおよびスイッチを使用する高速の総合デジタル通信網技術。
  • Fixed Wireless： 受信者の場所が固定されているワイヤレス接続。
  • Mobile Wireless： 受信者の場所が移動するワイヤレス接続。

locationContext/
routingType

接続に使用した IP ルーティング メソッド。

  • Fixed： ケーブル、DSL、OCX
  • AOL： AOL ユーザ
  • POP： 地域 ISP へのダイアルアップ
  • Super POP： 多地域 ISP へのダイアルアップ
  • Cache Proxy： アクセラレータ プロキシ、コンテンツ配信サービス
  • Regional Proxy： 国内の多地域用プロキシ
  • Anonymizer： 匿名プロキシ
  • Satellite： 民生用衛星またはバックボーン衛星 ISP
  • International Proxy： 国際トラフィックを収束するプロキシ
  • Mobile Gateway： インターネットへのモバイル デバイス ゲートウェイ
  • Unknown： 現時点では特定できません

locationContext/
lineSpeed

ユーザのインターネット接続の速度。 これは connectionType によって異なります。