バインド <binding>

概要

<bindings> 要素の <binding> 要素を使用すると、要求が Web サイトと通信するために必要な情報を構成できます。

Web サイトを作成するときにバインド情報を構成することも、サイトの作成後にバインド情報を編集することもできます。 バインド情報には、クライアントがサイトとの通信に使用するプロトコル、サイトの IP アドレス、ポート番号、およびホスト ヘッダーが含まれます。

<binding> 要素には、バインド情報を構成するための 2 つの属性 (bindingInformation と protocol) が含まれます。 bindingInformation 属性には、サイトの IP アドレス、ポート番号、および必要に応じてホスト ヘッダーが含まれます。 protocol 属性は、サイトとの通信に使用するプロトコルを定義します。

IIS マネージャーを使用してサイトを選択し、[操作] ウィンドウの [バインド...] リンクまたは [詳細設定...] リンクを使用するか、サイトのショートカット メニューの [バインドの編集...] をクリックして、サイトのバインドのコレクションを構成できます。

IIS 8.0 以降では、Windows Server 2012 の集中証明書ストアにある証明書を使用して、Web サイトのセキュリティを強化できます。 詳細については、「IIS 8.0 の集中 SSL 証明書サポート: SSL のスケーラビリティと管理状態」を参照してください。

binding 要素を使用すると、Secure Sockets Layer (SSL) 証明書に使用されるバインドの種類を指定できます。

互換性

段取り

<binding> 要素は IIS 7 以降の既定のインストールに含まれています。

集中証明書ストアをインストールする方法

IIS 8 以降では、集中証明書ストア内の証明書を使用して、Web サイトのセキュリティを強化できます。 Windows Server 2012 以降の Web サーバーでこのストアを使用するには、集中 SSL 証明書ストア ロールをインストールする必要があります。 IIS が既にインストールされている状態でこれを行うには、次の手順に従います。

1. Windows キーを押してから、[サーバー マネージャー] をクリックします。
2. サーバー マネージャーで、[管理] をクリックし、[役割と機能の追加] をクリックします。
3. 役割と機能の追加ウィザードで、[開始する前に] ページをクリックして進み、インストールの種類を選択し、[インストールの種類] ページで [次へ] をクリックし、インストールする場所を選択し、[サーバーの選択] ページで [次へ] をクリックします。
4. [サーバーの役割] ページで、[Web サーバー (IIS)] がオンになっていることを確認してから、展開します。 [Web サーバー] を展開し、[セキュリティ] をオンにして展開します。
5. [SSL 証明書の集中サポート] を選択してから、[次へ] をクリックします。
6. [機能] ページで [次へ] をクリックします。
7. [インストール オプションの確認] ページで、[インストール] をクリックします。
8. [結果] ページで、 [閉じる]をクリックします。

操作方法

バインド情報をサイトに追加する方法

1. 次のようにインターネット インフォメーション サービス (IIS) マネージャーを開きます。

   • Windows Server 2012 または Windows Server 2012 R2 を使用している場合:

     • タスク バーで、[サーバー マネージャー] をクリックし、[ツール]、[インターネット インフォメーション サービス (IIS) マネージャー] の順にクリックします。

   • Windows 8 または Windows 8.1 を使用している場合:

     • Windows キーを押しながら文字 X を押し、[コントロール パネル] をクリックします。
     • [管理ツール] をクリックし、[インターネット インフォメーション サービス (IIS) マネージャー] をダブルクリックします。

   • Windows Server 2008 または Windows Server 2008 R2 を使用している場合:

     • タスク バーで、[スタート] ボタンをクリックし、[管理ツール]、[インターネット インフォメーション サービス (IIS) マネージャー] の順にクリックします。

   • Windows Vista または Windows 7 を使用している場合:

     • タスク バーで、[スタート]、[コントロール パネル] の順にクリックします。
     • [管理ツール] をダブルクリックし、[インターネット インフォメーション サービス (IIS) マネージャー] をダブルクリックします。

2. [接続] ウィンドウでサーバー名を展開し、[サイト] を展開してから、バインドを構成する Web サイトをクリックします。

3. [操作] ウィンドウで、[バインド...]をクリックします。

4. [サイト バインド] ダイアログ ボックスの [追加...]をクリックします。
   

5. [サイト バインドの追加] ダイアログ ボックスに、バインド情報を追加し、[OK] クリックします。
   

集中証明書ストアを作成する方法

1. スタート ボタンを押してから、[サーバー マネージャー] をクリックします。 サーバー マネージャーで、[ツール] をクリックし、[インターネット インフォメーション サービス (IIS) マネージャー] をクリックします。
2. [接続] ウィンドウでサーバー名を選びます。
3. [ホーム] ページの [管理] 領域で、[Centralized Certificates] をダブルクリックします。
4. [操作] ウィンドウで、[機能設定の編集] をクリックします。
5. [Centralized Certificates を有効にする] を選択し、物理パスを入力します。 パスのユーザー名を入力し、パスのパスワードを入力して、パスワードを確認します。 OK をクリックします。

構成

ApplicationHost.config ファイルの各サイトの <bindings> 要素内に、<binding> 要素を追加できます。 インターネット経由で表示するには、各サイトに少なくとも 1 つの HTTP バインドまたは HTTPS バインドが必要です。

属性

子要素

なし。

構成サンプル

次の例は、2 つのバインドを持つ Contoso という名前のサイトを定義します。 1 つめのバインドは、ポート 80 にあり、IP アドレス が 192.168.0.1 の "www.contoso.com" というホスト名用で、2 つめのバインドはポート 443 を経由するすべての IP アドレスに対する HTTPS バインド用です。

<site name="Contoso" id="2">
   <application path="/" applicationPool="Contoso">
      <virtualDirectory path="/" physicalPath="C:\inetpub\wwwroot" />
   </application>
   <bindings>
      <binding protocol="http" bindingInformation="192.168.0.1:80:www.contoso.com" />
      <binding protocol="https" bindingInformation="*:443:" />
   </bindings>
</site>

サンプル コード

次の例は、ポート 80 にあり、IP アドレス が 192.168.0.1 の "www.contoso.com" というホスト名と、ポート 443 を経由するすべての IP アドレスに対する HTTPS バインドを持つ Contoso という名前のサイトを構成します。

AppCmd.exe

appcmd.exe set site /site.name:Contoso /+bindings.[protocol='http',bindingInformation='192.168.0.1:80:www.contoso.com']

appcmd.exe set site /site.name:Contoso /+bindings.[protocol='https',bindingInformation='*:443:']

または、次を使用できます。

appcmd.exe set config -section:system.applicationHost/sites /+"[name='Contoso'].bindings.[protocol='http',bindingInformation='192.168.0.1:80:www.contoso.com']" /commit:apphost

appcmd.exe set config -section:system.applicationHost/sites /+"[name='Contoso'].bindings.[protocol='https',bindingInformation='*:443:']" /commit:apphost

C#

using System;
using System.Text;
using Microsoft.Web.Administration;

internal static class Sample
{
   private static void Main()
   {
      using (ServerManager serverManager = new ServerManager())
      {
          Configuration config = serverManager.GetApplicationHostConfiguration();
          ConfigurationSection sitesSection = config.GetSection("system.applicationHost/sites");
          ConfigurationElementCollection sitesCollection = sitesSection.GetCollection();
          ConfigurationElement siteElement = FindElement(sitesCollection, "site", "name", @"Contoso");

          if (siteElement == null) throw new InvalidOperationException("Element not found!");

          ConfigurationElementCollection bindingsCollection = siteElement.GetCollection("bindings");
          ConfigurationElement bindingElement = bindingsCollection.CreateElement("binding");
          bindingElement["protocol"] = @"http";
          bindingElement["bindingInformation"] = @"192.168.0.1:80:www.contoso.com";
          bindingsCollection.Add(bindingElement);

          ConfigurationElement bindingElement1 = bindingsCollection.CreateElement("binding");
          bindingElement1["protocol"] = @"https";
          bindingElement1["bindingInformation"] = @"*:443:";
          bindingsCollection.Add(bindingElement1);

          serverManager.CommitChanges();
      }
   }

   private static ConfigurationElement FindElement(ConfigurationElementCollection collection, string elementTagName, params string[] keyValues)
   {
      foreach (ConfigurationElement element in collection)
      {
         if (String.Equals(element.ElementTagName, elementTagName, StringComparison.OrdinalIgnoreCase))
         {
            bool matches = true;
            for (int i = 0; i < keyValues.Length; i += 2)
            {
               object o = element.GetAttributeValue(keyValues[i]);
               string value = null;
               if (o != null)
               {
                  value = o.ToString();
               }
               if (!String.Equals(value, keyValues[i + 1], StringComparison.OrdinalIgnoreCase))
               {
                  matches = false;
                  break;
               }
            }
            if (matches)
            {
               return element;
            }
         }
      }
      return null;
   }
}

VB.NET

Imports System
Imports System.Text
Imports Microsoft.Web.Administration

Module Sample
   Sub Main()
      Dim serverManager As ServerManager = New ServerManager
      Dim config As Configuration = serverManager.GetApplicationHostConfiguration
      Dim sitesSection As ConfigurationSection = config.GetSection("system.applicationHost/sites")
      Dim sitesCollection As ConfigurationElementCollection = sitesSection.GetCollection
      Dim siteElement As ConfigurationElement = FindElement(sitesCollection, "site", "name", "Contoso")

      If (siteElement Is Nothing) Then
         Throw New InvalidOperationException("Element not found!")
      End If

      Dim bindingsCollection As ConfigurationElementCollection = siteElement.GetCollection("bindings")

      Dim bindingElement As ConfigurationElement = bindingsCollection.CreateElement("binding")
      bindingElement("protocol") = "http"
      bindingElement("bindingInformation") = "192.168.0.1:80:www.contoso.com"
      bindingsCollection.Add(bindingElement)

      Dim bindingElement1 As ConfigurationElement = bindingsCollection.CreateElement("binding")
      bindingElement1("protocol") = "https"
      bindingElement1("bindingInformation") = "*:443:"
      bindingsCollection.Add(bindingElement1)

      serverManager.CommitChanges()
   End Sub

   Private Function FindElement(ByVal collection As ConfigurationElementCollection, ByVal elementTagName As String, ByVal ParamArray keyValues() As String) As ConfigurationElement
      For Each element As ConfigurationElement In collection
         If String.Equals(element.ElementTagName, elementTagName, StringComparison.OrdinalIgnoreCase) Then
            Dim matches As Boolean = True
            Dim i As Integer
            For i = 0 To keyValues.Length - 1 Step 2
               Dim o As Object = element.GetAttributeValue(keyValues(i))
               Dim value As String = Nothing
               If (Not (o) Is Nothing) Then
                  value = o.ToString
               End If
               If Not String.Equals(value, keyValues((i + 1)), StringComparison.OrdinalIgnoreCase) Then
                  matches = False
                  Exit For
               End If
            Next
            If matches Then
               Return element
            End If
         End If
      Next
      Return Nothing
   End Function


End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";
var sitesSection = adminManager.GetAdminSection("system.applicationHost/sites", "MACHINE/WEBROOT/APPHOST");
var sitesCollection = sitesSection.Collection;
var siteElementPos = FindElement(sitesCollection, "site", ["name", "Contoso"]);

if (siteElementPos == -1) throw "Element not found!";

var siteElement = sitesCollection.Item(siteElementPos);
var bindingsCollection = siteElement.ChildElements.Item("bindings").Collection;

var bindingElement = bindingsCollection.CreateNewElement("binding");
bindingElement.Properties.Item("protocol").Value = "http";
bindingElement.Properties.Item("bindingInformation").Value = "192.168.0.1:80:www.contoso.com";
bindingsCollection.AddElement(bindingElement);

var bindingElement1 = bindingsCollection.CreateNewElement("binding");
bindingElement1.Properties.Item("protocol").Value = "https";
bindingElement1.Properties.Item("bindingInformation").Value = "*:443:";
bindingsCollection.AddElement(bindingElement1);

adminManager.CommitChanges();

function FindElement(collection, elementTagName, valuesToMatch) {
   for (var i = 0; i < collection.Count; i++) {
      var element = collection.Item(i);
      if (element.Name == elementTagName) {
         var matches = true;
         for (var iVal = 0; iVal < valuesToMatch.length; iVal += 2) {
            var property = element.GetPropertyByName(valuesToMatch[iVal]);
            var value = property.Value;
            if (value != null) {
               value = value.toString();
            }
            if (value != valuesToMatch[iVal + 1]) {
               matches = false;
               break;
            }
         }
         if (matches) {
            return i;
         }
      }
   }
   return -1;
}

VBScript

Set adminManager = createObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"
Set sitesSection = adminManager.GetAdminSection("system.applicationHost/sites", "MACHINE/WEBROOT/APPHOST")
Set sitesCollection = sitesSection.Collection
siteElementPos = FindElement(sitesCollection, "site", Array("name", "Contoso"))

If siteElementPos = -1 Then
   WScript.Echo "Element not found!"
   WScript.Quit
End If

Set siteElement = sitesCollection.Item(siteElementPos)
Set bindingsCollection = siteElement.ChildElements.Item("bindings").Collection

Set bindingElement = bindingsCollection.CreateNewElement("binding")
bindingElement.Properties.Item("protocol").Value = "http"
bindingElement.Properties.Item("bindingInformation").Value = "192.168.0.1:80:www.contoso.com"
bindingsCollection.AddElement(bindingElement)

Set bindingElement1 = bindingsCollection.CreateNewElement("binding")
bindingElement1.Properties.Item("protocol").Value = "https"
bindingElement1.Properties.Item("bindingInformation").Value = "*:443:"
bindingsCollection.AddElement(bindingElement1)

adminManager.CommitChanges()

Function FindElement(collection, elementTagName, valuesToMatch)
   For i = 0 To CInt(collection.Count) - 1
      Set element = collection.Item(i)
      If element.Name = elementTagName Then
         matches = True
         For iVal = 0 To UBound(valuesToMatch) Step 2
            Set property = element.GetPropertyByName(valuesToMatch(iVal))
            value = property.Value
            If Not IsNull(value) Then
               value = CStr(value)
            End If
            If Not value = CStr(valuesToMatch(iVal + 1)) Then
               matches = False
               Exit For
            End If
         Next
         If matches Then
            Exit For
         End If
      End If
   Next
   If matches Then
      FindElement = i
   Else
      FindElement = -1
   End If
End Function