FTP-Anbieterdefinitionen <providerDefinitions>

Artikel
03/25/2024

Übersicht

Das <providerDefinitions>-Element gibt die Sammlung benutzerdefinierter FTP-Anbieter an. Das <providerDefinitions>-Element enthält eine Sammlung von <add>-Anweisungen, die jeweils einen Anbieter mit verwaltetem Code oder nativem Code (COM-Anbieter) registrieren. Das <providerDefinitions>-Element enthält zudem ein <activation>-Element, das eine Sammlung von benutzerdefinierten Schlüssel-Wert-Paaren definiert, die alle für einen benutzerdefinierten Anbieter erforderliche Parameter angeben.

Ab FTP 7.5 unterstützt der FTP-Dienst die Erweiterbarkeit für benutzerdefinierte Authentifizierung und Rollen, Protokollierung und Suchvorgänge im Basisverzeichnis. Wenn Sie einen Erweiterbarkeitsanbieter erstellen, müssen Sie ihn zuerst im globalen .NET-Assemblycache (Global Assembly Cache, GAC) für Anbieter mit verwaltetem Code oder in der Registrierung Ihres Systems für Anbieter mit nativem Code (COM-Anbieter) registrieren. Weitere Informationen zum Erstellen benutzerdefinierter FTP-Feature-Anbieter finden Sie im folgenden Abschnitt auf der iis.net-Website von Microsoft:

Entwickeln für FTP 7.5

Kompatibilität

Version	Hinweise
IIS 10.0	Das `<providerDefinitions>`-Element wurde in IIS 10.0 nicht geändert.
IIS 8.5	Das `<providerDefinitions>`-Element wurde in IIS 8.5 nicht geändert.
IIS 8.0	Das `<providerDefinitions>`-Element wurde in IIS 8.0 nicht geändert.
IIS 7.5	Das `<providerDefinitions>`-Element des `<system.ftpServer>`-Elements wird als Feature von IIS 7.5 bereitgestellt.
IIS 7.0	Das Element `<providerDefinitions>` des Elements `<system.ftpServer>` wurde in FTP 7.0 als separater Download für IIS 7.0 eingeführt.
IIS 6.0	Der FTP-Dienst in IIS 6.0 hat die Erweiterbarkeit nicht unterstützt.

Hinweis

Die Dienste FTP 7.0 und FTP 7.5 waren nicht im Lieferumfang von IIS 7.0 enthalten, daher mussten die Module unter der folgenden URL heruntergeladen und installiert werden:

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

Bei Windows 7 und Windows Server 2008 R2 wird der FTP 7.5-Dienst als Feature für IIS 7.5 bereitgestellt, sodass das Herunterladen des FTP-Diensts nicht mehr erforderlich ist.

Setup

Um die FTP-Veröffentlichung für Ihren Webserver zu unterstützen, müssen Sie den FTP-Dienst installieren. Führen Sie dazu die folgenden Schritte aus:

Windows Server 2012 oder Windows Server 2012 R2

Klicken Sie auf der Taskleiste auf Server-Manager.
Klicken Sie im Server-Manager auf das Menü Verwalten und dann auf Rollen und Features hinzufügen.
Klicken Sie im Assistenten zum Hinzufügen von Rollen und Features auf Weiter. Wählen Sie den Installationstyp aus, und klicken Sie auf Weiter. Wählen Sie den Zielserver aus, und klicken Sie auf Weiter.
Erweitern Sie auf der Seite Serverrollen den Eintrag Webserver (IIS), und wählen Sie dann FTP-Server aus.

Hinweis

Um die Authentifizierung mittels ASP.NET-Mitgliedschaft oder IIS-Manager für den FTP-Dienst zu unterstützen, müssen Sie zusätzlich zu FTP-Dienst die Option FTP-Erweiterbarkeit auswählen.
Klicken Sie auf Weiter, und wählen Sie dann auf der Seite Features auswählen erneut Weiter aus.
Klicken Sie auf der Seite Installationsauswahl bestätigen auf Installieren.
Klicken Sie auf der Seite Ergebnisse auf Schließen.

Windows 8 oder Windows 8.1

Klicken Sie auf dem Startbildschirm in der unteren linken Ecke mit der rechten Maustaste auf die Schaltfläche Start, und klicken Sie dann auf Systemsteuerung.
Klicken Sie in der Systemsteuerung auf Programme und Features und dann auf Windows-Features aktivieren oder deaktivieren.
Erweitern Sie Internetinformationsdienste, und wählen Sie dann FTP-Server aus.

Hinweis

Um die Authentifizierung mittels ASP.NET-Mitgliedschaft oder IIS-Manager für den FTP-Dienst zu unterstützen, müssen Sie auch FTP-Erweiterbarkeit auswählen.
Klicken Sie auf OK.
Klicken Sie auf Schließen.

Windows Server 2008 R2

Klicken Sie auf der Taskleiste auf Start, zeigen Sie auf Verwaltung, und klicken Sie dann auf Server-Manager.
Erweitern Sie im Hierarchiebereich des Server-Managers den Eintrag Rollen, und klicken Sie dann auf Webserver (IIS).
Scrollen Sie im Bereich Webserver (IIS) zum Abschnitt Rollendienste, und klicken Sie dann auf Rollendienste hinzufügen.
Erweitern Sie auf der Seite Rollendienste auswählen des Assistenten zum Hinzufügen von Rollendiensten die Option FTP-Server.
Wählen Sie FTP-Dienst aus.

Hinweis

Um die Authentifizierung mittels ASP.NET-Mitgliedschaft oder IIS-Manager für den FTP-Dienst zu unterstützen, müssen Sie auch FTP-Erweiterbarkeit auswählen.
Klicken Sie auf Weiter.
Klicken Sie auf der Seite Installationsauswahl bestätigen auf Installieren.
Klicken Sie auf der Seite Ergebnisse auf Schließen.

Windows 7

Klicken Sie auf der Taskleiste auf Start und dann auf Systemsteuerung.
Klicken Sie in der Systemsteuerung auf Programme und Funktionen und dann auf Windows-Features aktivieren oder deaktivieren.
Erweitern Sie Internetinformationsdienste und dann FTP-Server.
Wählen Sie FTP-Dienst aus.

Hinweis

Um die Authentifizierung mittels ASP.NET-Mitgliedschaft oder IIS-Manager für den FTP-Dienst zu unterstützen, müssen Sie auch FTP-Erweiterbarkeit auswählen.
Klicken Sie auf OK.

Windows Server 2008 oder Windows Vista

Laden Sie das Installationspaket unter der folgenden URL herunter:
- https://www.iis.net/expand/FTP
Befolgen Sie die Anleitung in der folgenden exemplarischen Vorgehensweise, um den FTP-Dienst zu installieren:
- Installieren von FTP 7 und Problembehandlung

Gewusst wie

Hinzufügen eines benutzerdefinierten Authentifizierungsanbieters mit verwaltetem Code für eine FTP-Site

Hinweis

Bei diesen Schritten wird davon ausgegangen, dass bereits ein benutzerdefinierter FTP-Authentifizierungsanbieter installiert und im globalen Assemblycache (GAC) Ihres Servers registriert wurde. Weitere Informationen zum Registrieren verwalteter Assemblys finden Sie auf der MSDN-Website von Microsoft im Thema Tool für den globalen Assemblycache (Gacutil.exe).

Ermitteln Sie die Assemblyinformationen für den Erweiterbarkeitsanbieter:
- Öffnen Sie in Windows-Explorer den Pfad „C:\Windows\assembly“, wobei „C:“ Ihr Betriebssystemlaufwerk ist.
- Suchen Sie nach der Assembly, z. B. FtpAuthenticationDemo.
- Klicken Sie mit der rechten Maustaste auf die Assembly, und klicken Sie dann auf Eigenschaften.
- Kopieren Sie den für Kultur angegebenen Wert, z. B. Neutral.
- Kopieren Sie die für Version angegebene Nummer, z. B. 1.0.0.0.
- Kopieren Sie den für Öffentliches Schlüsseltoken angegebenen Wert, z. B. 426f62526f636b73.
- Klicken Sie auf Abbrechen.
Fügen Sie den Erweiterbarkeitsanbieter zur globalen Liste der FTP-Authentifizierungsanbieter hinzu:
- Öffnen Sie das Dialogfeld Internetinformationsdienste-Manager.
- Klicken Sie im Bereich Verbindungen auf Ihren Computernamen.
- Doppelklicken Sie im Hauptfenster auf FTP-Authentifizierung.
- Klicken Sie im Bereich Aktionen auf Benutzerdefinierte Anbieter....
- Klicken Sie auf Registrieren.
- Geben Sie im Feld Name einen Anzeigenamen für den benutzerdefinierten Authentifizierungsanbieter ein, z. B. FtpAuthenticationDemo.
- Klicken Sie auf Managed Provider (.NET).
- Geben Sie die Assemblyinformationen für den Erweiterungsanbieter ein, und verwenden Sie dabei die Informationen, die Sie zuvor kopiert haben. Zum Beispiel:
  FtpAuthentication.FtpAuthDemo, FtpAuthenticationDemo, version=1.0.0.0, Culture=neutral, PublicKeyToken=426f62526f636b73
- Klicken Sie auf OK.
- Deaktivieren Sie in der Anbieterliste das Kontrollkästchen für den benutzerdefinierten Authentifizierungsanbieter.
- Klicken Sie auf OK.
Fügen Sie den benutzerdefinierten Authentifizierungsanbieter für eine FTP-Site hinzu:
- Öffnen Sie eine FTP-Site in Internetinformationsdienste-Manager (IIS-Manager).
- Doppelklicken Sie im Hauptfenster auf FTP-Authentifizierung.
- Klicken Sie im Bereich Aktionen auf Benutzerdefinierte Anbieter....
- Wählen Sie den benutzerdefinierten Authentifizierungsanbieter in der Anbieterliste aus, und aktivieren Sie ihn.
- Klicken Sie auf OK.

Konfiguration

Das <providerDefinitions>-Element wird auf globaler Ebene in der Datei „ApplicationHost.config“ konfiguriert.

Attribute

Keine

Untergeordnete Elemente

Element	Beschreibung
`add`	Optionales Element. Gibt die Registrierungsinformationen für einen Anbieter mit verwaltetem Code oder nativem Code (COM-Anbieter) an.
`activation`	Optionales Element. Gibt eine Sammlung von benutzerdefinierten Name-Wert-Paaren an, die alle für einen benutzerdefinierten Anbieter erforderlichen Parameter definieren. Hinweis: Dieses Element wurde in FTP 7.5 hinzugefügt.

Konfigurationsbeispiel

Im folgenden Beispiel werden mehrere Konfigurationseinstellungen im globalen <system.ftpServer>-Element für einen Server veranschaulicht. Genauer gesagt zeigen die Einstellungen in diesem Beispiel Folgendes:

Aktivieren der Zwischenspeicherung von FTP-Anmeldeinformationen und Angeben eines Timeouts von 10 Minuten (600 Sekunden)
Konfigurieren des unteren Ports als 5000 und des oberen Ports als 6000 für die Datenkanalkommunikation
Aktivieren der Protokollierung und Angeben, dass Protokolldateien pro Site gespeichert und täglich (UTC-Zeit) rotiert werden
Angeben eines benutzerdefinierten FTP-Anbieters und eines benutzerdefinierten Parameter für diesen Anbieter
Angeben lokaler IP-Einschränkungen, die den FTP-Zugriff vom lokalen Host zulassen und den Zugriff auf den IP-Adressblock 169.254.0.0 bis 169.254.255.255 verweigern
Konfigurieren der Anforderungsfilterung mit den folgenden Optionen:
- FTP-Zugriff auf das virtuelle Verzeichnis „_vti_bin“ blockieren, das mit den FrontPage-Servererweiterungen (FPSE) verwendet wird
- Mehrere Dateitypen blockieren, die ausführbaren Dateien zugeordnet sind
- 100 MB als maximale Dateigröße angeben
Hinzufügen einer globalen Autorisierungsregel, die den Zugriff für die Administratorgruppe zulässt
Angeben, dass die Domänennamensyntax für virtuelle FTP-Hostnamen verwendet werden kann

<system.ftpServer>
   <caching>
      <credentialsCache enabled="true" flushInterval="600" />
   </caching>
   <firewallSupport lowDataChannelPort="5000" highDataChannelPort="6000" />
   <log centralLogFileMode="Site">
      <centralLogFile period="Daily" localTimeRollover="false" enabled="true" />
   </log>
   <providerDefinitions>
      <add name="FtpXmlAuthentication"
         type="FtpXmlAuthentication, FtpXmlAuthentication, version=1.0.0.0, Culture=neutral, PublicKeyToken=426f62526f636b73" />
      <activation>
         <providerData name="FtpXmlAuthentication">
            <add key="xmlFileName" value="C:\Inetpub\XmlSample\Users.xml" />
         </providerData>
      </activation>
   </providerDefinitions>
   <security>
      <ipSecurity enableReverseDns="false" allowUnlisted="true">
         <add ipAddress="169.254.0.0" subnetMask="255.255.0.0" allowed="false" />
         <add ipAddress="127.0.0.1" allowed="true" />
      </ipSecurity>
      <requestFiltering>
         <hiddenSegments>
            <add segment="_vti_bin" />
         </hiddenSegments>
         <fileExtensions allowUnlisted="true">
            <add fileExtension="exe" allowed="false" />
            <add fileExtension="cmd" allowed="false" />
            <add fileExtension="com" allowed="false" />
            <add fileExtension="bat" allowed="false" />
         </fileExtensions>
         <requestLimits maxAllowedContentLength="104857600" />
      </requestFiltering>
      <authorization>
         <add accessType="Allow" roles="administrators" permissions="Read, Write" />
      </authorization>
   </security>
   <serverRuntime>
      <hostNameSupport useDomainNameAsHostName="true" />
   </serverRuntime>
</system.ftpServer>

Beispielcode

Die folgenden Beispiele fügen einem Server eine Definition für einen benutzerdefinierten FTP-Anbieter und dann einen Datenparameter für diesen Anbieter hinzu.

AppCmd.exe

appcmd.exe set config -section:system.ftpServer/providerDefinitions /+"[name='FtpXmlAuthentication',type='FtpXmlAuthentication, FtpXmlAuthentication, version=1.0.0.0, Culture=neutral, PublicKeyToken=426f62526f636b73']" /commit:apphost

appcmd.exe set config -section:system.ftpServer/providerDefinitions /+"activation.[name='FtpXmlAuthentication']" /commit:apphost

appcmd.exe set config -section:system.ftpServer/providerDefinitions /+"activation.[name='FtpXmlAuthentication'].[key='xmlFileName',value='C:\Inetpub\wwwroot\App_Data\Users.xml']" /commit:apphost

Hinweis

Legen Sie den commit-Parameter auf apphost fest, wenn Sie „AppCmd.exe“ verwenden, um diese Einstellungen zu konfigurieren. Dadurch werden die Konfigurationseinstellungen auf den entsprechenden Speicherortabschnitt in der Datei „ApplicationHost.config“ festgelegt.

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 providerDefinitionsSection = config.GetSection("system.ftpServer/providerDefinitions");
         ConfigurationElementCollection providerDefinitionsCollection = providerDefinitionsSection.GetCollection();

         ConfigurationElement addElement = providerDefinitionsCollection.CreateElement("add");
         addElement["name"] = @"FtpXmlAuthentication";
         addElement["type"] = @"FtpXmlAuthentication, FtpXmlAuthentication, version=1.0.0.0, Culture=neutral, PublicKeyToken=426f62526f636b73";
         providerDefinitionsCollection.Add(addElement);

         ConfigurationElementCollection activationCollection = providerDefinitionsSection.GetCollection("activation");
         ConfigurationElement providerDataElement = activationCollection.CreateElement("providerData");
         providerDataElement["name"] = @"FtpXmlAuthentication";

         ConfigurationElementCollection providerDataCollection = providerDataElement.GetCollection();
         ConfigurationElement addElement1 = providerDataCollection.CreateElement("add");
         addElement1["key"] = @"xmlFileName";
         addElement1["value"] = @"C:\Inetpub\wwwroot\App_Data\Users.xml";
         providerDataCollection.Add(addElement1);
         activationCollection.Add(providerDataElement);

         serverManager.CommitChanges();
      }
   }
}

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 providerDefinitionsSection As ConfigurationSection = config.GetSection("system.ftpServer/providerDefinitions")
      Dim providerDefinitionsCollection As ConfigurationElementCollection = providerDefinitionsSection.GetCollection

      Dim addElement As ConfigurationElement = providerDefinitionsCollection.CreateElement("add")
      addElement("name") = "FtpXmlAuthentication"
      addElement("type") = "FtpXmlAuthentication, FtpXmlAuthentication, version=1.0.0.0, Culture=neutral, PublicKeyToken=426f62526f636b73"
      providerDefinitionsCollection.Add(addElement)

      Dim activationCollection As ConfigurationElementCollection = providerDefinitionsSection.GetCollection("activation")
      Dim providerDataElement As ConfigurationElement = activationCollection.CreateElement("providerData")
      providerDataElement("name") = "FtpXmlAuthentication"

      Dim providerDataCollection As ConfigurationElementCollection = providerDataElement.GetCollection
      Dim addElement1 As ConfigurationElement = providerDataCollection.CreateElement("add")
      addElement1("key") = "xmlFileName"
      addElement1("value") = "C:\Inetpub\wwwroot\App_Data\Users.xml"
      providerDataCollection.Add(addElement1)
      activationCollection.Add(providerDataElement)

      serverManager.CommitChanges()
   End Sub
End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";

var providerDefinitionsSection = adminManager.GetAdminSection("system.ftpServer/providerDefinitions", "MACHINE/WEBROOT/APPHOST");
var providerDefinitionsCollection = providerDefinitionsSection.Collection;

var addElement = providerDefinitionsCollection.CreateNewElement("add");
addElement.Properties.Item("name").Value = "FtpXmlAuthentication";
addElement.Properties.Item("type").Value = "FtpXmlAuthentication, FtpXmlAuthentication, version=1.0.0.0, Culture=neutral, PublicKeyToken=426f62526f636b73";
providerDefinitionsCollection.AddElement(addElement);

var activationCollection = providerDefinitionsSection.ChildElements.Item("activation").Collection;
var providerDataElement = activationCollection.CreateNewElement("providerData");
providerDataElement.Properties.Item("name").Value = "FtpXmlAuthentication";
var providerDataCollection = providerDataElement.Collection;

var addElement1 = providerDataCollection.CreateNewElement("add");
addElement1.Properties.Item("key").Value = "xmlFileName";
addElement1.Properties.Item("value").Value = "C:\\Inetpub\\wwwroot\\App_Data\\Users.xml";
providerDataCollection.AddElement(addElement1);
activationCollection.AddElement(providerDataElement);

adminManager.CommitChanges();

VBScript

Set adminManager = createObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"

Set providerDefinitionsSection = adminManager.GetAdminSection("system.ftpServer/providerDefinitions", "MACHINE/WEBROOT/APPHOST")
Set providerDefinitionsCollection = providerDefinitionsSection.Collection

Set addElement = providerDefinitionsCollection.CreateNewElement("add")
addElement.Properties.Item("name").Value = "FtpXmlAuthentication"
addElement.Properties.Item("type").Value = "FtpXmlAuthentication, FtpXmlAuthentication, version=1.0.0.0, Culture=neutral, PublicKeyToken=426f62526f636b73"
providerDefinitionsCollection.AddElement(addElement)

Set activationCollection = providerDefinitionsSection.ChildElements.Item("activation").Collection
Set providerDataElement = activationCollection.CreateNewElement("providerData")
providerDataElement.Properties.Item("name").Value = "FtpXmlAuthentication"
Set providerDataCollection = providerDataElement.Collection

Set addElement1 = providerDataCollection.CreateNewElement("add")
addElement1.Properties.Item("key").Value = "xmlFileName"
addElement1.Properties.Item("value").Value = "C:\Inetpub\wwwroot\App_Data\Users.xml"
providerDataCollection.AddElement(addElement1)
activationCollection.AddElement(providerDataElement)

adminManager.CommitChanges()

Freigeben über

FTP-Anbieterdefinitionen <providerDefinitions>

Übersicht

Kompatibilität

Setup

Windows Server 2012 oder Windows Server 2012 R2

Windows 8 oder Windows 8.1

Windows Server 2008 R2

Windows 7

Windows Server 2008 oder Windows Vista

Gewusst wie

Hinzufügen eines benutzerdefinierten Authentifizierungsanbieters mit verwaltetem Code für eine FTP-Site

Konfiguration

Attribute

Untergeordnete Elemente

Konfigurationsbeispiel

Beispielcode

AppCmd.exe

C#

VB.NET

JavaScript

VBScript

Feedback

Zusätzliche Ressourcen