Server Configuration: Difference between revisions

From Bondix Wiki
(Created page with " == Server Commands == ==System Commands== {| class="wikitable" |- | ===shutdown=== Shuts down the client and terminates. | style="width: 40%" | <nowiki>{ "target": "system", "action": "shutdown" }</nowiki> |- | ===set-log=== Enables logging to file or changes output file. {| class="wikitable" |+Parameters |- |file||The filename that the log should be written to. Required. |- |fileMode||can be <code>append</code> or <code>overwrite</code>. Required. |} || <no...")
 
No edit summary
Line 1: Line 1:


== Server Commands ==
== Server Commands ==
{| class="wikitable"
|-
|
=== add-apikey ===
Adds an authentication key to use with the [[Server HTTP Api | HTTP API]].
{| class="wikitable"
|+Parameters
|-
|key||A secret string used to authenticate an API request.
|}
| style="width: 40%" |
<nowiki>{
  "target": "server",
  "action": "add-apikey",
  "key": "a-secret-key"
}</nowiki>
|-
|
=== add-environment===
Adds an environment. Deprecated, you can directly create environments in the web interface instead.
{| class="wikitable"
|+Parameters
|-
|key||A secret string used to authenticate an API request.
|}
| style="width: 40%" |
<nowiki>{
  "target": "server",
  "action": "add-apikey",
  "key": "a-secret-key"
}</nowiki>
|-
|
=== add-http ===
Adds an unencrypted http listener for web interface access.
{| class="wikitable"
|+Parameters
|-
|key||A secret string used to authenticate an API request.
|}
| style="width: 40%" |
<nowiki>{
  "target": "server",
  "action": "add-apikey",
  "key": "a-secret-key"
}</nowiki>
|-
|
=== add-https ===
Adds an authentication key to use with the [[Server HTTP Api | HTTP API]].
{| class="wikitable"
|+Parameters
|-
|key||A secret string used to authenticate an API request.
|}
| style="width: 40%" |
<nowiki>{
  "target": "server",
  "action": "add-apikey",
  "key": "a-secret-key"
}</nowiki>
|-
|
=== add-user ===
Adds an user/password pair that can be used to log into the server's web interface.
{| class="wikitable"
|+Parameters
|-
|user||The username
|password||and password
|}
| style="width: 40%" |
<nowiki>{
  "target": "server",
  "action": "add-user",
  "user": "admin",
  "password": "bad password"
}</nowiki>
|-
|
=== set-fallback-watchdog ===
{| class="wikitable"
|+Parameters
|-
|user||The username
|}
| style="width: 40%" |
<nowiki>{
  "target": "server",
  "action": ""
}</nowiki>
|-
|
=== slow-shutdown ===
{| class="wikitable"
|+Parameters
|-
|user||The username
|}
| style="width: 40%" |
<nowiki>{
  "target": "server",
  "action": ""
}</nowiki>
|-
|
=== set-password-authentication ===
{| class="wikitable"
|+Parameters
|-
|user||The username
|}
| style="width: 40%" |
<nowiki>{
  "target": "server",
  "action": ""
}</nowiki>
|-
|
=== set-web-login ===
{| class="wikitable"
|+Parameters
|-
|user||The username
|}
| style="width: 40%" |
<nowiki>{
  "target": "server",
  "action": ""
}</nowiki>
|-
|
=== enable-demo ===
{| class="wikitable"
|+Parameters
|-
|user||The username
|}
| style="width: 40%" |
<nowiki>{
  "target": "server",
  "action": ""
}</nowiki>
|}


==System Commands==
==System Commands==
Line 14: Line 165:
  }</nowiki>
  }</nowiki>
|-
|-
|
|
===set-log===
===set-log===

Revision as of 15:25, 14 October 2022

Server Commands

add-apikey

Adds an authentication key to use with the HTTP API.

Parameters
key A secret string used to authenticate an API request.
{
   "target": "server", 
   "action": "add-apikey",
   "key": "a-secret-key"
 }

add-environment

Adds an environment. Deprecated, you can directly create environments in the web interface instead.

Parameters
key A secret string used to authenticate an API request.
{
   "target": "server", 
   "action": "add-apikey",
   "key": "a-secret-key"
 }

add-http

Adds an unencrypted http listener for web interface access.

Parameters
key A secret string used to authenticate an API request.
{
   "target": "server", 
   "action": "add-apikey",
   "key": "a-secret-key"
 }

add-https

Adds an authentication key to use with the HTTP API.

Parameters
key A secret string used to authenticate an API request.
{
   "target": "server", 
   "action": "add-apikey",
   "key": "a-secret-key"
 }

add-user

Adds an user/password pair that can be used to log into the server's web interface.

Parameters
user The username password and password
{
   "target": "server", 
   "action": "add-user",
   "user": "admin",
   "password": "bad password"
 }

set-fallback-watchdog

Parameters
user The username
{
   "target": "server", 
   "action": ""
 }

slow-shutdown

Parameters
user The username
{
   "target": "server", 
   "action": ""
 }

set-password-authentication

Parameters
user The username
{
   "target": "server", 
   "action": ""
 }

set-web-login

Parameters
user The username
{
   "target": "server", 
   "action": ""
 }

enable-demo

Parameters
user The username
{
   "target": "server", 
   "action": ""
 }


System Commands

shutdown

Shuts down the client and terminates.

{
   "target": "system", 
   "action": "shutdown"
 }

set-log

Enables logging to file or changes output file.

Parameters
file The filename that the log should be written to. Required.
fileMode can be append or overwrite. Required.
{
   "target": "system", 
   "action": "set-log", 
   "file": "/var/log/saneclient.log", 
   "fileMode": "append"
 }

set-script-path

Changes the directory that points towards the client scripts. (/opt/bondix/client/scripts by default)

Parameters
path Path to the new bondix script directory.
{
   "target": "system", 
   "action": "set-script-path", 
   "path": "/etc/bondix/scripts"
 }

set-webinterface

Enables the integrated webserver & debug webinterface.

Parameters
host IP that the service should listen on. Required.
port TCP Port that the service should listen on. Required.
allowConfig En- or disables web configuration. Not required, enabled by default.
allowMonitor En- or disables web monitor. Not required, enabled by default.
configApiKey The password required to access configuration & monitor. Not required, "123456" by default.
webroot Web root directory. Points to the "www" subdirectory in installation directory. Not required, changing not advised.
{
   "target": "system", 
   "action": "set-webinterface", 
   "host": "0.0.0.0", 
   "port": "80",
   "allowConfig": false, 
   "allowMonitor": true, 
   "configApiKey": "123456", 
   "webroot": "/tmp/"
 }