本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 在桌面上使用 Okta for Amazon Quick 设置企业登录
<a name="desktop-enterprise-okta"></a>


|  | 
| --- |
|  适用于：企业版  | 


|  | 
| --- |
|    目标受众：系统管理员  | 

本页将引导您完成使用 Okta 设置企业登录的所有四个步骤：

1. 在 Okta 中创建 OIDC 应用程序并记录其值。

1. 在 Amazon Quick 管理控制台中添加扩展访问权限。

1. 在 Amazon Quick 控制台中创建扩展。

1. 下载、验证和分发桌面应用程序。

**注意**  
在开始之前，请查看中的先决条件[在桌面上设置 Amazon Quick 以进行企业部署](desktop-enterprise-setup.md)。

## 第 1 步：在 Okta 中创建 OIDC 应用程序
<a name="desktop-enterprise-okta-step1"></a>

在 Okta 中注册 OIDC 原生应用程序。Amazon Quick 桌面应用程序使用此客户端通过 PKCE 的授权码流程对用户进行身份验证，并在登录时请求`openid``profile``email`、、和`offline_access`范围。

有关更多信息，请参阅 Okta 文档[中的](https://help.okta.com/en-us/content/topics/apps/apps_app_integration_wizard_oidc.htm)创建 OpenID Connect 应用程序集成。

**创建 Okta OIDC 本机应用程序**

1. 在 Okta 管理控制台中，导航到**应用程序 → 应用程序 → 创建应用程序集成**。

1. 选择 ** OIDC-OpenID Connect ** 作为登录方法。

1. 选择 “**本机应用程序” ** 作为应用程序类型，然后选择 “**下一步” **。

1. 配置以下设置：    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_cn/quick/latest/userguide/desktop-enterprise-okta.html)

1. 选择**保存**。

1. 在 “常**规**” 选项卡上，记下**客户端 ID **。

Okta 会自动为原生应用程序强制执行 PKCE (S256)。

**验证身份验证设置**

1. 在应用程序集成中，转到 ** “**常规” 选项卡。

1. 在 “**常规设置” 下**，确认应用程序类型为 “**本机”**，客户端身份验证为 “**无”**（公共客户端），并且 PKCE 为**必填项**。

1. 在 “**登录” 下**，确认将其列`http://localhost:18080`为重定向 URI。

1. **如果您进行了任何更改，请选择 “**保存”。

记录以下 OIDC 端点。在步骤 2 中，输入这些值以及**之前记下的**客户端 ID。`<OKTA_DOMAIN>`替换为您的 Okta 域名（例如，`your-org.okta.com`）。有关端点参考，请参阅 Okta 文档[中的 PKCE ](https://developer.okta.com/docs/guides/implement-grant-type/authcodepkce/main/) 授权码。


| Field | Value | 
| --- | --- | 
| 客户端 ID | “常规” 选项卡中的客户端 ID | 
| 发布者 URL | https://<OKTA\_DOMAIN> | 
| 授权端点 | https://<OKTA\_DOMAIN>/oauth2/v1/authorize | 
| 令牌端点 | https://<OKTA\_DOMAIN>/oauth2/v1/token | 
| JWKS URI | https://<OKTA\_DOMAIN>/oauth2/v1/keys | 

**使用标准 Okta 域，不是管理子域**  
在这些终端节点中使用您的标准Okta域（例如`your-org.okta.com`），而不是管理员控制台地址栏中显示的`-admin`子域（`your-org-admin.okta.com`）。该`-admin`子域不托管 OAuth 端点，因此使用它会导致登录失败并出现 HTTP 404 错误。

## 第 2 步：在 Amazon Quick 管理控制台中添加扩展访问权限
<a name="w2aac51c11c23c15"></a>

在 Amazon Quick 管理控制台中，使用您在步骤 1 中记录的 OIDC 终端节点值和客户端 ID 添加扩展访问权限。

**添加扩展访问权限**

1. 登录亚马逊 Quick 管理控制台并选择**管理账户**。

1. 在左侧导航窗格的 “**权限” 下**，选择 “**扩展访问权限” **。

1. 选择 “**添加扩展访问权限” **。

1. 在 ** “选择服务” 下**，选择 ** Amazon Quick（Quick 桌面应用程序）**，然后选择 “**下一步” **。

1. 使用您在步骤 1 中记录的值输入分机详细信息：    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_cn/quick/latest/userguide/desktop-enterprise-okta.html)

1. 选择**添加**。
**重要**  
在选择 “**添加” 之前，请验证所有值是否正确**。扩展访问配置在创建后无法编辑。如果任何值不正确，则必须删除扩展访问权限并创建一个新的扩展访问权限。

## 第 3 步：在 Amazon Quick 控制台中创建扩展
<a name="w2aac51c11c23c17"></a>

在 Amazon Quick 管理控制台中添加扩展访问权限后，在 Amazon Quick 控制台的**扩展**页面上创建扩展。

**创建扩展**

1. 在 Amazon Quick 控制台的左侧导航窗格中，选择**扩展**。如果您没有看到**扩展程序**，请选择 “**更多” ** 进行查找。

1. 选择 “**添加扩展” **。

1. 选择您在步骤 2 中创建的用于快速**扩展访问的**桌面应用程序，然后选择 “**下一步” **。

1. 选择**创建**。

**重要**  
步骤 2 和步骤 3 均为必填项。如果您添加扩展程序访问权限但未创建扩展程序，则企业登录不可用，用户会看到错误：“尚未为此帐户配置 Quick Desktop 的企业登录。”

**注意**  
创建扩展程序是一次性的、账户级别的操作。管理员创建扩展程序后，该帐户中的所有用户均可使用企业登录。个人用户无需自己启用扩展程序，他们只需要下载桌面应用程序并登录即可。

## 步骤 4：下载、验证和分发桌面应用程序
<a name="w2aac51c11c23c19"></a>

在此步骤中，您将下载并安装桌面应用程序，验证企业登录是否有效，然后将该应用程序分发给您的用户。

首先，从亚马逊 Quick 控制台下载应用程序。

**下载桌面应用程序**

1. 在 Amazon Quick 控制台的左侧导航窗格中，选择**扩展**。如果您没有看到**扩展程序**，请选择 “**更多” ** 进行查找。

1. 选择您在步骤 3 中创建的快速桌面扩展程序。

1. 选择 “更多选项” 图标 (**...**) 用于扩展。

1. 根据您的操作系统**，选择 ** Windows ** 版下载**或为 Mac 版下载。

然后，安装该应用程序。有关安装说明，请参阅[开始使用](getting-started-desktop.md)。

安装应用程序后，验证企业登录是否有效。

**验证企业登录**

1. 打开亚马逊 Quick 桌面应用程序。

1. 在登录屏幕上，选择 “**继续使用 SSO**”。

1. （可选） AWS 区域 从列表中选择您的，或选择**动态，**让应用程序自动检测您的区域。

1. 使用您的公司凭证进行身份验证。应用程序重定向到您的身份提供商，然后在身份验证成功后返回主屏幕。

**提示**  
如果登录失败，请根据步骤 1 中的 OIDC 端点和客户端 ID 验证您在步骤 2 中输入的值。如果任何值不正确，请删除 Amazon Quick 管理控制台**中 “**权限” → “扩展程序访问权限” 下的扩展访问权限，并使用正确的值重复步骤 2。有关更多帮助，请参阅 [桌面版 Amazon Quick 企业登录疑难解答](desktop-enterprise-setup-troubleshooting.md)。

最后，验证设置后，将应用程序分发给您的用户。引导他们[开始使用](getting-started-desktop.md)访问以获取下载、安装和登录说明。用户选择 “**继续使用 SSO” ** 并使用其公司凭据登录，无需为每位用户进行额外的配置。