---
title: 连接 Okta
description: 在 Okta 中创建一个 OpenID Connect Web 应用，在 Pyn 中输入它的签发者、客户端 ID 和密钥，然后分发登录链接。
sidebar:
  order: 2
area: integrations
feature: sso
appPath: /settings/integrations/available
lastVerified: 2026-11-09
version: "2026-11-09"
audience: admin
related:
  - integrations/sso
  - integrations/sso/connect-an-oidc-provider
  - settings/users
intercom:
  - id: "16838252"
    title: Connect to Okta SSO (Pyn 2)
    url: https://intercom.help/pyn/en/articles/16838252-connect-to-okta-sso-pyn-2
    note: replaces
  - id: "6002159"
    title: Connect to Okta SSO
    url: https://intercom.help/pyn/en/articles/6002159-connect-to-okta-sso
    note: "Pyn 1 article, kept for reference"
  - id: "9421970"
    title: Connect to Okta API
    url: https://intercom.help/pyn/en/articles/9421970-connect-to-okta-api
    note: "Pyn 1 article, kept for reference"
translation:
  source: integrations/sso/connect-okta.mdx
  sourceSha: 5cdef886dcd86c273aab2332332ec87bed3c6dbc
---

你希望员工用 Okta 登录 Pyn。Okta 管理员创建一个 OpenID Connect Web 应用，你把它的详细信息粘贴到 Pyn 中，Pyn 给你一个需要注册的重定向 URI 和一个用于分享的登录链接。

## 开始之前

- 你是 Pyn 中的管理员或所有者，并且你的工作区启用了 Okta 集成。
- Okta 管理员可以创建应用集成：**Applications > Create App Integration**、**OIDC - OpenID Connect**、**Web Application**、授权类型仅 **Authorization Code**，并分配应有访问权限的人员或群组。
- 该应用必须在 ID 令牌中发出 `groups` 声明，并且你的组织必须允许它使用 `groups` 范围；Pyn 请求 `openid`、`profile`、`email` 和 `groups`。
- 你有 **Issuer URL**（你的 Okta 组织 URL，或自定义授权服务器的签发者）、**Client ID** 和 **Client Secret**。

![Connect Okta asks for the Issuer URL, Client ID, Client Secret and Redirect URI.](https://support.pyn.ai/media/integrations/sso/integrations-okta-connect.png)

## 步骤

1. 在 Pyn 中，打开左侧导航中的 **Settings**，然后打开 **Integrations** 下的 **Available**。

2. 选择 **Okta** 磁贴。**Connect Okta** 对话框打开。

3. 输入 **Issuer URL**（例如 `https://example.okta.com`）、**Client ID** 和 **Client Secret**。

4. 保持 **Redirect URI** 不变，并按对话框的说明操作："Register the redirect URI as a sign-in redirect URI on the Okta app integration." 你的 Okta 管理员把它添加到应用的 **Sign-in redirect URIs** 中。

5. 选择 **Connect**。Okta 集成面板打开。

6. 在面板上，复制 **Initiate Login URI**："Register this as the initiate login URI on the Okta app integration. Opening it signs you in." 把它分享给你的员工，或把应用添加到 Okta 仪表板。

7. 要让 Okta 设置角色，把声明中所有者、管理员、高级用户和用户对应的群组名称发给 Pyn 支持。面板以只读方式显示由此产生的 **Owner Groups**、**Admin Groups**、**Power User Groups** 和 **User Groups**；要自己管理映射，改用 [Single Sign-On](https://support.pyn.ai/zh-cn/integrations/sso/connect-an-oidc-provider/) 集成。

> **Note:** 要轮换密钥，在面板上的 **Credentials** 下选择 **Replace**。在 **Replace Credentials** 中，输入新的 **Issuer URL**、**Client ID** 和 **Client Secret**，然后选择 **Replace**。如果无法保存，对话框会显示 "The credentials could not be saved. Please try again. If the error persists, contact support."

## 你应该看到什么

磁贴在 **Installed** 下显示 **Active**。打开 Initiate Login URI，或在登录页面上选择 **Continue with SSO** 并输入工作邮箱，会把此人送到 Okta 再带回 Pyn。面板的 **Identities** 标签页列出每个通过 Okta 登录过的人。当详细信息有误或请求没有到达 Pyn 时，对话框会报告 "Okta could not be connected. Check the details and try again. If the error persists, contact support."；确认签发者是提供 OpenID 配置的基础 URL，并且重定向 URI 已完全一致地注册。

## 相关

- [单点登录](https://support.pyn.ai/zh-cn/integrations/sso/)，了解角色映射和员工看到的内容。
- [连接 OpenID Connect 提供商](https://support.pyn.ai/zh-cn/integrations/sso/connect-an-oidc-provider/)，用于 Entra、Auth0、Ping 或 Keycloak。
- [用户](https://support.pyn.ai/zh-cn/settings/users/)，了解群组列表所指的角色。
