Attivazione <provider FTP>

Articolo
07/19/2023

Panoramica

L'elemento <activation> dell'elemento <providerDefinitions> definisce una raccolta di coppie nome/valore personalizzate che specificano i parametri richiesti da un provider personalizzato.

Nota

Questo elemento è stato aggiunto in FTP 7.5.

A partire da FTP 7.5, il servizio FTP supporta l'estendibilità per l'autenticazione e i ruoli personalizzati, la registrazione e le ricerche nella home directory. Quando si crea un provider di estendibilità, è prima necessario registrarlo nella Global Assembly Cache (GAC) di .NET per i provider di codice gestito o nel Registro di sistema per i provider COM (Native-Code). Per altre informazioni su come creare provider personalizzati FTP, vedere la sezione seguente nel sito Web di Microsoft IIS.net:

Sviluppo per FTP 7.5

Compatibilità

Versione	Note
IIS 10.0	L'elemento `<activation>` non è stato modificato in IIS 10.0.
IIS 8,5	L'elemento `<activation>` non è stato modificato in IIS 8.5.
IIS 8,0	L'elemento `<activation>` non è stato modificato in IIS 8.0.
IIS 7,5	L'elemento `<activation>` dell'elemento `<providerDefinitions>` viene fornito come funzionalità di FTP 7.5.
IIS 7.0	L'elemento `<activation>` non faceva parte di FTP 7.0.
IIS 6.0	Il servizio FTP in IIS 6.0 non supporta l'estendibilità.

Nota

I servizi FTP 7.0 e FTP 7.5 forniti fuori banda per IIS 7.0, che richiedevano il download e l'installazione dei moduli dall'URL seguente:

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

Con Windows 7 e Windows Server 2008 R2, il servizio FTP 7.5 viene fornito come funzionalità per IIS 7.5, quindi il download del servizio FTP non è più necessario.

Installazione

Per supportare la pubblicazione FTP per il server Web, è necessario installare il servizio FTP. A tale scopo, seguire questa procedura.

Windows Server 2012 o Windows Server 2012 R2

Sulla barra delle applicazioni fare clic su Server Manager.
In Server Manager fare clic sul menu Gestisci e quindi su Aggiungi ruoli e funzionalità.
Nella procedura guidata Aggiungi ruoli e funzionalità fare clic su Avanti. Selezionare il tipo di installazione e fare clic su Avanti. Selezionare il server di destinazione e fare clic su Avanti.
Nella pagina Ruoli server espandere Server Web (IIS) e quindi selezionare Server FTP.

Nota

Per supportare ASP. Autenticazione di appartenenza o autenticazione di Gestione IIS per il servizio FTP, sarà necessario selezionare Estendibilità FTP, oltre al servizio FTP.
.
Fare clic su Avanti e quindi nella pagina Seleziona funzionalità fare di nuovo clic su Avanti .
Nella pagina Conferma selezioni per l'installazione fare clic su Installa.
Nella pagina Risultati fare clic su Chiudi.

Windows 8 o Windows 8.1

Nella schermata Start spostare il puntatore fino all'angolo inferiore sinistro, fare clic con il pulsante destro del mouse sul pulsante Start e quindi scegliere Pannello di controllo.
In Pannello di controllo fare clic su Programmi e funzionalità e quindi su Attiva o disattiva funzionalità di Windows.
Espandere Internet Information Services e quindi selezionare Server FTP.

Nota

Per supportare ASP. L'autenticazione di appartenenza o l'autenticazione di Gestione IIS per il servizio FTP, sarà anche necessario selezionare Estendibilità FTP.
Fare clic su OK.
Fare clic su Close.

Windows Server 2008 R2

Sulla barra delle applicazioni fare clic su Start, scegliere Strumenti di amministrazione, quindi fare clic su Server Manager.
Nel riquadro della gerarchia Server Manager espandere Ruoli, quindi fare clic su Server Web (IIS).
Nel riquadro Server Web (IIS) scorrere fino alla sezione Servizi ruolo e quindi fare clic su Aggiungi servizi ruolo.
Nella pagina Selezione servizi ruolo della Procedura guidata Aggiungi servizi ruolo espandere Server FTP.
Selezionare Servizio FTP.

Nota

Per supportare ASP. L'autenticazione di appartenenza o l'autenticazione di Gestione IIS per il servizio FTP, sarà anche necessario selezionare Estendibilità FTP.
Fare clic su Avanti.
Nella pagina Conferma selezioni per l'installazione fare clic su Installa.
Nella pagina Risultati fare clic su Chiudi.

Windows 7

Sulla barra delle applicazioni fare clic su Start e quindi su Pannello di controllo.
In Pannello di controllo fare clic su Programmi e funzionalità e quindi su Attiva o disattiva funzionalità di Windows.
Espandere Internet Information Services e quindi server FTP.
Selezionare Servizio FTP.

Nota

Per supportare ASP. L'autenticazione di appartenenza o l'autenticazione di Gestione IIS per il servizio FTP, sarà anche necessario selezionare Estendibilità FTP.
Fare clic su OK.

Windows Server 2008 o Windows Vista

Scaricare il pacchetto di installazione dall'URL seguente:
- https://www.iis.net/expand/FTP
Seguire le istruzioni riportate nella procedura dettagliata seguente per installare il servizio FTP:
- Installazione e risoluzione dei problemi di FTP 7

Procedure

Come aggiungere un provider di autenticazione personalizzato con codice gestito per un sito FTP

Nota

Questi passaggi presuppongono che un provider di autenticazione FTP personalizzato sia già stato installato e registrato nella Global Assembly Cache (GAC) del server. Per altre informazioni su come registrare gli assembly gestiti, vedere l'argomento Global Assembly Cache Tool (Gacutil.exe) sul sito Web MSDN di Microsoft.

Determinare le informazioni sull'assembly per il provider di estendibilità:
- In Esplora risorse aprire il percorso "C:\Windows\assembly", dove C: è l'unità del sistema operativo.
- Individuare l'assembly. Ad esempio, FtpAuthenticationDemo.
- Fare clic con il pulsante destro del mouse sull'assembly e quindi scegliere Proprietà.
- Copiare il valore Impostazioni cultura . Ad esempio , neutrale.
- Copiare il numero di versione . Ad esempio, 1.0.0.0.
- Copiare il valore del token di chiave pubblica . Ad esempio , 426f62526f636b73.
- Fare clic su Annulla.
Aggiungere il provider di estendibilità all'elenco globale dei provider di autenticazione FTP:
- Aprire Gestione Internet Information Services (IIS) .
- Fare clic sul nome del computer nel riquadro Connessioni .
- Fare doppio clic su Autenticazione FTP nella finestra principale.
- Fare clic su Provider personalizzati... nel riquadro Azioni .
- Fare clic su Registra.
- Immettere un nome descrittivo per il provider di autenticazione personalizzato nella casella Nome . Ad esempio , FtpAuthenticationDemo.
- Fare clic su Provider gestito (.NET).
- Immettere le informazioni sull'assembly per il provider di estendibilità usando le informazioni copiate in precedenza. Ad esempio:
  FtpAuthentication.FtpAuthDemo, FtpAuthenticationDemo, versione=1.0.0.0, Culture=neutral, PublicKeyToken=426f62526f636b73
- Fare clic su OK.
- Deselezionare la casella di controllo per il provider di autenticazione personalizzato nell'elenco dei provider.
- Fare clic su OK.
Aggiungere il provider di autenticazione personalizzato per un sito FTP:
- Aprire un sito FTP in Gestione Internet Information Services (IIS).
- Fare doppio clic su Autenticazione FTP nella finestra principale.
- Fare clic su Provider personalizzati... nel riquadro Azioni .
- Selezionare e abilitare il provider di autenticazione personalizzato nell'elenco dei provider.
- Fare clic su OK.

Configurazione

L'elemento <activation> dell'elemento <providerDefinitions> è configurato a livello globale in ApplicationHost.config.

Attributi

Nessuno.

Elementi figlio

Elemento	Descrizione
`providerData`	Elemento facoltativo. Specifica la raccolta di coppie chiave/valore che contengono i dati per un provider personalizzato.

Esempio di configurazione

Nell'esempio seguente vengono illustrate diverse impostazioni di configurazione nell'elemento globale <system.ftpServer> per un server. In particolare, le impostazioni in questo esempio illustrano come:

Abilitare la memorizzazione nella cache delle credenziali FTP e specificare un timeout di 10 minuti (600 secondi).
Configurare la porta bassa come 5000 e la porta elevata come 6000 per le comunicazioni del canale dati.
Abilitare la registrazione e specificare che i file di log verranno mantenuti per sito e che i file di log verranno ruotati ogni giorno per ora UTC.
Specificare un provider FTP personalizzato e specificare un parametro personalizzato per tale provider.
Specificare restrizioni IP globali che consentono l'accesso FTP dall'host locale e negare l'accesso al blocco 169.254.0.0 a 169.254.255.255 di indirizzi IP.
Configurare il filtro delle richieste con le opzioni seguenti:
- Bloccare l'accesso FTP alla directory virtuale _vti_bin, usata con le estensioni del server FrontPage.
- Bloccare diversi tipi di file associati ai file eseguibili.
- Specificare 100 MB come dimensione massima del file.
Aggiungere una regola di autorizzazione globale che consente l'accesso per il gruppo administrators.
Specificare che la sintassi del nome di dominio può essere usata per i nomi host virtuali FTP.

<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>

Codice di esempio

Gli esempi seguenti aggiungono una definizione di provider FTP personalizzata a un server e quindi aggiungono un parametro di dati per tale provider.

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

Nota

È necessario assicurarsi di impostare il parametro commit su apphost quando si usa AppCmd.exe per configurare queste impostazioni. Questa operazione esegue il commit delle impostazioni di configurazione nella sezione percorso appropriata nel file di 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 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()

Condividi tramite

Attivazione <provider FTP>

Panoramica

Compatibilità

Installazione

Windows Server 2012 o Windows Server 2012 R2

Windows 8 o Windows 8.1

Windows Server 2008 R2

Windows 7

Windows Server 2008 o Windows Vista

Procedure

Come aggiungere un provider di autenticazione personalizzato con codice gestito per un sito FTP

Configurazione

Attributi

Elementi figlio

Esempio di configurazione

Codice di esempio

AppCmd.exe

C#

VB.NET

JavaScript

VBScript

Commenti e suggerimenti

Risorse aggiuntive