Feature Request: Public APIs for Third-Party Integrations and Mobile Apps

[jgjimenezs (Jose G Jimenez S)]

Have you considered developing a comprehensive public API for NethServer? This could enable:

1. Third-party integrations (monitoring tools, custom dashboards, backup systems)
2. Mobile applications for on-the-go server management
3. Custom automation scripts and external service connectivity
4. Developer ecosystem growth around the NethServer platform

Key benefits would include:
Remote management capabilities
Custom reporting/alerting systems
Integration with existing IT workflows
Enhanced flexibility without compromising security

I believe this could significantly expand NethServer’s versatility while maintaining its user-friendly core. What are your thoughts on API development priorities and potential use cases?

[giacomo (Giacomo Sanchietti)]

All NethServer APIs are already public.

To use them:

• login with curl to the cluster-admin with an admin (you can create one just for the automation)
• use the obtained JWT token to call the APIs

More info here: API server | NS8 dev manual

[jgjimenezs (Jose G Jimenez S)]

Thanks @giacomo I am going to develop a mobile app to monitor the server and its logs among others, I will read the manual. I am returning to support, anxiety is affecting my health and I must keep my mind busy.

[jgjimenezs (Jose G Jimenez S)]

Bro @giacomo how are you? I’m tweaking the app to display the JSON output from cluster/tasks in cards. I’d like to know since I can’t find the endpoints for the APIs. I only know that I can use tasks from these modules:

node/1/
module/metrics1/
module/traefik1/
module/loki1/
module/nethsecurity-controller2/
module/ldapproxy1/
cluster/

But as I install packages, it will increase. Is there a task manager that shows me this data? I want to add some data management to the app, such as restarting services, an SSH window for console administration, but some or all of them can be done from the app.

The app will initially be in English.

I’m looking at swagger.json to see the endpoints.

My problem is anxiety. My glasses bother me and make me dizzy. Sometimes I skip information I’m looking for until I rest.

If you have more research options, I’d appreciate it.

[jgjimenezs (Jose G Jimenez S)]

I’m running tests in Postman to create a user.

{
“action”: “cluster/add-user”,
“data”: {
“user”: “jose_admin”,
“password_hash”: " 0122fc300816170f44023c80f1ed0e581a313bda0e838271f48c2e8a674b0bc8",
“set”: {
“display_name”: “Jose Administrator 2”,
“2fa”: false
},
“grant”: [
{
“role”: “owner”,
“on”: “*”
}
]
}
}

It returns

{
“code”: 403,
“data”: null,
“message”: “you don’t have permission to access this resource”
}

I have attached the login token but I get that error

[jgjimenezs (Jose G Jimenez S)]

sorry my mistake is “action”: “add-user”,

[jgjimenezs (Jose G Jimenez S)]

An Invitation to Test the NethServer 8 Client APK (Alpha)

Hey NethServer Community,

I’m excited to announce that I’ve been working on an Android APK client for NethServer 8, and I’m ready to invite you to try out its alpha phase!

This early version is still under development, but it’s fully operational for some core functionalities:

• Login
• Add Servers to Connect
• Logout

If you manage multiple NethServer 8 instances, I’d really appreciate it if you could register them within the app and verify that they connect without any issues.

Your feedback is incredibly valuable as I continue to develop this client. Please let me know what you think, any bugs you find, or features you’d love to see.

Thanks for your support!

21.21 MB file on MEGA

I have added a node, check if you have more than one node and if it shows the corresponding information, update to English, it needs to be implemented in the user module and enable modifying user data

[mrmarkuz (Markus Neuberger)]

Login, adding servers and logout worked.

The dashboard shows an error:

[jgjimenezs (Jose G Jimenez S)]

Yes, I wanted to show the statuses from the dashboard, but I’ll do it from the menu. I’m working on it. Just like the user panel, I’ll add a change password and log out immediately to get a new token.

[jgjimenezs (Jose G Jimenez S)]

How are you, brother? Can you tell me if I’m right? When I create a user on the NethServer website, I enter a plain text password, and the system internally generates a hash-256?

[mrmarkuz (Markus Neuberger)]

You’re right, see ns8-core/core/imageroot/usr/local/sbin/add-user at 5b367970005730d829e16b5219727395e50a64d7 · NethServer/ns8-core · GitHub

[jgjimenezs (Jose G Jimenez S)]

Thanks @mrmarkuz I should be active, but sometimes anxiety gets the better of me and I stop seeing things. It’s not that I’m blind but I just overlook them.

[jgjimenezs (Jose G Jimenez S)]

@giacomo I am creating the module to create a repository, but I have realized that when I run a process from the API on the server it shows me like this

but from the server it shows me like this

Am I missing some command to display it correctly?

{
“action”: “add-repository”,
“data”:{“name”:“nethforge”,“status”:false,“url”:“https://forge.nethserver.org/ns8/updates/”}
}

[jgjimenezs (Jose G Jimenez S)]

Changes made in the new version: the user panel can now change the password and validate whether it’s satisfactory or invalid. Another item called Settings has been added to the menu, which will be worked on. If the user changes their password, an automatic logout will be performed to revoke the token. In the next version, security and length validations will be added to the password.

I’ll be resting. I’ve been sick since yesterday. Apparently, I have admidaitis. As soon as I feel better, I’ll be working and applying changes. I’ll create a repository on GitHub and post it on Ko-Fi to avoid cluttering the topic.

The Mega link is updated to the latest APK. If you could tell me if your servers have more than one node and that the information is displayed correctly, I’d appreciate it.

[mrmarkuz (Markus Neuberger)]

Get well soon.

I tested to connect to 2 Nethservers but this time the dashboard shows nothing, just a blank screen.
I tried removing/reinstalling the app but it didn’t help.

[jgjimenezs (Jose G Jimenez S)]

By clicking on the nodes menu you will get the nodes, nothing will appear on the dashboard for now

[mrmarkuz (Markus Neuberger)]

Thanks, now I got it, I didn’t find the menu

The nodes are shown:

The values are correct except of the status…

[jgjimenezs (Jose G Jimenez S)]

If I missed also adjust that value, thanks for sharing, I forgot to say that moving from left to right will make the menu appear, sorry.

[jgjimenezs (Jose G Jimenez S)]

@giacomo Brother, I’ll be following my project on GitHub. If you’d like to support me there with your advice and guidance, I’d be grateful. I’ll leave you alone. I don’t want to feel any worse than I’m already experiencing.

[giacomo (Giacomo Sanchietti)]

@jgjimenezs

I am creating the module to create a repository, but I have realized that when I run a process from the API on the server it shows me like this

You can passa a flag to the API.
IIRC it should be: "isNotificationHidden": True