@server-state/ufw-status-module

0.1.6 • Public • Published

ufw-status-module

Info Value
Repository https://github.com/server-state/ufw-status-module
NPM Package @server-state/ufw-status-module
Package version npm version
CI Build Build Status
Issues GitHub Issues

Abstract

A module for querying the status of a UFW firewall (requires sudo privileges)

This official Server State Server Module belongs to the organization Server State.

Setup

To successfully use this module, you'll need to grant the user executing the command (here, we'll call him nodeUser) sudo (or root) execution rights for the command ufw status. To do this, please add the following server-state-ufw-status-module file to /etc/sudoers.d/:

nodeUser ALL=(ALL) NOPASSWD: /usr/bin/ufw status

Input

Type

undefined

Description

No input is needed for this module

Output

This is using

  • [x] A standard data format as defined in Data Formats
  • [x] A custom data format described below

Custom data format specifications

Type: TableData -compatible

{  
    type: 'ufw-status',
    status: 'active' | 'inactive',
    _fields: string[],
    rows: Array<{
        [_field: string]: string | number | boolean
    }>
}

Specifications about the information in the return variable

n/a

Exceptions (if applicable)

sudo ufw status returned with an exit code other than 0

If sudo ufw status returns with an exit code other than 0, an Error containing the stderr output in its message gets thrown.

Performance

The module performs the tasks in a runtime-complexity of

O(n)

where n is the number of rules in the status (i.e., here, table rows).

Readme

Keywords

none

Package Sidebar

Install

npm i @server-state/ufw-status-module

Weekly Downloads

1

Version

0.1.6

License

MIT

Unpacked Size

13.5 kB

Total Files

6

Last publish

Collaborators

  • fussel178
  • pklaschka
  • server-state-ci