尧图网站设计 尧图网站设计YAOTU DESIGN
ARTICLE DETAIL

资讯详情

深耕网站设计与一线实操的经验洞察。

Composio Snapchat 工具包认证指南:客户自有 OAuth 凭据配置与授权排障

Composio Snapchat 工具包认证指南:客户自有 OAuth 凭据配置与授权排障 Composio Snapchat 工具包认证指南客户自有 OAuth 凭据配置与授权排障【免费下载链接】composioComposio powers 1000 toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.项目地址: https://gitcode.com/GitHub_Trending/co/composio本篇技术指南以 Composio 开源仓库中的 Snapchat 认证说明 为核心讲解当前snapchat工具包基于OAuth2 客户自有customer-owned开发者应用凭据的认证模型包括 client ID / client secret 的配置方式、redirect URI 与 scopes 的注册要求以及登录前授权被拒这类典型错误的排查思路。读完本文你将能够独立完成 Snapchat 工具包的认证配置并准确区分授权流程错误与用户密码错误的判断依据。认证模式概览Snapchat 使用客户自有 OAuth 凭据与许多默认使用 Composio 托管 OAuth 应用managed auth的工具包不同当前snapchat工具包走的是客户自有 OAuth 凭据路线。根据 docs/kb/source/toolkits/snapchat/public.md 的说明该工具包支持 OAuth2并要求开发者提供自己 Snapchat 应用的 client ID 与 client secret。这一点在仓库的 Toolkit 元数据中得到印证docs/public/data/toolkits.json 中snapchat条目声明类别marketing营销认证方案OAUTH2工具数量139 个涵盖广告账户、营销活动、受众分段、媒体上传、转化事件等能力认证配置名称snapchat_oauth版本20260721_00从authConfigDetails字段可以看出Snapchat 的认证配置必填项恰好是client_id与client_secret这正是客户自有 OAuth 应用的典型特征——你需要先在 Snapchat 开发者平台创建自己的应用再把应用凭据托管到 Composio而不是使用 Composio 的默认开发者应用。配置前置创建 Snapchat 开发者应用在使用 Composio 的 auth-config 流程前需要先在 Snapchat 侧准备一个 OAuth 应用在 Snapchat 开发者平台创建应用获取该应用专属的client ID与client secret将 Composio auth-config 流程中显示的精确 redirect URI注册到该应用的 OAuth 允许列表allow list中只申请该应用已获批准approved的 Snapchat 权限scopes不要请求应用尚未获批的权限范围。关于 redirect URI 与 scopes 的具体取值仓库元数据给出了明确默认值详见下文配置字段详解。配置字段详解snapchat_oauth 的必填与可选参数依据 docs/public/data/toolkits.json 中snapchat_oauth的authConfigDetails该 OAuth2 配置的字段结构如下字段必填类型说明默认值client_id是stringSnapchat 应用的 Client ID无client_secret是stringSnapchat 应用的 Client Secret无oauth_redirect_uri否string需要添加到应用 OAuth 允许列表的回调地址https://backend.composio.dev/api/v1/auth-apps/addscopes否string向用户请求的权限逗号分隔snapchat-marketing-api,snapchat-offline-conversions-api,snapchat-profile-api要点说明redirect URI 必须逐字符一致。Snapchat 端注册的回调地址必须与 Composio 流程显示/默认的oauth_redirect_uri完全相同任何路径或参数的差异都会导致授权请求在到达登录页之前被拒绝。scopes 默认值为三个snapchat-marketing-api营销 API、snapchat-offline-conversions-api离线转化 API、snapchat-profile-api个人资料 API。配置时建议只保留你实际使用的权限且必须是该 Snapchat 应用已获批的权限。默认的oauth_redirect_uri与 docs/content/docs/auth-configuration/custom-auth-configs.mdx 中描述的 Composio 标准回调地址https://backend.composio.dev/api/v1/auth-apps/add一致说明 Snapchat 沿用通用 OAuth2 自定义凭据流程。通过 SDK 创建自定义 Auth ConfigSnapchat 的自有凭据配置属于 Composio 的custom auth config模型。在 python/composio/core/models/auth_configs.py 中AuthConfigs资源类提供了list/create/get/update/delete/enable/disable等完整操作能力其中create接收toolkit与options两个参数options支持托管认证use_composio_managed_auth与自定义认证use_custom_auth两种变体。参考 python/examples/auth_configs.py 中 Notion 自定义认证的写法Snapchat 对应的 Python 创建逻辑为from composio import Composio composio Composio() # 查看 Snapchat 认证配置需要哪些必填字段 required_fields composio.toolkits.get_auth_config_creation_fields( toolkitSNAPCHAT, auth_schemeOAUTH2, ) print(required_fields) # 创建客户自有凭据的 Snapchat auth config auth_config composio.auth_configs.create( toolkitsnapchat, options{ name: My Snapchat App, type: use_custom_auth, auth_scheme: OAUTH2, credentials: { client_id: your-snapchat-client-id, client_secret: your-snapchat-client-secret, oauth_redirect_uri: https://backend.composio.dev/api/v1/auth-apps/add, scopes: snapchat-marketing-api,snapchat-profile-api, }, }, ) print(auth_config)注意client_id与client_secret必须与 Snapchat 开发者应用完全一致oauth_redirect_uri应与你在 Snapchat 应用里注册的地址逐字符匹配scopes只列该应用已获批的权限逗号分隔。创建成功后即可用该auth_config的 ID 为用户发起连接connected account流程引导用户完成 Snapchat 授权登录之后 Composio 负责存取并刷新 access/refresh token。授权失败排查区分应用配置错误与用户密码错误原文档特别强调了一个容易误判的场景如果 Snapchat 在用户登录之前就拒绝了授权请求应检查该 Snapchat 应用上的 client ID、redirect URI 与已获批的 scopes。登录前出现的授权错误并不能证明用户的 Snapchat 密码有误。排查顺序建议如下client ID 是否正确确认填入的 client ID 与 Snapchat 开发者应用一致没有复制错位或截断redirect URI 是否精确匹配核对 Composio 流程中显示的 redirect URI 是否逐字符注册到了 Snapchat 应用含协议、域名、路径大小写敏感scopes 是否已获批确认请求的权限都在该 Snapchat 应用获批范围内未获批的 scope 会在授权握手阶段被 Snapchat 拒绝判断错误阶段错误发生在用户到达 Snapchat 登录页之前pre-login说明是 OAuth 应用配置问题而非账号问题只有用户完成输入并提交凭据后才出现的失败才可能与账号凭据相关。这一判断逻辑对应到仓库的认证架构中Snapchat 认证配置的必填字段全部是应用级凭据docs/public/data/toolkits.json 的authConfigDetailsconnected_account_initiation阶段没有额外必填项说明整条授权链路的前置条件完全由应用配置质量决定。延伸阅读Snapchat 认证知识库条目衍生版 与 docs/content/kb/guide/toolkits-snapchat.mdx同一内容的知识库渲染版本自定义 Auth Config 完整指南涵盖何时使用自定义凭据的决策表、OAuth 步骤式配置流程与 Python/TypeScript 双语言示例Auth Config 概念总览说明 auth config 作为跨所有用户的认证蓝图其四种认证方案OAUTH2/API_KEY/BEARER_TOKEN/BASIC与 managed vs custom 的取舍Auth Configs SDK 实现AuthConfigs资源类的完整方法签名与行为Auth Config SDK 示例从查询必填字段、创建、更新到启用/禁用/删除的端到端可运行示例。【免费下载链接】composioComposio powers 1000 toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.项目地址: https://gitcode.com/GitHub_Trending/co/composio创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表