NetXMS WebAPI
This Wiki is deprecated and we are are currrently migrating remaining pages into product documentation (Admin Guide, NXSL Guide) |
The NetXMS WebAPI is being developed to support larger integration possibilities for the NetXMS server and is based on the RESTful philosophy. The API currently supports Grafana integration and external tool authentication which will be described shortly. The NetXMS WebAPI is currently in very early development!
Requirements
- A running instance of the NetXMS server.
- Access to a web server.
- Git tools
- Maven tools
Setup
1. Clone the NetXMS git repository to a folder on your computer.
2. Navigate to
NETXMS_GIT/src/server/nxapisrv/java
3. Run
mvn package
4. Copy the resulting .war file from
/targets/netxms-websvc-2.1-M3.war
to your web server.
5. Create a
nxapisrv.properties
file and place it in the property file location of your web server and specify the NetXMS Server address with the
netxms.server.address=
property. If server is running on non-standard port specify it with
netxms.server.port=
property.
External tool authentication
It is possible to use the NetXMS WebAPI to for authentication in external tools. This can be done by sending a POST request that includes the following JSON data:
{"login":"admin","password":"netxms"}
To the path:
API_HOME/authenticate
The API will return a 200 response if the credentials are correct, a 400 response if either login or password is not provided or 401 if the provided credentials are incorrect.