Configuring Vehicle Monitoring plugin data sources - Vehicle Monitoring 2.3.18.0

Security Center Vehicle Monitoring Plugin Guide 2.3.18.0

Applies to
Vehicle Monitoring 2.3.18.0
Last updated
2023-09-29
Content type
Guides > Plugin and extension guides
Language
English
Product
Vehicle Monitoring
Version
2.3

Before you add GPS push data sources as GPS units to Security Center, you must configure the Security Center Vehicle Monitoring plugin's data source settings.

What you should know

Geolocation and other types of metadata can be sent to the Vehicle Monitoring plugin using raw UDP sockets, MQTT, or HTTP/S. To keep your data secure, it is recommended to use third-party encryption and authentication methods, such as end-to-end VPNs or SSH tunnels.

Procedure

  1. From the Config Tool homepage, open the Plugins task.
  2. From the entity tree, select the Vehicle Monitoring plugin role, and click the Data sources tab.
  3. To configure a push data source, click Add ():
    Data source name
    Enter a name for the data source.
    Tip: For better search indexing, it is a best practice to indicate that the router is submitting NMEA data.
    Input type
    Select the input type that you require and configure the settings for it:
    • UDP socket
      Data format
      Select the type of data that you require. Depending on the Input type you selected, choose from the following:
      • NMEA
      • TAIP
      • Genetec GPS data
      • Genetec metadata
      • Genetec mixed data
      Vehicle ID position
      Choose where the vehicle ID is situated in the NMEA sentence.
      Socket
      Define the communication information so the data source can communicate with your system:
      (Optional) Listen IP address type
      Choose to target all IP addresses or specific IP addresses.
      NOTE: Most use cases require all IP addresses be used.
      Listen port
      If your computer has multiple network interfaces, specify the port that the UDP socket should listen on.
      Receive timeout
      Set how long each socket read waits for data before a timeout. When a socket read times out, it immediately attempts another read.
    • MQTT
      NOTE: The supported MQTT version is 3.1.1.
      Data format
      Select the type of data that you require. Depending on the Input type you selected, choose from the following:
      • NMEA
      • TAIP
      • Genetec GPS data
      • Genetec metadata
      • Genetec mixed data
      • Component health
      Vehicle ID position
      Choose where the vehicle ID is situated in the NMEA sentence.
      Broker hostname
      Enter the hostname used by the data broker.
      Broker port
      Enter the port used by the data broker.
      Topic
      Information that the broker uses to filter messages for each connected client.
      SSL protocol
      Select a compatible version of the Secure Sockets Layer (SSL) protocol.
    • Rest endpoint
      NOTE: The Rest endpoint input type is depreciated and its use is no longer recommended. The REST API input type is recommended as a replacement. For more information, refer to the REST API section of Configuring Vehicle Monitoring plugin data sources.
      Listen port
      If your computer has multiple network interfaces, specify the port that the UDP socket should listen on.
      NOTE: The recommended value is 443. Additional data sources increment from this value.
      (Optional) HTTPS
      Activate this setting to use HTTPS communication protocol.
      (Optional) Authenticate
      Activate this setting to configure authentication information used with HTTPS protocol.
      (Optional) Authentication host
      The host address associated with the endpoint.
      (Optional) Authentication port
      The port associated with the endpoint.
      NOTE: The default port is 443.
      End Points
      Select a data format and enter the URI path associated with the endpoint.
  4. To configure a pull data source Add ():
    Data source name
    Enter a name for the data source.
    Data source format
    Select the type of data source that you require.
    Data source URL
    Input the URL where your data source is located.
    Poll interval
    Define a time period after which the system polls for new data.
  5. Click Apply.