https://github.com/jnatten/acurl
A simple authentication wrapper for cURL
https://github.com/jnatten/acurl
auth0 authentication curl jwt python token-authetication
Last synced: 3 months ago
JSON representation
A simple authentication wrapper for cURL
- Host: GitHub
- URL: https://github.com/jnatten/acurl
- Owner: jnatten
- Created: 2018-07-05T12:39:10.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2023-10-09T21:01:18.000Z (over 1 year ago)
- Last Synced: 2023-10-09T22:22:27.355Z (over 1 year ago)
- Topics: auth0, authentication, curl, jwt, python, token-authetication
- Language: Python
- Size: 12.7 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# acurl 🔓
A simple authentication wrapper for cURL
## Usage
Usage is exactly like curl, with one exception.
If the first argument equals one of the blocks in the config file, it will not be sent to curl, but rather load the configuration.
- `acurl ` will use default configuration.
- `acurl test ` will use default + test configuration.
#### Example:
acurl test https://example.com/ -iXPOST -H 'Content-Type: application/json' -d '{"x": 10}'
## Configuration
acurl requires a config at `~/.config/acurl/config.json` with a few fields.
Currently only json responses are supported.
Here is an example where we fetch tokens from auth0:
```javascript
{
"default": {
"authorization_url": "https://example.eu.auth0.com/oauth/token",
"request_body": {
"grant_type": "client_credentials",
"client_id": "default_client_id",
"client_secret": "default_client_secret",
"audience": "api_identifier"
},
"token_field": "access_token",
"expiration_field": "expires_in"
}
}
```
### Configuration overriding
Any other names than default can be used to override `default` configuration when calling `acurl`.
#### Example:
acurl test https://example.com/ -XPOST -H 'Content-Type: application/json' -d '{"x": 1}'
Will use configuration from `test` block to override.
It will use `test_client_id` and `test_client_secret` in the request body, and still keep all the other settings from the default block (Including other fields in the request body).
```javascript
{
"test": {
"request_body": {
"client_id": "test_client_id",
"client_secret": "test_client_secret"
}
},
"default": {
"authorization_url": "https://example.eu.auth0.com/oauth/token",
"request_body": {
"grant_type": "client_credentials",
"client_id": "default_client_id",
"client_secret": "default_client_secret",
"audience": "api_identifier"
},
"token_field": "access_token",
"expiration_field": "expires_in"
}
}
```