@ismaillowkey/node-red-contrib-configpass 0.2.0

Node-RED palette node to get the running Node-RED project folder path

npm install @ismaillowkey/node-red-contrib-configpass

@ismaillowkey/node-red-contrib-configpass

English | Bahasa Indonesia

---

English

A Node-RED palette package for Node-RED project utility & configuration management. It includes features for retrieving folder paths, hashing passwords, controlling Admin Editor & Dashboard Password, managing PM2 processes (pm2 list & pm2 action), and obtaining network IP & Gateway information (get ip).

Nodes List in Palette

Category / Main Palette: Additional

---

1. get path node-red

Gets path folder information of the currently running Node-RED project.

Output (msg.payload)

An object containing:

• userDir: Node-RED user directory path (e.g., C:\Users\username\.node-red)
• cwd: Current working directory of the Node-RED process
• projectDir: Active project directory path (if Node-RED Projects feature is enabled)
• flowFile: Name of the active flow file
• settingsFile: The settings.js file path used by Node-RED

---

2. generate hash pw

Hashes a password. By default, it generates a bcrypt (8 salt rounds) hash which is 100% compatible with Node-RED's built-in command node-red admin hash-pw and adminAuth settings in settings.js.

Node Configuration

• Input Password: Input message property (default: msg.payload)
• Output Hash: Output message property (default: msg.payload)
• Algorithm: bcrypt (default 8 salt rounds), sha256, sha512, md5, sha1
• Salt Rounds: Number of salt rounds for bcrypt (default: 8)

---

3. admin editor

Enables or disables the Node-RED Admin Editor automatically by updating the settings.js file. When enabled, password protection is mandatory.

Node Configuration

• Action: Enable Admin Editor / Disable Admin Editor
• Password Auth: Enter Directly in Node / Via msg.payload / msg.password
• Username: Admin username (default: admin)
• Admin Path: Editor root path when enabled (default: /)

Output Format (msg.payload)

{
  "status": true,
  "message": "please restart node-red"
}

---

4. disable/enable dashboard password (or set pass dashboard flowfuse)

Enables or disables password protection on Node-RED Dashboard / FlowFuse Dashboard by configuring the httpNodeAuth option in settings.js.

Node Configuration

• Action: Enable Dashboard Password / Disable Dashboard Password
• Password Auth: Enter Directly in Node / Via msg.payload / msg.password
• Username: Dashboard username (default: user)

Output Format (msg.payload)

{
  "status": true,
  "message": "please restart node-red"
}

---

5. pm2 list

Retrieves a list of currently running PM2 processes with their ID, Name, CPU usage, and Memory usage.

Output Format (msg.payload)

{
  "status": true,
  "message": "success",
  "data": [
    {
      "id": 0,
      "name": "my-app",
      "cpu": 0.5,
      "memory": 24538112,
      "status": "online"
    }
  ]
}

---

6. pm2 action

Runs PM2 actions (start, stop, restart) on a specific process based on process ID, Index, or Name.

Output Format (msg.payload)

{
  "status": true,
  "message": "pm2 restart 0 success"
}

---

7. get ip

Retrieves a list of active network interfaces along with their IP Address, Default Gateway, Interface Name, and Password.

Output Format (msg.payload)

{
  "status": true,
  "message": "success",
  "data": [
    {
      "name": "Wi-Fi",
      "ip": "192.168.2.129",
      "gateway": "192.168.2.1",
      "password": ""
    }
  ]
}

---

Local Installation

1. Go to your Node-RED user directory:

   cd ~/.node-red
   

2. Install this local package:

   npm install "D:\DATA\App software bikinan\Node-red\node-red-contrib-configpass"
   

3. Restart Node-RED.

---

Bahasa Indonesia

Package palet Node-RED untuk utilitas manajemen & konfigurasi proyek Node-RED, termasuk path folder, hashing password, pengontrol Admin Editor & Dashboard Password, manajemen proses PM2 (pm2 list & pm2 action), serta informasi IP Address & Gateway jaringan (get ip).

Daftar Node dalam Palette

Kategori / Main Palette: Additional

---

1. get path node-red

Node untuk mendapatkan informasi path folder dari proyek Node-RED yang sedang berjalan.

Output (msg.payload)

Mengeluarkan objek path:

• userDir: Path direktori user Node-RED (misal: C:\Users\username\.node-red)
• cwd: Current working directory dari proses Node-RED
• projectDir: Path direktori proyek yang aktif (jika fitur Node-RED Projects diaktifkan)
• flowFile: Nama file flow yang sedang dibuka
• settingsFile: File settings.js yang digunakan oleh Node-RED

---

2. generate hash pw

Node untuk meng-hash password. Secara default menghasilkan hash bcrypt (8 salt rounds) yang 100% kompatibel dengan perintah bawaan node-red admin hash-pw dan adminAuth pada settings.js.

Konfigurasi Node

• Input Password: Properti pesan input (default: msg.payload)
• Output Hash: Properti pesan output (default: msg.payload)
• Algorithm: bcrypt (default 8 salt rounds), sha256, sha512, md5, sha1
• Salt Rounds: Jumlah salt rounds untuk bcrypt (default: 8)

---

3. admin editor

Node untuk mengaktifkan (enable) atau mematikan (disable) Admin Editor Node-RED secara otomatis melalui file settings.js. Saat di-enable, proteksi password wajib dikonfigurasi.

Konfigurasi Node

• Action: Enable Admin Editor / Disable Admin Editor
• Password Auth: Ketik Langsung di Node / Lewat msg.payload / msg.password
• Username: Username admin (default: admin)
• Admin Path: Path root editor ketika di-enable (default: /)

Format Output (msg.payload)

{
  "status": true,
  "message": "please restart node-red"
}

---

4. disable/enable dashboard password (atau set pass dashboard flowfuse)

Node untuk mengaktifkan (enable) atau mematikan (disable) proteksi password pada Node-RED Dashboard / FlowFuse Dashboard melalui opsi httpNodeAuth pada settings.js.

Konfigurasi Node

• Action: Enable Dashboard Password / Disable Dashboard Password
• Password Auth: Ketik Langsung di Node / Lewat msg.payload / msg.password
• Username: Username dashboard (default: user)

Format Output (msg.payload)

{
  "status": true,
  "message": "please restart node-red"
}

---

5. pm2 list

Node untuk mengambil daftar proses PM2 yang sedang berjalan beserta informasi ID, Nama, CPU usage, dan Memory usage.

Format Output (msg.payload)

{
  "status": true,
  "message": "success",
  "data": [
    {
      "id": 0,
      "name": "my-app",
      "cpu": 0.5,
      "memory": 24538112,
      "status": "online"
    }
  ]
}

---

6. pm2 action

Node untuk menjalankan perintah PM2 (start, stop, restart) pada proses tertentu berdasarkan ID, Index, atau Nama proses.

Format Output (msg.payload)

{
  "status": true,
  "message": "pm2 restart 0 success"
}

---

7. get ip

Node untuk mendapatkan daftar interface jaringan aktif beserta informasi IP Address, Default Gateway, Nama Interface, dan Password.

Format Output (msg.payload)

{
  "status": true,
  "message": "success",
  "data": [
    {
      "name": "Wi-Fi",
      "ip": "192.168.2.129",
      "gateway": "192.168.2.1",
      "password": ""
    }
  ]
}

---

Cara Install Lokal

1. Buka folder .node-red pengguna Anda:

   cd ~/.node-red
   

2. Install package lokal ini:

   npm install "D:\DATA\App software bikinan\Node-red\node-red-contrib-configpass"
   

3. Restart Node-RED.