28.1Introduction to the Android Flow Monitoring Open Specification 28.1.1Android Flow Monitoring Open Specification Core
The Android Flow Monitoring Open Specification defines a set of NetFlow v9 templates that specify what data is monitored and exported by the application. The use of these templates allows the application to export geolocation information, as well as Android specific information, when available.
28.1.2Intended Audience
This specification is intended for both software developers and reimplementers of this GE. For the former, this document provides a full specification of what data is available. For the latter, this specification provides a full specification of what data might be expected by software developers.
28.1.3Specification Change History
This version of the Android Flow Monitoring Open Specification Guide replaces and obsoletes all previous versions. The most recent changes are described in the table below:
Revision Date
|
Changes Summary
|
Jun 28, 2013
| -
Added Device ID and App Name fields
-
Updated templates to reflect R2.3 software usage
|
Apr 22, 2013
| | 28.1.4Additional Resources
You can download the most current version of this document from the FIWARE specification website at Android Flow Monitoring Open Specification. For more details about the Android Flow Monitoring that this specification is based upon, please refer to High Level Description. Related documents, including an Architectural Description, are available at the same site.
28.2General Android Flow Monitoring Open Specification Information 28.2.1Geolocation Field Type Definitions
In order to be able to export geolocation information, we had to extend NetFlow v9, adding the following field type definitions, in addition to using the ones defined in the Section 8 of the RFC:
Field Type
|
Value
|
Length (bytes)
|
Description
|
LOCATION_ALGORITHM
|
347
|
1
|
Can take two values:
-
100 if the location was determined using cell towers and WiFi access points
-
200 if the location was determined using GPS satellites
|
LOCATION_TIME
|
348
|
4
|
Time at which the location was acquired, in seconds since EPOCH
|
LOCATION_LATITUDE
|
349
|
4
|
Integer part of the latitude, as a uint32
|
LOCATION_LATITUDE_DEC
|
350
|
8
|
Decimal part of the latitude as a uint64
|
LOCATION_LONGITUDE
|
351
|
4
|
Integer part of the longitude, as a uint32
|
LOCATION_LONGITUDE_DEC
|
352
|
8
|
Decimal part of the longitude as a uint64
| 28.2.2Android Field Type Definitions
In addition to geolocation information, some Android specific application are also exported:
Field Type
|
Value
|
Length (bytes)
|
Description
|
ANDROID_DEVICE_ID
|
353
|
4
|
Unique Identifier of the Android device running the probe
|
ANDROID_APP_NAME
|
354
|
50
|
Name of the application that initiated the network traffic
| 28.3Templates Specifications
The Android Flow Monitoring GE chooses the template it uses among four different possibilities, depending on the version of the IP protocol used in the flow, and the availability of geolocation information (which can be configured in the User Interface, please refer to the User Guide).
28.3.1IPv4, TCP
Field Type
|
Value
|
Length (bytes)
|
IP_PROTOCOL_VERSION
|
60
|
1
|
IPV4_SRC_ADDR
|
8
|
4
|
IPV4_DST_ADDR
|
12
|
4
|
IN_BYTES
|
1
|
4
|
PROTOCOL
|
4
|
1
|
L4_SRC_PORT
|
7
|
2
|
L4_DST_PORT
|
11
|
2
|
TCP_FLAGS
|
6
|
1
|
ANDROID_APP_NAME
|
354
|
50
|
FIRST_SWITCHED
|
22
|
4
|
LAST_SWITCHED
|
21
|
4
|
IN_PKTS
|
2
|
4
|
ANDROID_DEVICE_ID
|
353
|
4
|
LOCATION_ALGORITHM
|
347
|
1
|
LOCATION_TIME
|
348
|
4
|
LOCATION_LATITUDE
|
349
|
4
|
LOCATION_LATITUDE_DEC
|
350
|
8
|
LOCATION_LONGITUDE
|
351
|
4
|
LOCATION_LONGITUDE_DEC
|
352
|
8
| 28.3.2IPv4, UDP
Field Type
|
Value
|
Length (bytes)
|
IP_PROTOCOL_VERSION
|
60
|
1
|
IPV4_SRC_ADDR
|
8
|
4
|
IPV4_DST_ADDR
|
12
|
4
|
IN_BYTES
|
1
|
4
|
PROTOCOL
|
4
|
1
|
L4_SRC_PORT
|
7
|
2
|
L4_DST_PORT
|
11
|
2
|
ANDROID_APP_NAME
|
354
|
50
|
FIRST_SWITCHED
|
22
|
4
|
LAST_SWITCHED
|
21
|
4
|
IN_PKTS
|
2
|
4
|
ANDROID_DEVICE_ID
|
353
|
4
|
LOCATION_ALGORITHM
|
347
|
1
|
LOCATION_TIME
|
348
|
4
|
LOCATION_LATITUDE
|
349
|
4
|
LOCATION_LATITUDE_DEC
|
350
|
8
|
LOCATION_LONGITUDE
|
351
|
4
|
LOCATION_LONGITUDE_DEC
|
352
|
8
| 28.3.3IPv4, ICMP
Field Type
|
Value
|
Length (bytes)
|
IP_PROTOCOL_VERSION
|
60
|
1
|
IPV4_SRC_ADDR
|
8
|
4
|
IPV4_DST_ADDR
|
12
|
4
|
IN_BYTES
|
1
|
4
|
PROTOCOL
|
4
|
1
|
FIRST_SWITCHED
|
22
|
4
|
LAST_SWITCHED
|
21
|
4
|
IN_PKTS
|
2
|
4
|
ANDROID_DEVICE_ID
|
353
|
4
|
LOCATION_ALGORITHM
|
347
|
1
|
LOCATION_TIME
|
348
|
4
|
LOCATION_LATITUDE
|
349
|
4
|
LOCATION_LATITUDE_DEC
|
350
|
8
|
LOCATION_LONGITUDE
|
351
|
4
|
LOCATION_LONGITUDE_DEC
|
352
|
8
| 28.3.4IPv6
In case IPv6 is used instead of IPv4, the above templates are still used, with the only difference being that the fields:
Field Type
|
Value
|
Length (bytes)
|
IPV4_SRC_ADDR
|
8
|
4
|
IPV4_DST_ADDR
|
12
|
4
|
are replaced by the fields:
Field Type
|
Value
|
Length (bytes)
|
IPV6_SRC_ADDR
|
27
|
16
|
IPV6_DST_ADDR
|
28
|
16
| 29FI-WARE Open Specifications Legal Notice Use Of Specification - Terms, Conditions & Notices
The material in this document details a FI-WARE Generic Enabler Specification in accordance with the terms, conditions and notices set forth below. This document does not represent a commitment to implement any portion of this specification in any company's products. The information contained in this document is subject to change without notice.
License
The FI-WARE Project Partners hereby grant you a nonexclusive, royalty-free, paid up, worldwide license to copy and modify this document and to distribute copies of the modified version. The FI-WARE Project Partners agree that no person shall be deemed to have infringed the copyright in the included material of any such copyright holder by reason of having used the specification set forth herein or having conformed any computer software to the specification. Subject to all of the terms and conditions below, the owners of the copyright in this specification hereby grant you a fully-paid up, non-exclusive, nontransferable, perpetual, worldwide license (without the right to sublicense), to use this specification, to create and distribute software and special purpose specifications that are based upon this specification, and to use, copy, and distribute this specification as provided under applicable law.
Patents
The FI-WARE Project Partners shall not be responsible for identifying patents for which a license may be required by any FI-WARE specification, or for conducting legal inquiries into the legal validity or scope of those patents that are brought to its attention. FI-WARE specifications are prospective and advisory only. Prospective users are responsible for protecting themselves against liability for infringement of patents.
General Use Restrictions
Any unauthorized use of this specification may violate copyright laws, trademark laws, and communications regulations and statutes. This document contains information which is protected by copyright. All Rights Reserved.
No part of this work covered by copyright herein may be reproduced or used in any form or by any means--graphic, electronic, or mechanical, including photocopying, recording, taping, or information storage and retrieval systems--without permission of the copyright owner.
Disclaimer Of Warranty
WHILE THIS PUBLICATION IS BELIEVED TO BE ACCURATE, IT IS PROVIDED "AS IS" AND MAY CONTAIN ERRORS OR MISPRINTS. THE FI-WARE PARTNERS MAKE NO WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, WITH REGARD TO THIS PUBLICATION, INCLUDING BUT NOT LIMITED TO ANY WARRANTY OF TITLE OR OWNERSHIP, IMPLIED WARRANTY OF MERCHANTABILITY OR WARRANTY OF FITNESS FOR A PARTICULAR PURPOSE OR USE.
IN NO EVENT SHALL THE FI-WARE PARTNERS BE LIABLE FOR ERRORS CONTAINED HEREIN OR FOR DIRECT, INDIRECT, INCIDENTAL, SPECIAL, CONSEQUENTIAL, RELIANCE OR COVER DAMAGES, INCLUDING LOSS OF PROFITS, REVENUE, DATA OR USE, INCURRED BY ANY USER OR ANY THIRD PARTY IN CONNECTION WITH THE FURNISHING, PERFORMANCE, OR USE OF THIS MATERIAL, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. The entire risk as to the quality and performance of software developed using this specification is borne by you. This disclaimer of warranty constitutes an essential part of the license granted to you to use this specification.
Trademarks
You will not use any trademark, marks or trade names (collectively, "Marks") of the FI-WARE Project Partners or the FI-WARE project without prior written consent.
Issue Reporting
This specification is subject to continuous review and improvement. As part of this process we encourage readers to report any ambiguities, inconsistencies, or inaccuracies they may find by completing the Issue Reporting Procedure described on the web page http://www.fi-ware.eu.
30Open Specifications Interim Legal Notice General Information
FI-WARE Project Partners refers to Parties of the FI-WARE Project in accordance with the terms of the FI-WARE Consortium Agreement.
Use Of Specification - Terms, Conditions & Notices
The material in this specification details a FI-WARE Generic Enabler Specification (hereinafter “Specification”) in accordance with the terms, conditions and notices set forth below. This Specification does not represent a commitment to implement any portion of this Specification in any company's products. The information contained in this Specification is subject to change without notice.
Copyright License
Subject to all of the terms and conditions below, the copyright holders in this Specification hereby grant you, the individual or legal entity exercising permissions granted by this License, a fully-paid up, non-exclusive, nontransferable, perpetual, worldwide license (without the right to sublicense) under its respective copyrights incorporated in the Specification, to copy and modify this Specification and to distribute copies of the modified version, and to use this Specification, to create and distribute special purpose specifications and software that are an implementation of this Specification, and to use, copy, and distribute this Specification as provided under applicable law.
Patent License
“Specification Essential Patents” shall mean patents and patent applications, which are necessarily infringed by an implementation of the Specification and which are owned by any of the FI-WARE Project Partners. “Necessarily infringed” shall mean that no commercially reasonable alternative exists to avoid infringement.
Each of the FI-WARE Project Partners, jointly or solely, hereby agrees to grant you, on royalty-free and otherwise fair, reasonable and non-discriminatory terms, a personal, nonexclusive, non-transferable, non-sub-licensable, royalty-free, paid up, worldwide license, under their respective Specification Essential Patents, to make, use sell, offer to sell, and import software implementations utilizing the Specification.
The FI-WARE Project Partners shall not be responsible for identifying patents for which a license may be required by any FI-WARE Specification, or for conducting legal inquiries into the legal validity or scope of those patents that are brought to its attention. FI-WARE specifications are prospective and advisory only. Prospective users are responsible for protecting themselves against liability for infringement of patents.
General Use Restrictions
Any unauthorized use of this Specification may violate copyright laws, trademark laws, and communications regulations and statutes. This Specification contains information which is protected by copyright. All Rights Reserved. This Specification shall not be used in any form or for any other purpose different from those herein authorized, without the permission of the respective copyright owners.
For avoidance of doubt, the rights granted are only those expressly stated in this Section herein. No other rights of any kind are granted by implication, estoppel, waiver or otherwise
Disclaimer Of Warranty
WHILE THIS PUBLICATION IS BELIEVED TO BE ACCURATE, IT IS PROVIDED "AS IS" AND MAY CONTAIN ERRORS OR MISPRINTS. THE FI-WARE PARTNERS MAKE NO WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, WITH REGARD TO THIS PUBLICATION, INCLUDING BUT NOT LIMITED TO ANY WARRANTY OF TITLE OR OWNERSHIP, WARRANTY OF NON INFRINGEMENT OF THIRD PARTY RIGHTS, IMPLIED WARRANTY OF MERCHANTABILITY OR WARRANTY OF FITNESS FOR A PARTICULAR PURPOSE OR USE.
IN NO EVENT SHALL THE FI-WARE PARTNERS BE LIABLE FOR ERRORS CONTAINED HEREIN OR FOR DIRECT, INDIRECT, INCIDENTAL, SPECIAL, CONSEQUENTIAL, RELIANCE OR COVER DAMAGES, INCLUDING LOSS OF PROFITS, REVENUE, DATA OR USE, INCURRED BY ANY USER OR ANY THIRD PARTY IN CONNECTION WITH THE FURNISHING, PERFORMANCE, OR USE OF THIS MATERIAL, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. The entire risk as to the quality and performance of software developed using this Specification is borne by you. This disclaimer of warranty constitutes an essential part of the license granted to you to use this Specification.
Trademarks
You shall not use any trademark, marks or trade names (collectively, "Marks") of the FI-WARE Project Partners or the FI-WARE project without prior written consent.
Issue Reporting
This Specification is subject to continuous review and improvement. As part of this process we encourage readers to report any ambiguities, inconsistencies, or inaccuracies they may find by completing the Issue Reporting Procedure described on the web page http://www.fi-ware.eu.
Share with your friends: |