Linux 叢集上的憑證和安全性

本文提供在Linux叢集上設定 X.509 憑證的相關信息。

Linux節點上 X.509 憑證的位置和格式

Service Fabric 通常會預期 X.509 憑證會出現在 Linux 叢集節點上 的 /var/lib/sfcerts 目錄中。 這對於叢集憑證、客戶端憑證等都是適用的。在某些情況下,您可以為憑證指定 var/lib/sfcerts 資料夾以外的位置。 例如,透過使用 Service Fabric Java SDK 建置的 Reliable Services,您可以透過某些應用程式特定憑證的組態套件 (Settings.xml) 指定不同的位置。 若要深入瞭解,請參閱組態套件中參考的憑證(Settings.xml)。

針對Linux叢集,Service Fabric預期憑證會以包含憑證和私鑰的 .pem 檔案的形式存在,或是包含憑證的 .crt 檔案,以及包含私鑰的.key檔案。 所有檔案都應該為 PEM 格式。

如果您使用 Resource Manager 範本 或 PowerShell 命令從 Azure Key Vault 安裝憑證,則憑證會以正確的格式安裝在每個節點上 的 /var/lib/sfcerts 目錄中。 如果您透過其他方法安裝憑證,您必須確定憑證已正確安裝在叢集節點上。

應用程式指令清單中所參考的憑證

例如,透過 SecretsCertificate 或 EndpointCertificate 元素在應用程式指令清單中指定的憑證必須存在於 /var/lib/sfcerts 目錄中。 應用程式清單中用來指定憑證的元素不會使用路徑屬性,因此憑證必須存在於預設目錄中。 這些元素會採用選擇性 的 X509StoreName 屬性。 默認值為 「My」,指向 Linux 節點上 的 /var/lib/sfcerts 目錄。 Linux 叢集上未定義任何其他值。 建議您省略 Linux 叢集上執行之應用程式的 X509StoreName 屬性。

組態套件中所參考的憑證 (Settings.xml)

針對某些服務,您可以在 ConfigPackage 中設定 X.509 憑證(根據預設,Settings.xml)。 例如,當您宣告用來保護使用 Service Fabric .NET Core 或 Java SDK 建置之 Reliable Services 服務 RPC 通道的憑證時,就會發生這種情況。 有兩種方式可以參考組態套件中的憑證。 .NET Core 與 Java SDK 的支援會有所不同。

使用 X509 SecurityCredentialsType

使用 .NET 或 Java SDK 時,你可以指定 X509 作為 SecurityCredentialsType。 這對應於 X509Credentials (.NET/Java) 類型的 SecurityCredentials (.NET/Java)。

X509 參考可將憑證定位於憑證存放區中。 下列 XML 顯示用來指定憑證位置的參數:

    <Parameter Name="SecurityCredentialsType" Value="X509" />
    <Parameter Name="CertificateStoreLocation" Value="LocalMachine" />
    <Parameter Name="CertificateStoreName" Value="My" />

針對在Linux上執行的服務, LocalMachine/My 會指向憑證的預設位置 /var/lib/sfcerts 目錄。 針對 Linux,任何其他組合的 CertificateStoreLocation 和 CertificateStoreName 都是未定義的。

請一律將 CertificateStoreLocation 參數指定為 LocalMachine。 不需要指定 CertificateStoreName 參數,因為它預設是「我的」。 使用 X509 參考時,憑證檔案必須位於叢集節點上 的 /var/lib/sfcerts 目錄中。

下列 XML 將根據此形式顯示 TransportSettings 區段:

<Section Name="HelloWorldStatefulTransportSettings">
    <Parameter Name="MaxMessageSize" Value="10000000" />
    <Parameter Name="SecurityCredentialsType" Value="X509" />
    <Parameter Name="CertificateFindType" Value="FindByThumbprint" />
    <Parameter Name="CertificateFindValue" Value="AA11BB22CC33DD44EE55FF66AA77BB88CC99DD00" />
    <Parameter Name="CertificateRemoteThumbprints" Value="BB22CC33DD44EE55FF66AA77BB88CC99DD00EE11" />
    <Parameter Name="CertificateStoreLocation" Value="LocalMachine" />
    <Parameter Name="CertificateProtectionLevel" Value="EncryptAndSign" />
    <Parameter Name="CertificateRemoteCommonNames" Value="ServiceFabric-Test-Cert" />
</Section>

使用 X509_2 SecurityCredentialsType

使用 Java SDK,您可以為 SecurityCredentialsType 指定X509_2。 這對應於 X509Credentials2 (Java) 類型的 SecurityCredentials (Java)。

使用 X509_2 參考時,您可以指定路徑參數,以便在 /var/lib/sfcerts 以外的目錄中尋找憑證。 下列 XML 顯示用來指定憑證位置的參數:

     <Parameter Name="SecurityCredentialsType" Value="X509_2" />
     <Parameter Name="CertificatePath" Value="/path/to/cert/CC33DD44EE55FF66AA77BB88CC99DD00EE11FF22.crt" />

下列 XML 將根據此形式顯示 TransportSettings 區段。

<!--Section name should always end with "TransportSettings".-->
<!--Here we are using a prefix "HelloWorldStateless".-->
<Section Name="HelloWorldStatelessTransportSettings">
    <Parameter Name="MaxMessageSize" Value="10000000" />
    <Parameter Name="SecurityCredentialsType" Value="X509_2" />
    <Parameter Name="CertificatePath" Value="/path/to/cert/CC33DD44EE55FF66AA77BB88CC99DD00EE11FF22.crt" />
    <Parameter Name="CertificateProtectionLevel" Value="EncryptandSign" />
    <Parameter Name="CertificateRemoteThumbprints" Value="CC33DD44EE55FF66AA77BB88CC99DD00EE11FF22" />
</Section>

備註

憑證會指定為上述 XML 中的 .crt 檔案。 這表示同一位置也有一個包含私鑰的.key檔案。

設定 Reliable Services 應用程式以在 Linux 叢集上執行

Service Fabric SDK 可讓您與 Service Fabric 執行階段 API 通訊以使用平台。 當您在安全的 Linux 叢集上執行使用這項功能的任何應用程式時,您必須使用可用來向 Service Fabric 執行時間驗證的憑證來設定應用程式。 包含使用 .NET Core 或 Java SDK 所撰寫 Service Fabric Reliable Service 服務的應用程式需要此設定。

若要設定應用程式,請在 Certificates 標籤下新增 SecretsCertificate 元素,該標籤位於 ApplicationManifest.xml 檔案的 ApplicationManifest 卷標底下。 下列 XML 顯示依憑證的指紋參考的憑證:

   <Certificates>
       <SecretsCertificate X509FindType="FindByThumbprint" X509FindValue="0A00AA0AAAA0AAA00A000000A0AA00A0AAAA00" />
   </Certificates>   

您可以參考叢集憑證或您在每個叢集節點上安裝的憑證。 在 Linux 上,憑證檔案必須存在於 /var/lib/sfcerts 目錄中。 若要深入瞭解,請參閱 Linux 節點上 X.509 憑證的位置和格式。