本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 在桌面上使用 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`、`email`、 `profile`和 `offline_access`範圍。

如需詳細資訊，請參閱 Okta 文件中的[建立 OpenID Connect 應用程式整合](https://help.okta.com/en-us/content/topics/apps/apps_app_integration_wizard_oidc.htm)。

**建立 Okta OIDC 原生應用程式**

1. 在 Okta 管理員主控台中，導覽至**應用程式 → 應用程式 → 建立應用程式整合**。

1. 選取 **OIDC - OpenID Connect** 作為登入方法。

1. 選取**原生應用程式**做為應用程式類型，然後選擇**下一步**。

1. 進行下列設定：


<table>
<thead>
  <tr><th>設定</th><th>Value</th></tr>
</thead>
<tbody>
  <tr><td>應用程式整合名稱</td><td><code>Amazon Quick Desktop</code></td></tr>
  <tr><td>授予類型</td><td>授權碼和重新整理權杖</td></tr>
  <tr><td>登入重新導向 URIs</td><td><code>http://localhost:18080</code></td></tr>
  <tr><td>指派</td><td>指派給適當的使用者或群組</td></tr>
</tbody>
</table>


1. 選擇**儲存**。

1. 在**一般**索引標籤上，記下**用戶端 ID**。

Okta 會自動為原生應用程式強制執行 PKCE (S256)。

**驗證身分驗證設定**

1. 在應用程式整合中，前往**一般**索引標籤。

1. 在**一般設定**下，確認應用程式類型為**原生**，用戶端身分驗證為**無** （公有用戶端），且 PKCE 為**必要**。

1. 在 **LOGIN** 下，確認 `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/)。


| 欄位 | 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. 登入 Amazon Quick 管理主控台，然後選擇**管理帳戶**。

1. 在左側導覽窗格**的許可**下，選擇**延伸存取**。

1. 選擇**新增延伸項目存取**。

1. 在**選取服務**下，選取 **Amazon Quick （適用於 Quick 的桌面應用程式）**，然後選擇**下一步**。

1. 使用您在步驟 1 中記錄的值輸入延伸模組詳細資訊：


<table>
<thead>
  <tr><th>欄位</th><th>Value</th></tr>
</thead>
<tbody>
  <tr><td>名稱</td><td>此延伸存取的名稱 （例如 <code>QuickDesktop-access</code>)。這只是內部參考，未在 IdP 中設定。僅使用英數字元和連字號，不含空格。</td></tr>
  <tr><td>說明</td><td>（選用） 此延伸存取的說明，僅供您參考。</td></tr>
  <tr><td>發行者 URL</td><td>步驟 1 的確切 OIDC 發行者 URL，包括任何必要的路徑尾碼。</td></tr>
  <tr><td>授權端點</td><td>步驟 1 中的 OIDC 授權端點 URL</td></tr>
  <tr><td>權杖端點</td><td>步驟 1 中的 OIDC 字符端點 URL</td></tr>
  <tr><td>JWKS URI</td><td>步驟 1 中的 JSON Web 金鑰集 URI</td></tr>
  <tr><td>用戶端 ID</td><td>您在步驟 1 中記錄的 OIDC 用戶端識別符 （用戶端 ID 或應用程式 （用戶端） ID)。必要.</td></tr>
</tbody>
</table>


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>

在此步驟中，您會下載並安裝桌面應用程式、驗證企業登入是否正常運作，然後將應用程式分發給您的使用者。

首先，從 Amazon Quick 主控台下載應用程式。

**下載桌面應用程式**

1. 在 Amazon Quick 主控台的左側導覽窗格中，選擇**延伸模組**。如果您沒有看到**延伸模組**，請選擇**更多**以尋找。

1. 選取您在步驟 3 中建立的快速桌面擴充功能。

1. 選擇延伸模組的更多選項圖示 (**...**)。

1. 根據您的作業系統，選擇**適用於 Windows** 的下載或**適用於 Mac 的下載**。

然後，安裝應用程式。如需安裝指示，請參閱[開始使用](getting-started-desktop.md)。

安裝應用程式後，請確認企業登入是否正常運作。

**驗證企業登入**

1. 開啟 Amazon 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 繼續**，並使用其公司登入資料登入 - 不需要額外的每位使用者組態。