Compartir a través de

Autenticación personalizada de FTP <customAuthentication>

  • Artículo

Información general

El elemento <customAuthentication> especifica la configuración de autenticación personalizada para un sitio FTP. Esta forma de autenticación usa proveedores de autenticación personalizados para validar los nombres de usuario y las contraseñas.

Cuando se agregan proveedores de autenticación personalizados a sitios FTP, el servicio FTP intentará autenticar a un usuario con cada proveedor de autenticación personalizado que esté habilitado en el orden en que se especifican los proveedores en los valores de configuración de FTP. En caso de que el usuario no se pueda autenticar mediante ninguno de los proveedores de autenticación personalizados, el servicio FTP intentará una autenticación básica, si está habilitada, para autenticar al usuario.

La principal ventaja de usar proveedores de autenticación personalizados es que no es necesario crear cuentas de usuario en el servidor o dominio. Esto mejora la seguridad de la red.

Nota:

FTP 7.0 y FTP 7.5 se incluyen con dos proveedores de autenticación personalizados:

Nota:

Los proveedores de autenticación personalizados que se agregan al elemento <customAuthentication/providers> deben registrarse en la colección <system.ftpServer/providerDefinitions>.

Nota:

La compatibilidad con la creación de proveedores de autenticación personalizados se introdujo en FTP 7.5. Para obtener información adicional sobre cómo crear proveedores de autenticación personalizados, consulte la sección Desarrollo para FTP 7.5 del sitio web www.iis.net/learn de Microsoft.

Compatibilidad

Versión Notas
IIS 10.0 El elemento <customAuthentication> no se modificó en IIS 10.0.
IIS 8.5 El elemento <customAuthentication> no se modificó en IIS 8.5.
IIS 8.0 El elemento <customAuthentication> no se modificó en IIS 8.0.
IIS 7.5 El elemento <customAuthentication> del elemento <authentication> se incluye como una característica de IIS 7.5.
IIS 7.0 El elemento <customAuthentication> del elemento <authentication> se introdujo en FTP 7.0, que era una descarga independiente para IIS 7.0.
IIS 6,0 El elemento <ftpServer> y sus elementos secundarios reemplazan la configuración FTP de IIS 6.0 que se encontraban en la ruta de acceso de metabase LM/MSFTPSVC.

Nota:

Los servicios FTP 7.0 y FTP 7.5 se enviaron fuera de banda para IIS 7.0, lo que requería descargar e instalar los módulos desde la siguiente dirección URL:

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

Con Windows 7 y Windows Server 2008 R2, el servicio FTP 7.5 se incluye como característica para IIS 7.5, por lo que la descarga del servicio FTP ya no es necesaria.

Configuración

Para admitir la publicación de FTP para el servidor web, debe instalar el servicio FTP. Para ello, siga estos pasos.

Windows Server 2012 o Windows Server 2012 R2

  1. En la barra de tareas, haga clic en Administrador del servidor.

  2. En Administrador del servidor, haga clic en el menú Administrar y, después, haga clic en Agregar roles y características.

  3. En el asistente para Agregar roles y características, haga clic en Siguiente. Seleccione el tipo de instalación y haga clic en Siguiente. Seleccione el servidor de destino y haga clic en Siguiente.

  4. En la página Roles de servidor, expanda Servidor web (IIS) y, a continuación, seleccione Servidor FTP.

    Nota:

    Para admitir la autenticación ASP.Membership o la autenticación del Administrador de IIS para el servicio FTP, también deberá seleccionar Extensibilidad de FTP, además de Servicio FTP.
    Screenshot of the F T P Extensibility option being highlighted and selected..

  5. Haga clic en Siguiente y, después, en la página Seleccionar características, vuelva a hacer clic en Siguiente.

  6. En la página Confirmar selecciones de instalación, haga clic en Instalar.

  7. En la página Resultados , haga clic en Cerrar.

Windows 8 o Windows 8.1

  1. En la pantalla Inicio, mueva el puntero hasta la esquina inferior izquierda, haga clic con el botón derecho en el botón Inicio y, a continuación, haga clic en Panel de control.

  2. En Panel de control, haga clic en Programas y características y después en Activar o desactivar las características de Windows.

  3. Expanda Internet Information Services y, después, seleccione Servidor FTP.

    Nota:

    Para admitir la autenticación ASP.Membership o la autenticación del Administrador de IIS para el servicio FTP, también deberá seleccionar Extensibilidad de FTP.
    Screenshot of the F T P Extensibility folder being highlighted and selected.

  4. Haga clic en OK.

  5. Haga clic en Cerrar.

Windows Server 2008 R2

  1. En la barra de tareas, haga clic en Inicio, seleccione Herramientas administrativas y, luego, haga clic en Administrador del servidor.

  2. En el panel de jerarquía del Administrador del servidor, expanda Roles y, luego, haga clic en Servidor web (IIS).

  3. En el panel Servidor web (IIS), desplácese hasta la sección Servicios de rol y, luego, haga clic en Agregar servicios de rol.

  4. En la página Seleccionar servicios de rol del Asistente para agregar servicios de rol, expanda Servidor FTP.

  5. Seleccione Servicio FTP.

    Nota:

    Para admitir la autenticación ASP.Membership o la autenticación del Administrador de IIS para el servicio FTP, también deberá seleccionar Extensibilidad de FTP.
    Screenshot of the Select Role Services wizard showing the highlighted F T P Service option.

  6. Haga clic en Next.

  7. En la página Confirmar selecciones de instalación, haz clic en Instalar.

  8. En la página Resultados , haga clic en Cerrar.

Windows 7

  1. En la barra de tareas, haga clic en Inicio y, luego, haga clic en Panel de control.

  2. En Panel de control, haga clic en Programas y características y después en Activar o desactivar las características de Windows.

  3. Expanda Internet Information Services y, luego, Servidor FTP.

  4. Seleccione Servicio FTP.

    Nota:

    Para admitir la autenticación ASP.Membership o la autenticación del Administrador de IIS para el servicio FTP, también deberá seleccionar Extensibilidad de FTP.
    Screenshot of the Internet Information Services folder and its sub folders.

  5. Haga clic en OK.

Windows Server 2008 o Windows Vista

  1. Descargue el paquete de instalación desde la siguiente dirección URL:

  2. Siga las instrucciones del siguiente tutorial para instalar el servicio FTP:

Procedimientos

Habilitación de la autenticación del Administrador de IIS para un sitio FTP

  1. Abra el Administrador de Internet Information Services (IIS):

    • Si usa Windows Server 2012 o Windows Server 2012 R2:

      • En la barra de tareas, haga clic en Administrador del servidor, en Herramientas y, a continuación, en Administrador de Internet Information Services (IIS).

    • Si usa Windows 8 o Windows 8.1:

      • Mantenga presionada la tecla Windows, presione la letra X y haga clic en Panel de control.
      • En Panel de control, haga clic en Herramientas administrativas y, a continuación, haga doble clic en Administrador de Internet Information Services (IIS).

    • Si usa Windows Server 2008 o Windows Server 2008 R2:

      • En la barra de tareas, haga clic en Inicio, seleccione Herramientas administrativas y, a continuación, haga clic en Administrador de Internet Information Services (IIS).

    • Si usa Windows Vista o Windows 7:

      • En la barra de tareas, haga clic en Inicio y, luego, haga clic en Panel de control.
      • Haga doble clic en Herramientas administrativas y, a continuación, haga doble clic en Administrador de Internet Information Services (IIS).

  2. En el panel Conexiones, expanda el nombre del servidor, expanda el nodo Sitios y, a continuación, haga clic en el nombre del sitio.

  3. En el panel Inicio del sitio, haga doble clic en la característica Autenticación FTP.

  4. Cuando se muestre la página Autenticación FTP, haga clic en Proveedores personalizados... en el panel Acciones.
    Screenshot of the F T P Authentication page, showing the Custom Providers option in the Actions pane.

  5. Cuando se muestre el cuadro de diálogo Proveedores personalizados, haga clic para seleccionar Autenticación del administrador de IIS. Haga clic en OK.
    Screenshot of the Custom Providers dialog box showing the I I S Manager Authentication option.

  6. La página Autenticación de FTP ahora debería mostrar la autenticación del administrador de IIS habilitada.
    Screenshot of the F T P Authentication page showing the I I S Manager Authentication option being enabled.

  7. Si lo desea, puede deshabilitar la Autenticación básica o la Autenticación anónima resaltando el modo y haciendo clic en Deshabilitar en el panel Acciones.

Para obtener más información sobre cómo configurar la autenticación del Administrador de IIS para FTP, consulte el tema Configurar FTP con autenticación del administrador de IIS 7.0 en el sitio web de www.iis.net/learn de Microsoft.

Adición de un proveedor de autenticación personalizada de código administrado para un sitio FTP

Nota:

En estos pasos se supone que ya se ha instalado y registrado un proveedor de autenticación FTP personalizado en la caché global de ensamblados (GAC) del servidor. Para obtener más información sobre cómo registrar ensamblados administrados, vea el tema Herramienta de caché global de ensamblados (Gacutil.exe) en el sitio web MSDN de Microsoft.

  1. Determine la información del ensamblado para el proveedor de extensibilidad:

    • En el Explorador de Windows, abra la ruta de acceso "C:\Windows\assembly", donde C: es la unidad del sistema operativo.
    • Busque el ensamblado. Por ejemplo, FtpAuthenticationDemo.
    • Haga clic con el botón derecho en el ensamblado y, después, haga clic en Propiedades.
    • Copie el valor Culture. Por ejemplo, Neutral.
    • Copie el número de Versión. Por ejemplo, 1.0.0.0.
    • Copie el valor del token de clave pública. Por ejemplo, 426f62526f636b73.
    • Haga clic en Cancelar.

  2. Agregue el proveedor de extensibilidad a la lista global de proveedores de autenticación FTP:

    • Abra el Administrador de Internet Information Services (IIS) .
    • Haga clic en el nombre de equipo en el panel Conexiones.
    • Haga doble clic en Autenticación FTP en la ventana principal.
      Screenshot of the F T P Authentication main window.
    • Haga clic en Proveedores personalizados... en el panel Acciones.
    • Haga clic en Registrar.
      Screenshot of the Custom Providers dialog box, showing the Register option.
    • Escriba un nombre descriptivo para el proveedor de autenticación personalizado en el cuadro Nombre. Por ejemplo, FtpAuthenticationDemo.
    • Haga clic en Proveedor de datos administrados (.NET).
      Screenshot of the Add Custom Authentication Provider dialog box, showing the Managed Provider dot NET option being selected.
    • Escriba la información de ensamblado para el proveedor de extensibilidad mediante la información que copió anteriormente. Por ejemplo:
      FtpAuthentication.FtpAuthDemo, FtpAuthenticationDemo, version=1.0.0.0, Culture=neutral, PublicKeyToken=426f62526f636b73
    • Haga clic en OK.
    • Desactive la casilla del proveedor de autenticación personalizado en la lista de proveedores.
    • Haga clic en OK.

  3. Agregue el proveedor de autenticación personalizado para un sitio de FTP:

    • Abra un sitio FTP en el Administrador de Internet Information Services (IIS).
    • Haga doble clic en Autenticación FTP en la ventana principal.
    • Haga clic en Proveedores personalizados... en el panel Acciones.
    • Active esta opción para seleccionar y habilitar el proveedor de autenticación personalizado en la lista de proveedores.
    • Haga clic en OK.

Configuración

El elemento <customAuthentication> se configura en el nivel de sitio.

Atributos

Ninguno.

Elementos secundarios

Elemento Descripción
providers Elemento opcional.

Especifica la colección de proveedores de autenticación personalizados.

Ejemplo de configuración

En el ejemplo siguiente se muestra un sitio FTP con un elemento <customAuthentication> que habilita un proveedor de autenticación personalizado denominado FtpAuthenticationDemo y deshabilita los proveedores de autenticación integrados.

<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 serverAutoStart="true">
      <security>
         <authentication>
            <basicAuthentication enabled="false" />
            <anonymousAuthentication enabled="false" />
            <customAuthentication>
               <providers>
                  <add name="FtpAuthenticationDemo" enabled="true" />
               </providers>
            </customAuthentication>
         </authentication>
         <ssl controlChannelPolicy="SslAllow" dataChannelPolicy="SslAllow" />
      </security>
   </ftpServer>
</site>

Código de ejemplo

En los ejemplos siguientes se agrega un proveedor de autenticación personalizado a un sitio FTP y se habilita.

AppCmd.exe

appcmd.exe set config -section:system.applicationHost/sites /+"[name='ftp.example.com'].ftpServer.security.authentication.customAuthentication.providers.[name='FtpXmlAuthentication',enabled='True']" /commit:apphost

Nota:

Debe asegurarse de establecer el parámetro de confirmación en apphost cuando use AppCmd.exe para configurar estas opciones. Esto confirma los valores de configuración en la sección de ubicación adecuada del archivo 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 customAuthenticationElement = authenticationElement.GetChildElement("customAuthentication");
         ConfigurationElementCollection providersCollection = customAuthenticationElement.GetCollection("providers");

         ConfigurationElement addElement = providersCollection.CreateElement("add");
         addElement["name"] = @"FtpXmlAuthentication";
         addElement["enabled"] = true;
         providersCollection.Add(addElement);

         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 customAuthenticationElement As ConfigurationElement = authenticationElement.GetChildElement("customAuthentication")
      Dim providersCollection As ConfigurationElementCollection = customAuthenticationElement.GetCollection("providers")
      Dim addElement As ConfigurationElement = providersCollection.CreateElement("add")
      addElement("name") = "FtpXmlAuthentication"
      addElement("enabled") = True
      providersCollection.Add(addElement)

      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 customAuthenticationElement = authenticationElement.ChildElements.Item("customAuthentication");
var providersCollection = customAuthenticationElement.ChildElements.Item("providers").Collection;

var addElement = providersCollection.CreateNewElement("add");
addElement.Properties.Item("name").Value = "FtpXmlAuthentication";
addElement.Properties.Item("enabled").Value = true;
providersCollection.AddElement(addElement);

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 customAuthenticationElement = authenticationElement.ChildElements.Item("customAuthentication")
Set providersCollection = customAuthenticationElement.ChildElements.Item("providers").Collection

Set addElement = providersCollection.CreateNewElement("add")
addElement.Properties.Item("name").Value = "FtpXmlAuthentication"
addElement.Properties.Item("enabled").Value = True
providersCollection.AddElement(addElement)

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