node-firewalla

Package to talk your firewalla box & API

If you want to get your firewalla token, or want to help reverse engineering firewalla, checkout firewalla-tools

If you like my work, give this repository a ⭐ or consider Buying Me A Coffee ☕

Installation

bash

npm install node-firewalla





Examples

js

import { SecureUtil, NetworkService, FWGroup, FWGroupApi, HostService } from 'node-firewalla'



// Import your public & private key (by file name)

SecureUtil.importKeyPair(publicKeyPath, privateKeyPath)



// Login & get firewalla box

let { groups } = await FWGroupApi.login()

let fwGroup = FWGroup.fromJson(groups[0])



// Send a ping message

let networkService = new NetworkService(fwGroup)

let pingResult = await networkService.ping()



// List all hosts connected to your firewalla

let hostService = new HostService(fwGroup)

let hosts = await hostService.getAll()





Authenticating

First time

To authenticate the first time with your firewalla box, use the create-etp-token script in firewalla-tools.

This will generate a public & private key that you need to keep.



Other times

Now you simply have to use SecureUtil to import your keys.

javascript

import { SecureUtil } from 'node-firewalla'



// using a file name e.g. etp.public.pem

SecureUtil.importKeyPair(publicKeyPath, privateKeyPath)



// using a string e.g. "----BEGIN PUBLIC KEY---- ..."

SecureUtil.importKeyFromString(publicKeyPath, privateKeyPath)





Then to get your firewalla box(es) (a.k.a FWGroup), you will have to login first.

javascript

import { FWGroupApi, FWGroup } from 'node-firewalla'



let { groups } = await FWGroupApi.login()

let fwGroup = FWGroup.fromJson(groups[0], "192.168.1.1")



Currently this package doesn't fully support cloud communication, so you will still have to supply your box's IP like above.



Now you can use all the service classes to your hearts content :)



Services

To use a service, you first have to supply the FWGroup (box) to its constructor, e.g.

javascript

import { AlarmService } from 'node-firewalla'



// Ignore all current alarms

let alarmService = new AlarmService(fwGroup)

let pingResult = await alarmService.ignoreAll()

AlarmService

Manage alarms

$3

---

BoxService

Manage your box

$3

---

FeatureService

Manage features that your box uses

$3

---

HostService

Manage hosts connected to your box

$3

---

InitService

Get initial data of your box

$3

---

NetworkService

Manage your firewalla network

$3

Installation

bash
npm install node-firewalla

Examples

js
import { SecureUtil, NetworkService, FWGroup, FWGroupApi, HostService } from 'node-firewalla'

// Import your public & private key (by file name)
SecureUtil.importKeyPair(publicKeyPath, privateKeyPath)

// Login & get firewalla box
let { groups } = await FWGroupApi.login()
let fwGroup = FWGroup.fromJson(groups[0])

// Send a ping message
let networkService = new NetworkService(fwGroup)
let pingResult = await networkService.ping()

// List all hosts connected to your firewalla
let hostService = new HostService(fwGroup)
let hosts = await hostService.getAll()

Authenticating

First time

To authenticate the first time with your firewalla box, use the create-etp-token script in firewalla-tools.
This will generate a public & private key that you need to keep.

Other times

Now you simply have to use SecureUtil to import your keys.

javascript
import { SecureUtil } from 'node-firewalla'

// using a file name e.g. etp.public.pem
SecureUtil.importKeyPair(publicKeyPath, privateKeyPath)

// using a string e.g. "----BEGIN PUBLIC KEY---- ..."
SecureUtil.importKeyFromString(publicKeyPath, privateKeyPath)

Then to get your firewalla box(es) (a.k.a FWGroup), you will have to login first.

javascript
import { FWGroupApi, FWGroup } from 'node-firewalla'

let { groups } = await FWGroupApi.login()
let fwGroup = FWGroup.fromJson(groups[0], "192.168.1.1")

Currently this package doesn't fully support cloud communication, so you will still have to supply your box's IP like above.

Now you can use all the service classes to your hearts content :)

Services

To use a service, you first have to supply the FWGroup (box) to its constructor, e.g.

javascript
import { AlarmService } from 'node-firewalla'

// Ignore all current alarms
let alarmService = new AlarmService(fwGroup)
let pingResult = await alarmService.ignoreAll()