Regenerate documentation

Author: Ivan De Marino

docs/data-sources/certificate.md

@@ -3,14 +3,14 @@ page_title: "tls_certificate Data Source - terraform-provider-tls"
 subcategory: ""
 description: |-
   Get information about the TLS certificates securing a host.
-  Use this data source to get information, such as SHA1 fingerprint or serial number, about the TLS certificates that protects an HTTPS website.
+  Use this data source to get information, such as SHA1 fingerprint or serial number, about the TLS certificates that protects a URL.
 ---
 
 # tls_certificate (Data Source)
 
 Get information about the TLS certificates securing a host.
 
-Use this data source to get information, such as SHA1 fingerprint or serial number, about the TLS certificates that protects an HTTPS website.
+Use this data source to get information, such as SHA1 fingerprint or serial number, about the TLS certificates that protects a URL.
 
 ## Example Usage
 

docs/index.md

@@ -70,6 +70,57 @@ resource "aws_iam_server_certificate" "example" {
 }
 ```
 
+### Configuring Proxy
+
+```terraform
+# This example fetches the TLS certificate chain
+# from `example.com` using an HTTP Proxy.
+
+provider "tls" {
+  proxy {
+    url = "https://corporate.proxy.service"
+  }
+}
+
+data "tls_certificate" "test" {
+  url = "https://example.com"
+}
+```
+
+```terraform
+# This example fetches the TLS certificate chain
+# from `example.com` using an HTTP Proxy.
+# The Proxy is discovered via environment variables:
+# see https://pkg.go.dev/net/http#ProxyFromEnvironment for details.
+
+provider "tls" {
+  proxy {
+    from_env = true
+  }
+}
+
+data "tls_certificate" "test" {
+  url = "https://example.com"
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Optional
+
+- `proxy` (Block List, Max: 1) Proxy used by resources and data sources that connect to external endpoints. (see [below for nested schema](#nestedblock--proxy))
+
+<a id="nestedblock--proxy"></a>
+### Nested Schema for `proxy`
+
+Optional:
+
+- `from_env` (Boolean) When `true` the provider will discover the proxy configuration from environment variables. This is based upon [`http.ProxyFromEnvironment`](https://pkg.go.dev/net/http#ProxyFromEnvironment) and it supports the same environment variables (default: `true`).
+- `password` (String, Sensitive) Password used for Basic authentication against the Proxy.
+- `url` (String) URL used to connect to the Proxy. Accepted schemes are: `http`, `https`, `socks5`.
+- `username` (String) Username (or Token) used for Basic authentication against the Proxy.
+
 ## Limitations
 
 ### `ECDSA` with `P224` elliptic curve

examples/provider/provider_with_proxy.tf

@@ -0,0 +1,12 @@
+# This example fetches the TLS certificate chain
+# from `example.com` using an HTTP Proxy.
+
+provider "tls" {
+  proxy {
+    url = "https://corporate.proxy.service"
+  }
+}
+
+data "tls_certificate" "test" {
+  url = "https://example.com"
+}

examples/provider/provider_with_proxy_from_env.tf

@@ -0,0 +1,14 @@
+# This example fetches the TLS certificate chain
+# from `example.com` using an HTTP Proxy.
+# The Proxy is discovered via environment variables:
+# see https://pkg.go.dev/net/http#ProxyFromEnvironment for details.
+
+provider "tls" {
+  proxy {
+    from_env = true
+  }
+}
+
+data "tls_certificate" "test" {
+  url = "https://example.com"
+}

templates/index.md.tmpl

@@ -26,6 +26,14 @@ Use the navigation to the left to read about the available resources.
 
 {{ tffile "examples/provider/provider.tf" }}
 
+### Configuring Proxy
+
+{{ tffile "examples/provider/provider_with_proxy.tf" }}
+
+{{ tffile "examples/provider/provider_with_proxy_from_env.tf" }}
+
+{{ .SchemaMarkdown | trimspace }}
+
 ## Limitations
 
 ### `ECDSA` with `P224` elliptic curve