Skip to main content
此產品有較新版本可以使用。
本繁體中文版使用機器翻譯,譯文僅供參考,若與英文版本牴觸,應以英文版本為準。

使用 PowerShell 、 sccli 和 REST API 在 SnapCenter 伺服器中設定 MFA

貢獻者

您可以使用 PowerShell 、 sccli 和 REST API 在 SnapCenter 伺服器中設定 MFA 。

SnapCenter MFA CLI 驗證

在 PowerShell 和 sccli 中、現有的 Cmdlet ( Open-SmConnection )會以另一個稱為「 AccessToken 」的欄位來延伸、以使用承載權杖來驗證使用者。

Open-SmConnection -Credential <PSCredential> [-SMSbaseUrl <String>] [-Port <String>] [-RoleName <String>] [ -AccessToken <string>]

執行上述 Cmdlet 之後 , 會建立工作階段 , 讓個別使用者進一步執行 SnapCenter Cmdlet 。

SnapCenter MFA REST API 驗證

在 REST API 用戶端(例如 Postman 或 swagger )中使用 _Authorization=B承載 <access token> 格式的承載權杖、並在標頭中提及使用者 RoleName 、以取得 SnapCenter 的成功回應。

MFA REST API 工作流程

當 MFA 設定為 AD FS 時、您應該使用存取(承載)權杖進行驗證、以便透過任何 REST API 存取 SnapCenter 應用程式。

關於此工作

  • 您可以使用任何 REST 用戶端、例如 Postman 、 Swagger UI 或 Fireplane 。

  • 取得存取權杖、並使用它來驗證後續要求( SnapCenter REST API )以執行任何作業。

步驟

  • 透過 AD FS MFA * 驗證

    1. 設定 REST 用戶端呼叫 AD FS 端點以取得存取權杖。

      當您按下按鈕以取得應用程式的存取權杖時、系統會將您重新導向至 AD FS SSO 頁面、您必須在其中提供 AD 認證並驗證 MFA 。 1. 在 AD FS SSO 頁面的「使用者名稱」文字方塊中、輸入您的使用者名稱或電子郵件。

      使用者名稱必須格式化為 user@domain 或 domain\user 。

    2. 在密碼文字方塊中、輸入您的密碼。

    3. 按一下*登入*。

    4. 在 * 登入選項 * 區段中、選取驗證選項並進行驗證(視您的組態而定)。

      • 推播:核准傳送至手機的推播通知。

      • QR 代碼:使用驗證點行動應用程式掃描 QR 代碼、然後輸入應用程式中顯示的驗證代碼

      • 一次性密碼:輸入 Token 的一次性密碼。

    5. 驗證成功後、會開啟一個快顯視窗、其中包含存取權、 ID 和重新整理 Token 。

      複製存取權杖、並在 SnapCenter REST API 中使用它來執行作業。

    6. 在 REST API 中、您應該在標頭區段中傳遞存取權杖和角色名稱。

    7. SnapCenter 會從 AD FS 驗證此存取權杖。

      如果它是有效的權杖、 SnapCenter 會將其解碼、並取得使用者名稱。

    8. SnapCenter 會使用使用者名稱和角色名稱來驗證使用者執行 API 。

      如果驗證成功、 SnapCenter 會傳回結果、否則會顯示錯誤訊息。

啟用或停用 REST API 、 CLI 和 GUI 的 SnapCenter MFA 功能

  • 圖形使用者介面 *

步驟

  1. 以 SnapCenter 管理員身分登入 SnapCenter Server 。

  2. 按一下 * 設定 * > * 全域設定 * > * 多重資料驗證( MFA )設定 *

  3. 選取介面( GUI/RST API/CLI )以啟用或停用 MFA 登入。

    • PowerShell 介面 *

步驟

  1. 執行 PowerShell 或 CLI 命令、以啟用 MFA for GUI 、 REST API 、 PowerShell 和 sccli 。

    Set-SmMultiFactorAuthentication -IsGuiMFAEnabled -IsRestApiMFAEnabled -IsCliMFAEnabled -Path

    path 參數會指定 AD FS MFA 中繼資料 XML 檔案的位置。

    啟用 MFA 以使用指定的 AD FS 中繼資料檔案路徑來設定 SnapCenter GUI 、 REST API 、 PowerShell 和 sccli 。

  2. 使用檢查 MFA 組態狀態和設定 Get-SmMultiFactorAuthentication Cmdlet。

*sccli 介面 *

步驟

  1. # sccli Set-SmMultiFactorAuthentication -IsGuiMFAEnabled true -IsRESTAPIMFAEnabled true -IsCliMFAEnabled true -Path "C:\ADFS_metadata\abc.xml"

  2. # sccli Get-SmMultiFactorAuthentication

    • REST API*

  3. 執行下列 POST API 以啟用 MFA for GUI 、 REST API 、 PowerShell 和 sccli 。

    參數

    價值

    要求的 URL

    /API/4.9/settings/multitactorauthentication

    HTTP方法

    貼文

    要求主體

    { "IsGuiMFAEnabled" :錯誤、 "IsRestApiMFAEnabled" :對、 "IsClicMFAEnabled" :錯、 "ADFSConfigFilePath" : "C:\\ADFS_中繼 資料 \\abc.xml " }

    回應本文

    { "MFAConfiguration" : { "IsGuiMFAEnabled" :錯誤、 "ADFSConfigFilePath" : "C:\\ADFS_中繼 資料 \\abc.xml 、 "SCConfigFilePath" : null 、 "IsRestApiMFAEnabled" :對、 "IsClicMFAEnabled" :錯、 "ADFSHostName" : "win-adfs-sc49.winscedom2.com } }

  4. 使用下列 API 檢查 MFA 組態狀態和設定。

    參數

    價值

    要求的 URL

    /API/4.9/settings/multitactorauthentication

    HTTP方法

    取得

    回應本文

    { "MFAConfiguration" : { "IsGuiMFAEnabled" :錯誤、 "ADFSConfigFilePath" : "C:\\ADFS_中繼 資料 \\abc.xml 、 "SCConfigFilePath" : null 、 "IsRestApiMFAEnabled" :對、 "IsClicMFAEnabled" :錯、 "ADFSHostName" : "win-adfs-sc49.winscedom2.com } }