@devries-cameron20 / composio Mirror · read-only / commits / f4cccd2de
Fork 0

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

Mirrored from https://github.com/Camo67/composio.git

Synced Nov 21, 19:45 UTC

docs: add Security and Data section (overview, data retention/ZDR, sub-processors)

New /docs/security section mirroring the structure of comparable security docs: - security/overview: posture, isolation, credential protection, Trust Center links - security/data-retention: what's stored, 1-year retention, the Log storage / ZDR toggle ("Don't store data"), encryption scope - security/sub-processors: which providers see payloads vs metadata; defers the authoritative list to trust.composio.dev Grounded in code (logVisibilitySetting, ClickHouse TTL, AES-256-GCM secret encryption). Items needing trust-owner sign-off are marked with TRUST-OWNER comments. DRAFT. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Palash Kala committed Jun 5, 2026 at 16:27 UTC f4cccd2de87ce25dc537aef497b4ef463d2b535f
4 files changed +129
docs/content/docs/meta.json
+4
@@ -22,6 +22,10 @@
22 "triggers",
23 "setting-up-triggers",
24 "webhook-verification",
25 + "---Security and Data---",
26 + "security/overview",
27 + "security/data-retention",
28 + "security/sub-processors",
29 "---Direct Tool Execution Guides (Legacy)---",
30 "sessions-vs-direct-execution",
31 "tools-direct",
docs/content/docs/security/data-retention.mdx new
+52
@@ -0,0 +1,52 @@
1 +---
2 +title: Data retention and Zero Data Retention
3 +description: What Composio stores from your tool calls, how long it is retained, and how to minimize or eliminate payload storage with the Log storage setting.
4 +keywords: [data retention, zero data retention, ZDR, logs, log storage, privacy, dont store data]
5 +---
6 +
7 +Composio stores an audit log of tool executions so you can observe and debug your agents. You control how much of each call is stored, including running with no payload retention at all.
8 +
9 +## What Composio stores
10 +
11 +When your agent runs a tool, Composio writes an execution log. Each log records:
12 +
13 +- which toolkit and action ran, success or failure and the status, the connection and auth-config IDs, the `user_id` you supplied, timing, and the runtime/source;
14 +- by default, the **request arguments** and the **response data** of the call.
15 +
16 +Trigger events are logged similarly. Composio identifies your end users only by the opaque `user_id` you provide; it does not store end-user identities beyond that.
17 +
18 +## How long we retain it
19 +
20 +Tool execution logs and trigger event logs are retained for up to **one year**, after which they are automatically deleted.
21 +
22 +{/* TRUST-OWNER: code-confirmed TTL is 1 year for tool_execution_logs and trigger_event_logs. Confirm retention windows for other data classes (connected-account data, webhook delivery records, support transcripts) before stating them. The "30 days" figure mentioned on a call is NOT in code. */}
23 +
24 +## Log storage: control what we store
25 +
26 +You control how much of each call is stored, per project, in **Settings → General → Log storage**:
27 +
28 +- **Store all logs** (default) — the full request and response payloads are stored on the execution log.
29 +- **Don't store data** — Composio does not persist the request arguments or the response data of your tool calls. It keeps only the audit record: which tool ran, when, success or failure, the IDs, and timing.
30 +
31 +Selecting **Don't store data** lets you run Composio with **zero retention of tool-call payloads** while keeping an audit trail. The same setting governs [Proxy Execute](/docs/proxy-execute) logging, which fails closed: if the setting cannot be read, payloads are not stored.
32 +
33 +<Callout type="info">
34 +To enable: open the Dashboard, choose your project, go to **Settings → General → Log storage**, and select **Don't store data**.
35 +</Callout>
36 +
37 +## What "Don't store data" does and does not cover
38 +
39 +- **Covered:** the request arguments and response data are dropped from the durable execution log.
40 +- **Not covered** (this is inherent to running a tool call): while a call runs, the data is still sent to the destination provider and passes through Composio's execution path; file payloads may transit object storage; and trigger payloads are delivered to your configured destinations in real time. See [Sub-processors and data flow](/docs/security/sub-processors).
41 +
42 +{/* TRUST-OWNER: real-time trigger delivery is not gated by this setting; confirm phrasing. */}
43 +
44 +## Encryption
45 +
46 +Connected-account credentials, auth configs, and API keys are encrypted at rest using AES-256-GCM, and all traffic is encrypted in transit using TLS.
47 +
48 +{/* TRUST-OWNER: at-rest encryption of the execution-log store itself is NOT asserted here. Only secret-field AES-256-GCM is code-confirmed. Confirm with the Trust Center before adding a broader at-rest claim. */}
49 +
50 +## Stronger guarantees
51 +
52 +For a contractual zero-data-retention agreement or shorter retention windows, contact your Composio account team or support. For our data-handling policies and the current sub-processor list, see the [Composio Trust Center](https://trust.composio.dev).
docs/content/docs/security/overview.mdx new
+43
@@ -0,0 +1,43 @@
1 +---
2 +title: Security
3 +description: How Composio secures your data, credentials, and tool execution, and where to find our compliance reports.
4 +keywords: [security, compliance, SOC 2, trust center, encryption, isolation, data]
5 +---
6 +
7 +Composio is built with security at its core. We use least-privilege defaults, isolate every organization and project, encrypt credentials, and give you controls over what we store.
8 +
9 +## Compliance and the Trust Center
10 +
11 +Composio is SOC 2 Type II compliant. For our latest reports and certifications (the SOC 2 Type II report, our sub-processor list, and more), visit the [Composio Trust Center](https://trust.composio.dev).
12 +
13 +{/* TRUST-OWNER: confirm the full certification list to name inline. SOC 2 Type II is the only one currently stated in our public FAQ; add ISO 27001 etc. only if confirmed. */}
14 +
15 +## Isolation and access control
16 +
17 +- Organizations and projects isolate your resources. Data from one project is not visible to another.
18 +- API keys are scoped, support per-key IP allowlisting, and can opt in to capabilities such as Proxy Execute at creation.
19 +- Multi-factor authentication (MFA) is available for Dashboard sign-in and can be enforced by an organization admin.
20 +
21 +## Credential protection
22 +
23 +- Connected-account credentials, auth configs, and API keys are encrypted at rest using AES-256-GCM, and all traffic is encrypted in transit using TLS.
24 +- Connected-account tokens are redacted by default in API responses, for both Composio-managed and custom auth configs. To act on a provider directly, use [Proxy Execute](/docs/proxy-execute).
25 +
26 +## Webhooks and triggers
27 +
28 +Webhook deliveries are signed. Verify the `webhook-signature` header before trusting a payload. See [Webhook verification](/docs/webhook-verification).
29 +
30 +## Your responsibilities
31 +
32 +Composio executes the tools and connections you configure. You control which toolkits are enabled, which accounts are connected, and what your agents are allowed to do. Review the access you grant, and treat connected-account scopes as you would any production credential. Composio does not security-audit the third-party tools or MCP servers you choose to connect.
33 +
34 +## Reporting a vulnerability
35 +
36 +{/* TRUST-OWNER: confirm the disclosure channel (security@composio.dev / bug-bounty URL). */}
37 +To report a security issue, contact `security@composio.dev`. Please do not disclose vulnerabilities publicly until we have addressed them.
38 +
39 +## Related resources
40 +
41 +- [Data retention and Zero Data Retention](/docs/security/data-retention)
42 +- [Sub-processors and data flow](/docs/security/sub-processors)
43 +- [Composio Trust Center](https://trust.composio.dev): security certifications and compliance.
docs/content/docs/security/sub-processors.mdx new
+30
@@ -0,0 +1,30 @@
1 +---
2 +title: Sub-processors and data flow
3 +description: Where your data goes when you use Composio, and which providers may process tool payloads versus only metadata.
4 +keywords: [sub-processors, subprocessors, data flow, third parties, data residency, gdpr]
5 +---
6 +
7 +When you execute tools through Composio, data flows to a small set of infrastructure providers. The authoritative, maintained sub-processor list lives in the [Composio Trust Center](https://trust.composio.dev); this page explains the categories so you can reason about exposure.
8 +
9 +## Providers that may process tool payloads
10 +
11 +- **The destination tool provider** (for example Gmail, Slack, Salesforce) — the tool call is made directly to them.
12 +- **Composio's execution backend and log store** — payloads are stored only when **Log storage** is set to **Store all logs** (see [Data retention](/docs/security/data-retention)).
13 +- **Object storage** (AWS S3 / Azure Blob) — for file payloads in tool calls.
14 +- **Code sandbox** (E2B) — only when you use the remote workbench or code execution.
15 +- **Real-time trigger delivery** — trigger payloads are streamed to the destinations you configure.
16 +
17 +## Providers that process only metadata or non-payload data
18 +
19 +- **Observability** (Datadog) — operational metadata and diagnostics.
20 +- **Tool search, grounding, and embeddings** providers — receive your natural-language search query when discovering tools, not your execution payloads.
21 +- **Vector store** — stores the tool catalog and query embeddings.
22 +- **Product analytics and billing** — usage and account data, not tool payloads.
23 +
24 +## Data residency
25 +
26 +Composio's primary processing region is AWS **us-east-1 (US)**.
27 +
28 +{/* TRUST-OWNER: confirm regional/EU options and whether to list named vendors + regions here vs. only on the Trust Center. Temporal payload-transit is unverified in env.ts — confirm before listing it as a payload sub-processor. */}
29 +
30 +For the current, authoritative list of sub-processors and our data-processing terms, see the [Composio Trust Center](https://trust.composio.dev).