Bagikan melalui

Autentikasi Autentikasi <FTP>

Gambaran Umum

Elemen <authentication> menentukan pengaturan autentikasi untuk situs FTP. Pengaturan autentikasi hanya dikonfigurasi di tingkat situs, meskipun pengaturan FTP <authorization> dapat dikonfigurasi per URL.

Ada empat bentuk autentikasi berbeda yang dapat dikonfigurasi untuk situs FTP:

  • Autentikasi anonim: Bentuk autentikasi ini memungkinkan akses ke situs FTP tanpa akun pengguna di server atau domain Anda, dan paling sering digunakan untuk situs FTP publik. Biasanya, pengguna akan masuk dengan menggunakan nama pengguna ftp atau anonim, dan sebagian besar pengguna akan menggunakan alamat email mereka sebagai kata sandi, meskipun ini tidak diperlukan.

  • Autentikasi dasar: Bentuk autentikasi ini memerlukan akun pengguna yang valid di server atau domain Anda sebelum pengguna dapat masuk.

    Catatan: Karena desain Protokol Transfer File (FTP), nama pengguna dan kata sandi ditransmisikan melalui FTP dalam teks biasa, membuatnya rentan terhadap penemuan jaringan. Oleh karena itu disarankan agar Anda menggunakan autentikasi Dasar dengan SSL.

  • Autentikasi Sertifikat Klien: Bentuk autentikasi ini menggunakan sertifikat klien untuk mengautentikasi klien FTP.

  • Autentikasi kustom: Bentuk autentikasi ini menggunakan penyedia autentikasi kustom untuk memvalidasi nama pengguna dan kata sandi. FTP 7.0 dan FTP 7.5 dikirim dengan dua penyedia autentikasi kustom:

    Keuntungan utama menggunakan penyedia autentikasi kustom adalah bahwa akun pengguna tidak harus dibuat di server atau domain Anda. Ini meningkatkan keamanan jaringan Anda.

Kompatibilitas

Versi Catatan
IIS 10.0 Elemen <authentication> tidak dimodifikasi dalam IIS 10.0.
IIS 8.5 Elemen <authentication> tidak dimodifikasi dalam IIS 8.5.
IIS 8.0 Elemen <authentication> tidak dimodifikasi dalam IIS 8.0.
IIS 7.5 Elemen <authentication><security> dari elemen dikirim sebagai fitur IIS 7.5.
IIS 7.0 Elemen <authentication> elemen diperkenalkan dalam FTP 7.0, yang merupakan unduhan <security> terpisah untuk IIS 7.0.
IIS 6.0 Elemen <ftpServer> dan elemen turunannya menggantikan pengaturan FTP IIS 6.0 yang terletak di jalur metabase LM/MSFTPSVC .

Catatan

Layanan FTP 7.0 dan FTP 7.5 yang dikirim di luar band untuk IIS 7.0, yang memerlukan pengunduhan dan penginstalan modul dari URL berikut:

https://www.iis.net/expand/FTP

Dengan Windows 7 dan Windows Server 2008 R2, layanan FTP 7.5 dikirim sebagai fitur untuk IIS 7.5, sehingga mengunduh layanan FTP tidak lagi diperlukan.

Siapkan

Untuk mendukung penerbitan FTP untuk server Web, Anda harus menginstal layanan FTP. Untuk melakukannya, gunakan langkah-langkah berikut.

Windows Server 2012 atau Windows Server 2012 R2

  1. Pada taskbar, klik Manajer Server.

  2. Di Manajer Server, klik menu Kelola , lalu klik Tambahkan Peran dan Fitur.

  3. Di wizard Tambahkan Peran dan Fitur , klik Berikutnya. Pilih jenis penginstalan dan klik Berikutnya. Pilih server tujuan dan klik Berikutnya.

  4. Pada halaman Peran Server , perluas Server Web (IIS), lalu pilih Server FTP.

    Catatan

    Untuk mendukung ASP. Autentikasi keanggotaan atau autentikasi Manajer IIS untuk layanan FTP, Anda harus memilih Ekstensibilitas FTP, selain Layanan FTP.
    Gambar halaman Peran Server di wizard Tambahkan Peran dan Fitur dengan panel I I S Server Web diperluas dan Ekstensibilitas F T P dipilih. .

  5. Klik Berikutnya, lalu pada halaman Pilih fitur , klik Berikutnya lagi.

  6. Pada halaman Konfirmasi pilihan instalasi, klik Instal.

  7. Pada halaman Hasil , klik Tutup.

Windows 8 atau Windows 8.1

  1. Pada layar Mulai, pindahkan penunjuk ke sudut kiri bawah, klik kanan tombol Mulai, lalu klik Panel Kontrol.

  2. Di Panel Kontrol, klik Program dan Fitur, lalu klik Aktifkan atau nonaktifkan fitur Windows.

  3. Perluas Layanan Informasi Internet, lalu pilih Server FTP.

    Catatan

    Untuk mendukung ASP. Autentikasi keanggotaan atau autentikasi Manajer IIS untuk layanan FTP, Anda juga harus memilih Ekstensibilitas FTP.
    Gambar panel Layanan Informasi Internet dan Server F T P diperluas dan Ekstensibilitas F T P dipilih.

  4. Klik OK.

  5. Klik Tutup.

Windows Server 2008 R2

  1. Pada taskbar, klik Mulai, arahkan ke Alat Administratif, lalu klik Manajer Server.

  2. Di panel hierarki Manajer Server , perluas Peran, lalu klik Server Web (IIS).

  3. Di panel Server Web (IIS), gulir ke bagian Layanan Peran , lalu klik Tambahkan Layanan Peran.

  4. Pada halaman Pilih Layanan Peran dari Wizard Tambahkan Layanan Peran, perluas Server FTP.

  5. Pilih Layanan FTP.

    Catatan

    Untuk mendukung ASP. Autentikasi keanggotaan atau autentikasi Manajer IIS untuk layanan FTP, Anda juga harus memilih Ekstensibilitas FTP.
    Cuplikan layar Pilih Layanan Peran di Wizard Tambahkan Layanan Peran dengan panel Server F T P diperluas dan Layanan F T P disorot.

  6. Klik Berikutnya.

  7. Pada halaman Konfirmasi Pilihan Penginstalan , klik Instal.

  8. Pada halaman Hasil , klik Tutup.

Windows 7

  1. Pada taskbar, klik Mulai, lalu klik Panel Kontrol.

  2. Di Panel Kontrol, klik Program dan Fitur, lalu klik Aktifkan atau nonaktifkan Fitur Windows.

  3. Perluas Layanan Informasi Internet, lalu Server FTP.

  4. Pilih Layanan FTP.

    Catatan

    Untuk mendukung ASP. Autentikasi keanggotaan atau autentikasi Manajer IIS untuk layanan FTP, Anda juga harus memilih Ekstensibilitas FTP.
    Cuplikan layar panel Layanan Informasi Internet dan Server F T P diperluas dan Ekstensibilitas F T P dipilih.

  5. Klik OK.

Windows Server 2008 atau Windows Vista

  1. Unduh paket penginstalan dari URL berikut:

  2. Ikuti instruksi dalam panduan berikut untuk menginstal layanan FTP:

Bagaimana Caranya

Cara mengaktifkan atau menonaktifkan autentikasi Anonim untuk situs FTP

  1. Buka Pengelola Layanan Informasi Internet (IIS):

    • Jika Anda menggunakan Windows Server 2012 atau Windows Server 2012 R2:

      • Pada bilah tugas, klik Manajer Server, klik Alat, lalu klik Pengelola Layanan Informasi Internet (IIS).

    • Jika Anda menggunakan Windows 8 atau Windows 8.1:

      • Tahan tombol Windows, tekan huruf X, lalu klik Panel Kontrol.
      • Klik Alat Administratif, lalu klik dua kali Manajer Layanan Informasi Internet (IIS).

    • Jika Anda menggunakan Windows Server 2008 atau Windows Server 2008 R2:

      • Pada bilah tugas, klik Mulai, arahkan ke Alat Administratif, lalu klik Pengelola Layanan Informasi Internet (IIS).

    • Jika Anda menggunakan Windows Vista atau Windows 7:

      • Pada taskbar, klik Mulai, lalu klik Panel Kontrol.
      • Klik dua kali Alat Administratif, lalu klik dua kali Manajer Layanan Informasi Internet (IIS).

  2. Di panel Koneksi , perluas nama server, perluas simpul Situs , lalu klik nama situs.

  3. Di panel Beranda situs, klik dua kali fitur Autentikasi FTP .

  4. Pada halaman Autentikasi FTP , pilih Autentikasi Anonim.

  5. Di panel Tindakan , klik Aktifkan untuk mengaktifkan autentikasi Anonim atau klik Nonaktifkan untuk menonaktifkan autentikasi Anonim.
    Gambar halaman Autentikasi F T P memperlihatkan opsi Autentikasi Anonim dipilih.

Cara menggunakan Panduan Situs FTP untuk Membuat Situs FTP dengan Akses Baca Anonim

  1. Buka Pengelola Layanan Informasi Internet (IIS):

    • Jika Anda menggunakan Windows Server 2012 atau Windows Server 2012 R2:

      • Pada bilah tugas, klik Manajer Server, klik Alat, lalu klik Pengelola Layanan Informasi Internet (IIS).

    • Jika Anda menggunakan Windows 8 atau Windows 8.1:

      • Tahan tombol Windows, tekan huruf X, lalu klik Panel Kontrol.
      • Klik Alat Administratif, lalu klik dua kali Manajer Layanan Informasi Internet (IIS).

    • Jika Anda menggunakan Windows Server 2008 atau Windows Server 2008 R2:

      • Pada bilah tugas, klik Mulai, arahkan ke Alat Administratif, lalu klik Pengelola Layanan Informasi Internet (IIS).

    • Jika Anda menggunakan Windows Vista atau Windows 7:

      • Pada taskbar, klik Mulai, lalu klik Panel Kontrol.
      • Klik dua kali Alat Administratif, lalu klik dua kali Manajer Layanan Informasi Internet (IIS).

  2. Di panel Koneksi , klik simpul Situs di pohon.

  3. Klik kanan simpul Situs di pohon dan klik Tambahkan Situs FTP, atau klik Tambahkan Situs FTP di panel Tindakan .

  4. Saat wizard Tambahkan Situs FTP muncul:

    • Masukkan "Situs FTP Baru Saya" di kotak nama situs FTP .

    • Untuk kotak Jalur fisik , Anda bisa menggunakan salah satu opsi berikut untuk menentukan direktori konten Anda:

      • Klik tombol elipsis (...), lalu navigasi ke folder yang berisi konten untuk situs FTP Anda.
      • Ketik jalur ke folder konten Anda dalam kotak. Perhatikan bahwa jika Anda memilih untuk mengetik jalur, Anda dapat menggunakan variabel lingkungan di jalur Anda. Misalnya, Anda dapat menggunakan "%SystemDrive%\inetpub\ftproot" untuk direktori konten Anda.

    • Ketika Anda telah menyelesaikan item ini, klik Berikutnya.
      Gambar Informasi Situs di Panduan Tambahkan Situs F T P yang menampilkan Situs F T P Baru Saya yang di ketik di bidang nama situs F T P.

  5. Pada halaman kedua wizard Tambahkan Situs FTP :

    • Pilih alamat IP untuk situs FTP Anda dari menu drop-down Alamat IP , atau pilih untuk menerima pilihan default "Semua Tidak Ditetapkan."

    • Masukkan port TCP/IP untuk situs FTP dalam kotak Port . Secara default, situs dan klien FTP menggunakan port 21. (Catatan: Untuk menentukan FTPS Implisit, Anda perlu menggunakan port 990.)

    • Untuk menggunakan nama host virtual FTP, pilih kotak untuk Aktifkan Nama Host Virtual, lalu masukkan nama host virtual di kotak Host Virtual .

    • Untuk opsi SSL, pilih salah satu opsi berikut:

      • Pilih Tidak Ada SSL untuk menonaktifkan opsi SSL.
      • Pilih Izinkan SSL untuk mengizinkan klien FTP secara opsional menggunakan FTP melalui SSL saat terhubung dengan server FTP.
      • Pilih Perlu SSL untuk memungkinkan klien FTP selalu menggunakan FTP melalui SSL saat terhubung dengan server FTP.
      • Jika Anda memilih Izinkan SSL atau Memerlukan SSL, pilih sertifikat dari menu drop-down Sertifikat SSL .

    • Ketika Anda telah menyelesaikan item ini, klik Berikutnya.
      Gambar Pengikatan dan Pengaturan S S L di Wizard Tambahkan Situs F T P memperlihatkan Alamat I P yang dipilih dari daftar drop-down.

  6. Pada halaman panduan berikutnya:

    • Pilih Anonim untuk pengaturan Autentikasi .
    • Untuk Pengaturan otorisasi , pilih "Pengguna anonim" dari menu drop-down Izinkan akses ke .
    • Pilih Baca untuk opsi Izin .
    • Ketika Anda telah menyelesaikan item ini, klik Selesai.
      Gambar pengaturan Autentikasi dan Otorisasi di Tambahkan Wizard F T P dengan opsi Anonim dipilih.

Cara mengaktifkan atau menonaktifkan autentikasi Dasar untuk situs FTP

  1. Buka Pengelola Layanan Informasi Internet (IIS):

    • Jika Anda menggunakan Windows Server 2012 atau Windows Server 2012 R2:

      • Pada bilah tugas, klik Manajer Server, klik Alat, lalu klik Pengelola Layanan Informasi Internet (IIS).

    • Jika Anda menggunakan Windows 8 atau Windows 8.1:

      • Tahan tombol Windows, tekan huruf X, lalu klik Panel Kontrol.
      • Klik Alat Administratif, lalu klik dua kali Manajer Layanan Informasi Internet (IIS).

    • Jika Anda menggunakan Windows Server 2008 atau Windows Server 2008 R2:

      • Pada bilah tugas, klik Mulai, arahkan ke Alat Administratif, lalu klik Pengelola Layanan Informasi Internet (IIS).

    • Jika Anda menggunakan Windows Vista atau Windows 7:

      • Pada taskbar, klik Mulai, lalu klik Panel Kontrol.
      • Klik dua kali Alat Administratif, lalu klik dua kali Manajer Layanan Informasi Internet (IIS).

  2. Di panel Koneksi , perluas nama server, perluas simpul Situs , lalu klik nama situs.

  3. Di panel Beranda situs, klik dua kali fitur Autentikasi FTP .

  4. Pada halaman Autentikasi FTP , pilih Autentikasi Dasar.
    Gambar Autentikasi F T P yang menampilkan Autentikasi Dasar dipilih.

  5. Di panel Tindakan , klik Aktifkan untuk mengaktifkan Autentikasi dasar atau klik Nonaktifkan untuk menonaktifkan autentikasi Dasar.

Cara menggunakan Panduan Situs FTP untuk Membuat Situs FTP dengan autentikasi Dasar dan Akses Baca/Tulis

  1. Buka Pengelola Layanan Informasi Internet (IIS):

    • Jika Anda menggunakan Windows Server 2012 atau Windows Server 2012 R2:

      • Pada bilah tugas, klik Manajer Server, klik Alat, lalu klik Pengelola Layanan Informasi Internet (IIS).

    • Jika Anda menggunakan Windows 8 atau Windows 8.1:

      • Tahan tombol Windows, tekan huruf X, lalu klik Panel Kontrol.
      • Klik Alat Administratif, lalu klik dua kali Manajer Layanan Informasi Internet (IIS).

    • Jika Anda menggunakan Windows Server 2008 atau Windows Server 2008 R2:

      • Pada bilah tugas, klik Mulai, arahkan ke Alat Administratif, lalu klik Pengelola Layanan Informasi Internet (IIS).

    • Jika Anda menggunakan Windows Vista atau Windows 7:

      • Pada taskbar, klik Mulai, lalu klik Panel Kontrol.
      • Klik dua kali Alat Administratif, lalu klik dua kali Manajer Layanan Informasi Internet (IIS).

  2. Di panel Koneksi , klik simpul Situs di pohon.

  3. Klik kanan simpul Situs di pohon dan klik Tambahkan Situs FTP, atau klik Tambahkan Situs FTP di panel Tindakan .

  4. Saat wizard Tambahkan Situs FTP muncul:

    • Masukkan "Situs FTP Baru Saya" di kotak nama situs FTP .

    • Untuk kotak Jalur fisik , Anda bisa menggunakan salah satu opsi berikut untuk menentukan direktori konten Anda:

      • Klik tombol elipsis (...), lalu navigasi ke folder yang berisi konten untuk situs FTP Anda.
      • Ketik jalur ke folder konten Anda dalam kotak. Perhatikan bahwa jika Anda memilih untuk mengetik jalur, Anda dapat menggunakan variabel lingkungan di jalur Anda. Misalnya, Anda dapat menggunakan "%SystemDrive%\inetpub\ftproot" untuk direktori konten Anda.

    • Ketika Anda telah menyelesaikan item ini, klik Berikutnya.
      Cuplikan layar Informasi Situs di Panduan Tambahkan Situs F T P yang menampilkan Situs F T P Baru Saya yang di ketikkan dalam kotak nama situs F T P.

  5. Pada halaman kedua wizard Tambahkan Situs FTP :

    • Pilih alamat IP untuk situs FTP Anda dari menu drop-down Alamat IP , atau pilih untuk menerima pilihan default "Semua Tidak Ditetapkan."

    • Masukkan port TCP/IP untuk situs FTP dalam kotak Port . Secara default, situs dan klien FTP menggunakan port 21. (Catatan: Untuk menentukan FTPS Implisit, Anda perlu menggunakan port 990.)

    • Untuk menggunakan nama host virtual FTP, pilih kotak untuk Aktifkan Nama Host Virtual, lalu masukkan nama host virtual di kotak Host Virtual .

    • Untuk opsi SSL, pilih salah satu opsi berikut:

      • Pilih Tidak Ada SSL untuk menonaktifkan opsi SSL.
      • Pilih Izinkan SSL untuk mengizinkan klien FTP secara opsional menggunakan FTP melalui SSL saat terhubung dengan server FTP.
      • Pilih Perlu SSL untuk memungkinkan klien FTP selalu menggunakan FTP melalui SSL saat terhubung dengan server FTP.
      • Jika Anda memilih Izinkan SSL atau Memerlukan SSL, pilih sertifikat dari menu drop-down Sertifikat SSL .

    • Ketika Anda telah menyelesaikan item ini, klik Berikutnya.
      Cuplikan layar halaman Pengikatan dan Pengaturan S S L di Wizard Tambahkan Situs F T P memperlihatkan Alamat I P yang dipilih dari menu drop-down.

  6. Pada halaman panduan berikutnya:

    • Pilih Dasar untuk pengaturan Autentikasi .
    • Untuk Pengaturan otorisasi , pilih "Pengguna yang ditentukan" dari menu drop-down Izinkan akses ke , dan masukkan nama akun di kotak di bawah menu drop-down.
    • Pilih Baca dan Tulis untuk opsi Izin .
    • Ketika Anda telah menyelesaikan item ini, klik Selesai.
      Cuplikan layar Pengaturan Autentikasi dan Otorisasi di Wizard Tambahkan Situs F T P memperlihatkan opsi Dasar yang dipilih untuk Autentikasi.

Konfigurasi

Elemen <authentication> dikonfigurasi di tingkat situs.

Atribut

Tidak ada.

Elemen Anak

Elemen Deskripsi
anonymousAuthentication Elemen opsional.

Menentukan pengaturan autentikasi Anonim untuk situs FTP.
basicAuthentication Elemen opsional.

Menentukan pengaturan autentikasi Dasar untuk situs FTP.
clientCertAuthentication Elemen opsional.

Menentukan pengaturan autentikasi Sertifikat Klien untuk situs FTP.
customAuthentication Elemen opsional.

Menentukan pengaturan Autentikasi kustom untuk situs FTP.

Catatan: Autentikasi kustom diterapkan melalui penyedia autentikasi kustom.

Sampel Konfigurasi

Contoh berikut mengilustrasikan beberapa pengaturan konfigurasi dalam <ftpServer> elemen untuk situs FTP. Lebih khusus lagi, <site> pengaturan dalam contoh ini menunjukkan cara:

  • Buat situs FTP dan tambahkan pengikatan untuk protokol FTP pada port 21.
  • Konfigurasikan opsi SSL FTP untuk memungkinkan akses aman pada kontrol dan saluran data menggunakan sertifikat.
  • Nonaktifkan autentikasi Anonim dan aktifkan autentikasi Dasar untuk FTP.
  • Tolak akses untuk perintah FTP SYST .
  • Tentukan format daftar direktori UNIX.
  • Mengonfigurasi opsi pengelogan.
  • Tentukan pesan selamat datang yang dikustomisasi dan aktifkan pesan kesalahan terperinci lokal.
  • Tentukan bahwa pengguna akan memulai di direktori beranda yang didasarkan pada nama login mereka, tetapi hanya jika direktori tersebut ada.
<site name="ftp.example.com" id="5">
  <application path="/">
    <virtualDirectory path="/" physicalPath="c:\inetpub\www.example.com" />
  </application>
  <bindings>
    <binding protocol="ftp" bindingInformation="*:21:" />
  </bindings>
  <ftpServer>
    <security>
      <ssl controlChannelPolicy="SslAllow"
         dataChannelPolicy="SslAllow"
         serverCertHash="57686f6120447564652c2049495320526f636b73" />
      <authentication>
        <basicAuthentication enabled="true" />
        <anonymousAuthentication enabled="false" />
      </authentication>
      <commandFiltering maxCommandLine="4096" allowUnlisted="true">
        <add command="SYST" allowed="false" />
      </commandFiltering>
    </security>
    <directoryBrowse showFlags="StyleUnix" />
    <logFile logExtFileFlags="Date, Time, ClientIP, UserName, ServerIP, Method, UriStem, FtpStatus, Win32Status, ServerPort, FtpSubStatus, Session, FullPath, Info" />
    <messages expandVariables="true"
       greetingMessage="Welcome %UserName%!"
       allowLocalDetailedErrors="true" />
    <userIsolation mode="StartInUsersDirectory" />
  </ftpServer>
</site>

Kode Sampel

Contoh berikut menonaktifkan autentikasi Anonim untuk situs FTP.

AppCmd.exe

appcmd.exe set config -section:system.applicationHost/sites /[name='ftp.example.com'].ftpServer.security.authentication.anonymousAuthentication.enabled:"False" /commit:apphost

Catatan

Anda harus memastikan untuk mengatur parameter penerapan ke apphost saat Anda menggunakan AppCmd.exe untuk mengonfigurasi pengaturan ini. Ini menerapkan pengaturan konfigurasi ke bagian lokasi yang sesuai dalam file ApplicationHost.config.

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", @"ftp.example.com");
         if (siteElement == null) throw new InvalidOperationException("Element not found!");

         ConfigurationElement ftpServerElement = siteElement.GetChildElement("ftpServer");
         ConfigurationElement securityElement = ftpServerElement.GetChildElement("security");
         ConfigurationElement authenticationElement = securityElement.GetChildElement("authentication");
         ConfigurationElement anonymousAuthenticationElement = authenticationElement.GetChildElement("anonymousAuthentication");
         anonymousAuthenticationElement["enabled"] = false;

         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", "ftp.example.com")
      If (siteElement Is Nothing) Then
         Throw New InvalidOperationException("Element not found!")
      End If

      Dim ftpServerElement As ConfigurationElement = siteElement.GetChildElement("ftpServer")
      Dim securityElement As ConfigurationElement = ftpServerElement.GetChildElement("security")
      Dim authenticationElement As ConfigurationElement = securityElement.GetChildElement("authentication")
      Dim anonymousAuthenticationElement As ConfigurationElement = authenticationElement.GetChildElement("anonymousAuthentication")
      anonymousAuthenticationElement("enabled") = False

      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", "ftp.example.com"]);
if (siteElementPos == -1) throw "Element not found!";
var siteElement = sitesCollection.Item(siteElementPos);

var ftpServerElement = siteElement.ChildElements.Item("ftpServer");
var securityElement = ftpServerElement.ChildElements.Item("security");
var authenticationElement = securityElement.ChildElements.Item("authentication");
var anonymousAuthenticationElement = authenticationElement.ChildElements.Item("anonymousAuthentication");
anonymousAuthenticationElement.Properties.Item("enabled").Value = false;

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", "ftp.example.com"))
If siteElementPos = -1 Then
WScript.Echo "Element not found!"
WScript.Quit
End If
Set siteElement = sitesCollection.Item(siteElementPos)

Set ftpServerElement = siteElement.ChildElements.Item("ftpServer")
Set securityElement = ftpServerElement.ChildElements.Item("security")
Set authenticationElement = securityElement.ChildElements.Item("authentication")
Set anonymousAuthenticationElement = authenticationElement.ChildElements.Item("anonymousAuthentication")
anonymousAuthenticationElement.Properties.Item("enabled").Value = False

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

Contoh berikut menonaktifkan autentikasi Dasar untuk situs FTP.

AppCmd.exe

appcmd.exe set config -section:system.applicationHost/sites /[name='ftp.example.com'].ftpServer.security.authentication.basicAuthentication.enabled:"False" /commit:apphost

Catatan

Anda harus memastikan untuk mengatur parameter penerapan ke apphost saat Anda menggunakan AppCmd.exe untuk mengonfigurasi pengaturan ini. Ini menerapkan pengaturan konfigurasi ke bagian lokasi yang sesuai dalam file ApplicationHost.config.

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", @"ftp.example.com");
         if (siteElement == null) throw new InvalidOperationException("Element not found!");

         ConfigurationElement ftpServerElement = siteElement.GetChildElement("ftpServer");
         ConfigurationElement securityElement = ftpServerElement.GetChildElement("security");
         ConfigurationElement authenticationElement = securityElement.GetChildElement("authentication");
         ConfigurationElement basicAuthenticationElement = authenticationElement.GetChildElement("basicAuthentication");
         basicAuthenticationElement["enabled"] = false;

         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", "ftp.example.com")
      If (siteElement Is Nothing) Then
         Throw New InvalidOperationException("Element not found!")
      End If

      Dim ftpServerElement As ConfigurationElement = siteElement.GetChildElement("ftpServer")
      Dim securityElement As ConfigurationElement = ftpServerElement.GetChildElement("security")
      Dim authenticationElement As ConfigurationElement = securityElement.GetChildElement("authentication")
      Dim basicAuthenticationElement As ConfigurationElement = authenticationElement.GetChildElement("basicAuthentication")
      basicAuthenticationElement("enabled") = False

      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", "ftp.example.com"]);
if (siteElementPos == -1) throw "Element not found!";
var siteElement = sitesCollection.Item(siteElementPos);

var ftpServerElement = siteElement.ChildElements.Item("ftpServer");
var securityElement = ftpServerElement.ChildElements.Item("security");
var authenticationElement = securityElement.ChildElements.Item("authentication");
var basicAuthenticationElement = authenticationElement.ChildElements.Item("basicAuthentication");
basicAuthenticationElement.Properties.Item("enabled").Value = false;

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", "ftp.example.com"))
If siteElementPos = -1 Then
WScript.Echo "Element not found!"
WScript.Quit
End If
Set siteElement = sitesCollection.Item(siteElementPos)

Set ftpServerElement = siteElement.ChildElements.Item("ftpServer")
Set securityElement = ftpServerElement.ChildElements.Item("security")
Set authenticationElement = securityElement.ChildElements.Item("authentication")
Set basicAuthenticationElement = authenticationElement.ChildElements.Item("basicAuthentication")
basicAuthenticationElement.Properties.Item("enabled").Value = False

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