Cifrar y descifrar secciones de configuración

Para cifrar el contenido del archivo de configuración, utilice la herramienta Aspnet_regiis.exe con la opción –pe y el nombre del elemento de configuración que se va a cifrar.

Utilice la opción –app para identificar la aplicación para la cual se va a cifrar el archivo Web.config y la opción -site para identificar el sitio Web del que forma parte la aplicación. El sitio Web se identifica utilizando el número del sitio de la metabase de Internet Information Services (IIS). Puede recuperar el número del sitio desde la variable del servidor INSTANCE_META_PATH de la colección ServerVariables. Por ejemplo, cuando se instala IIS, se crea un sitio web denominado "Sitio web predeterminado" como sitio 1. En las páginas servidas desde ese sitio, la variable de servidor INSTANCE_META_PATH devuelve "/LM/W3SVC/1". Si no especifica una opción -site, se utiliza sitio 1.

Utilice la opción –prov para identificar el nombre del ProtectedConfigurationProvider que llevará a cabo el cifrado y descifrado. Si no especifica un proveedor mediante la opción -prov, se utilizará el proveedor configurado como defaultProvider.

Nota
Si está utilizando una instancia de RsaProtectedConfigurationProvider que especifica un contenedor de claves personalizado, debe crear el contenedor de claves antes de ejecutar la herramienta Aspnet_regiis.exe. Para obtener más información, vea Importar y exportar contenedores de claves RSA con configuración protegida.

El comando siguiente cifra el elemento connectionStrings del archivo Web.config para la aplicación SampleApplication. Dado que no se incluye ninguna opción -site, se supone que la aplicación es del sitio Web 1 (más conocido como Default Web Site en IIS). El cifrado se realiza utilizando el RsaProtectedConfigurationProvider especificado en la configuración del equipo.

aspnet_regiis -pe "connectionStrings" -app "/SampleApplication" -prov "RsaProtectedConfigurationProvider"

Cuando se solicita una página u otro recurso de ASP.NET en la aplicación, ASP.NET llama al proveedor de la sección de configuración protegida para cifrar la información que utilizarán ASP.NET y el código de la aplicación.

Nota
Para descifrar y cifrar una sección del archivo Web.config, el proceso de ASP.NET debe tener el permiso para leer la información adecuada de la clave de cifrado. Para obtener más información, vea Importar y exportar contenedores de claves RSA con configuración protegida.

Para descifrar el contenido del archivo de configuración, utilice la herramienta Aspnet_regiis.exe con el modificador -pd y el nombre del elemento de configuración que se va a descifrar. Utilice los modificadores –app y -site para identificar la aplicación para la que se va a descifrar el archivo Web.config. No es necesario especificar el modificador –prov para identificar el nombre del ProtectedConfigurationProvider, ya que esa información se lee desde el atributo configProtectionProvider de la sección de configuración protegida.

El comando siguiente descifra el elemento connectionStrings del archivo Web.config para la aplicación SampleApplication.

aspnet_regiis -pd "connectionStrings" -app "/SampleApplication"

Tareas

Conceptos

Otros recursos