Comments (2)
My apologies for the lack of documentation, this API is still very much a work in progress and I unfortunately have less time to work on it than I had hoped. Any contributions to documentation would be very much appreciated.
By default, the API will use the same credentials as the pfSense webConfigurator. A client-id
and client-token
must be specified in your payload to authenticate the API call. Your client-id and client-token will differ depending on which auth mode you have set in the General > API settings page within the UI:
- Local database is the default setting. This will allow you to authenticate using the same credentials as an existing UI user. Your
client-id
will be your UI username, and theclient-token
will be your UI password. For example,https://localhost/api/v1/users/?client-id=admin&client-token=pfsense
- Base64 will also allow you to use an existing UI user, but the
client-id
andclient-token
parameters must be Base64 encoded in your payload. For example,https://localhost/api/v1/users/?client-id=YWRtaW4K&client-token=cGZzZW5zZQo
- API Token will allow you to generate unique API tokens that will remain static. You can create an API token by setting the auth mode to API Token within the General > API settings page in the UI. You will need to save the changes, then a button to generate an API token will appear. You should get a dialogue containing the client-token (which will only be displayed once) and your client-id can be found in the API tokens table at the bottom of the page. For example,
https://localhost/api/v1/users/?client-id=61646d696e&client-token=4ef51f460b78cc1ff0d6667b447b3031
Let me know if this allows you to authenticate.
from pfsense-api.
Thank you for the clarification, typically when one reads HTTP Basic auth, the process is performed using that protocol, and can be performed with curl's --username param.
Not sure how pfSense is performing it under the hood. Passing the URL parameters however does work, although this is probably not the most secure method, it does work. - Thank you.
from pfsense-api.
Related Issues (20)
- API authentication JWT does not work with none admin users HOT 1
- /api/v1/firewall/nat/outbound/mapping throws error when no mappings exist
- API version compare returns always "update_available" false HOT 1
- Captive Portal API HOT 2
- Error when updating firewall alias
- Alias description is blank if its the first alias on the list HOT 1
- Put method on /api/v1/user got HTTP 405 error HOT 1
- Be able to create token to an other user from admin
- PUT system/config not working. Unable to write config HOT 5
- bad request 4031 Firewall rule tracker ID required HOT 1
- pfSense API not able to logon to pfSense after upgrade to version 2.7 HOT 2
- /api/v1/firewall/nat/outbound/mapping `target` field no longer works correctly on pfSense 2.7.1
- Plus: Support CARP Unicast mode
- FreeRadius Configuration HOT 1
- Crash report HOT 3
- 2.0.0 package for pfSense 23.09 HOT 1
- Crash in v2.0.0 HOT 3
- pfsense-api environment crash can still submit a post but the gui can't see the result HOT 2
- POST | IPsec Phase2 | "hash-algorithm-option" is required even for GCM Algorithms HOT 1
- OpenVPN Client Enable/Disable HOT 1
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from pfsense-api.