Use REST API for configure proxy host

[shihab-uddin24]

How it use REST API for configure proxy host. Can it possible?

[erreib]

Hey, I have been investigating solutions for adding custom domain functionality to my hobby project app and came across the possibility of using NGINX Proxy Manager for this purpose. Since I've been using proxy manager for years and already was using it to forward the main domain I thought I'd take a closer look. Basically, it seems like even though there is an API available for use it is undocumented.

Essentially, after a bit of tinkering and feeding the schemas from https://github.com/NginxProxyManager/nginx-proxy-manager/tree/develop/backend/schema to chatGPT, I was able to get a basic integration between the backend of my app and a running instance of the Proxy Manager. I also used Insomnia to learn about how to interact with the API through POST and GET requests.

Essentially, you will need to submit {"identity": "[email protected]", "secret": "yoUrPassWord1!"} to http://nginxaddress:PORT/api/tokens . That will return a Bearer token. If you are in insomnia, you can insert this token via the Auth > bearer token tab. If you're writing a node app like I am you might need to use Axios to first post to get the bearer token, and then another post to actually create a new proxy host.

Hope this helps you get started. Would love to hear how other people are approaching integrating NGINX Proxy Manager into their apps, and whether or not it seems like a good solution at higher scale.

[shlomiassaf]

There's an OpenApi available

http://my:81/api/schema

[gadget78]

FYI you can create a token that will last as long as you want, (so you dont have to keep using you actually password)

[chpego]

FYI you can create a token that will last as long as you want, (so you dont have to keep using you actually password)

How can you do that ?

[kmanwar89]

+1 here - coming back to setting up NPM in my home lab and the tokens currently returning from a POST to {{url/api/tokens}} using a key:value body of : returns a 24 hour lifetime token. I'd love to make this last longer if possible.

[gadget78]

you can request a longer term, like this for EG...

curl "http://192.168.0.100/api/tokens" -H "Content-Type: application/json; charset=UTF-8" --data-raw '{"identity":"[email protected]","secret":"PASSWORD","expiry":"1y"}'

changing that expiry will alter the length ...

[Oneloutre]

I'd like to know too since I'm writing a tool using this API lol
It's really hard to find documentation on it, I guess the best way is to feed ChatGPT with it 😂
Anyway, lemme know if you find something interesting please
Regards,

[kmanwar89]

ChatGPT failed me (initially, at least) - there is no "access" sidebar? ChatGPT response below:

To request a 30 day access token for nginx proxy manager's API, follow these steps:

1. Log in to your nginx proxy manager dashboard.
2. Navigate to the "Access" tab in the sidebar menu.
3. Click on the "API Tokens" section.
4. Click on the "Create" button to generate a new access token.
5. In the popup window, enter a name for the token and select the desired expiration date (in this case, choose 30 days).
6. Click on the "Create" button to generate the access token.
7. Copy the generated access token and store it in a secure location.
8. You can now use this token to authenticate your API requests for the next 30 days.

Note: Make sure to keep your access token secure and do not share it with anyone else. It is recommended to regenerate the token after it expires for security purposes.

[gadget78]

#3265 (reply in thread)

[kmanwar89]

Thank you! This isn't documented anywhere that I can find (at least not in the schema obtained from mynpmurl.com/api/schema -- how'd you find this tidbit?

[kmanwar89]

I was able to test this out and had success with a few different values:

1d
3m
10y

I'm not sure if you can (or would even want to) request a shorter-lived API token; maybe that might be useful for some sort of CI/CD pipeline, but this certainly meets my needs. I've used this to create an API-only user with limited permissions, so I'm very happy. Thanks again for sharing this tidbit of knowledge!

[Erreur32]

i have done a bash script for that ;)

Verify and manage token validation and also managing NPM settings via API

https://github.com/Erreur32/nginx-proxy-manager-API

Let me know ;)

[kmanwar89]

Very nicely done! Much better than the attempt I made to do this (in Python). If you're curious - https://github.com/kmanwar89/nginx_proxy_manager_automation

What I did is make use of a .csv file for bulk-uploads, though it does not feature as many command-line arguments as yours (something I might, one day, eventually, work on :) )

[Erreur32]

Thanks @kmanwar89 .

Your idea is good to have a file locally ;)
This makes me think of adding an NPM backup/restore functionality, to have a file and doing it like you did for export.

Good luck