{"componentChunkName":"component---src-templates-acg-portal-new-template-tsx","path":"/1mrfcmm7n","result":{"data":{"markdownRemark":{"html":"

本文主要介绍，如何配置外部身份提供商SSO入站

\n

操作说明

\n

创建用户池

\n

操作步骤：

\n
    \n
  1. Agent Identity控制台-用户池管理，点击「+ 创建用户池」，弹出创建弹窗
    2. \n
  2. \n

    填写以下字段：

    \n\n
    3. \n
  3. 点击「确定」完成创建
    4. \n
\n

\n

创建客户端

\n

操作步骤：

\n
    \n
  1. Agent Identity控制台-用户池管理-客户端，点击「+ 创建客户端」，弹出创建弹窗
    2. \n
  2. 填写以下字段：
    3. \n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
字段是否必填说明
客户端名称必填1-64 位字符
客户端类型-当前仅支持「Web 应用」，默认选中
允许回调 URL必填用户池中的用户完成登录认证后，页面跳转的目标地址
必须以 https:// 开头，支持添加多个
\n
    \n
  1. 点击「确定」完成创建
    2. \n
\n

\n

创建身份提供商

\n

操作步骤：

\n
    \n
  1. Agent Identity控制台-用户池管理-外部身份提供商，点击「+ 创建提供商」，右侧滑出创建抽屉面板
    2. \n
  2. 填写表单信息
    3. \n
\n

基本信息

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
字段是否必填说明
提供商名称必填最多 64 个字符，该名称会在用户登录页展示供用户选择
提供商类型必填选择提供商支持 SSO 协议
提供商必填选择自定义配置 或 系统内置的常见身份提供商
\n

OAuth 2.0 协议配置

\n

根据选择的提供商不同，展示不同的配置表单：

\n

自定义提供商：

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
字段是否必填说明
客户端 ID必填在外部身份提供商处申请获得的 Client ID
客户端密钥必填在外部身份提供商处申请获得的 Client Secret
授权端点必填OAuth 2.0协议中的授权端点
Token 端点必填OAuth 2.0协议中的Token 端点
用户信息端点必填OAuth 2.0协议中的用户信息端点
Scope 授权范围选填根据提供商要求，配置Scope 授权范围
\n

钉钉提供商：

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
字段是否必填说明
客户端 ID必填钉钉开放平台应用的 AppKey
客户端密钥必填钉钉开放平台应用的 AppSecret
Scope 授权范围必填默认包含 openid（不可移除）和 corpid（可移除），可追加自定义 scope
建议此处不做改动
\n

用户映射

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
字段是否必填说明
自动创建用户-开关控制，默认关闭。开启后，使用身份提供商登录时若平台内不存在映射用户，将自动创建
用户唯一标识 → username必填配置身份提供商返回的用户信息中，用于映射 Agent Identity 用户名的字段。钉钉预置为 unionId
此字段十分关键，用于单点登录时的用户映射，即单点登录到用户池中的哪个用户
显示名映射字段 → displayname选填开启「自动创建用户」后可见。钉钉预置为 nick
自动创建用户时，取身份提供商返回的哪个字段作为用户的显示名，非必填
\n
    \n
  1. 点击「确定」完成创建
    2. \n
\n

说明：

\n\n

\n

用户登录

\n

操作步骤：

\n
    \n
  1. 查看上述创建的客户端详情，复制登录页面 URL
    2. \n
\n

\n
    \n
  1. 用户访问登录页面 URL，使用配置的外部身份提供商登录
    2. \n
\n

","fields":{"slug":"1mrfcmm7n","title":"外部身份提供商SSO入站","date":"2026-07-13","extractedHeadings":[]},"headings":[{"value":"操作说明","depth":2},{"value":"创建用户池","depth":3},{"value":"创建客户端","depth":3},{"value":"创建身份提供商","depth":3},{"value":"基本信息","depth":4},{"value":"OAuth 2.0 协议配置","depth":4},{"value":"用户映射","depth":4},{"value":"用户登录","depth":3}]}},"pageContext":{"isCreatedByStatefulCreatePages":false,"slug":"1mrfcmm7n","prev":{"id":"Jmrfcjepc","name":"用户名密码登录入站","path":"Jmrfcjepc","filePath":"入站/用户名密码登录入站.md","seo":null,"parentIds":["Mmra9qdxq"],"parents":[{"id":"Mmra9qdxq","documentId":"b59f3b97-4320-4203-ac50-9a679442cec0","name":"入站","repoName":"AGENT_ID","filePath":"入站","disabled":false,"path":"Mmra9qdxq","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":""}]},"next":{"id":"umrfcpzi6","name":"出站","path":"umrfcpzi6","filePath":"出站/出站概述.md","seo":null,"parentIds":["wmrfbb8pm"],"parents":[{"id":"wmrfbb8pm","documentId":"66bed742-6b8f-41d0-9be0-6efbd48a6010","name":"出站","repoName":"AGENT_ID","filePath":"出站","disabled":false,"path":"wmrfbb8pm","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":""}]},"parents":[{"id":"Mmra9qdxq","documentId":"b59f3b97-4320-4203-ac50-9a679442cec0","name":"入站","repoName":"AGENT_ID","filePath":"入站","disabled":false,"path":"Mmra9qdxq","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":""}],"specificSeo":null}}}