Howto: Use serverinfo with curl

German below…

if you are wondering how exactly the external monitoring tool works to monitor the Nextcloud, then see the following step by step guide:

Generate a random password:

user@server:~$ openssl rand -hex 32
f65578a77feb8ba2ce584f15f50718fa2a4a94465748fb433a4f1b475a11acc8

Set token for serverinfo:

user@server:/var/www/html$ ./occ config:app:set serverinfo token --value f65578a77feb8ba2ce584f15f50718fa2a4a94465748fb433a4f1b475a11acc8
Config value token for app serverinfo set to f65578a77feb8ba2ce584f15f50718fa2a4a94465748fb433a4f1b475a11acc8

Query with curl:

user@client:~$ curl -H 'NC-Token: f65578a77feb8ba2ce584f15f50718fa2a4a94465748fb433a4f1b475a11acc8' -X GET https://your.nextcloud.com/ocs/v2.php/apps/serverinfo/api/v1/info
Output
<?xml version="1.0"?>
<ocs>
 <meta>
  <status>ok</status>
  <statuscode>200</statuscode>
  <message>OK</message>
 </meta>
 <data>
  <nextcloud>
   <system>
[...]

If you want to delete the token:

user@server:/var/www/html$ ./occ config:app:delete serverinfo token
Config value token of app serverinfo deleted


DEUTSCH:

Wenn du dich wunderst, wie genau man das mit dem NC-Token im Externen Überwachungsprogramm macht um die Nextcloud überwachen zu können, dann folgt hier eine kurze Anleitung:

Zufälliges Passwort generieren:

user@server:~$ openssl rand -hex 32
f65578a77feb8ba2ce584f15f50718fa2a4a94465748fb433a4f1b475a11acc8

Token für Serverinfo festlegen:

user@server:/var/www/html$ ./occ config:app:set serverinfo token --value f65578a77feb8ba2ce584f15f50718fa2a4a94465748fb433a4f1b475a11acc8
Config value token for app serverinfo set to f65578a77feb8ba2ce584f15f50718fa2a4a94465748fb433a4f1b475a11acc8

Abfrage mit curl:

user@client:~$ curl -H 'NC-Token: f65578a77feb8ba2ce584f15f50718fa2a4a94465748fb433a4f1b475a11acc8' -X GET https://your.nextcloud.com/ocs/v2.php/apps/serverinfo/api/v1/info
Output
<?xml version="1.0"?>
<ocs>
 <meta>
  <status>ok</status>
  <statuscode>200</statuscode>
  <message>OK</message>
 </meta>
 <data>
  <nextcloud>
   <system>
[...]

Falls du den Token wieder zu löschen möchtest:

user@server:/var/www/html$ ./occ config:app:delete serverinfo token
Config value token of app serverinfo deleted


To let you search for any of those lines of the serverinfo app:

Summary

External monitoring tool

You can connect an external monitoring tool by using this end point:
https://your.nextcloud.com/ocs/v2.php/apps/serverinfo/api/v1/info

Appending “?format=json” at the end of the URL gives you the result in JSON.

To use an access token, please generate one then set it using the following command:

occ config:app:set serverinfo token --value yourtoken

Then pass the token with the “NC-Token” header when querying the above URL.

Damit dieser Beitrag gefunden werden kann:

Zusammenfassung

Externes Überwachungsprogramm

Durch Verwendung des folgenden Zugangspunktes kann ein externes Überwachungsprogramm verwendet werden:
https://your.nextcloud.com/ocs/v2.php/apps/serverinfo/api/v1/info

Wenn du “?format=json” am Ende der URL anhängst, erhältst du das Ergebnis in JSON.

Um ein Zugriffstoken zu verwenden, generiere bitte ein Token und lege es mit dem folgenden Befehl fest:

occ config:app:set serverinfo token --value yourtoken

Übergib dann das Token mit dem “NC-Token”-Header bei der Abfrage der obigen URL.

2 Likes