From ace35dc79ee32b74b6040f8e81b94ee95be53b73 Mon Sep 17 00:00:00 2001
From: Omero Saienni <39497847+omerosaienni@users.noreply.github.com>
Date: Thu, 19 Sep 2024 06:42:47 +1200
Subject: [PATCH] Add connection configuration documentation (#131)

* Add new configuration document for connection abuseipdb (#94)

* Add new configuration document for connection alicloud (#95)

* Add new configuration document for connection azure (#97)

* Add new configuration document for connection bitbucket (#98)

* Add new configuration document for connection clickup (#99)

* Add new configuration document for connection datadog (#100)

* Add new configuration document for connection discord (#101)

* Add new configuration document for connection freshdesk (#102)

* Add new configuration document for connection github (#103)

* Add new configuration document for connection gitlab (#104)

* Add new configuration document for connection ip2locationio (#105)

* Add new configuration document for connection ipstack (#106)

* Add new configuration document for connection jira (#107)

* Add new configuration document for connection jumpcloud (#108)

* Add new configuration document for connection mastodon (#109)

* Add new configuration document for connection microsoft_teams (#110)

* Add new configuration document for connection okta (#111)

* Add new configuration document for connection opsgenie (#112)

* Add new configuration document for connection openai (#113)

* Add new configuration document for connection pagerduty (#114)

* Add new configuration document for connection sendgrid (#115)

* Add new configuration document for connection servicenow (#116)

* Add new configuration document for connection slack (#117)

* Add new configuration document for connection turbot_guardrails (#118)

* Add new configuration document for connection turbot_pipes (#119)

* Add new configuration document for connection uptime_robot (#120)

* Add new configuration document for connection urlscan (#121)

* Add new configuration document for connection vault (#122)

* Add new configuration document for connection virus_total (#123)

* Add new configuration document for connection zendesk (#124)

* Add new configuration document for connection pagerduty (#125)

* Add new configuration document for connection aws (#96)

* Add new configuration document for connection gcp (#128)

* Add new configuration document for connection slack (#127)

* Create Index and Template for connection documents (#129)
---
 .../config-files/connection/abuseipdb.md      |  32 ++++++
 .../config-files/connection/alicloud.md       |  55 ++++++++++
 docs/reference/config-files/connection/aws.md |  78 +++++++++++++
 .../config-files/connection/azure.md          |  46 ++++++++
 .../config-files/connection/bitbucket.md      |  44 ++++++++
 .../config-files/connection/clickup.md        |  32 ++++++
 .../config-files/connection/datadog.md        |  37 +++++++
 .../config-files/connection/discord.md        |  38 +++++++
 .../config-files/connection/freshdesk.md      |  35 ++++++
 docs/reference/config-files/connection/gcp.md | 103 ++++++++++++++++++
 .../config-files/connection/github.md         |  38 +++++++
 .../config-files/connection/gitlab.md         |  32 ++++++
 .../config-files/connection/index.md          |  76 +++++++++++++
 .../config-files/connection/ip2locationio.md  |  32 ++++++
 .../config-files/connection/ipstack.md        |  32 ++++++
 .../reference/config-files/connection/jira.md |  38 +++++++
 .../config-files/connection/jumpcloud.md      |  32 ++++++
 .../config-files/connection/mastodon.md       |  24 ++++
 .../reference/config-files/connection/okta.md |  41 +++++++
 .../config-files/connection/openai.md         |  38 +++++++
 .../config-files/connection/opsgenie.md       |  35 ++++++
 .../config-files/connection/pagerduty.md      |  32 ++++++
 .../config-files/connection/pipes.md          |  38 +++++++
 .../config-files/connection/sendgrid.md       |  38 +++++++
 .../config-files/connection/servicenow.md     |  38 +++++++
 .../config-files/connection/slack.md          |  73 +++++++++++++
 .../config-files/connection/teams.md          |  38 +++++++
 .../config-files/connection/template.keep     |  39 +++++++
 .../config-files/connection/trello.md         |  35 ++++++
 .../connection/turbot_guardrails.md           |  44 ++++++++
 .../config-files/connection/uptimerobot.md    |  38 +++++++
 .../config-files/connection/urlscan.md        |  38 +++++++
 .../config-files/connection/vault.md          |  41 +++++++
 .../config-files/connection/virustotal.md     |  32 ++++++
 .../config-files/connection/zendesk.md        |  38 +++++++
 35 files changed, 1480 insertions(+)
 create mode 100644 docs/reference/config-files/connection/abuseipdb.md
 create mode 100644 docs/reference/config-files/connection/alicloud.md
 create mode 100644 docs/reference/config-files/connection/aws.md
 create mode 100644 docs/reference/config-files/connection/azure.md
 create mode 100644 docs/reference/config-files/connection/bitbucket.md
 create mode 100644 docs/reference/config-files/connection/clickup.md
 create mode 100644 docs/reference/config-files/connection/datadog.md
 create mode 100644 docs/reference/config-files/connection/discord.md
 create mode 100644 docs/reference/config-files/connection/freshdesk.md
 create mode 100644 docs/reference/config-files/connection/gcp.md
 create mode 100644 docs/reference/config-files/connection/github.md
 create mode 100644 docs/reference/config-files/connection/gitlab.md
 create mode 100644 docs/reference/config-files/connection/index.md
 create mode 100644 docs/reference/config-files/connection/ip2locationio.md
 create mode 100644 docs/reference/config-files/connection/ipstack.md
 create mode 100644 docs/reference/config-files/connection/jira.md
 create mode 100644 docs/reference/config-files/connection/jumpcloud.md
 create mode 100644 docs/reference/config-files/connection/mastodon.md
 create mode 100644 docs/reference/config-files/connection/okta.md
 create mode 100644 docs/reference/config-files/connection/openai.md
 create mode 100644 docs/reference/config-files/connection/opsgenie.md
 create mode 100644 docs/reference/config-files/connection/pagerduty.md
 create mode 100644 docs/reference/config-files/connection/pipes.md
 create mode 100644 docs/reference/config-files/connection/sendgrid.md
 create mode 100644 docs/reference/config-files/connection/servicenow.md
 create mode 100644 docs/reference/config-files/connection/slack.md
 create mode 100644 docs/reference/config-files/connection/teams.md
 create mode 100644 docs/reference/config-files/connection/template.keep
 create mode 100644 docs/reference/config-files/connection/trello.md
 create mode 100644 docs/reference/config-files/connection/turbot_guardrails.md
 create mode 100644 docs/reference/config-files/connection/uptimerobot.md
 create mode 100644 docs/reference/config-files/connection/urlscan.md
 create mode 100644 docs/reference/config-files/connection/vault.md
 create mode 100644 docs/reference/config-files/connection/virustotal.md
 create mode 100644 docs/reference/config-files/connection/zendesk.md

diff --git a/docs/reference/config-files/connection/abuseipdb.md b/docs/reference/config-files/connection/abuseipdb.md
new file mode 100644
index 0000000..8492868
--- /dev/null
+++ b/docs/reference/config-files/connection/abuseipdb.md
@@ -0,0 +1,32 @@
+---
+title: abuseipdb
+sidebar_label: abuseipdb
+---
+
+# abuseipdb
+
+The `abuseipdb` connection can be used to access AbuseIPDB resources.
+
+```hcl
+connection "abuseipdb" "abuseipdb_api_key" {
+  api_key = "bfc6f1c42dfakefdxxxx26977977b2xxxsfake98f310123456789de0d"
+}
+```
+
+## Arguments
+
+| Name      | Type   | Required? | Description |
+| --------- | ------ | --------- | ----------- |
+| `api_key` | String | Optional  | API Key     |
+
+All arguments are optional, and an `abuseipdb` connection with no arguments will behave the same as the [default connection](#default-connection).
+
+## Default Connection
+
+The `abuseipdb` connection type includes an implicit, default connection (`connection.abuseipdb.default`) that will be configured to set the `api_key` to the `ABUSEIPDB_API_KEY` environment variable.
+
+```hcl
+connection "abuseipdb" "default" {
+  api_key = env("ABUSEIPDB_API_KEY")
+}
+```
diff --git a/docs/reference/config-files/connection/alicloud.md b/docs/reference/config-files/connection/alicloud.md
new file mode 100644
index 0000000..6a0ab0b
--- /dev/null
+++ b/docs/reference/config-files/connection/alicloud.md
@@ -0,0 +1,55 @@
+---
+title: alicloud
+sidebar_label: alicloud
+---
+
+# alicloud
+
+The `alicloud` connection can be used to access Alibaba Cloud resources.
+
+```hcl
+connection "alicloud" "alicloud" {
+   access_key = "LTAI4GBVFakeKey09Kxezv66"
+   secret_key = "6iNPvThisIsNotARealSecretk1sZF"
+}
+```
+
+## Arguments
+
+| Name         | Type   | Required? | Description                                 |
+| ------------ | ------ | --------- | ------------------------------------------- |
+| `access_key` | String | Optional  | A static access key to use to authenticate. |
+| `secret_key` | String | Optional  | A static secret key to use to authenticate. |
+
+All arguments are optional, and a `alicloud` connection with no arguments will behave the same as the [default connection](#default-connection).
+
+## Default Connection
+
+The `alicloud` connection type includes an implicit, default connection (`connection.alicloud.default`) that will be configured using either of the following environment variables:
+
+1.`ALIBABACLOUD_ACCESS_KEY_ID` and `ALIBABACLOUD_ACCESS_KEY_SECRET`.
+
+```hcl
+connection "alicloud" "default" {
+   access_key = env("ALIBABACLOUD_ACCESS_KEY_ID")
+   secret_key = env("ALIBABACLOUD_ACCESS_KEY_SECRET")
+}
+```
+
+2.`ALICLOUD_ACCESS_KEY_ID` and `ALICLOUD_ACCESS_KEY_SECRET`.
+
+```hcl
+connection "alicloud" "default" {
+   access_key = env("ALICLOUD_ACCESS_KEY_ID")
+   secret_key = env("ALICLOUD_ACCESS_KEY_SECRET")
+}
+```
+
+3.`ALICLOUD_ACCESS_KEY` and `ALICLOUD_SECRET_KEY`.
+
+```hcl
+connection "alicloud" "default" {
+   access_key = env("ALICLOUD_ACCESS_KEY")
+   secret_key = env("ALICLOUD_SECRET_KEY")
+}
+```
diff --git a/docs/reference/config-files/connection/aws.md b/docs/reference/config-files/connection/aws.md
new file mode 100644
index 0000000..c4b3678
--- /dev/null
+++ b/docs/reference/config-files/connection/aws.md
@@ -0,0 +1,78 @@
+---
+title: aws
+sidebar_label: aws
+---
+
+# aws
+
+The `aws` connection can be used to access Amazon Web Services resources.
+
+```hcl
+connection "aws" "my_connection" {
+  profile = "aws-account-01"
+}
+```
+
+## Arguments
+
+| Name            | Type   | Required? | Description                                                                                                                |
+| --------------- | ------ | --------- | -------------------------------------------------------------------------------------------------------------------------- |
+| `profile`       | String | Optional  | The [AWS Profile](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html) to use to obtain connections. |
+| `access_key`    | String | Optional  | A static AWS access key to use to authenticate.                                                                            |
+| `secret_key`    | String | Optional  | A static AWS secret key to use to authenticate.                                                                            |
+| `session_token` | String | Optional  | A static AWS session token to use to authenticate. This is only used if you specify `access_key` and `secret_key`.         |
+| `ttl`           | Number | Optional  | The time, in seconds, to cache the connections. By default, the AWS connection will be cached for 5 minutes.               |
+
+All arguments are optional, and an `aws` connection with no arguments will behave the same as the [AWS default connection](#default-connection). You may instead specify exactly one of:
+
+- `profile`
+- `access_key` and `secret_key` (and optionally `session_token`)
+
+## Attributes (Read-Only)
+
+| Attribute       | Type   | Description                                                                                                                                                                                                                                        |
+| --------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `access_key`    | String | The AWS access key to use to authenticate. If you specified the `access_key` arg, then this is the argument value verbatim. If you have specified `profile`, then this is the resolved temporary access key for that profile.                      |
+| `secret_key`    | String | The AWS secret key to use to authenticate. If you specified the `secret_key` arg, then this is the argument value verbatim. If you have specified `profile`, then this is the resolved temporary secret key for that profile.                      |
+| `session_token` | String | The AWS session token to use to authenticate. If you specified the `session_token` arg, then this is the argument value verbatim. If you have specified `profile`, then this is the resolved temporary session token for that profile.             |
+| `env`           | Map    | A map of the resolved [connection-related environment variables](https://docs.aws.amazon.com/sdk-for-php/v3/developer-guide/guide_connections_environment.html) (`AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`, `AWS_SESSION_TOKEN`, `AWS_PROFILE`) |
+
+## Default Connection
+
+The AWS connection type includes an implicit, default connection (`connection.aws.default`) that will be configured using the same mechanism as the AWS CLI (AWS environment variables, default profile, etc); the effective connections of this default are the same as if you run the `aws` command.
+
+## Examples
+
+### Static Connections
+
+```hcl
+connection "aws" "aws_static" {
+  access_key = "ASIAQGDFAKEKGUI5MCEU"
+  secret_key = "QhLNLGM5MBkXiZm2k2tfake+TduEaCkCdpCSLl6U"
+}
+```
+
+### AWS Profile
+
+```hcl
+connection "aws" "aws_profile" {
+  profile = "awx_prod_01"
+}
+```
+
+### Using AWS Connections in Container Step
+
+```hcl
+pipeline "ex1" {
+  param "connection" {
+    type    = string
+    default = "default"
+  }
+
+  step "container" "aws" {
+    image = "public.ecr.aws/aws-cli/aws-cli"
+    cmd   = [ "s3", "ls" ]
+    env   = connection.aws[param.connection].env
+  }
+}
+```
diff --git a/docs/reference/config-files/connection/azure.md b/docs/reference/config-files/connection/azure.md
new file mode 100644
index 0000000..0a0ecf6
--- /dev/null
+++ b/docs/reference/config-files/connection/azure.md
@@ -0,0 +1,46 @@
+---
+title: azure
+sidebar_label: azure
+---
+
+# azure
+
+The `azure` connection can be used to access Azure resources.
+
+```hcl
+connection "azure" "azure_connection" {
+  tenant_id       = "YourTenantID"
+  client_secret   = "YourClientSecret"
+  client_id       = "YourClientID"
+}
+```
+
+## Arguments
+
+| Name            | Type   | Required? | Description                                                                                                     |
+| --------------- | ------ | --------- | --------------------------------------------------------------------------------------------------------------- |
+| `tenant_id`     | String | Optional  | The Microsoft Entra tenant (directory) ID.                                                                      |
+| `client_id`     | String | Optional  | The client (application) ID of an App Registration in the tenant                                                |
+| `client_secret` | String | Optional  | A client secret that was generated for the App Registration.                                                    |
+| `environment`   | String | Optional  | The Azure cloud where your resources exist - `AzureCloud` (default), `AzureChinaCloud`, or `AzureUSGovernment`. |
+
+All arguments are optional, and a `azure` connection with no arguments will behave the same as the [default connection](#default-connection).
+
+## Attributes (Read-Only)
+
+| Attribute | Type | Description                                                                                                                                       |
+| --------- | ---- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `env`     | Map  | A map of the resolved connection-related environment variables (`AZURE_TENANT_ID`, `AZURE_CLIENT_SECRET`, `AZURE_CLIENT_ID`, `AZURE_ENVIRONMENT`) |
+
+## Default Connection
+
+The `azure` connection type includes an implicit, default connection (`connection.azure.default`) that will be configured using the Azure environment variables:
+
+```hcl
+connection "azure" "default" {
+  tenant_id       = env("AZURE_TENANT_ID")
+  client_secret   = env("AZURE_CLIENT_SECRET")
+  client_id       = env("AZURE_CLIENT_ID")
+  environment     = env("AZURE_ENVIRONMENT")
+}
+```
diff --git a/docs/reference/config-files/connection/bitbucket.md b/docs/reference/config-files/connection/bitbucket.md
new file mode 100644
index 0000000..c28c972
--- /dev/null
+++ b/docs/reference/config-files/connection/bitbucket.md
@@ -0,0 +1,44 @@
+---
+title: bitbucket
+sidebar_label: bitbucket
+---
+
+# bitbucket
+
+The `bitbucket` connection can be used to access Bitbucket resources.
+
+```hcl
+connection "bitbucket" "bb_connection" {
+  username = "user_name"
+  password = "P@ss123!"
+  base_url = "https://api.bitbucket.org/2.0"
+}
+```
+
+## Arguments
+
+| Name       | Type   | Required? | Description                       |
+| ---------- | ------ | --------- | --------------------------------- |
+| `username` | String | Optional  | Bitbucket username                |
+| `password` | String | Optional  | Bitbucket app password            |
+| `base_url` | String | Optional  | Base URL of your Bitbucket Server |
+
+All arguments are optional, and a `bitbucket` connection with no arguments will behave the same as the [default connection](#default-connection).
+
+## Attributes (Read-Only)
+
+| Attribute | Type | Description                                                                                                                           |
+| --------- | ---- | ------------------------------------------------------------------------------------------------------------------------------------- |
+| `env`     | Map  | A map of the resolved connection-related environment variables (`BITBUCKET_USERNAME`, `BITBUCKET_PASSWORD`, `BITBUCKET_API_BASE_URL`) |
+
+## Default Connection
+
+The `bitbucket` connection type includes an implicit, default connection (`connection.bitbucket.default`) that will be configured using the environment variables `BITBUCKET_USERNAME`, `BITBUCKET_PASSWORD`, and `BITBUCKET_API_BASE_URL`.
+
+```hcl
+connection "bitbucket" "default" {
+  username = env("BITBUCKET_USERNAME")
+  password = env("BITBUCKET_PASSWORD")
+  base_url = env("BITBUCKET_API_BASE_URL")
+}
+```
diff --git a/docs/reference/config-files/connection/clickup.md b/docs/reference/config-files/connection/clickup.md
new file mode 100644
index 0000000..58412ed
--- /dev/null
+++ b/docs/reference/config-files/connection/clickup.md
@@ -0,0 +1,32 @@
+---
+title:  clickup
+sidebar_label: clickup
+---
+
+# clickup
+
+The `clickup` connection can be used to access ClickUp resources.
+
+```hcl
+connection "clickup" "my_clickup" {
+  token = "pk_616_L5H36X3CXXXXXXXWEAZZF0NM5"
+}
+```
+
+## Arguments
+
+| Name            | Type    | Required?| Description
+|-----------------|---------|----------|-------------------
+| `token`         |  String | Optional | API token
+
+All arguments are optional, and a `clickup` connection with no arguments will behave the same as the [default connection](#default-connection).
+
+## Default Connection
+
+The `clickup` connection type includes an implicit, default connection (`connection.clickup.default`) that will be configured to set the `token` to the `CLICKUP_TOKEN` environment variable.
+
+```hcl
+connection "clickup" "default" {
+  token = env("CLICKUP_TOKEN")
+}
+```
diff --git a/docs/reference/config-files/connection/datadog.md b/docs/reference/config-files/connection/datadog.md
new file mode 100644
index 0000000..43e2e00
--- /dev/null
+++ b/docs/reference/config-files/connection/datadog.md
@@ -0,0 +1,37 @@
+---
+title: datadog
+sidebar_label: datadog
+---
+
+# datadog
+
+The `datadog` connection can be used to access Datadog resources.
+
+```hcl
+connection "datadog" "my_datadog_connection" {
+  api_key = "b1cf234................."
+  app_key = "1a2345bc..................."
+  api_url = "https://api.adoghq.com/"
+}
+```
+
+## Arguments
+
+| Name      | Type   | Required? | Description     |
+| --------- | ------ | --------- | --------------- |
+| `api_key` | String | Optional  | API key         |
+| `app_key` | String | Optional  | Application key |
+| `api_url` | String | Optional  | API URL         |
+
+All arguments are optional, and a `datadog` connection with no arguments will behave the same as the [default connection](#default-connection).
+
+## Default Connection
+
+The `datadog` connection type includes an implicit, default connection (`connection.datadog.default`) that will be configured using the environment variables `DD_CLIENT_API_KEY`, and `DD_CLIENT_APP_KEY`.
+
+```hcl
+connection "datadog" "my_datadog_connection" {
+  api_key = env("DD_CLIENT_API_KEY")
+  app_key = env("DD_CLIENT_APP_KEY")
+}
+```
diff --git a/docs/reference/config-files/connection/discord.md b/docs/reference/config-files/connection/discord.md
new file mode 100644
index 0000000..ba88723
--- /dev/null
+++ b/docs/reference/config-files/connection/discord.md
@@ -0,0 +1,38 @@
+---
+title: discord
+sidebar_label: discord
+---
+
+# discord
+
+The `discord` connection can be used to access Discord resources.
+
+```hcl
+connection "discord" "my_discord" {
+  token = "00B630jSCGU4Fake5Yh4KQMFakezwE2OgVcS7N999b"
+}
+```
+
+## Arguments
+
+| Name    | Type   | Required? | Description |
+| ------- | ------ | --------- | ----------- |
+| `token` | String | Optional  | API token   |
+
+All arguments are optional, and a `discord` connection with no arguments will behave the same as the [default connection](#default-connection).
+
+## Attributes (Read-Only)
+
+| Attribute | Type | Description                                                                      |
+| --------- | ---- | -------------------------------------------------------------------------------- |
+| `env`     | Map  | A map of the resolved connection-related environment variables (`DISCORD_TOKEN`) |
+
+## Default Connection
+
+The `discord` connection type includes an implicit, default connection (`connection.discord.default`) that will be configured to set the `token` to the `DISCORD_TOKEN` environment variable.
+
+```hcl
+connection "discord" "default" {
+  token = env("DISCORD_TOKEN")
+}
+```
diff --git a/docs/reference/config-files/connection/freshdesk.md b/docs/reference/config-files/connection/freshdesk.md
new file mode 100644
index 0000000..f434755
--- /dev/null
+++ b/docs/reference/config-files/connection/freshdesk.md
@@ -0,0 +1,35 @@
+---
+title: freshdesk
+sidebar_label: freshdesk
+---
+
+# freshdesk
+
+The `freshdesk` connection can be used to access Freshdesk resources.
+
+```hcl
+connection "freshdesk" "freshdesk_connection" {
+  api_key = "sk-jwgthNa..."
+  subdomain = "domain_name"
+}
+```
+
+## Arguments
+
+| Name        | Type   | Required? | Description         |
+| ----------- | ------ | --------- | ------------------- |
+| `api_key`   | String | Optional  | Freshdesk API key   |
+| `subdomain` | String | Optional  | Freshdesk subdomain |
+
+All arguments are optional, and a `freshdesk` connection with no arguments will behave the same as the [default connection](#default-connection).
+
+## Default Connection
+
+The `freshdesk` connection type includes an implicit, default connection (`connection.freshdesk.default`) that will be configured using the environment variables `FRESHDESK_API_KEY` and `FRESHDESK_SUBDOMAIN`.
+
+```hcl
+connection "freshdesk" "default" {
+  api_key = env("FRESHDESK_API_KEY")
+  subdomain = env("FRESHDESK_SUBDOMAIN")
+}
+```
diff --git a/docs/reference/config-files/connection/gcp.md b/docs/reference/config-files/connection/gcp.md
new file mode 100644
index 0000000..9d69cb4
--- /dev/null
+++ b/docs/reference/config-files/connection/gcp.md
@@ -0,0 +1,103 @@
+---
+title: gcp
+sidebar_label: gcp
+---
+
+# gcp
+
+The `gcp` connection can be used to access Google Cloud Platform resources.
+
+```hcl
+connection "gcp" "gcp_def" {
+  connections = "~/.config/gcloud/my_connections.json"
+}
+```
+
+## Arguments
+
+| Name          | Type   | Required? | Description                                                                                                                                          |
+| ------------- | ------ | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `credentials` | String | Optional  | Either the path to a JSON credential file that contains Google application credentials or the contents of a service account key file in JSON format. |
+| `ttl`         | Number | Optional  | The time, in seconds, to cache the connections. By default, the GP connection will be cached for 5 minutes.                                          |
+
+All arguments are optional, and a `gcp` connection with no arguments will behave the same as the [GCP default connection](#default-connection).
+
+## Attributes (Read-Only)
+
+| Attribute      | Type   | Description                                          |
+| -------------- | ------ | ---------------------------------------------------- |
+| `access_token` | String | An OAuth access token to use to authenticate to GCP. |
+
+## Default Connection
+
+The GCP connection type includes an implicit, default connection (`connection.gcp.default`) that will be configured using the same mechanism as the GCloud CLI (environment variables, config files, etc); the effective connections of this default are the same as if you run the `gcloud` command. Connections will be loaded from:
+
+- The path specified in the `GOOGLE_APPLICATION_CONNECTIONS` environment variable, if set; otherwise
+- The standard location (`~/.config/gcloud/application_default_connections.json`)
+
+## Examples
+
+### Static Connections from Connection File
+
+```hcl
+connection "gcp" "gcp_def" {
+  connections = "~/.config/gcloud/my_connections.json"
+}
+```
+
+### Static Connections defined inline
+
+```hcl
+connection "gcp_inline" {
+  #project = "my_project"
+  connections = <<EOC
+  {
+  "client_id": "blah-blah.apps.googleusercontent.com",
+  "client_secret": "d-blah",
+  "quota_project_id": "dev-aaa",
+  "refresh_token": "1//blah-blah",
+  "type": "authorized_user"
+  }
+  EOC
+}
+```
+
+### Using GCP Connections in Container Step
+
+```hcl
+pipeline "gcp_test" {
+    param "connection" {
+    type    = string
+    default = "default"
+  }
+
+  step "container" "get_instances" {
+    image = "gcr.io/google.com/cloudsdktool/google-cloud-cli"
+    cmd   = ["gcloud", "compute", "instances", "list"]
+    env = {
+      CLOUDSDK_CORE_PROJECT      = "my-project"
+      CLOUDSDK_AUTH_ACCESS_TOKEN = connections.gcp[param.connection].access_token
+    }
+  }
+}
+```
+
+### Using GCP Connections in HTTP Step
+
+```hcl
+pipeline "gcp_test" {
+  param "connection" {
+    type    = string
+    default = "default"
+  }
+
+  step "http" "get_instances" {
+    url = "https://compute.googleapis.com/compute/v1/projects/my-project/aggregated/instances"
+
+    request_headers = {
+      Content-Type = "application/json; charset=utf-8"
+      Authorization = "Bearer ${connections.gcp[param.connection].access_token}"
+    }
+  }
+}
+```
diff --git a/docs/reference/config-files/connection/github.md b/docs/reference/config-files/connection/github.md
new file mode 100644
index 0000000..c1f303f
--- /dev/null
+++ b/docs/reference/config-files/connection/github.md
@@ -0,0 +1,38 @@
+---
+title:  github
+sidebar_label: github
+---
+
+# github
+
+The `github` connection can be used to access GitHub resources.
+
+```hcl
+connection "github" "my_gh_token" {
+  token = "ghpat-..."
+}
+```
+
+## Arguments
+
+| Name            | Type    | Required?| Description
+|-----------------|---------|----------|-------------------
+| `token`         |  String | Optional | API access token
+
+All arguments are optional, and a `github` connection with no arguments will behave the same as the [default connection](#default-connection).
+
+## Attributes (Read-Only)
+
+| Attribute       | Type    | Description
+|-----------------|---------|-----------------
+| `env`           | Map     | A map of the resolved connection-related environment variables (`GITHUB_TOKEN`)
+
+## Default Connection
+
+The `github` connection type includes an implicit, default connection (`connection.github.default`) that will be configured to set the `token` to the `GITHUB_TOKEN` environment variable.
+
+```hcl
+connection "github" "default" {
+  token = env("GITHUB_TOKEN")
+}
+```
diff --git a/docs/reference/config-files/connection/gitlab.md b/docs/reference/config-files/connection/gitlab.md
new file mode 100644
index 0000000..e2ae1fd
--- /dev/null
+++ b/docs/reference/config-files/connection/gitlab.md
@@ -0,0 +1,32 @@
+---
+title: gitlab
+sidebar_label: gitlab
+---
+
+# gitlab
+
+The `gitlab` connection can be used to access GitLab resources.
+
+```hcl
+connection "gitlab" "my_gitlab_token" {
+  token = "glpat-..."
+}
+```
+
+## Arguments
+
+| Name    | Type   | Required? | Description      |
+| ------- | ------ | --------- | ---------------- |
+| `token` | String | Optional  | API access token |
+
+All arguments are optional, and a `gitlab` connection with no arguments will behave the same as the [default connection](#default-connection).
+
+## Default Connection
+
+The `gitlab` connection type includes an implicit, default connection (`connection.gitlab.default`) that will be configured to set the `token` to the `GITLAB_TOKEN` environment variable.
+
+```hcl
+connection "gitlab" "default" {
+  token = env("GITLAB_TOKEN")
+}
+```
diff --git a/docs/reference/config-files/connection/index.md b/docs/reference/config-files/connection/index.md
new file mode 100644
index 0000000..77d289d
--- /dev/null
+++ b/docs/reference/config-files/connection/index.md
@@ -0,0 +1,76 @@
+---
+title: connection
+sidebar_label: connection
+---
+
+# Connection
+
+Flowpipe **Connections** provide a mechanism for defining and sharing secrets in your Flowpipe environment.
+
+```hcl
+connection "aws" "aws_01" {
+  profile = "aws-account-01"
+}
+
+connection "gcp" "gcp_01" {
+  credentials = "~/.config/gcloud/application_default_connections.json"
+}
+
+connection "slack" "slack" {
+  token = "xoxp-asd7f8fd0fake9890"
+}
+```
+
+Connections are defined using the `connection` block in one or more Flowpipe config files. Flowpipe will load ALL configuration files (`*.fpc`) from every directory in the [configuration search path](/docs/reference/env-vars/flowpipe_config_path), with decreasing precedence. The set of connections is the union of all connections defined in these directories.
+
+Each connection has a type label and a name. There is a type for each service: [aws](/docs/reference/config-files/connection/aws), [gcp](/docs/reference/config-files/connection/gcp), [azure](/docs/reference/config-files/connection/azure), [github](/docs/reference/config-files/connection/github), [slack](/docs/reference/config-files/connection/slack), etc. **The arguments and attributes vary by type.**
+
+To learn more, see **[Managing Connections →](/docs/run/connections)**
+
+### Default connections
+
+Flowpipe also creates a single **implicit default** connection for each connection type. The connection is named `default`, eg `connection.aws.default`, `connection.github.default`, etc. The intent of the default connection is that flowpipe can "just work" with your existing setup, and is similar to the default connection that Steampipe creates for each plugin. For example, the AWS default connection will use the standard AWS SDK connection resolution mechanism to create a Flowpipe connection that will use the same connection that the `aws` CLI would use.
+
+You can override the default by simply creating a connection for that type that is named `default`:
+
+```hcl
+connection "slack" "default" {
+  token    = "xoxp-mydefaulttoken"
+}
+```
+
+---
+
+## Using / Referencing Connections
+
+Although connections are defined in config files (not mod files), Flowpipe makes all the connections available to mods using the `connection` variable. This special variable is a map of all connection types by type and name, so you can reference it with standard HCL syntax: `connection.{type}.{name}` eg `connection.aws.aws01` or `connection[{type}][{name}]` eg `connection["aws"["aws01"]`.
+
+You can reference them directly in a mod:
+
+```hcl
+pipeline "ex1" {
+  step "container" "aws" {
+    image = "public.ecr.aws/aws-cli/aws-cli"
+    cmd   = [ "s3", "ls" ]
+    env   = connection.aws.aws01.env
+  }
+}
+```
+
+### Dynamic Connections
+
+Some connections support dynamic attributes that contain temporary connections. Cloud services like AWS and GCP provide many mechanisms for defining connections (static keys, SSO, assumed roles, profiles,etc) but in all cases can be exchanged for a "standard" format such as an access token or AWS key pair.
+
+When using dynamic connection attributes, the connections are resolved as late as possible. When the _step instance_ runs that uses the connection, it is fetched (from the cache if not expired) or generated. This is important because the dynamic connections are usually temporary and will expire and become invalid. You can tell Flowpipe how long to cache these temporary connections with the `ttl` argument. This specifies the number of seconds to cache the connections. Not all connections support (or require) `ttl`, and for those that do, the default value varies by type. Note that the cache is in-memory only, and does not persist when Flowpipe stops.
+
+---
+
+## Handling secret data
+
+At this time, Flowpipe does not encrypt the connections, either in the config files or in the event store.
+
+Flowpipe will need the secret data in the event store as long as a pipeline is running. After a pipeline completes, however, Flowpipe will attempt to redact secrets from the event store for the completed pipeline. The `args`, `attributes`, and `data` for all events related to the pipeline will be scrubbed.
+
+Additionally, Flowpipe will redact secrets from the CLI display and diagnostic logs.
+
+The redaction will use pattern matching to look for known secret names (`AWS_SECRET_KEY`, `password`, `token`, etc) as well as value patterns (regular expressions for JWT tokens, API tokens, AWS keys, etc).
diff --git a/docs/reference/config-files/connection/ip2locationio.md b/docs/reference/config-files/connection/ip2locationio.md
new file mode 100644
index 0000000..f6500f1
--- /dev/null
+++ b/docs/reference/config-files/connection/ip2locationio.md
@@ -0,0 +1,32 @@
+---
+title: ip2locationio
+sidebar_label: ip2locationio
+---
+
+# ip2locationio
+
+The `ip2locationio` connection can be used to access Ip2Location.io resources.
+
+```hcl
+connection "ip2locationio" "my_api_key" {
+  api_key = "12345678901A23BC4D5E6FG78HI9J101"
+}
+```
+
+## Arguments
+
+| Name      | Type   | Required? | Description |
+| --------- | ------ | --------- | ----------- |
+| `api_key` | String | Optional  | API key     |
+
+All arguments are optional, and a `ip2locationio` connection with no arguments will behave the same as the [default connection](#default-connection).
+
+## Default Connection
+
+The `ip2locationio` connection type includes an implicit, default connection (`connection.ip2locationio.default`) that will be configured to set the `api_key` to the `IP2LOCATIONIO_API_KEY` environment variable.
+
+```hcl
+connection "ip2locationio" "default" {
+  api_key = env("IP2LOCATIONIO_API_KEY")
+}
+```
diff --git a/docs/reference/config-files/connection/ipstack.md b/docs/reference/config-files/connection/ipstack.md
new file mode 100644
index 0000000..378be0c
--- /dev/null
+++ b/docs/reference/config-files/connection/ipstack.md
@@ -0,0 +1,32 @@
+---
+title: ipstack
+sidebar_label: ipstack
+---
+
+# ipstack
+
+The `ipstack` connection can be used to access IpStack resources.
+
+```hcl
+connection "ipstack" "my_ipstack" {
+  access_key = "1234801fakekeyf123455e6cfaf2"
+}
+```
+
+## Arguments
+
+| Name         | Type   | Required? | Description    |
+| ------------ | ------ | --------- | -------------- |
+| `access_key` | String | Optional  | API access key |
+
+All arguments are optional, and a `ipstack` connection with no arguments will behave the same as the [default connection](#default-connection).
+
+## Default Connection
+
+The `ipstack` connection type includes an implicit, default connection (`connection.ipstack.default`) that will be configured to set the `access_key` to the `IPSTACK_ACCESS_KEY` environment variable.
+
+```hcl
+connection "ipstack" "default" {
+  access_key = env("IPSTACK_ACCESS_KEY")
+}
+```
diff --git a/docs/reference/config-files/connection/jira.md b/docs/reference/config-files/connection/jira.md
new file mode 100644
index 0000000..f3402b5
--- /dev/null
+++ b/docs/reference/config-files/connection/jira.md
@@ -0,0 +1,38 @@
+---
+title:  jira
+sidebar_label: jira
+---
+
+# jira
+
+The `jira` connection can be used to access Jira resources.
+
+```hcl
+connection "jira" "jira_connection" {
+   api_token = "ATATT3S........................."
+   base_url  = "https://test.atlassian.net/"
+   username  = "test@abbb.com"
+}
+```
+
+## Arguments
+
+| Name            | Type    | Required?| Description
+|-----------------|---------|----------|-------------------
+| `api_token`     |  String | Optional | API access token
+| `base_url`      |  String | Optional | The Base Url of your Jira API instance
+| `username`      |  String | Optional | The user name to access the Jira cloud instance
+
+All arguments are optional, and a `jira` connection with no arguments will behave the same as the [default connection](#default-connection).
+
+## Default Connection
+
+The `jira` connection type includes an implicit, default connection (`connection.jira.default`) that will be configured using the environment variables `JIRA_API_TOKEN` (or `JIRA_TOKEN`), `JIRA_URL`, and `JIRA_USER`.
+
+```hcl
+connection "jira" "default" {
+   api_token = env("JIRA_API_TOKEN")
+   base_url  = env("JIRA_URL")
+   username  = env("JIRA_USER")
+}
+```
diff --git a/docs/reference/config-files/connection/jumpcloud.md b/docs/reference/config-files/connection/jumpcloud.md
new file mode 100644
index 0000000..717e240
--- /dev/null
+++ b/docs/reference/config-files/connection/jumpcloud.md
@@ -0,0 +1,32 @@
+---
+title: jumpcloud
+sidebar_label: jumpcloud
+---
+
+# jumpcloud
+
+The `jumpcloud` connection can be used to access JumpCloud resources.
+
+```hcl
+connection "jumpcloud" "jumpcloud_api_key" {
+  api_key = "2e256f0faked412345676fake914cf7e68d8e53c8d"
+}
+```
+
+## Arguments
+
+| Name      | Type   | Required? | Description |
+| --------- | ------ | --------- | ----------- |
+| `api_key` | String | Optional  | API Key     |
+
+All arguments are optional, and an `jumpcloud` connection with no arguments will behave the same as the [default connection](#default-connection).
+
+## Default Connection
+
+The `jumpcloud` connection type includes an implicit, default connection (`connection.jumpcloud.default`) that will be configured to set the `api_key` to the `JUMPCLOUD_API_KEY` environment variable.
+
+```hcl
+connection "jumpcloud" "default" {
+  api_key = env("JUMPCLOUD_API_KEY")
+}
+```
diff --git a/docs/reference/config-files/connection/mastodon.md b/docs/reference/config-files/connection/mastodon.md
new file mode 100644
index 0000000..064afee
--- /dev/null
+++ b/docs/reference/config-files/connection/mastodon.md
@@ -0,0 +1,24 @@
+---
+title: mastodon
+sidebar_label: mastodon
+---
+
+# mastodon
+
+The `mastodon` connection can be used to access Mastodon resources.
+
+```hcl
+connection "mastodon" "mastodon_connection" {
+  server = "https://myserver.social"
+  access_token = "FK1_fake-token"
+}
+```
+
+## Arguments
+
+| Name           | Type   | Required? | Description                             |
+| -------------- | ------ | --------- | --------------------------------------- |
+| `server`       | String | Optional  | The federated server your account lives |
+| `access_token` | String | Optional  | Mastodon access token                   |
+
+All arguments are optional, and a `mastodon` connection with no arguments will behave the same as the [default connection](#default-connection).
diff --git a/docs/reference/config-files/connection/okta.md b/docs/reference/config-files/connection/okta.md
new file mode 100644
index 0000000..cee63e7
--- /dev/null
+++ b/docs/reference/config-files/connection/okta.md
@@ -0,0 +1,41 @@
+---
+title:  okta
+sidebar_label: okta
+---
+
+# okta
+
+The `okta` connection can be used to access Okta resources.
+
+```hcl
+connection "okta" "my_okta" {
+  domain    = "https://dev-11111111.okta.com"
+  api_token = "00B..."
+}
+```
+
+## Arguments
+
+| Name            | Type    | Required?| Description
+|-----------------|---------|----------|-------------------
+| `api_token`     |  String | Optional | API token
+| `domain`        |  String | Optional | URL for your Okta Organization
+
+All arguments are optional, and a `okta` connection with no arguments will behave the same as the [default connection](#default-connection).
+
+## Attributes (Read-Only)
+
+| Attribute       | Type    | Description
+|-----------------|---------|-----------------
+| `env`           | Map     | A map of the resolved connection-related environment variables (`OKTA_CLIENT_TOKEN`, `OKTA_ORGURL`)
+
+## Default Connection
+
+The `okta` connection type includes an implicit, default connection (`connection.okta.default`) that will be configured to set the `api_token` to the `OKTA_CLIENT_TOKEN` environment variable and the `domain` to the `OKTA_ORGURL` environment variable.
+
+```hcl
+connection "okta" "default" {
+  api_token = env("OKTA_CLIENT_TOKEN")
+  domain    = env("OKTA_ORGURL")
+}
+```
diff --git a/docs/reference/config-files/connection/openai.md b/docs/reference/config-files/connection/openai.md
new file mode 100644
index 0000000..2fce3a1
--- /dev/null
+++ b/docs/reference/config-files/connection/openai.md
@@ -0,0 +1,38 @@
+---
+title: openai
+sidebar_label: openai
+---
+
+# openai
+
+The `openai` connection can be used to access OpenAI resources.
+
+```hcl
+connection "openai" "my_openai" {
+  api_key = "sk-jwgthNa..."
+}
+```
+
+## Arguments
+
+| Name      | Type   | Required? | Description |
+| --------- | ------ | --------- | ----------- |
+| `api_key` | String | Optional  | API key     |
+
+All arguments are optional, and an `openai` connection with no arguments will behave the same as the [default connection](#default-connection).
+
+## Attributes (Read-Only)
+
+| Attribute | Type | Description                                                                       |
+| --------- | ---- | --------------------------------------------------------------------------------- |
+| `env`     | Map  | A map of the resolved connection-related environment variables (`OPENAI_API_KEY`) |
+
+## Default Connection
+
+The `openai` connection type includes an implicit, default connection (`connection.openai.default`) that will be configured to set the `api_key` to the `OPENAI_API_KEY` environment variable.
+
+```hcl
+connection "openai" "default" {
+  api_key = env("OPENAI_API_KEY")
+}
+```
diff --git a/docs/reference/config-files/connection/opsgenie.md b/docs/reference/config-files/connection/opsgenie.md
new file mode 100644
index 0000000..f6ae1ea
--- /dev/null
+++ b/docs/reference/config-files/connection/opsgenie.md
@@ -0,0 +1,35 @@
+---
+title: opsgenie
+sidebar_label: opsgenie
+---
+
+# opsgenie
+
+The `opsgenie` connection can be used to access OpsGenie resources.
+
+```hcl
+connection "opsgenie" "my_opsgenie" {
+  alert_api_key    = "1234f4f0-3333-4837-90af-0123456789ab"
+  incident_api_key = "1234f4f0-1111-4837-90af-9cdef0123456"
+}
+```
+
+## Arguments
+
+| Name               | Type   | Required? | Description                   |
+| ------------------ | ------ | --------- | ----------------------------- |
+| `alert_api_key`    | String | Optional  | API key for the alerts API    |
+| `incident_api_key` | String | Optional  | API key for the incidents API |
+
+All arguments are optional, and an `opsgenie` connection with no arguments will behave the same as the [default connection](#default-connection).
+
+## Default Connection
+
+The `opsgenie` connection type includes an implicit, default connection (`connection.opsgenie.default`) that will be configured to set the `alert_api_key` to the `OPSGENIE_ALERT_API_KEY` environment variable and `incident_api_key` to `OPSGENIE_INCIDENT_API_KEY`.
+
+```hcl
+connection "opsgenie" "default" {
+  alert_api_key    = env("OPSGENIE_ALERT_API_KEY")
+  incident_api_key = env("OPSGENIE_INCIDENT_API_KEY")
+}
+```
diff --git a/docs/reference/config-files/connection/pagerduty.md b/docs/reference/config-files/connection/pagerduty.md
new file mode 100644
index 0000000..33c645d
--- /dev/null
+++ b/docs/reference/config-files/connection/pagerduty.md
@@ -0,0 +1,32 @@
+---
+title: pagerduty
+sidebar_label: pagerduty
+---
+
+# pagerduty
+
+The `pagerduty` connection can be used to access PagerDuty resources.
+
+```hcl
+connection "pagerduty" "my_pagerduty" {
+  token = "u+_szhLR4FakeTokenGZSA"
+}
+```
+
+## Arguments
+
+| Name    | Type   | Required? | Description |
+| ------- | ------ | --------- | ----------- |
+| `token` | String | Optional  | API token   |
+
+All arguments are optional, and a `pagerduty` connection with no arguments will behave the same as the [default connection](#default-connection).
+
+## Default Connection
+
+The `pagerduty` connection type includes an implicit, default connection (`connection.pagerduty.default`) that will be configured to set the `token` to the `PAGERDUTY_TOKEN` environment variable.
+
+```hcl
+connection "pagerduty" "default" {
+  token = env("PAGERDUTY_TOKEN")
+}
+```
diff --git a/docs/reference/config-files/connection/pipes.md b/docs/reference/config-files/connection/pipes.md
new file mode 100644
index 0000000..9118ad4
--- /dev/null
+++ b/docs/reference/config-files/connection/pipes.md
@@ -0,0 +1,38 @@
+---
+title: pipes
+sidebar_label: pipes
+---
+
+# pipes
+
+The `pipes` connection can be used to access [Turbot Pipes](https://pipes.turbot.com/) resources.
+
+```hcl
+connection "pipes" "my_pipes" {
+  token = "tpt_cld630jTisISAFakeTokenAdqizwE2OgVcS7N9UHb"
+}
+```
+
+## Arguments
+
+| Name    | Type   | Required? | Description |
+| ------- | ------ | --------- | ----------- |
+| `token` | String | Optional  | API token   |
+
+All arguments are optional, and a `pipes` connection with no arguments will behave the same as the [default connection](#default-connection).
+
+## Attributes (Read-Only)
+
+| Attribute | Type | Description                                                                    |
+| --------- | ---- | ------------------------------------------------------------------------------ |
+| `env`     | Map  | A map of the resolved connection-related environment variables (`PIPES_TOKEN`) |
+
+## Default Connection
+
+The `pipes` connection type includes an implicit, default connection (`connection.pipes.default`) that will be configured to set the `token` to the `PIPES_TOKEN` environment variable.
+
+```hcl
+connection "pipes" "default" {
+  token = env("PIPES_TOKEN")
+}
+```
diff --git a/docs/reference/config-files/connection/sendgrid.md b/docs/reference/config-files/connection/sendgrid.md
new file mode 100644
index 0000000..e06d0d2
--- /dev/null
+++ b/docs/reference/config-files/connection/sendgrid.md
@@ -0,0 +1,38 @@
+---
+title: sendgrid
+sidebar_label: sendgrid
+---
+
+# sendgrid
+
+The `sendgrid` connection can be used to access SendGrid resources.
+
+```hcl
+connection "sendgrid" "my_sendgrid" {
+  api_key = "SG.R7..."
+}
+```
+
+## Arguments
+
+| Name      | Type   | Required? | Description      |
+| --------- | ------ | --------- | ---------------- |
+| `api_key` | String | Optional  | SendGrid API Key |
+
+All arguments are optional, and a `sendgrid` connection with no arguments will behave the same as the [default connection](#default-connection).
+
+## Attributes (Read-Only)
+
+| Attribute | Type | Description                                                                         |
+| --------- | ---- | ----------------------------------------------------------------------------------- |
+| `env`     | Map  | A map of the resolved connection-related environment variables (`SENDGRID_API_KEY`) |
+
+## Default Connection
+
+The `sendgrid` connection type includes an implicit, default connection (`connection.sendgrid.default`) that will be configured to set the `api_key` to the `SENDGRID_API_KEY` environment variable.
+
+```hcl
+connection "sendgrid" "default" {
+  api_key = env("SENDGRID_API_KEY")
+}
+```
diff --git a/docs/reference/config-files/connection/servicenow.md b/docs/reference/config-files/connection/servicenow.md
new file mode 100644
index 0000000..61f7c5a
--- /dev/null
+++ b/docs/reference/config-files/connection/servicenow.md
@@ -0,0 +1,38 @@
+---
+title: servicenow
+sidebar_label: servicenow
+---
+
+# servicenow
+
+The `servicenow` connection can be used to access ServiceNow resources.
+
+```hcl
+connection "servicenow" "snow_connection" {
+  instance_url = "https://my-instance.service-now.com"
+  username = "john.hill"
+  password = "fake-p@ss"
+}
+```
+
+## Arguments
+
+| Name           | Type   | Required? | Description                  |
+| -------------- | ------ | --------- | ---------------------------- |
+| `instance_url` | String | Optional  | Your ServiceNow instance URL |
+| `username`     | String | Optional  | ServiceNow username          |
+| `password`     | String | Optional  | ServiceNow app password      |
+
+All arguments are optional, and a `servicenow` connection with no arguments will behave the same as the [default connection](#default-connection).
+
+## Default Connection
+
+The `servicenow` connection type includes an implicit, default connection (`connection.servicenow.default`) that will be configured using the environment variables `SERVICENOW_INSTANCE_URL`, `SERVICENOW_USERNAME`, and `SERVICENOW_PASSWORD`.
+
+```hcl
+connection "servicenow" "default" {
+  instance_url = env("SERVICENOW_INSTANCE_URL")
+  username = env("SERVICENOW_USERNAME")
+  password = env("SERVICENOW_PASSWORD")
+}
+```
diff --git a/docs/reference/config-files/connection/slack.md b/docs/reference/config-files/connection/slack.md
new file mode 100644
index 0000000..042c283
--- /dev/null
+++ b/docs/reference/config-files/connection/slack.md
@@ -0,0 +1,73 @@
+---
+title: slack
+sidebar_label: slack
+---
+
+# slack
+
+The `slack` connection can be used to access Slack resources.
+
+```hcl
+connection "slack" "my_slack" {
+  token = "xoxp-234567890"
+}
+```
+
+## Arguments
+
+| Name    | Type   | Required? | Description             |
+| ------- | ------ | --------- | ----------------------- |
+| `token` | String | Optional  | An API token for slack. |
+
+All arguments are optional, and a `slack` connection with no arguments will behave the same as the [Slack default connection](#default-connection).
+
+## Attributes (Read-Only)
+
+| Attribute | Type | Description                                                                    |
+| --------- | ---- | ------------------------------------------------------------------------------ |
+| `env`     | Map  | A map of the resolved connection-related environment variables (`SLACK_TOKEN`) |
+
+## Default Connection
+
+The Slack connection type includes an implicit, default connection (`connection.slack.default`) that will be configured to set the `token` to the `SLACK_TOKEN` environment variable.
+
+```hcl
+connection "slack" "default" {
+  token = env("SLACK_TOKEN")
+}
+```
+
+## Examples
+
+### Static Connections
+
+```hcl
+connection "slack" "my_slack" {
+  token = "xoxp-234567890"
+}
+```
+
+### Using Slack Connections in HTTP Step
+
+```hcl
+pipeline "gcp_test" {
+  param "connection" {
+    type    = string
+    default = "default"
+  }
+
+  step "http" "list_channels" {
+    url    = "https://slack.com/api/conversations.list"
+    method = "get"
+
+    request_headers = {
+      Content-Type  = "application/json; charset=utf-8"
+      Authorization = "Bearer ${connections.slack[param.connection].token}"
+    }
+
+    request_body = jsonencode({
+      types            = "public_channel"
+    })
+  }
+}
+```
diff --git a/docs/reference/config-files/connection/teams.md b/docs/reference/config-files/connection/teams.md
new file mode 100644
index 0000000..1bdf7a7
--- /dev/null
+++ b/docs/reference/config-files/connection/teams.md
@@ -0,0 +1,38 @@
+---
+title: teams
+sidebar_label: teams
+---
+
+# teams
+
+The `teams` connection can be used to access Microsoft Teams resources.
+
+```hcl
+connection "teams" "my_teams" {
+  access_token= "bfc6f1c4fakesdfdxxxx26fake977b2xxxsfsdfakef313c3d389126de0d"
+}
+```
+
+## Arguments
+
+| Name           | Type   | Required? | Description |
+| -------------- | ------ | --------- | ----------- |
+| `access_token` | String | Optional  | API token   |
+
+All arguments are optional, and a `teams` connection with no arguments will behave the same as the [default connection](#default-connection).
+
+## Attributes (Read-Only)
+
+| Attribute | Type | Description                                                                           |
+| --------- | ---- | ------------------------------------------------------------------------------------- |
+| `env`     | Map  | A map of the resolved connection-related environment variables (`TEAMS_ACCESS_TOKEN`) |
+
+## Default Connection
+
+The `teams` connection type includes an implicit, default connection (`connection.teams.default`) that will be configured to set the `access_token` to the `TEAMS_ACCESS_TOKEN` environment variable.
+
+```hcl
+connection "teams" "default" {
+  access_token = env("TEAMS_ACCESS_TOKEN")
+}
+```
diff --git a/docs/reference/config-files/connection/template.keep b/docs/reference/config-files/connection/template.keep
new file mode 100644
index 0000000..1798caa
--- /dev/null
+++ b/docs/reference/config-files/connection/template.keep
@@ -0,0 +1,39 @@
+---
+title:  xxxxx
+sidebar_label: xxxxx
+---
+
+# xxxxx
+
+The `xxxxx` connection can be used to access XXXXX resources.
+
+```hcl
+
+```
+
+## Arguments
+
+| Name            | Type    | Required?| Description
+|-----------------|---------|----------|-------------------
+| `TTTTTT`         |  String | Optional | API   
+
+
+All arguments are optional, and a `xxxxx` connection with no arguments will behave the same as the [default connection](#default-connection).  
+
+## Default Connection
+The `xxxxx` connection type includes an implicit, default connection (`connection.xxxxx.default`) that will be configured to set the `TTTTTT` to the `EEEEEEE` environment variable.
+
+```hcl
+connection "xxxxx" "default" {
+  TTTTTT = env("EEEEEEE")
+}
+```
+
+## Examples
+
+### Static Connections
+```hcl
+connection "xxxxx" "my_xxxxx" {
+  TTTTTT = "xoxp-234567890"
+}
+```
diff --git a/docs/reference/config-files/connection/trello.md b/docs/reference/config-files/connection/trello.md
new file mode 100644
index 0000000..44ddc10
--- /dev/null
+++ b/docs/reference/config-files/connection/trello.md
@@ -0,0 +1,35 @@
+---
+title: trello
+sidebar_label: trello
+---
+
+# trello
+
+The `trello` connection can be used to access Trello resources.
+
+```hcl
+connection "trello" "my_trello" {
+  api_key = "a25ad2e..."
+  token   = "ATTAb179ea..."
+}
+```
+
+## Arguments
+
+| Name      | Type   | Required? | Description |
+| --------- | ------ | --------- | ----------- |
+| `api_key` | String | Optional  | API key     |
+| `token`   | String | Optional  | API token   |
+
+All arguments are optional, and a `trello` connection with no arguments will behave the same as the [default connection](#default-connection).
+
+## Default Connection
+
+The `trello` connection type includes an implicit, default connection (`connection.trello.default`) that will be configured to set the `api_key` to the `TRELLO_API_KEY` environment variable and the `token` to the `TRELLO_TOKEN` environment variable.
+
+```hcl
+connection "trello" "default" {
+  api_key = env("TRELLO_API_KEY")
+  token   = env("TRELLO_TOKEN")
+}
+```
diff --git a/docs/reference/config-files/connection/turbot_guardrails.md b/docs/reference/config-files/connection/turbot_guardrails.md
new file mode 100644
index 0000000..b9be4be
--- /dev/null
+++ b/docs/reference/config-files/connection/turbot_guardrails.md
@@ -0,0 +1,44 @@
+---
+title: guardrails
+sidebar_label: guardrails
+---
+
+# guardrails
+
+The `guardrails` connection can be used to access [Turbot Guardrails](https://turbot.com/guardrails) resources.
+
+```hcl
+connection "guardrails" "my_guardrail" {
+  access_key = "c8e2c2ed-1ca8-429b-b369-123..."
+  secret_key = "a3d8385d-47f7-40c5-a90c-123..."
+  workspace = "https://my_workspace.sass.turbot.com"
+}
+```
+
+## Arguments
+
+| Name         | Type   | Required? | Description   |
+| ------------ | ------ | --------- | ------------- |
+| `access_key` | String | Optional  | Access key    |
+| `secret_key` | String | Optional  | Secret key    |
+| `workspace`  | String | Optional  | Workspace URL |
+
+All arguments are optional, and a `guardrails` connection with no arguments will behave the same as the [default connection](#default-connection).
+
+## Attributes (Read-Only)
+
+| Attribute | Type | Description                                                                                                                   |
+| --------- | ---- | ----------------------------------------------------------------------------------------------------------------------------- |
+| `env`     | Map  | A map of the resolved connection-related environment variables (`TURBOT_ACCESS_KEY`, `TURBOT_SECRET_KEY`, `TURBOT_WORKSPACE`) |
+
+## Default Connection
+
+The `guardrails` connection type includes an implicit, default connection (`connection.guardrails.default`) that will be configured using the environment variables `TURBOT_ACCESS_KEY`, `TURBOT_SECRET_KEY`, and `TURBOT_WORKSPACE`.
+
+```hcl
+connection "guardrails" "my_guardrail" {
+  access_key = env("TURBOT_ACCESS_KEY")
+  secret_key = env("TURBOT_SECRET_KEY")
+  workspace  = env("TURBOT_WORKSPACE")
+}
+```
diff --git a/docs/reference/config-files/connection/uptimerobot.md b/docs/reference/config-files/connection/uptimerobot.md
new file mode 100644
index 0000000..e0e0735
--- /dev/null
+++ b/docs/reference/config-files/connection/uptimerobot.md
@@ -0,0 +1,38 @@
+---
+title: uptimerobot
+sidebar_label: uptimerobot
+---
+
+# uptimerobot
+
+The `uptimerobot` connection can be used to access UptimeRobot resources.
+
+```hcl
+connection "uptimerobot" "my_uptimerobot" {
+  api_key = "u123456-ecaf32fakekey633ff33dd3c445"
+}
+```
+
+## Arguments
+
+| Name      | Type   | Required? | Description |
+| --------- | ------ | --------- | ----------- |
+| `api_key` | String | Optional  | API Key     |
+
+All arguments are optional, and a `uptimerobot` connection with no arguments will behave the same as the [default connection](#default-connection).
+
+## Attributes (Read-Only)
+
+| Attribute | Type | Description                                                                            |
+| --------- | ---- | -------------------------------------------------------------------------------------- |
+| `env`     | Map  | A map of the resolved connection-related environment variables (`UPTIMEROBOT_API_KEY`) |
+
+## Default Connection
+
+The `uptimerobot` connection type includes an implicit, default connection (`connection.uptimerobot.default`) that will be configured to set the `api_key` to the `UPTIMEROBOT_API_KEY` environment variable.
+
+```hcl
+connection "uptimerobot" "default" {
+  api_key = env("UPTIMEROBOT_API_KEY")
+}
+```
diff --git a/docs/reference/config-files/connection/urlscan.md b/docs/reference/config-files/connection/urlscan.md
new file mode 100644
index 0000000..2176516
--- /dev/null
+++ b/docs/reference/config-files/connection/urlscan.md
@@ -0,0 +1,38 @@
+---
+title: urlscan
+sidebar_label: urlscan
+---
+
+# urlscan
+
+The `urlscan` connection can be used to access URLScan resources.
+
+```hcl
+connection "urlscan" "my_urlscan" {
+  api_key = "11111111-e127-1234-adcd-59cad2f12abc"
+}
+```
+
+## Arguments
+
+| Name      | Type   | Required? | Description |
+| --------- | ------ | --------- | ----------- |
+| `api_key` | String | Optional  | API Key     |
+
+All arguments are optional, and a `urlscan` connection with no arguments will behave the same as the [default connection](#default-connection).
+
+## Attributes (Read-Only)
+
+| Attribute | Type | Description                                                                        |
+| --------- | ---- | ---------------------------------------------------------------------------------- |
+| `env`     | Map  | A map of the resolved connection-related environment variables (`URLSCAN_API_KEY`) |
+
+## Default Connection
+
+The `urlscan` connection type includes an implicit, default connection (`connection.urlscan.default`) that will be configured to set the `api_key` to the `URLSCAN_API_KEY` environment variable.
+
+```hcl
+connection "urlscan" "default" {
+  api_key = env("URLSCAN_API_KEY")
+}
+```
diff --git a/docs/reference/config-files/connection/vault.md b/docs/reference/config-files/connection/vault.md
new file mode 100644
index 0000000..dd89c76
--- /dev/null
+++ b/docs/reference/config-files/connection/vault.md
@@ -0,0 +1,41 @@
+---
+title: vault
+sidebar_label: vault
+---
+
+# vault
+
+The `vault` connection can be used to access Vault resources.
+
+```hcl
+connection "vault" "my_vault" {
+  address = "http://127.0.0.1:8200"
+  token = "hvs.FaKe"
+}
+```
+
+## Arguments
+
+| Name      | Type   | Required? | Description          |
+| --------- | ------ | --------- | -------------------- |
+| `address` | String | Optional  | Vault server address |
+| `token`   | String | Optional  | API token            |
+
+All arguments are optional, and a `vault` connection with no arguments will behave the same as the [default connection](#default-connection).
+
+## Attributes (Read-Only)
+
+| Attribute | Type | Description                                                                                  |
+| --------- | ---- | -------------------------------------------------------------------------------------------- |
+| `env`     | Map  | A map of the resolved connection-related environment variables (`VAULT_ADDR`, `VAULT_TOKEN`) |
+
+## Default Connection
+
+The `vault` connection type includes an implicit, default connection (`connection.vault.default`) that will be configured to set the `token` to the `VAULT_TOKEN` environment variable and the `domain` to `VAULT_ADDR`.
+
+```hcl
+connection "vault" "default" {
+  domain = env("VAULT_ADDR")
+  token  = env("VAULT_TOKEN")
+}
+```
diff --git a/docs/reference/config-files/connection/virustotal.md b/docs/reference/config-files/connection/virustotal.md
new file mode 100644
index 0000000..a3e08d2
--- /dev/null
+++ b/docs/reference/config-files/connection/virustotal.md
@@ -0,0 +1,32 @@
+---
+title: virustotal
+sidebar_label: virustotal
+---
+
+# virustotal
+
+The `virustotal` connection can be used to access VirusTotal resources.
+
+```hcl
+connection "virustotal" "my_ virustotal" {
+  api_key = "SG.R7..."
+}
+```
+
+## Arguments
+
+| Name      | Type   | Required? | Description |
+| --------- | ------ | --------- | ----------- |
+| `api_key` | String | Optional  | API key     |
+
+All arguments are optional, and a `virustotal` connection with no arguments will behave the same as the [default connection](#default-connection).
+
+## Default Connection
+
+The `virustotal` connection type includes an implicit, default connection (`connection.virustotal.default`) that will be configured to set the `api_key` to the `VTCLI_APIKEY` environment variable.
+
+```hcl
+connection "virustotal" "default" {
+  api_key = env("VTCLI_APIKEY")
+}
+```
diff --git a/docs/reference/config-files/connection/zendesk.md b/docs/reference/config-files/connection/zendesk.md
new file mode 100644
index 0000000..59dd001
--- /dev/null
+++ b/docs/reference/config-files/connection/zendesk.md
@@ -0,0 +1,38 @@
+---
+title:  zendesk
+sidebar_label: zendesk
+---
+
+# zendesk
+
+The `zendesk` connection can be used to access Zendesk resources.
+
+```hcl
+connection "zendesk" "my_zendesk" {
+  subdomain  = "dmi"
+  email      = "pam@dmi.com"
+  token      = "17ImlCYdfThisIsFakepJn1fi1pLwVdrb21114"
+}
+```
+
+## Arguments
+
+| Name            | Type    | Required?| Description
+|-----------------|---------|----------|-------------------
+| `subdomain`     |  String | Optional | The subdomain name of your Zendesk account.
+| `email`         |  String | Optional | Email address of agent user who have permission to access the API.
+| `token`         |  String | Optional | API Token for your Zendesk instance.
+
+All arguments are optional, and a `zendesk` connection with no arguments will behave the same as the [default connection](#default-connection).
+
+## Default Connection
+
+The `zendesk` connection type includes an implicit, default connection (`connection.zendesk.default`) that will be configured to set defaults using the environment variables `ZENDESK_EMAIL`, `ZENDESK_SUBDOMAIN`, and `ZENDESK_API_TOKEN`.
+
+```hcl
+connection "zendesk" "default" {
+  subdomain  = env("ZENDESK_SUBDOMAIN")
+  email      = env("ZENDESK_EMAIL")
+  token      = env("ZENDESK_API_TOKEN")
+}
+```