<serviceMetadata>

サービス メタデータと関連情報の公開を指定します。

<system.serviceModel>
  <behaviors>
    <serviceBehaviors>
      <serviceBehaviors> の <behavior>
        <serviceMetadata>

<serviceMetadata 
    externalMetadataLocation="String"
    httpGetBinding=”String”
    httpGetEnabled="Boolean" 
    httpGetUrl="String"
    httpsGetBinding=”String”
    httpsGetEnabled="Boolean" 
    httpsGetUrl="String"
    policyVersion="Policy12/Policy15"/>

属性および要素

属性

子要素

なし

親要素

解説

この構成要素を使用すると、サービスのメタデータ公開機能を制御できます。サービスのメタデータには機密情報が含まれる可能性がありますが、意図的ではない開示を回避するために、Windows Communication Foundation (WCF) サービスの既定の構成では、メタデータは公開されないように設定されています。この動作は、既定の設定ではセキュリティで保護されますが、同時に、サービスの構成の中でメタデータ公開の動作が明示的に有効化されない限り、サービスの呼び出しに必要なクライアント コードをメタデータ インポート ツール (Svcutil.exe など) を使用して生成できないことも意味します。この構成要素を使用すると、サービスのこの公開動作を有効にできます。

この動作を構成する詳細なコード例については、「Metadata Publishing Behavior」を参照してください。

オプションの httpGetBinding 属性および httpsGetBinding 属性を使用すると、HTTP GET または HTTPS GET を介してメタデータを取得するバインディングを構成できます。これらの属性を指定しない場合、メタデータの取得には、適切な既定のバインディグ (HTTP の場合は HttpTransportBindingElement、HTTPS の場合は HttpsTransportBindingElement) が使用されます。これらの属性は、組み込みの WCF バインディングでは使用できないことに注意してください。System.ServiceModel.Channels.IReplyChannel をサポートする内部バインディング要素を使用したバインディングでのみサポートされます。さらに、バインディングの System.ServiceModel.Channels.MessageVersion プロパティが System.ServiceModel.Channels.MessageVersion.None である必要があります。

サービスが悪意のあるユーザーに公開されないようにするために、SSL over HTTP (HTTPS) 機構を使用して転送をセキュリティで保護できます。転送を保護するには、まず、サービスをホストしているコンピュータの特定のポートに適切な X.509 証明書をバインドする必要があります。詳細な情報については、次のページを参照してください。 「Working with Certificates」を参照してください。次に、この要素をサービス構成に追加し、httpsGetEnabled 属性を true に設定します。最後に、次の例に示すように、httpsGetUrl 属性をサービス メタデータ エンドポイントの URL に設定します。

<behaviors>
 <serviceBehaviors>
  <behavior name="NewBehavior">
    <serviceMetadata httpsGetEnabled="true" 
     httpsGetUrl="https://myComputerName/myEndpoint" />
  </behavior>
 </serviceBehaviors>
</behaviors>

例

次の例では、<serviceMetadata> 要素を使用してメタデータを公開するサービスを構成します。さらに、IMetadataExchange コントラクトを WS-MetadataExchange (MEX) プロトコルの実装として公開するエンドポイントも構成します。この例では、mexHttpBinding を使用します。これは使いやすい標準バインドで、セキュリティ モードが None に設定されている wsHttpBinding と同等です。エンドポイントには、相対アドレスの "mex" が使用されています。このアドレスがサービスのベース アドレスに対して解決されると、エンドポイントのアドレスは https://localhost/servicemodelsamples/service.svc/mex になります。

<configuration>
<system.serviceModel>
  <services>
    <service 
        name="Microsoft.ServiceModel.Samples.CalculatorService"
        behaviorConfiguration="CalculatorServiceBehavior">
      <!-- This endpoint is exposed at the base address provided by the host: https://localhost/servicemodelsamples/service.svc  -->
      <endpoint address=""
                binding="wsHttpBinding"
                contract="Microsoft.ServiceModel.Samples.ICalculator" />
      <!-- the mex endpoint is exposed at https://localhost/servicemodelsamples/service.svc/mex 
           To expose the IMetadataExchange contract, you 
           must enable the serviceMetadata behavior as demonstrated below -->
      <endpoint address="mex"
                binding="mexHttpBinding"
                contract="IMetadataExchange" />
    </service>
  </services>

  <!--For debugging purposes set the includeExceptionDetailInFaults attribute to true-->
  <behaviors>
    <serviceBehaviors>
      <behavior name="CalculatorServiceBehavior">
        <!-- The serviceMetadata behavior publishes metadata through 
             the IMetadataExchange contract. When this behavior is 
             present, you can expose this contract through an endpoint 
             as shown above. Setting httpGetEnabled to true publishes 
             the service's WSDL at the <baseaddress>?wsdl
             eg. https://localhost/servicemodelsamples/service.svc?wsdl -->
        <serviceMetadata httpGetEnabled="True"/>
        <serviceDebug includeExceptionDetailInFaults="False" />
      </behavior>
    </serviceBehaviors>
  </behaviors>

</system.serviceModel>

</configuration>

関連項目

リファレンス

ServiceMetadataPublishingElement
ServiceMetadataBehavior

その他の技術情報

Security Behaviors in WCF
Metadata Publishing Behavior