新增或移除 Azure 中 Service Fabric 叢集的憑證

發行項
11/25/2024

建議您熟悉 Service Fabric 如何使用 X.509 憑證，並熟悉叢集安全性案例。您必須瞭解什麼是叢集憑證及其用途，方可繼續進行後續作業。

Azure Service Fabric SDK 的預設憑證載入行為是部署和使用到期日最晚的已定義憑證，而不論其主要或次要設定定義為何。回復為傳統行為是不建議採取的進階動作，而且需要在 Fabric.Code 設定內將 "UseSecondaryIfNewer" 設定參數值設為 false。

當您在叢集建立期間設定憑證安全性時，除了用戶端憑證之外，Service Fabric 還可讓您指定兩個叢集憑證：主要與次要。請參閱透過入口網站建立 Azure 叢集或透過 Azure Resource Manager 建立 Azure 叢集，以詳細了解如何在建立這些叢集時進行叢集設定。如果您在建立時僅指定一個叢集憑證，該憑證就會作為主要憑證。在叢集建立完成後，您可新增憑證做為次要憑證。

注意

針對安全叢集，您一律必須至少部署一個有效 (未撤銷或過期) 的叢集憑證 (主要或次要)，否則叢集將停止運作。在所有有效憑證到達到期日的 90 天前，系統會針對節點產生警告追蹤與警告健康狀態事件。這些是目前唯一 Service Fabric 傳送有關憑證到期的通知。

注意

建議您使用 Azure Az PowerShell 模組來與 Azure 互動。若要開始使用，請參閱安裝 Azure PowerShell (部分機器翻譯)。若要了解如何移轉至 Az PowerShell 模組，請參閱將 Azure PowerShell 從 AzureRM 移轉至 Az。

使用入口網站來新增次要叢集憑證

無法透過 Azure 入口網站新增次要叢集憑證;使用 Azure Resource Manager。

使用入口網站來移除叢集憑證

針對安全的叢集，您一律需要至少一個有效（未撤銷且未過期）憑證。隨著未來到期日最遠部署的憑證將會使用中，而移除憑證會讓您的叢集停止運作;請確定只移除已過期的憑證，或最遲過期的未使用憑證。

若要移除未使用的叢集安全性憑證，請瀏覽至 [安全性] 區段，然後在未使用的憑證上，從快顯功能表中選取 [刪除] 選項。

如果您的意圖是移除標示為主要憑證的憑證，則必須將到期日進一步部署到未來的次要憑證，才能啟用自動變換行為：在自動變換完成之後，刪除主要憑證。

使用 Azure Resource Manager 新增次要憑證

這些步驟假設您已熟悉 Resource Manager 的運作方式，並且已使用 Resource Manager 範本部署至少一個 Service Fabric 叢集，並讓用來設定叢集的範本方便使用。也假設您熟悉使用 JSON。

注意

如果您正在尋找可用來依循或作為起點的範例範本和參數，可從這個 git 存放庫下載。

編輯您的 Resource Manager 範本

為了方便遵循，範例5-VM-1-NodeTypes-Secure_Step2.JSON包含我們所做的所有編輯。此範例可在 git-repo 取得。

務必依照所有步驟操作

開啟您用來部署叢集的 Resource Manager 範本。 (如果您已從上述存放庫下載該範例，則請使用 5-VM-1-NodeTypes-Secure_Step1.JSON 來部署一個安全的叢集，然後開啟該範本)。

將類型為 "string" 的兩個新參數 "secCertificateThumbprint" 和 "secCertificateUrlValue" 新增到您範本的參數區段。您可以複製下列程式碼片段並新增到範本中。視您的範本來源而定，這些有可能已經定義好，如果是這樣，請移至下一個步驟。

   "secCertificateThumbprint": {
      "type": "string",
      "metadata": {
        "description": "Certificate Thumbprint"
      }
    },
    "secCertificateUrlValue": {
      "type": "string",
      "metadata": {
        "description": "Refers to the location URL in your key vault where the certificate was uploaded, it is should be in the format of https://<name of the vault>.vault.azure.net:443/secrets/<exact location>"
      }
    },

對 Microsoft.ServiceFabric/clusters 資源進行變更 - 找出您範本中的 "Microsoft.ServiceFabric/clusters" 資源定義。在該定義的屬性下，您會發現「憑證」JSON 標籤，其看起來應該類似下列 JSON 代碼段：

      "properties": {
        "certificate": {
          "thumbprint": "[parameters('certificateThumbprint')]",
          "x509StoreName": "[parameters('certificateStoreValue')]"
     }

加入新標籤「thumbprintSecondary」，並為它提供值「[parameters('secCertificateThumbprint')]」。

資源定義現在看起來應該像下面這樣 (視您的範本來源而定，可能不會與下面的程式碼片段完全相同)。

      "properties": {
        "certificate": {
          "thumbprint": "[parameters('certificateThumbprint')]",
          "thumbprintSecondary": "[parameters('secCertificateThumbprint')]",
          "x509StoreName": "[parameters('certificateStoreValue')]"
     }

如果您想要「變換憑證」，請將新憑證指定為主要憑證，並將目前的主要憑證移轉為次要憑證。這可讓您透過單一部署步驟，就將目前的主要憑證變換成新憑證。

      "properties": {
        "certificate": {
          "thumbprint": "[parameters('secCertificateThumbprint')]",
          "thumbprintSecondary": "[parameters('certificateThumbprint')]",
          "x509StoreName": "[parameters('certificateStoreValue')]"
     }

對所有Microsoft.Compute/virtualMachineScaleSets 資源定義進行變更 - 找出 Microsoft.Compute/virtualMachineScaleSets 資源定義。捲動到 "virtualMachineProfile" 底下的 "publisher": "Microsoft.Azure.ServiceFabric"。

在 Service Fabric 發行者設定中，您應該會看到像這樣的畫面。

Json_Pub_Setting1

請將新憑證項目新增到其中

               "certificateSecondary": {
                    "thumbprint": "[parameters('secCertificateThumbprint')]",
                    "x509StoreName": "[parameters('certificateStoreValue')]"
                    }
                  },

屬性現在應該看起來像這樣

Json_Pub_Setting2

如果您想要「變換憑證」，請將新憑證指定為主要憑證，並將目前的主要憑證移轉為次要憑證。這可讓您在單一部署步驟中，將目前的憑證變換為新憑證。

               "certificate": {
                   "thumbprint": "[parameters('secCertificateThumbprint')]",
                   "x509StoreName": "[parameters('certificateStoreValue')]"
                     },
               "certificateSecondary": {
                    "thumbprint": "[parameters('certificateThumbprint')]",
                    "x509StoreName": "[parameters('certificateStoreValue')]"
                    }
                  },

屬性現在應該看起來像這樣
Json_Pub_Setting3

對所有Microsoft.Compute/virtualMachineScaleSets 資源定義進行變更 - 找出 Microsoft.Compute/virtualMachineScaleSets 資源定義。捲動到 "OSProfile" 底下的 "vaultCertificates":。您應該會看到類似下面的畫面。

將 secCertificateUrlValue 新增至其中。使用下列程式碼片段：
```
                  {
                    "certificateStore": "[parameters('certificateStoreValue')]",
                    "certificateUrl": "[parameters('secCertificateUrlValue')]"
                  }
```
產生的 Json 現在應該看起來像這樣。

注意

請確定您已針對範本中的所有 Nodetypes/Microsoft.Compute/virtualMachineScaleSets 資源定義重複步驟 4 和 5。如果您遺漏其中一個，憑證就不會安裝在該虛擬機器擴展集上，而您的叢集中將會有無法預測的結果，包括叢集停止運作 (如果您最終沒有任何可供叢集用於安全性的有效憑證)。因此，在進一步進行之前，請先仔細檢查。

編輯您的範本檔案，以反映先前加入的新參數

如果您使用 git-repo 中的範例進行後續操作，您可以在範例5-VM-1-NodeTypes-Secure.parameters_Step2.JSON中開始進行變更

請編輯您的 Resource Manager 範本參數檔，新增 secCertificateThumbprint 和 secCertificateUrlValue 的兩個新參數。

    "secCertificateThumbprint": {
      "value": "thumbprint value"
    },
    "secCertificateUrlValue": {
      "value": "Refers to the location URL in your key vault where the certificate was uploaded, it is should be in the format of https://<name of the vault>.vault.azure.net:443/secrets/<exact location>"
     },

將範本部署至 Azure

您現在已準備好將範本部署至 Azure。開啟 Azure PowerShell 1+ 版命令提示字元。
登入您的 Azure 帳戶，並選取特定的 Azure 訂用帳戶。對於擁有多個 Azure 訂用帳戶存取權的使用者而言，這是一個重要步驟。

Connect-AzAccount
Select-AzSubscription -SubscriptionId <Subscription ID>

部署範本前先進行測試。使用您目前在其中部署叢集的同一個資源群組。

Test-AzResourceGroupDeployment -ResourceGroupName <Resource Group that your cluster is currently deployed to> -TemplateFile <PathToTemplate>

將範本部署至您的資源群組。使用您目前在其中部署叢集的同一個資源群組。執行 New-AzResourceGroupDeployment 命令。您不需要指定模式，因為預設值為累加。

注意

若您將 [模式] 設為 [完整]，您可能會無意間刪除不在您範本中的資源。因此請勿在此案例中使用該模式。

New-AzResourceGroupDeployment -Name ExampleDeployment -ResourceGroupName <Resource Group that your cluster is currently deployed to> -TemplateFile <PathToTemplate>

以下是相同 PowerShell 的完整範例。

$ResourceGroup2 = "chackosecure5"
$TemplateFile = "C:\GitHub\Service-Fabric\ARM Templates\Cert Rollover Sample\5-VM-1-NodeTypes-Secure_Step2.json"
$TemplateParmFile = "C:\GitHub\Service-Fabric\ARM Templates\Cert Rollover Sample\5-VM-1-NodeTypes-Secure.parameters_Step2.json"

New-AzResourceGroupDeployment -ResourceGroupName $ResourceGroup2 -TemplateParameterFile $TemplateParmFile -TemplateUri $TemplateFile -clusterName $ResourceGroup2

部署完成之後，使用新的憑證連線至叢集，並執行一些查詢。如果您能夠這麼做。接著，您可以刪除舊憑證。

如果您使用自我簽署憑證，別忘了將它們匯入本機 TrustedPeople 憑證存放區。

######## Set up the certs on your local box
Import-PfxCertificate -Exportable -CertStoreLocation Cert:\CurrentUser\TrustedPeople -FilePath c:\Mycertificates\chackdanTestCertificate9.pfx -Password (ConvertTo-SecureString -String abcd123 -AsPlainText -Force)
Import-PfxCertificate -Exportable -CertStoreLocation Cert:\CurrentUser\My -FilePath c:\Mycertificates\chackdanTestCertificate9.pfx -Password (ConvertTo-SecureString -String abcd123 -AsPlainText -Force)

如需快速參考，請參閱連線到安全叢集的命令

$ClusterName= "chackosecure5.westus.cloudapp.azure.com:19000"
$CertThumbprint= "70EF5E22ADB649799DA3C8B6A6BF7SD1D630F8F3" 

Connect-serviceFabricCluster -ConnectionEndpoint $ClusterName -KeepAliveIntervalInSec 10 `
    -X509Credential `
    -ServerCertThumbprint $CertThumbprint  `
    -FindType FindByThumbprint `
    -FindValue $CertThumbprint `
    -StoreLocation CurrentUser `
    -StoreName My

如需快速參考，請參閱取得叢集健康情況的命令

Get-ServiceFabricClusterHealth

將用戶端憑證部署到叢集。

您可以使用與上述步驟 5 中所述的相同步驟，將憑證從金鑰保存庫部署到節點。您只需定義和使用不同的參數即可。

新增或移除用戶端憑證

除了叢集憑證之外，您還可以新增用戶端憑證以在 Service Fabric 叢集上執行管理作業。

您可以新增兩種用戶端憑證 - 系統管理員或唯讀。接著這些憑證便可用來控制對叢集上系統管理員作業和查詢作業的存取。叢集憑證預設會新增到允許的系統管理員憑證清單中。

您可以指定任何數目的用戶端憑證。每次進行新增/刪除時，都會導致更新 Service Fabric 叢集的組態

透過入口網站新增用戶端憑證 - 系統管理員或唯讀

瀏覽至 [安全性] 區段，然後選取 [安全性] 區段頂端的 [+ 驗證] 按鈕。
在 [新增驗證] 區段上，選擇 [驗證類型] - [唯讀用戶端] 或 [系統管理員用戶端]
現在選擇 [驗證方法]。這會對 Service Fabric 指出其是否應該使用主體名稱或指紋來查詢此憑證。一般而言，使用主體名稱的授權方法不是很好的安全性做法。

使用入口網站來刪除用戶端憑證 - 系統管理員或唯讀

若要移除次要憑證，使其不用於叢集安全性，請瀏覽至 [安全性] 區段，然後從特定憑證上的操作功能表中選取 [刪除] 選項。

將應用程式憑證新增至虛擬機器擴展集

若要將您用於應用程式的憑證部署到叢集，請參閱此範例 PowerShell 指令碼。

下一步

如需有關叢集管理的詳細資訊，請參閱下列文件︰

共用方式為