This package contains an implementation of VICI API from strongswan. This can be used to initiate connections, monitor connected devices, reconfiguration and everything else which the API offers to do.
To use this package, just install it from NPM:
npm install -s strongswan-vici
Or with yarn:
yarn add strongswan-vici
TypeScript types are included in the package and don't have to be installed separately.
To use this library, you have to create an instance of this class:
This instance is now the adapter between your code and the VICI API. See documentation below.
The constructor accepts the following parameter. All of them are optional.
This parameter supports a UNIX or TCP address. Examples:
The number of milliseconds, the API has time to respond. When the timeout has exceeded, the operation with fail with an error. This does not close the connection
The number of milliseconds, until the connection will be closed. When no event is subscribed and no other packets are send or received for a specified time, the connection will be closed. On next operation, the connection will be reestablished automatically.
This method opens the connection.
Note: Calling this method it not necessary. The connection will be established automatically when required.
This method closes an active connection.
Note: This will unsubscribe all events.
This will send a raw packet. Example:
;;await vici.sendPacketPacketType.CMD_REQUEST, 'version';
This method will not be used in normal applications. There are simpler ways to archive a version request.
version(), stats(), reloadSettings()
These methods are sending the corresponding command to the API. Example:
;;;console.log'Daemon version:', version.daemon;
This method performs a command. When a second parameter is give, the value will be used as parameter for the command. Example:
;;;if response.success === 'yes'else
This method subscribes to an event. When the connection is reestablished, the event will be subscribed again. When the event is not known by the API, this method will throw an error.
Note: The connection will not reestablished automatically when lost
This method subscribes a list of events. (See subscribe(event))
This method unsubscribes an event. This method returns a boolean, which indicates if the operation has succeeded.
This method unsubscribes all currently subscribed events. This method returns a boolean, which indicates if all operations has been succeeded.
For more information about the API, look in the documentation from strongswan.
In short: I don't care, just use it.
Copyright 2020 Maximilian Schelbach
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.