@devries-cameron20 / composio Mirror · read-only / commits / a6be5a3cb
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 22, 13:15 UTC

docs: improve authentication page content and structure

- Replace "Tool Router" with "Composio" throughout - Add accordions for auth config, connected accounts, and token expiration FAQs - Restructure "How Composio manages authentication" section - Add icons to Useful links cards - Improve intro and card descriptions Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Sushmithamallesh committed Jan 26, 2026 at 01:42 UTC a6be5a3cb7dd3294e39890c13f601bcdf3a7412c
1 file changed +39 -23
docs/content/docs/authentication.mdx
+39 -23
@@ -1,10 +1,10 @@
1 ---
2 title: Authentication
3 -description: Understand how Tool Router handles user authentication to toolkits
4 -keywords: [connect link, oauth]
3 +description: Understand how Composio handles user authentication to toolkits
4 +keywords: [connect link, oauth, auth config]
5 ---
6
7 -Tool Router handles authentication through Connect Links, hosted pages where users complete OAuth or enter credentials.
7 +Composio simplifies authentication with Connect Links: hosted pages where users securely connect their accounts.
8
9 <video src="/images/connect-link-auth-flow-recording.mp4" autoPlay loop muted playsInline className="rounded-lg border" />
10
@@ -33,44 +33,60 @@ This flow works well for chat applications where users interact directly with th
33 For apps that manage auth outside of chat, use `session.authorize()` to generate Connect Links programmatically. This is useful when you want users to connect accounts during onboarding, or when building a custom connections page.
34
35 <Card icon={<BookOpen />} title="Manual authentication" href="/docs/authenticating-users/manually-authenticating">
36 - Generate Connect Links and manage authentication flows in your application
36 + Control when and how users connect their accounts
37 </Card>
38
39 -## How Tool Router manages auth configs
39 +## How Composio manages authentication
40
41 -When executing a tool, Tool Router needs an auth config to find or create a connected account. It handles this automatically:
41 +Behind the scenes, Composio uses **auth configs** to manage authentication.
42
43 -1. Uses your `authConfigs` override if provided
44 -2. Otherwise, reuses an auth config it previously created for this toolkit
45 -3. If none exists, creates one using Composio managed auth
43 +<Accordions>
44 +<Accordion title="What is an auth config?">
45 +An auth config is a blueprint that defines how authentication works for a toolkit across all your users. It defines:
46 +- **Authentication method** - OAuth2, Bearer token, API key, or Basic Auth
47 +- **Scopes** - what actions your tools can perform
48 +- **Credentials** - whether you'll use your own app credentials or Composio's managed auth
49 +</Accordion>
50 +</Accordions>
51
47 -You don't need to create auth configs manually for most toolkits.
52 +Composio handles this automatically:
53
49 -## Supported auth methods
54 +1. When a toolkit needs authentication, we create an auth config using Composio managed credentials
55 +2. The auth config is reused for all users authenticating with that toolkit
56 +3. Connected accounts are created and linked to your users
57
51 -Tool Router supports **Composio managed OAuth** (GitHub, Gmail, Slack, and most toolkits) and **API key auth** (users enter their own keys via Connect Link).
58 +<Accordions>
59 +<Accordion title="What are connected accounts?">
60 +A connected account is created when a user authenticates with a toolkit. It stores the user's credentials (OAuth tokens or API keys) and links them to your user ID. Each user can have multiple connected accounts—even multiple accounts for the same toolkit (e.g., work and personal Gmail).
61 +</Accordion>
62 +<Accordion title="What happens when tokens expire?">
63 +Composio automatically refreshes OAuth tokens before they expire. You don't need to handle re-authentication or token expiration—connected accounts stay valid as long as the user doesn't revoke access.
64 +</Accordion>
65 +</Accordions>
66
53 -<Callout type="info">
54 -Toolkits without Composio managed auth require a custom auth config. See [Using custom auth configs](/docs/guides/using-custom-auth-configuration).
55 -</Callout>
67 +Most toolkits work out of the box with **Composio managed OAuth**. For API key-based toolkits, users enter their keys directly via Connect Link.
68
57 -## White-labeling
69 +You only need to create a custom auth config when:
70 +- You want to use your **own OAuth app credentials** for white-labeling
71 +- You need **specific OAuth scopes** beyond the defaults
72 +- The toolkit doesn't have Composio managed auth
73 +- You have **existing auth configs** with connected accounts you want to use
74
59 -Show your own branding on OAuth consent screens by creating your own OAuth app.
75 +To bring your own OAuth apps or customize scopes, see [custom auth configs](/docs/using-custom-auth-configuration).
76
61 -## Next steps
77 +## Useful links
78
79 <Cards>
64 - <Card title="In-chat authentication" href="/docs/authenticating-users/in-chat-authentication">
80 + <Card icon={<BookOpen />} title="In-chat authentication" href="/docs/authenticating-users/in-chat-authentication">
81 Let the agent prompt users to authenticate during conversation
82 </Card>
67 - <Card title="Manual authentication" href="/docs/authenticating-users/manually-authenticating">
83 + <Card icon={<BookOpen />} title="Manual authentication" href="/docs/authenticating-users/manually-authenticating">
84 Generate Connect Links programmatically in your app
85 </Card>
70 - <Card title="White-labeling" href="/docs/white-labeling-authentication">
86 + <Card icon={<Palette />} title="White-labeling" href="/docs/white-labeling-authentication">
87 Customize OAuth screens with your branding
88 </Card>
73 - <Card title="Custom auth configs" href="/docs/using-custom-auth-configuration">
74 - Use your own OAuth apps with Tool Router
89 + <Card icon={<Key />} title="Custom auth configs" href="/docs/using-custom-auth-configuration">
90 + Use your own OAuth apps
91 </Card>
92 </Cards>