From 4fee5a583935f6292e26f194c87dda18b3b7886e Mon Sep 17 00:00:00 2001
From: Sheen Capadngan <sheensantoscapadngan@gmail.com>
Date: Fri, 20 Jun 2025 19:36:27 +0800
Subject: [PATCH] doc: added initial app connection doc

---
 .../app-connections/cloudflare.mdx            | 92 +++++++++++++++++++
 docs/mint.json                                |  1 +
 2 files changed, 93 insertions(+)
 create mode 100644 docs/integrations/app-connections/cloudflare.mdx

diff --git a/docs/integrations/app-connections/cloudflare.mdx b/docs/integrations/app-connections/cloudflare.mdx
new file mode 100644
index 000000000..6e8f26592
--- /dev/null
+++ b/docs/integrations/app-connections/cloudflare.mdx
@@ -0,0 +1,92 @@
+---
+title: "Cloudflare App Connection"
+description: "Learn how to configure a Cloudflare App Connection for Infisical."
+---
+
+Infisical supports connecting to Cloudflare using API tokens and Account ID for secure access to your Cloudflare services.
+
+## Configure API Token and Account ID for Infisical
+
+<Steps>
+  <Step title="Create API Token">
+    Navigate to your Cloudflare dashboard and go to **My Profile > API Tokens**.
+
+    ![Cloudflare API Tokens](/images/integrations/cloudflare/integrations-cloudflare-credentials-1.png)
+
+    Click **Create Token** to generate a new API token.
+
+    ![Create API Token](/images/integrations/cloudflare/integrations-cloudflare-credentials-2.png)
+
+  </Step>
+  <Step title="Configure Token Permissions">
+    Configure your API token with the necessary permissions for your Cloudflare services.
+
+    Depending on your use case, add one or more of the following permission sets to your API token:
+
+    <Tabs>
+      <Tab title="Secret Sync">
+        <AccordionGroup>
+          <Accordion title="Cloudflare Pages Secret Sync">
+            Use the following permissions to grant Infisical access to sync secrets to Cloudflare Pages:
+
+            ![Configure Token](/images/integrations/cloudflare/integrations-cloudflare-credentials-3.png)
+
+            **Required Permissions:**
+            - **Account** - **Cloudflare Pages** - **Edit**
+            - **Account** - **Account Settings** - **Read**
+
+            Add these permissions to your API token and click **Continue to summary**, then **Create Token** to generate your API token.
+          </Accordion>
+        </AccordionGroup>
+      </Tab>
+    </Tabs>
+
+  </Step>
+  <Step title="Save Your API Token">
+    After creation, copy and securely store your API token as it will not be shown again.
+
+    <Warning>
+      Keep your API token secure and do not share it. Anyone with access to this token can manage your Cloudflare resources based on the permissions granted.
+    </Warning>
+
+  </Step>
+  <Step title="Get Account ID">
+    Navigate to **Account > Workers & Pages > Overview** in your Cloudflare dashboard to find your Account ID.
+
+    ![Account ID](/images/integrations/cloudflare/integrations-cloudflare-credentials-4.png)
+
+    Copy your Account ID for use in the next step.
+
+  </Step>
+</Steps>
+
+## Setup Cloudflare Connection in Infisical
+
+<Steps>
+  <Step title="Navigate to App Connections">
+    Navigate to the **App Connections** tab on the **Organization Settings**
+    page. ![App Connections
+    Tab](/images/app-connections/general/add-connection.png)
+  </Step>
+  <Step title="Add Connection">
+    Select the **Cloudflare App Connection** option from the connection options
+    modal. ![Select Cloudflare
+    Connection](/images/app-connections/cloudflare/cloudflare-app-connection-select.png)
+  </Step>
+  <Step title="Input Credentials">
+    Enter your Cloudflare API token and Account ID in the provided fields and
+    click **Connect to Cloudflare** to establish the connection. ![Connect to
+    Cloudflare](/images/app-connections/cloudflare/cloudflare-app-connection-form.png)
+  </Step>
+  <Step title="Connection Created">
+    Your **Cloudflare App Connection** is now available for use in your
+    Infisical projects. ![Cloudflare Connection
+    Created](/images/app-connections/cloudflare/cloudflare-app-connection-created.png)
+  </Step>
+</Steps>
+
+<Info>
+  API token connections require manual token rotation when your Cloudflare API
+  token expires or is regenerated. Monitor your connection status and update the
+  token as needed.
+</Info>
diff --git a/docs/mint.json b/docs/mint.json
index c0c7b7c28..a05b3f882 100644
--- a/docs/mint.json
+++ b/docs/mint.json
@@ -504,6 +504,7 @@
             "integrations/app-connections/azure-devops",
             "integrations/app-connections/azure-key-vault",
             "integrations/app-connections/camunda",
+            "integrations/app-connections/cloudflare",
             "integrations/app-connections/databricks",
             "integrations/app-connections/flyio",
             "integrations/app-connections/gcp",