<scopedCertificates> 要素の <add>

[アーティクル]
04/07/2023

範囲指定された証明書のコレクションに X.509 証明書を追加します。

configuration
  system.serviceModel
    behaviors
      endpointBehaviors
        behavior
          <clientCredentials>
            <serviceCertificate>
              <scopedCertificates>
                <add>

構文

<add findValue="String"
     storeLocation="CurrentUser/LocalMachine"
     storeName=" CurrentUser/LocalMachine"
     targetUri="string"
     x509Type="FindByThumbprint/FindBySubjectName/FindBySubjectDistinguishedName/FindByIssuerName/FindByIssuerDistinguishedName/FindBySerialNumber/FindByTimeValid/FindByTimeNotYetValid/FindBySerialNumber/FindByTimeExpired/FindByTemplateName/FindByApplicationPolicy/FindByCertificatePolicy/FindByExtension/FindByKeyUsage/FindBySubjectKeyIdentifier" />

属性および要素

以降のセクションでは、属性、子要素、および親要素について説明します。

属性

属性	説明
targetUri	文字列をオンにします。証明書に関連付けられているサービスの URI を指定します。
findValue	文字列をオンにします。検索する値。
x509FindType	列挙値。検索する証明書フィールドのいずれかです。
storeLocation	列挙値。検索する 2 つの格納場所のいずれかです。
storeName	列挙値。検索するシステムストアのいずれかです。

findValue 属性

[値]	説明
String	値は、検索されるフィールド (X509FindType 属性により指定される) によって異なります。たとえば、サムプリント検索する場合、値は 16 進数の文字列にする必要があります。

x509FindType 属性

[値]	説明
列挙	値は、FindByThumbprint、FindBySubjectName、FindBySubjectDistinguishedName、FindByIssuerName、FindByIssuerDistinguishedName、FindBySerialNumber、FindByTimeValid、FindByTimeNotYetValid、FindBySerialNumber、FindByTimeExpired、FindByTemplateName、FindByApplicationPolicy、FindByCertificatePolicy、FindByExtension、FindByKeyUsage、FindBySubjectKeyIdentifier です。

storeLocation 属性

[値]	説明
列挙	CurrentUser または LocalMachine です。

storeName 属性

[値]	説明
列挙	値は、AddressBook、AuthRoot、CertificateAuthority、Disallowed、My、Root、TrustedPeople、および TrustedPublisher です。

子要素

なし。

親要素

要素	説明
<scopedCertificates>	認証用の (範囲指定された) 特定のサービスにより提供される X.509 証明書のコレクションを表します。

解説

この要素を使用すると、クライアントは、通信するサービスの URL に基づいて、使用するサービス証明書を構成できます。これは、クライアントが複数のサービス (エンドサービスと中間セキュリティトークンサービス) と通信している可能性がある発行済みトークンのシナリオで特に便利です。証明書に基づくメッセージセキュリティを使用したバインドにおいて、この証明書を使用してサービスへのメッセージを暗号化します。サービスがクライアントへの応答に署名する際には、この証明書を使用することが要求されます。

バインディングにサービスの証明書が必要で、サービスの URL に対する特定の証明書が ScopedCertificates 内に存在しない場合は、既定の証明書が使用されます。

詳細については、「方法 : フェデレーションクライアントを作成する」の「範囲指定された証明書」セクションを参照してください。

例

次の例は、コレクションに X.509 証明書を追加します。

<behaviors>
  <endpointBehaviors>
    <behavior name="MyEndpointBehavior">
      <clientCredentials>
        <serviceCertificate>
          <scopedCertificates>
            <add targetUri="http://www.contoso.com"
                 findValue="www.Contoso.com"
                 storeLocation="LocalMachine"
                 storeName="Root"
                 x509FindType="FindByIssuerName" />
          </scopedCertificates>
        </serviceCertificate>
      </clientCredentials>
    </behavior>
  </endpointBehaviors>
</behaviors>

次の方法で共有