Agregar reglas de creación de WebDAV <add>

Información general

El elemento <add> del elemento <authoringRules> especifica los permisos de acceso para usuarios o grupos para tipos de contenido específicos para una regla de creación única.

Las reglas de creación se pueden definir por URI dentro de un sitio web y especifica los permisos de creación de WebDAV para ese espacio de URI. Los permisos de este elemento se heredan, por lo que los URI secundarios tendrán los mismos permisos que un URI primario, siempre que el URI secundario no tenga permisos únicos definidos.

Compatibilidad

Versión	Notas
IIS 10.0	El elemento <add> no se modificó en IIS 10.0.
IIS 8.5	El elemento <add> no se modificó en IIS 8.5.
IIS 8.0	El elemento <add> no se modificó en IIS 8.0.
IIS 7.5	El elemento <add> del elemento <authoringRules> se incluye como una característica de IIS 7.5.
IIS 7.0	El elemento <add> del elemento <authoringRules> se introdujo en WebDAV 7.0, que era una descarga independiente para IIS 7.0.
IIS 6,0	N/D

Nota:

Los módulos WebDAV 7.0 y WebDAV 7.5 enviados fuera de banda para IIS 7.0, que requerían descargar e instalar los módulos desde la siguiente dirección URL:

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

Con Windows 7 y Windows Server 2008 R2, el módulo WebDAV 7.5 se incluye como una característica para IIS 7.5, por lo que la descarga de WebDAV ya no es necesaria.

Configuración

Para admitir la publicación de WebDAV para el servidor web, debe instalar el módulo WebDAV. 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), expanda Servidor web, expanda Características HTTP comunes y después seleccione Publicación de WebDAV. Haga clic en Next.
   
5. En la página Seleccionar características, haz 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, expanda World Wide Web Services, expanda Características HTTP comunes, y después seleccione Publicación de WebDAV.
   
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 Características HTTP comunes, seleccione Publicación de WebDAV y después haga clic en Siguiente.
   
5. En la página Confirmar selecciones de instalación, haz clic en Instalar.
6. 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, después World Wide Web Services y, a continuación, Características HTTP comunes.
4. Seleccione Publicación de WebDAV y, a continuación, haga clic en Aceptar.
   

Windows Server 2008 o Windows Vista

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

  • https://www.iis.net/expand/WebDAV

• Siga las instrucciones del siguiente tutorial para instalar el módulo de WebDAV:

  • Instalación y configuración de WebDAV en IIS 7.0

Procedimientos

Adición de reglas de creación de WebDAV

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 y vaya al sitio, la aplicación o el directorio donde desea habilitar la exploración de directorios.

3. En el panel Inicio, haga doble clic en Reglas de creación de WebDAV.
   

4. En el panel Acciones, haga clic en Agregar regla de creación....
   

5. En el cuadro de diálogo Agregar regla de creación, especifique las siguientes opciones:

   • Permitir acceso a: especifique si la regla de creación debe aplicarse a todos los tipos de contenido o especifique tipos de contenido específicos que se van a permitir.
   • Permitir el acceso a este contenido a: especifique si la regla de creación debe aplicarse a todos los usuarios, a grupos o roles específicos o a usuarios específicos.
   • Permisos: especifique si la regla de creación debe permitir el acceso de Lectura, Escritura u Origen para los tipos de contenido y usuarios especificados.
     

6. Haga clic en OK.

Configuración

El elemento <authoringRules> es configurable por URI en el archivo ApplicationHost.config. La configuración se puede almacenar globalmente, en el nivel de sitio o por carpeta. No se puede delegar el elemento <authoringRules>, por lo que se omiten los elementos <authoringRules> de los archivos Web.config.

Atributos

Atributo	Descripción
access	Atributo flags opcional. Especifica la configuración de acceso para la regla de creación. Estos valores se combinan con una operación OR lógica, por lo que "None, Read" = "Read". Nota: Source el acceso permite a un cliente webDAV solicitar el contenido de un archivo asignado a scripts, como un archivo ASP.NET o PHP, en lugar de la salida procesada del archivo. Valor Descripción None No se permite la creación. El valor numérico es 0. Read Se permite el acceso de lectura. El valor numérico es 1. Write Se permite el acceso de escritura. El valor numérico es 2. Source Se permite el acceso al código fuente. El valor numérico es 16. El valor predeterminado es None.
path	Atributo de cadena opcional. Especifica el nombre de archivo o la extensión de nombre de archivo para la que se aplica la regla de creación. Por ejemplo, "*.aspx", "*.php", etc. Además, se han definido los siguientes identificadores especiales. Valor Descripción * Especifica que la regla se aplicará a todo el contenido. No existe ningún valor predeterminado.
roles	Atributo de cadena opcional. Especifica roles o grupos para una regla de autorización. Se pueden agregar varios roles en una lista separada por comas. No existe ningún valor predeterminado.
users	Atributo de cadena opcional. Especifica los usuarios para una regla de autorización. Se pueden agregar varios usuarios en una lista separada por comas. Además, se han definido los siguientes identificadores especiales. Valor Descripción * Especifica que la regla se aplicará a todos los usuarios. ? Especifica que la regla se aplicará a los usuarios anónimos. No existe ningún valor predeterminado.

Elementos secundarios

Ninguno.

Ejemplo de configuración

En el ejemplo siguiente se muestra un elemento de ejemplo <webdav> para el sitio web predeterminado. En este ejemplo se borran las reglas de creación existentes, se agrega una sola regla para el grupo de administradores, se habilita la creación de WebDAV, se especifica que se permiten archivos ocultos, se habilitan los bloqueos de WebDAV, se especifica el proveedor de bloqueos, se habilitan las propiedades de WebDAV y se especifica el espacio de nombres XML predeterminado para la asignación de propiedades.

<location path="Default Web Site">
   <system.webServer>
      <webdav>
         <authoringRules defaultAccess="none" allowNonMimeMapFiles="true" defaultMimeType="text/plain">
            <clear />
            <add roles="administrators" path="*" access="Read, Write, Source" />
         </authoringRules>
         <authoring enabled="true" requireSsl="false">
            <fileSystem allowHiddenFiles="true" />
            <locks enabled="true" lockStore="webdav_simple_lock" requireLockForWriting="false" />
            <properties allowAnonymousPropfind="false" allowInfinitePropfindDepth="false" allowCustomProperties="true">
               <clear />
               <add xmlNamespace="*" propertyStore="webdav_simple_prop" />
            </properties>
         </authoring>
      </webdav>
   </system.webServer>
</location>

Código de ejemplo

En los ejemplos siguientes se configuran reglas de creación de WebDAV para que los clientes de WebDAV puedan publicar archivos que no aparecen en la asignación de MIME de IIS y agregar una sola regla de creación que conceda acceso de lectura, escritura y origen al grupo de administradores.

AppCmd.exe

appcmd.exe set config "Default Web Site" -section:system.webServer/webdav/authoringRules /allowNonMimeMapFiles:"True" /commit:apphost

appcmd.exe set config "Default Web Site" -section:system.webServer/webdav/authoringRules /+"[roles='administrators',path='*',access='Read, Write, Source']" /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 authoringRulesSection = config.GetSection("system.webServer/webdav/authoringRules", "Default Web Site");
         authoringRulesSection["allowNonMimeMapFiles"] = true;

         ConfigurationElementCollection authoringRulesCollection = authoringRulesSection.GetCollection();

         ConfigurationElement addElement = authoringRulesCollection.CreateElement("add");
         addElement["roles"] = @"administrators";
         addElement["path"] = @"*";
         addElement["access"] = @"Read, Write, Source";
         authoringRulesCollection.Add(addElement);

         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 authoringRulesSection As ConfigurationSection = config.GetSection("system.webServer/webdav/authoringRules", "Default Web Site")
      authoringRulesSection("allowNonMimeMapFiles") = True

      Dim authoringRulesCollection As ConfigurationElementCollection = authoringRulesSection.GetCollection

      Dim addElement As ConfigurationElement = authoringRulesCollection.CreateElement("add")
      addElement("roles") = "administrators"
      addElement("path") = "*"
      addElement("access") = "Read, Write, Source"
      authoringRulesCollection.Add(addElement)

      serverManager.CommitChanges()
   End Sub
End Module

JavaScript

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

var authoringRulesSection = adminManager.GetAdminSection("system.webServer/webdav/authoringRules", "MACHINE/WEBROOT/APPHOST/Default Web Site");
authoringRulesSection.Properties.Item("allowNonMimeMapFiles").Value = true;

var authoringRulesCollection = authoringRulesSection.Collection;

var addElement = authoringRulesCollection.CreateNewElement("add");
addElement.Properties.Item("roles").Value = "administrators";
addElement.Properties.Item("path").Value = "*";
addElement.Properties.Item("access").Value = "Read, Write, Source";
authoringRulesCollection.AddElement(addElement);

adminManager.CommitChanges();

VBScript

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

Set authoringRulesSection = adminManager.GetAdminSection("system.webServer/webdav/authoringRules", "MACHINE/WEBROOT/APPHOST/Default Web Site")
authoringRulesSection.Properties.Item("allowNonMimeMapFiles").Value = True

Set authoringRulesCollection = authoringRulesSection.Collection

Set addElement = authoringRulesCollection.CreateNewElement("add")
addElement.Properties.Item("roles").Value = "administrators"
addElement.Properties.Item("path").Value = "*"
addElement.Properties.Item("access").Value = "Read, Write, Source"
authoringRulesCollection.AddElement(addElement)

adminManager.CommitChanges()