Contract No.: 285248 Strategic Objective


Android Flow Monitoring Open Specification



Download 1.78 Mb.
Page54/54
Date28.01.2017
Size1.78 Mb.
#8871
1   ...   46   47   48   49   50   51   52   53   54

28Android Flow Monitoring Open Specification

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

  • Initial Release

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.
Download 1.78 Mb.

Share with your friends:
1   ...   46   47   48   49   50   51   52   53   54




The database is protected by copyright ©ininet.org 2024
send message

    Main page