Withdraw of the 6.9.2 Release
Unfortunately, due to critical issues identified with version 6.9.2, we have decided to remove it and ensure it's no longer available for download. These issues impacted the ability to install or upgrade but none were security-related. We are diligently working to resolve these issues and are planning to release an updated version 6.9.3 in early May.
What if you've already upgraded?For customers who have already upgraded to 6.9.2, no immediate action is required, as none of these issues are security-related. Once it's available, you will still be able to upgrade to 6.9.3 as normal. We appreciate your patience and trust as we continue to enhance our software to better serve you. Thank you for your understanding.
Authentication
There is process flow for authenticating to Opsview within the Introduction in the Authentication
section
Logging in Copied
URL: /rest/login
GET
— unimplemented.POST
— get session token. Pass in username and password.PUT
— unimplemented.DELETE
— if session token is valid, deletes from session list, effectively a logout.
Note
Theopsview_rest
command will automatically take care of authentication for you without having to post credentials to the login endpoint.
If a token cannot be generated, a 503 HTTP status code will be returned, with the text, “Error creating session token after 5 attempts”.
Example curl
request:
$ curl -H 'Content-Type: application/json' -X 'application/json' -X POST -d '{"username":"admin","password":"initial"}' http://localhost/rest/login
Example response:
{
"token": "7cd5652f7bfde4220211d063c166b263160a7d52"
}
The length of the token is 32 characters.
If you can pass the parameter, include_user_data=1
, a user_data
field will be returned in the response. This will contain the data from the /rest/user
call.
Logging out Copied
URL: /rest/logout
POST
— deletes the session.GET
,PUT
,DELETE
— unimplemented.
Example opsview_rest
request
opsview_rest --username=admin --password=initial --data-format=json --pretty POST logout
Expected response:
{
"logout_via" : "REST API"
}
User information Copied
URL: /rest/user
GET
— returns user information for the currently authenticated user.POST
,PUT
,DELETE
— unimplemented.
This returns information about the user.
See include_user_data=1
in the login
section above for fetching this information via a curl request when authenticating.
Example opsview_rest
request:
$ opsview_rest --token-file /path/to/opsview_restapi_token --pretty GET user
Example response:
{
"access_list": {
"ACTIONALL": 1,
"ADMINACCESS": 1,
"VIEWALL": 1,
...
},
"fullname": "Admin user",
"language": "",
"name": "admin",
"realm": "local",
"role": "Administrator"
}