Apéndice B: Secuencias de comandos y archivos auxiliares de la solución

2018-11-22

Publicado: octubre 11, 2004 | Actualizado: 24/11/04

En esta página

Introducción
Lista de los archivos de la guía de la solución
Estructura de las secuencias de comandos
Descripción de las secuencias de comandos y archivos auxiliares

Introducción

En este apéndice se incluye una breve descripción de las secuencias de comandos y otros archivos auxiliares suministrados con la solución para Seguridad en LAN inalámbricas con Servicios de Certificate Server. Aunque son funcionales y se han probado, las secuencias de comandos y los archivos auxiliares se proporcionan como ayuda para crear secuencias de comandos administrativas propias. No están diseñados para servir de código con calidad de producción.

Condiciones de uso

Las secuencias de comandos y los archivos auxiliares proporcionados con esta solución están sujetos a las CONDICIONES DE USO estándar de Microsoft. Las condiciones se encuentran en la página Microsoft: información acerca de las condiciones de uso en http://www.microsoft.com/info/cpyright.htm.

Nota: asegúrese de probar exhaustivamente estas secuencias de comandos y herramientas en un entorno de prueba antes de implementarlas en un entorno de producción.

Principio de la página

Lista de los archivos de la guía de la solución

Secuencias de comandos comunes

constants.vbs
helper.vbs

Secuencias de comandos de Servicios de Certificate Server

pkiparams.vbs
ca_monitor.vbs
ca_monitor.wsf
ca_operations.vbs
ca_operations.wsf
ca_setup.vbs
ca_setup.wsf

Secuencias de comandos de IAS y WLAN

ias_tools.vbs
ias_tools.wsf
wl_tools.vbs
wl_tools.wsf
IASClientExport.bat
IASClientImport.bat
IASExport.bat
IASImport.bat
IAS_Data.bat

Archivo auxiliar de IAS y WLAN

IASAccessPrep.txt

Archivos desatendidos de componentes opcionales

OC_AddIAS.txt
OC_AddIIS.txt
OC_RemoveRootUpdate.txt

Principio de la página

Estructura de las secuencias de comandos

Los archivos por lotes son relativamente simples de seguir, pero los archivos de Microsoft® Visual Basic® Scripting Edition (VBScript) requieren explicación para comprender el modo en que funcionan conjuntamente. A diferencia de muchos ejemplos de VBScript, estas secuencias de comandos son multifuncionales. Para proporcionar acceso a las distintas funciones, las secuencias de comandos aprovechan la funcionalidad de "trabajo" de Microsoft Windows® Scripting Host (WSH). Esto permite varias funciones de programa independientes mediante la especificación de un nombre de trabajo como parámetro para la secuencia de comandos.

Las secuencias de comandos normalmente van por parejas: un archivo .wsf y otro .vbs. El archivo WSF contiene la "interfaz de usuario" para distintas operaciones de la secuencia de comandos. El archivo VBS contiene todo el código que hace que el trabajo del programa.

Todos los archivos de secuencias de comandos utilizan la sintaxis donde NombreTrabajo es el nombre de la operación requerida y ArchivoSecuenciaComandosW es el nombre del archivo de interfaz XML de la secuencia de comandos como en el siguiente ejemplo:

cscript //job:NombreTrabajo ArchivoSecuenciaComandosW.wsf
Un extracto de uno de los archivos WSF incluye la siguiente información:

    <?xml version="1.0" encoding="utf-8" ?>
    <package xmlns="Windows Script Host
        <job id="GetCaCerts ">
            <comment></comment>
            <script language="VBScript" src="constants.vbs" />
            <script language="VBScript" src="pkiparams.vbs" />
            <script language="VBScript" src="helper.vbs" />
            <script language="VBScript" src="ca_operations.vbs" />
            <script language="VBScript
            <![CDATA[
                GetCaCerts
            ]]>
            </script>
        </job>
        <job id="PublishRootCertstoIIS ">
            <comment></comment>
            <script language="VBScript" src="constants.vbs" />
            <script language="VBScript" src="pkiparams.vbs" />
            <script language="VBScript" src="helper.vbs" />
            <script language="VBScript" src="ca_operations.vbs" />
            <script>
            <![CDATA[
                PublishCertstoIIS ROOT_CERT_SOURCE, WWW_LOCAL_PUB_PATH
            ]]>
            </script>
        </job>

El primer trabajo es GetCACerts. La definición de este trabajo especifica que se carguen los archivos VBS constants.vbs, pkiparams.vbs, helper.vbs y ca_operations.vbs, que contienen funciones o subrutinas que necesita el trabajo. La sección final del ejemplo de código especifica la función de nivel superior que se ejecutará para iniciar el trabajo; en este caso, GetCACerts. (Este ejemplo tiene el mismo nombre que el trabajo, pero no es necesario que sea así.) Observe que el segundo trabajo, PublishRootCertstoIIS, proporciona parámetros a la función llamada.

Los archivos VBS se encargan del trabajo real y hay tres tipos principales:

Archivos de secuencias de comandos específicos de la operación que contienen funciones relacionadas únicamente con dicho tipo de operación. (Por ejemplo, ca_operations.vbs contiene funciones relacionadas con las operaciones de entidad emisora de certificados, o CA.)
Archivos de secuencias de comandos genéricos que contienen funciones más generales de las que utilizan las secuencias de comandos más específicas de la operación. Helper.vbs es la única de estas secuencias de comandos y contiene funciones como crear cuentas de usuario y comprobar errores.
Archivos de secuencias de comandos de parámetros que contienen constantes de VBScript que definen el modo de ejecución de las secuencias de comandos operativas. Se han recopilado para que resulte más fácil modificarlas en un solo lugar en vez de incrustarlas en las funciones de secuencias de comandos. En esta categoría se encuentran los archivos constants.vbs, que contiene parámetros globales, y pkiparams.vbs, que contiene parámetros específicos a la configuración y operaciones de la infraestructura de claves públicas (PKI).

Principio de la página

Descripción de las secuencias de comandos y archivos auxiliares

En esta sección se describe cada una de las secuencias de comandos y los archivos auxiliares enumerados anteriormente.

Secuencias de comandos comunes

Hay dos tipos de archivos de secuencias de comandos comunes.

Constants.vbs

Esta secuencia de comandos contiene valores comunes que los usuarios pueden establecer para que los utilicen los demás archivos VBS y WSF. (Por ejemplo, los valores de las alertas SMTP y de registro de sucesos se establecen en esta secuencia de comandos.)

Helper.vbs

Esta secuencia de comandos contiene rutinas auxiliares que utilizan numerosas secuencias de comandos VBS (por ejemplo, creación de usuarios y grupos, rutinas de alertas y otras funciones de utilidad).

Secuencias de comandos de Servicios de Certificate Server

En esta sección se describen las secuencias de comandos de Servicios de Certificate Server.

pkiparams.vbs

Esta secuencia de comandos contiene valores específicos de PKI y de entidad emisora que el usuario puede cambiar. Algunos de estos valores se deben cambiar para poder utilizarlos (con el fin de reflejar la configuración correcta del entorno); otros no se tienen que cambiar a menos que se desee que el comportamiento de la secuencia de comandos sea distinto. En los capítulos principales de la guía (los capítulos 7, "Implementación de la infraestructura de claves públicas", y 11, "Administración de la infraestructura de claves públicas") se proporciona información acerca de dónde se debe o puede cambiar un valor en estos procedimientos.

Todas las demás secuencias de comandos hacen referencia a PKIParams.vbs con el prefijo "CA_".

ca_setup.vbs y ca_setup.wsf

Estas secuencias de comandos contienen funciones para configurar los parámetros de línea de base de las entidades emisoras que se utilizan para crear grupos de seguridad y usuarios. Hay rutinas de configuración para las CA raíz y emisoras. La mayoría de los valores configurados realmente se controlan desde el archivo pkiparams.vbs. Consulte el capítulo 7, "Implementación de la infraestructura de claves públicas", para obtener más información acerca de este archivo.