Bagikan melalui

Panduan: Membuat File Konfigurasi untuk Inti Web yang Dihosting

Panduan ini menunjukkan cara membuat file konfigurasi untuk digunakan dengan fitur Inti Web yang Dihosting yang tersedia di IIS 7.

Saat Anda membuat aplikasi yang menggunakan fungsionalitas Hosted Web Core di IIS 7, Anda harus menyediakan file konfigurasi kustom yang mengikuti format file ApplicationHost.config. Bergantung pada pengaturan konfigurasi Anda, aplikasi Anda dapat menghosting halaman Web dan aplikasi di server yang sama tempat Anda menghosting situs Web yang menggunakan IIS 7. Misalnya, jika server Web Anda hanya memiliki satu situs Web yang melayani halaman Web pada port TCP 80, Anda dapat mengonfigurasi aplikasi Anda untuk melayani halaman Web pada port TCP 8080.

Karena aplikasi Anda memerlukan file konfigurasi kustom, situs Web dan aplikasi Hosted Web Core Anda tidak berbagi pengaturan fitur yang sama. Misalnya, Anda dapat mengonfigurasi situs Web untuk menerapkan fungsionalitas dinamis yang tidak diperlukan oleh aplikasi Anda, atau Anda dapat mengonfigurasi aplikasi Anda untuk mewajibkan metode autentikasi tertentu yang tidak digunakan oleh situs Web Anda.

Meskipun file ApplicationHost.config Anda untuk IIS 7 mungkin berisi lebih dari satu kumpulan aplikasi, fungsionalitas Web Core yang Dihosting di IIS 7 hanya mendukung satu kumpulan aplikasi.

Prasyarat

Perangkat lunak berikut diperlukan untuk menyelesaikan langkah-langkah dalam contoh:

  • IIS 7 di Windows Vista.

Catatan

Meskipun Anda harus menjalankan aplikasi Hosted Web Core di Windows Vista, Anda tidak perlu membuat file konfigurasi di Windows Vista. Anda dapat membuat file konfigurasi pada versi Windows yang berbeda lalu menyalin file konfigurasi Anda ke komputer yang menginstal Windows Vista.

  • Visual Studio 2005.

Catatan

Anda juga dapat menggunakan Visual Studio .NET 2003 atau yang lebih lama, meskipun langkah-langkah penelusuran mungkin tidak identik.

Membuat File Konfigurasi

Langkah-langkah di bagian panduan ini akan membantu Anda membuat file konfigurasi baru untuk digunakan dengan aplikasi Hosted Web Core yang berisi pengaturan yang diperlukan untuk menyajikan konten statis.

Untuk membuat file konfigurasi

  1. Mulai Visual Studio 2005.

  2. Buat file konfigurasi baru:

    1. Pada menu File , arahkan ke Baru, lalu klik File.

      Kotak dialog File Baru terbuka.

    2. Di panel Kategori , klik Umum.

    3. Di panel Templat , pilih File XML.

    4. Klik Buka.

      File XML baru akan terbuka dengan kode XML berikut:

      <?xml version="1.0" encoding="UTF-8"?>

  3. Untuk mengidentifikasi file XML ini sebagai file konfigurasi untuk aplikasi Anda, tambahkan kode XML berikut di <?xml?> bawah elemen :

    <configuration>  

</configuration>

Menentukan Bagian Konfigurasi

Ketika file konfigurasi telah dibuat, Anda harus menentukan bagian konfigurasi mana yang akan dimuat file konfigurasi Anda. Anda melakukan ini dengan menambahkan <configSections> elemen ke file konfigurasi Anda.

Untuk menambahkan bagian <configSections>

  1. Untuk membuat bagian yang menentukan bagian mana yang akan dimuat file konfigurasi Anda, tambahkan kode XML berikut di <configuration> dalam elemen :

    <configSections>  

</configSections>

  2. Untuk menentukan informasi apa yang akan disertakan di bagian Anda <system.applicationHost> , tambahkan kode XML berikut di <configSections> dalam elemen :

    <sectionGroup name="system.applicationHost"  
        type="System.ApplicationHost.Configuration.SystemApplicationHostSectionGroup">  
    <section name="applicationPools"  
            type="System.ApplicationHost.Configuration.ApplicationPoolsSection"  
            allowDefinition="MachineOnly"  
            overrideModeDefault="Deny" />  
    <section name="listenerAdapters"  
            type="System.ApplicationHost.Configuration.ListenerAdaptersSection"  
            allowDefinition="MachineOnly"  
            overrideModeDefault="Deny" />  
    <section name="log"  
            type="System.ApplicationHost.Configuration.LogSection"  
            allowDefinition="MachineOnly"  
            overrideModeDefault="Deny" />  
    <section name="sites"  
            type="System.ApplicationHost.Configuration.SitesSection"  
            allowDefinition="MachineOnly"  
            overrideModeDefault="Deny" />  
</sectionGroup>

  3. Untuk menentukan informasi apa yang akan disertakan di bagian Anda <system.applicationHost> , tambahkan kode berikut di <configSections> dalam elemen :

    <sectionGroup name="system.webServer"  
    type="System.WebServer.Configuration.SystemWebServerSectionGroup">  
    <section name="defaultDocument"  
        type="System.WebServer.Configuration.DefaultDocumentSection"  
        overrideModeDefault="Allow" />  
    <section name="directoryBrowse"  
        type="System.WebServer.Configuration.DirectoryBrowseSection"  
        overrideModeDefault="Allow" />  
    <section name="globalModules"  
        type="System.WebServer.Configuration.GlobalModulesSection"  
        allowDefinition="MachineOnly"  
        overrideModeDefault="Deny" />  
    <section name="handlers"  
        type="System.WebServer.Configuration.HandlersSection"  
        overrideModeDefault="Deny" />  
    <section name="httpLogging"  
        type="System.WebServer.Configuration.HttpLoggingSection"  
        overrideModeDefault="Deny" />  
    <section name="modules"  
        type="System.WebServer.Configuration.ModulesSection"  
        allowDefinition="MachineToApplication"  
        overrideModeDefault="Deny" />  
    <sectionGroup name="security"  
        type="System.WebServer.Configuration.SecuritySectionGroup">  
        <section name="access"  
            type="System.WebServer.Configuration.AccessSection"  
            overrideModeDefault="Deny" />  
        <sectionGroup name="authentication"  
            type="System.WebServer.Configuration.AuthenticationSectionGroup">  
            <section name="anonymousAuthentication"  
                type="System.WebServer.Configuration.AnonymousAuthenticationSection"  
                overrideModeDefault="Allow" />  
        </sectionGroup>  
    </sectionGroup>  
    <section name="staticContent"  
        type="System.WebServer.Configuration.StaticContentSection"  
        overrideModeDefault="Deny" />  
</sectionGroup>

<Menambahkan Pengaturan system.applicationHost>

Ketika Anda telah menentukan bagian mana yang akan dimuat file konfigurasi Anda, Anda harus mengisi bagian konfigurasi dengan pengaturan yang diperlukan untuk aplikasi Anda.

Untuk menambahkan bagian <system.applicationHost>

  1. Untuk menambahkan bagian ke <system.applicationHost> file konfigurasi Anda, tambahkan kode XML berikut di <configuration> dalam elemen :

    <system.applicationHost>  

</system.applicationHost>

  2. Untuk membuat kumpulan aplikasi, tambahkan kode XML berikut di <system.applicationHost> dalam elemen :

    <applicationPools>  
    <add name="TestAppPool" />  
    <applicationPoolDefaults>  
        <processModel identityType="NetworkService" />  
    </applicationPoolDefaults>  
</applicationPools>

  3. Untuk menentukan adaptor pendengar untuk HTTP, tambahkan kode XML berikut di <system.applicationHost> dalam elemen :

    <listenerAdapters>  
    <add name="http" />  
</listenerAdapters>

  4. Untuk membuat situs Web, tambahkan kode XML berikut di <system.applicationHost> dalam elemen :

    <sites>  
    <site name="Test Web Site" id="1">  
        <application path="/">  
            <virtualDirectory path="/"  
                physicalPath="D:\inetpub\TestPath\wwwroot" />  
        </application>  
        <bindings>  
            <binding protocol="HTTP" bindingInformation="*:8080:" />  
        </bindings>  
    </site>  
    <siteDefaults>  
        <logFile directory="D:\inetpub\TestPath\Logs" />  
    </siteDefaults>  
    <applicationDefaults applicationPool="TestAppPool" />  
    <virtualDirectoryDefaults allowSubDirConfig="true" />  
</sites>

Catatan

Anda dapat mengubah jalur file dan pengikatan server di pengaturan XML yang sesuai untuk aplikasi Anda.

<Menambahkan Pengaturan system.webServer>

Untuk menambahkan bagian <system.webServer>

  1. Untuk menambahkan bagian ke <system.webServer> file konfigurasi Anda, tambahkan kode XML berikut di <configuration> dalam elemen :

    <system.webServer>  

</system.webServer>

  2. Untuk menentukan modul global yang akan digunakan aplikasi Anda, tambahkan kode XML berikut di <system.webServer> dalam elemen :

    <globalModules>  
    <add name="DefaultDocumentModule"  
        image="D:\Windows\system32\inetsrv\defdoc.dll" />  
    <add name="DirectoryListingModule"  
        image="D:\Windows\system32\inetsrv\dirlist.dll" />  
    <add name="StaticFileModule"  
        image="D:\Windows\system32\inetsrv\static.dll" />  
    <add name="AnonymousAuthenticationModule"  
        image="D:\Windows\system32\inetsrv\authanon.dll" />  
    <add name="HttpLoggingModule"  
        image="D:\Windows\system32\inetsrv\loghttp.dll" />  
</globalModules>

  3. Untuk menentukan handler yang akan digunakan aplikasi Anda, tambahkan kode XML berikut di <system.webServer> dalam elemen :

    <handlers>  
    <add name="StaticFile" path="*" verb="*"  
        modules="StaticFileModule,DefaultDocumentModule,DirectoryListingModule"  
        resourceType="Either" requireAccess="Read" />  
</handlers>

  4. Untuk menentukan modul yang akan digunakan aplikasi Anda, tambahkan kode XML berikut di <system.webServer> dalam elemen :

    <modules>  
    <add name="DefaultDocumentModule" />  
    <add name="DirectoryListingModule" />  
    <add name="StaticFileModule" />  
    <add name="AnonymousAuthenticationModule" />  
    <add name="HttpLoggingModule" />  
</modules>

  5. Untuk menentukan opsi penjelajahan direktori dan pengelogan HTTP Anda, tambahkan kode XML berikut di <system.webServer> dalam elemen :

    <directoryBrowse enabled="true" />  
<httpLogging dontLog="false" />

  6. Untuk mengaktifkan dokumen default, tambahkan kode XML berikut di <system.webServer> dalam elemen :

    <defaultDocument enabled="true">  
    <files>  
        <add value="default.htm" />  
    </files>  
</defaultDocument>

  7. Untuk menentukan jenis MIME yang akan diterapkan aplikasi Anda, tambahkan kode XML berikut di <system.webServer> dalam elemen :

    <staticContent>  
    <mimeMap fileExtension=".gif" mimeType="image/gif" />  
    <mimeMap fileExtension=".htm" mimeType="text/html" />  
    <mimeMap fileExtension=".jpg" mimeType="image/jpeg" />  
    <mimeMap fileExtension=".txt" mimeType="text/plain" />  
</staticContent>

    Catatan

    Anda dapat menambahkan jenis MIME yang sesuai untuk aplikasi Anda dengan menambahkan lebih <mimeMap> banyak elemen.

  8. Untuk menentukan opsi keamanan aplikasi Anda, tambahkan kode XML berikut di <system.webServer> dalam elemen :

    <security>  
    <access flags="Read" sslFlags="None" />  
    <authentication>  
        <anonymousAuthentication enabled="true"  
            userName="IUSR" defaultLogonDomain="" />  
    </authentication>  
</security>

    Ketika Anda telah menyelesaikan semua langkah sebelumnya, Anda perlu menyimpan file konfigurasi Anda ke jalur tempat aplikasi Hosted Web Core Anda akan dapat mengaksesnya.

    Aplikasi Anda mungkin mengalami kesalahan jika bagian file konfigurasi Anda belum ditentukan dengan benar. Bergantung pada kesalahannya, Anda mungkin dapat mengambil informasi tambahan tentang masalah dengan memeriksa log Pemantau Peristiwa server Anda dan file log IIS yang dibuat secara otomatis oleh aplikasi Anda. Untuk informasi selengkapnya tentang pemecahan masalah dengan aplikasi Hosted Web Core, lihat langkah-langkah pemecahan masalah yang tercantum di Panduan: Membuat Aplikasi Web Core yang Dihosting.

Lihat juga

Membuat Aplikasi Web Core yang Dihosting
Panduan: Membuat Aplikasi Web Core yang Dihosting