Fetching Location and Connection Information

RiskMinder Web Services Developer's Guide › Performing Selected Administration Tasks › Fetching Location and Connection Information

Fetching Location and Connection Information

To view the connection details by using the specified IP address, you must use the ArcotRiskFortAdminSvc service (available through ArcotRiskFortAdminWebService.wsdl). This section covers the following topics:

Preparing the Request Message
Invoking the Web Service
Interpreting the Response Message

Preparing the Request Message

You must use the getLocationAndConnectionInfoRequest message to view the detailed connection information for the specified IP address. The following table lists the elements of this request message.

Element	Mandatory	Description
ip	Yes	The IP address of the user whose details you want to see.
callerId	No	Unique transaction identifier that your calling application can include. This identifier helps in tracking related transactions.

Invoking the Web Service

To view the connection information for the specified IP address:

(Optional) Include the authentication and authorization details in the header of the getLocationAndConnectionInfo operation. See "Managing Web Services Security" for more information on the header elements.
Use the getLocationAndConnectionInfoRequest elements to set the IP address information, as listed in the table.
Use the getLocationAndConnectionInfoRequest message and construct the input message by using the details specified in preceding step.
Invoke the getLocationAndConnectionInfo operation of the ArcotRiskFortAdminSvc service to view the connection information.
This operation returns the getLocationAndConnectionInfoResponse message that includes the status of the operation, connection details, and success result. See the following section for more information on the response message.

Interpreting the Response Message

The response message, getLocationAndConnectionInfoResponse, returns the status of the operation, connection details, and success result in the SOAP envelope header. These elements are explained in the following table. The SOAP body returns a success message if the operation was performed successfully. If there are any errors, then the AdminFault response is returned. See appendix, "Exceptions and Error Codes" for more information on the SOAP error messages.

Element	Description

code	The status of the operation: 0: Indicates that the connection details were successfully fetched from the database. 1: Indicates that the operation failed.
message	Contains the string that indicates whether the information was successfully retrieved from the database or not.
transactionID	The unique transaction identifier.

locationContext	The connection and location details, as described by city, cityCF, state, stateCF, country, countryCF, countryISOCode, postalCode, timeZone, longitude, latitude, aolFlag, connectionType, routingType, and lineSpeed.
locationContext/ city	The city from where the IP address originated.
locationContext/ cityCF	The city code from where the IP address originated.
locationContext/ state	The first-level administrative division within each country (if one exists) from where the IP address originated.
locationContext/ stateCF	The state code from where the IP address originated.
locationContext/ country	The country from where the IP address originated.
locationContext/ countryCF	The country code from where the IP address originated.
locationContext/ countryISOCode	The two-letter country code (as defined in ISO 3166-1) from where the IP address originated.
locationContext/ postalCode	The postal (ZIP) code of the location from where the IP address originated.
locationContext/ timeZone	The timezone of the location from where the IP address originated.
locationContext/ longitude	A floating point number (with positive numbers representing East and negative numbers representing West) from where the IP address originated.
locationContext/ latitude	A floating point number (with positive numbers representing North and negative numbers representing South) from where the IP address originated.
locationContext/ aolFlag	The indication whether the specified IP is part of the AOL network: Y: The user with the specified IP address is a member of the AOL service. N: The user with the specified IP address is not a member of the AOL service.
locationContext/ connectionType	The type of data connection between the end-user’s device and their Internet Service Provider (ISP): Satellite: High-speed broadband links between a user and a geosynchronous satellite. OCX: The OC-3 circuits, OC-48 circuits that are used by large backbone carriers. TX: Old links of type T-3 circuits and T-1 circuits. Frame Relay: High-speed alternatives to TX. Dialup: Modems that operate at 56kbps. Cable: Cable modem broadband circuits, primarily offered by cable TV companies. DSL: Digital Subscriber Line broadband circuits that include aDSL, iDSL, and sDSL. ISDN: High-speed Integrated Services Digital Network technology with specialized modems and switches. Fixed Wireless: Wireless connections where the location of the receiver is fixed. Mobile Wireless: Wireless connections where the location of the receiver is mobile.
locationContext/ routingType	The IP routing method used for the connection: Fixed: Cable, DSL, OCX AOL: AOL users POP: Dial up to regional ISP Super POP: Dial up to multi-state ISP Cache Proxy: Accelerator proxy, content distribution service Regional Proxy: Proxy for multiple states in a country Anonymizer: Anonymizing proxy Satellite: Consumer satellite or backbone satellite ISP International Proxy: Proxy funneling international traffic Mobile Gateway: Mobile device gateway to Internet Unknown: Cannot currently be determined
locationContext/ lineSpeed	The speed of the user’s Internet connection. This is based on connectionType.