您可以在 Omnissa Connect 帳戶設定中管理您的個人設定檔。從您的設定檔中，您可以選取安全性設定並產生和管理 API Token。您也可以檢視您在組織中擁有的角色。
如何檢視我的設定檔
若要在 Omnissa Connect 中存取您的帳戶，請從 Omnissa Connect 首頁選取帳戶設定功能表項目。您的設定檔包含您建立 Omnissa 帳戶時所提供的詳細資料。
附註：您無法變更註冊時所使用的電子郵件地址。
附註：有關將聯盟帳戶與 Omnissa 帳戶連結的詳細資訊，請參閱聯盟帳戶、Omnissa 帳戶以及如何連結它們。
如何產生 API Token
當您進行獲授權的 API 連線時，可以使用 API Token 來驗證自己。API Token 用於交換存取 Token，並按組織授權存取。您可以從 Omnissa Connect 的帳戶頁面產生 API Token。
Token 權限範圍
Token 是使用選取英數字元的特殊演算法產生的。每個 Token 都是唯一的 65 個字元組合。產生 Token 時，您可以決定其持續時間和範圍。
- Token 的存留時間 (TTL) 可以從數分鐘到數個月不等，或設定為永不過期。預設持續時間為六個月。
- 權限範圍設定提供一種方式，用來控制您的 Token 在組織中可存取的區域，具體包括組織中的哪些角色、哪些服務以及權限層級。
先決條件
請為您的 API Token 準備一個安全且受保護的儲存位置。
操作程序
附註：
- 遭到入侵時，不會到期的 Token 可能存在安全性風險。如果 Token 遭到外洩，請立即將其撤銷。
- 即使您為 Token 指派所有角色存取權限，此 Token 仍僅會擁有您帳戶支援的存取角色。
- 如果您需要查看指派給您的組織角色或服務角色，請使用帳戶設定頁面中的我的角色索引標籤。
- 在 Omnissa Connect 的左側導覽中，選取帳戶設定 > API Token。
- 選取產生新的 API Token 連結。
- 輸入 Token 名稱。
- 在 Token TTL 文字欄位中指定 Token 的預期存留時間。
- 定義 Token 的範圍。您的選擇必須依據您帳戶支援的角色。如有需要，您可以選取所有角色，並授與 Token 存取所有組織和服務角色的權限。
| 範圍 | 描述 |
|---|---|
| 組織角色 | 組織角色決定了使用者對組織資源的存取權。 為您的 API Token 選取一或多個組織角色。 |
| 服務角色 | 服務角色是內建的預先定義權限集合，用於授與對 Omnissa 服務訂閱的存取。 使用服務名稱旁邊的箭頭圖示可展開可用於該服務的角色，然後為您的 API Token 選取一或多個服務角色。 |
| 權限 | 某些服務允許您為服務角色指派一組有限的權限集合，來進行更精細的選擇。 選取服務角色時，可用權限將顯示在表格右側。為您的 API Token 選取相關的服務權限。 |
- (可選) 選取 Open ID 核取方塊以擷取包含詳細使用者資訊且符合 Open ID 的 Token。
- (可選) 設定電子郵件喜好設定，以便在 Token 即將到期時接收提醒。
- 選取產生。
- 將 Token 認證儲存在安全的位置，以便日後需要時能擷取使用。
基於安全考量，在您產生 Token 之後，Omnissa Connect 只會在 API Token 索引標籤中顯示 Token 的名稱，而不會顯示 Token 認證。您將無法再透過從這個頁面複製認證來重複使用 Token。 - 選取繼續。
範例：使用 API Token 與 Omnissa Connect API 互動
透過用 API Token 換取驗證 Token，您可以使用 API Token 與我們的 API 互動。
- 產生 API Token。
- 對 https://connect.omnissa.com/csp/gateway/am/api/auth/api-tokens/authorize 執行 POST。
- 在標頭中，加入下列要求：
- accept:
application/json - 內容類型：
application/x-www-form-urlencoded/
- accept:
- 在本文中，加入
refresh_token={token value}要求。 - 在您的指令碼 HTTP 呼叫中的
csp-auth-token標頭中使用驗證 Token。
如何管理我的 API Token
做為 API Token 的唯一擁有者，您有責任妥善地安全儲存、備份並管理它們。
若要在 Omnissa Connect 中檢視和管理 API Token，請移至帳戶設定 > API Token。
- 若要重新產生 Token，請選取重新產生。這會將現有 Token 取代為新 Token。若要繼續呼叫 API，您必須在 API 呼叫中更新 Token。
- 若要停用 Token，請選取撤銷。這將撤銷 API Token 和相關聯的存取 Token。
- 為了防止未經授權存取您組織的資源，請將您產生的 API Token 保存在安全且受保護的位置。Omnissa Connect 不會檢查持有證明，但在列出的情境中會記錄 Token 使用稽核事件。
- 使用者產生 API Token。
- 使用者撤銷一或所有個人 Token。
- 使用者嘗試透過 API Token 重新整理產生存取 Token 失敗。
附註：若要在 Omnissa Connect 中檢視稽核事件記錄，您必須具有擁有者角色。
- 若要為 API 額外增加一層安全性，您可以將多重要素驗證 (MFA) 加入 API Token。如需詳細資訊，請參閱驗證原則。
停用 API Token 時會發生什麼情況？
如果您的 API Token 因違反組織中設定的任何原則或不遵守組織的標準，而遭擁有者停用，您將收到一封來自 Omnissa Connect 的電子郵件通知。
移至帳戶設定 > API Token 索引標籤，您會看到已停用的 Token 會以已停用標籤標示，並顯示在 API Token 名稱旁。
使用 API Token 時的常見任務
檢視最常見的 API Token 自助式管理任務清單。
| 如果要... | 步驟... |
|---|---|
| 延長已過期 API Token 的有效期。 | 您必須重新產生 Token。 |
| 重新產生有效的 API Token。 | 您可以隨時重新產生 Token。 如果您重新產生 Token，請撤銷先前 Token 的所有執行個體。如果您已使用 Token，例如在其中一個指令碼中，請記得將其取代為新產生的 Token。 |
| 取代已遭破壞的 API Token。 | 如果認為 Token 已遭洩露，您可以撤銷 Token，以防止未經授權的存取。 然後產生新的 Token 來更新授權。 |
| 銷毀仍然有效的 API Token。 | 透過撤銷有效的 API Token 可以將其銷毀。 |
| 復原丟失的 API Token。 | 無法復原丟失的 Token。 您必須撤銷丟失的 Token 並產生新的 Token。 |
| 重新啟用被擁有者停用的 API Token | 如果已停用的 Token 仍然有效，則必須連絡擁有者並請求重新啟用。 |
如何在組織中管理我的角色
角色由擁有者指派，而您通常會同時具有組織角色與服務角色。
使用帳戶設定頁面來檢視和管理您的角色。
- 從左側導覽，選取帳戶設定。
- 選取我的角色索引標籤。
- 若要刪除不再需要的服務角色或其他組織角色，請選取服務名稱以展開您在該服務下的所有角色。找到您要移除的服務角色後，選取刪除角色。為了使刪除角色的請求生效，必須經擁有者核准。
- 若要檢視過去的角色請求，請向下捲動至頁面的我的請求歷程記錄區段。
- 若要針對組織中現有的服務申請額外的服務角色，請選擇請求角色並進行選取。
如何設定我的 Cookie 喜好設定
Omnissa 使用追蹤技術來保護並促進服務交付、提供支援和建議、改善服務與使用者體驗，以及其他在隱私權注意事項中詳細說明的分析用途。
如果您想要退出 Cookie，請設定您的喜好設定。
- 在 Omnissa Connect 的左側導覽中，選取帳戶設定。
- 選取 Cookie 索引標籤。
- 進行選取。
此頁面對您有幫助嗎?