Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/salrashid123/terraform-provider-http-full
Terraform HTTP provider with mTLS and JSON POST support
https://github.com/salrashid123/terraform-provider-http-full
http terraform
Last synced: about 2 months ago
JSON representation
Terraform HTTP provider with mTLS and JSON POST support
- Host: GitHub
- URL: https://github.com/salrashid123/terraform-provider-http-full
- Owner: salrashid123
- License: apache-2.0
- Created: 2021-08-13T17:03:04.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-06-11T11:32:11.000Z (7 months ago)
- Last Synced: 2024-06-19T04:02:35.496Z (7 months ago)
- Topics: http, terraform
- Language: Go
- Homepage:
- Size: 95.7 KB
- Stars: 13
- Watchers: 4
- Forks: 4
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
Terraform Provider for HTTP mTLS and POST Dataources
=======================================
This provider is a copy/fork of Terraforms [http Provider](https://registry.terraform.io/providers/hashicorp/http/latest/docs/data-sources/http) except that this support HTTP `GET|POST|PUT|DELETE|PATCH` and `mTLS`.
thats all.
- Website: https://www.terraform.io
- [](https://gitter.im/hashicorp-terraform/Lobby)
Maintainers
-----------
This provider plugin is maintained by the sal, just sal for now.
Requirements
------------
- [Terraform](https://www.terraform.io/downloads.html) 0.14.x+
- [Go](https://golang.org/doc/install) 1.17 (to build the provider plugin)
Usage
---------------------
This provider is published here:
* [https://registry.terraform.io/providers/salrashid123/http-full/latest](https://registry.terraform.io/providers/salrashid123/http-full/latest)
```hcl
terraform {
required_providers {
http-full = {
source = "salrashid123/http-full"
}
}
}
provider "http-full" {}
# HTTP POST
data "http" "example" {
provider = http-full
url = "https://httpbin.org/post"
method = "POST"
request_headers = {
content-type = "application/json"
}
request_body = jsonencode({
foo = "bar",
bar = "bar"
})
}
output "data" {
value = jsondecode(data.http.example.response_body)
}
```
```hcl
# mTLS
data "http" "example" {
provider = http-full
url = "https://localhost:8081/get"
method = "GET"
ca = file("${path.module}/../certs/CA_crt.pem")
client_crt = file("${path.module}/../certs/client.crt")
client_key = file("${path.module}/../certs/client.key")
}
```
You can also use this to interact with an [STS server](https://github.com/salrashid123/sts_server) to get any auth token.
```hcl
data "http" "sts" {
provider = http-full
url = "https://stsserver-3kdezruzua-uc.a.run.app/token"
method = "POST"
request_headers = {
content-type = "application/json"
}
request_body = jsonencode({
grant_type = "urn:ietf:params:oauth:grant-type:token-exchange",
resource = "grpcserver-3kdezruzua-uc.a.run.app",
audience = "grpcserver-3kdezruzua-uc.a.run.app",
requested_token_type = "urn:ietf:params:oauth:token-type:access_token",
subject_token = "iamtheeggman",
subject_token_type = "urn:ietf:params:oauth:token-type:access_token"
})
}
output "sts_token" {
value = jsondecode(data.http.sts.response_body).access_token
}
```
The default mode will be POST with `application/json`. To POST as `application/x-www-form-urlencoded`:
```hcl
data "http" "example_form" {
provider = http-full
url = "https://httpbin.org/post"
method = "POST"
request_headers = {
content-type = "application/x-www-form-urlencoded"
}
request_body = "foo=bar&bar=bar"
}
```
For mTLS and other configurations, see [example/index.md](blob/main/docs/index.md)
Building the DEV Provider
---------------------
Clone repository to: `$GOPATH/src/github.com/salrashid123/terraform-provider-http-full
```sh
mkdir -p $GOPATH/src/github.com/terraform-providers
cd $GOPATH/src/github.com/terraform-providers
git clone https://github.com/salrashid123/terraform-provider-http-full.git
```
Enter the provider directory and build the provider
```sh
cd $GOPATH/src/github.com/terraform-providers/terraform-provider-http-full
make fmt
make build
```
Using the DEV provider
----------------------
Copy the provider to your directory
```bash
mkdir -p ~/.terraform.d/plugins/registry.terraform.io/salrashid123/http-full/5.0.0/linux_amd64/
cp $GOBIN/terraform-provider-http-full ~/.terraform.d/plugins/registry.terraform.io/salrashid123/http-full/5.0.0/linux_amd64/terraform-provider-http-full_v5.0.0
```
Then
```bash
cd example
terraform init
terraform apply
```
with
```hcl
terraform {
required_providers {
http-full = {
source = "registry.terraform.io/salrashid123/http-full"
version = "~> 5.0.0"
}
}
}
provider "http-full" {
}
data "http" "example" {
provider = http-full
url = "https://httpbin.org/post"
method = "POST"
request_headers = {
content-type = "application/json"
}
request_body = jsonencode({
foo = "bar"
bar = "bar"
})
}
output "data" {
value = jsondecode(data.http.example.response_body)
}
```
...
In order to test the provider, you can simply run `make test`.
### TEST
```sh
$ make test
```