A simple NodeJS application to accept WiFi location data from a Cisco Meraki network.
Meraki will first verify the intended receiver by sending a GET request to this server and expect to receive a "validator" key.
If validated, Meraki will periodically send a JSON stream of location data approx every 1-2 minutes.
The JSON data will contain a secret that can be verified by the CMX receiver (this app) to ensure the data is from the correct sending network.
Once the data has been received, it is sent to the cmxData(data) function, where the JSON data will be
in the data
object. This example simply prints the contents to the console. Ideally, this would be sent
to a database.
git clone https://github.com/dexterlabora/cmxreceiver.git
cd cmxreceiver
npm install
Modify the cmxreceiver.js
file with your correct service port, secret, validator.
Then, do something with the data
(i.e write to database) by modifying this function:
function cmxData(data){
console.log("JSON Feed: "+JSON.stringify(data, null, 2));
};
node cmxreceiver.js
Alternatively, you can define the parameters at runtime using environment variables (except for the DB piece) by typing this at the shell.
VALIDATOR="8e0846499d9a3f6c23f7868c4cFFFFd63250FFFF" SECRET="testing123" node cmxreceiver.js
http://developers.meraki.com/tagged/Location
http://www.internetoflego.com/wifi-location-based-analytics-workflows-cisco-meraki-cmx/
Cory Guynn
2016
$ node cmxreceiver.js
CMX Receiver listening on port: 1890
Validator = 8e0846499d9a3f6c23f7868c4c25b9d63250FFFF
Secret verified
JSON Feed: {
"version": "2.0",
"secret": "testing123",
"type": "DevicesSeen",
"data": {
"apMac": "00:18:0a:13:dd:b0",
"apFloors": [],
"apTags": [
"",
"home",
""
],
"observations": [
{
"ipv4": null,
"location": {
"lat": 51.5355157,
"lng": -0.06990350000000944,
"unc": 41.21077547635681,
"x": [],
"y": []
},
"seenTime": "2016-09-12T11:12:32Z",
"ssid": null,
"os": null,
"clientMac": "00:26:ab:b8:a9:a5",
"seenEpoch": 1473678752,
"rssi": 22,
"ipv6": null,
"manufacturer": "Seiko Epson"
},
{
"ipv4": "/192.168.0.15",
"location": {
"lat": 51.5355157,
"lng": -0.06990350000000944,
"unc": 1.5497743004111961,
"x": [],
"y": []
},
"seenTime": "2016-09-12T11:12:31Z",
"ssid": ".interwebs",
"os": null,
"clientMac": "74:da:38:56:0a:80",
"seenEpoch": 1473678751,
"rssi": 45,
"ipv6": null,
"manufacturer": "Edimax Technology"
},
{
"ipv4": null,
"location": {
"lat": 51.5355157,
"lng": -0.06990350000000944,
"unc": 43.562546906687274,
"x": [],
"y": []
},
"seenTime": "2016-09-12T11:12:35Z",
"ssid": null,
"os": "iOS",
"clientMac": "38:c9:86:d5:dd:08",
"seenEpoch": 1473678755,
"rssi": 21,
"ipv6": null,
"manufacturer": "Apple"
},
{
"ipv4": "/192.168.0.35",
"location": {
"lat": 51.5355157,
"lng": -0.06990350000000944,
"unc": 1.7158482391649275,
"x": [],
"y": []
},
"seenTime": "2016-09-12T11:12:41Z",
"ssid": ".interwebs",
"os": null,
"clientMac": "18:fe:34:f2:95:26",
"seenEpoch": 1473678761,
"rssi": 45,
"ipv6": null,
"manufacturer": "Espressif"
},
{
"ipv4": "/192.168.0.56",
"location": {
"lat": 51.5355157,
"lng": -0.06990350000000944,
"unc": 0.6844347949152217,
"x": [],
"y": []
},
"seenTime": "2016-09-12T11:12:31Z",
"ssid": ".interwebs",
"os": null,
"clientMac": "18:fe:34:d7:7c:26",
"seenEpoch": 1473678751,
"rssi": 50,
"ipv6": null,
"manufacturer": "Espressif"
},
{
"ipv4": "/192.168.0.63",
"location": {
"lat": 51.5355157,
"lng": -0.06990350000000944,
"unc": 0.15017592508191352,
"x": [],
"y": []
},
"seenTime": "2016-09-12T11:12:43Z",
"ssid": ".interwebs",
"os": null,
"clientMac": "18:fe:34:e1:b4:7a",
"seenEpoch": 1473678763,
"rssi": 56,
"ipv6": null,
"manufacturer": "Espressif"
},
{
"ipv4": "/192.168.0.92",
"location": {
"lat": 51.5355157,
"lng": -0.06990350000000944,
"unc": 0.11086029498053862,
"x": [],
"y": []
},
"seenTime": "2016-09-12T11:12:41Z",
"ssid": ".interwebs",
"os": null,
"clientMac": "18:fe:34:ce:a1:6d",
"seenEpoch": 1473678761,
"rssi": 55,
"ipv6": null,
"manufacturer": "Espressif"
},
{
"ipv4": null,
"location": {
"lat": 51.5355157,
"lng": -0.06990350000000944,
"unc": 43.562546906687274,
"x": [],
"y": []
},
"seenTime": "2016-09-12T11:11:40Z",
"ssid": null,
"os": null,
"clientMac": "54:e4:3a:7f:ad:af",
"seenEpoch": 1473678700,
"rssi": 21,
"ipv6": null,
"manufacturer": "Apple"
},
{
"ipv4": "/192.168.0.69",
"location": {
"lat": 51.5355157,
"lng": -0.06990350000000944,
"unc": 0.602243927869146,
"x": [],
"y": []
},
"seenTime": "2016-09-12T11:12:00Z",
"ssid": ".interwebs",
"os": null,
"clientMac": "18:fe:34:ed:8b:ea",
"seenEpoch": 1473678720,
"rssi": 62,
"ipv6": null,
"manufacturer": "Espressif"
},
{
"ipv4": "/192.168.0.38",
"location": {
"lat": 51.5355157,
"lng": -0.06990350000000944,
"unc": 1.847465525637238,
"x": [],
"y": []
},
"seenTime": "2016-09-12T11:11:51Z",
"ssid": ".interwebs",
"os": null,
"clientMac": "18:fe:34:fc:5a:7f",
"seenEpoch": 1473678711,
"rssi": 43,
"ipv6": null,
"manufacturer": "Espressif"
}
]
}
}