Compartir a través de

Cómo agregar un certificado a una aplicación

En este tema se describe cómo usar la línea de comandos para agregar un certificado a una aplicación de BizTalk. Esta opción no está disponible en la consola de administración de BizTalk Server. Agrega un certificado a una aplicación de BizTalk para que pueda transportar el certificado de un grupo de BizTalk a otro, empaquetado con una aplicación. Los certificados se usan para comprobar las identidades y para establecer vínculos seguros para los puertos de envío y las ubicaciones de recepción. Para obtener más información, vea Cómo asignar un certificado a un puerto de envío y Cómo asignar un certificado a una ubicación de recepción.

Al agregar un certificado a una aplicación, tenga en cuenta los siguientes puntos importantes:

  • Al agregar un certificado a una aplicación, el certificado se agrega a la base de datos de administración de BizTalk como un artefacto de certificado. Al instalar la aplicación, el certificado se importa en el almacén de certificados Otras personas del equipo local, por lo que es posible que no tenga que realizar el paso adicional de importarlo en este almacén antes de poder asignarlo a un puerto de envío o a una ubicación de recepción. Cuando se usa BTSTask para agregar el certificado, el certificado debe existir en el almacén de certificados de otras personas y debe especificar su huella digital.

    Nota:

    Cuando se exporta un certificado, se quita la clave privada. Cuando se instala la aplicación, aunque el certificado se importa en el almacén de certificados, no se puede usar para descifrar un mensaje cifrado, aunque se puede usar para enviar un mensaje cifrado. Si necesita usar el certificado para el propósito anterior, debe reinstalarlo en el Almacén de Certificados de Otras Personas en el equipo que hospeda el puerto de envío que usa el certificado.

  • Como procedimiento recomendado, si un puerto de envío usará un certificado o una ubicación de recepción en dos o más aplicaciones, debe implementar el certificado en una aplicación independiente y, a continuación, hacer referencia a esta aplicación desde las aplicaciones que necesitan usar el certificado. Esto se debe a que solo puede existir un certificado que tenga una huella digital determinada en el grupo de BizTalk, por lo que no podrá importar el mismo certificado en dos aplicaciones diferentes. Si intenta importar dos aplicaciones que usan el mismo certificado, la primera importación se realizará correctamente y la segunda no. En este caso, el uso de la opción Sobrescribir importación no corrige el problema, ya que el certificado existente que desea sobrescribir está contenido en otra aplicación.

Prerrequisitos

Para realizar los procedimientos de este tema, debe iniciar sesión con una cuenta que sea miembro del grupo Administradores de BizTalk Server. Para obtener información más detallada sobre los permisos, vea Permisos necesarios para implementar y administrar una aplicación de BizTalk.

Para agregar un certificado a una aplicación

  1. Abra un símbolo del sistema como se indica a continuación: haga clic en Inicio, haga clic en Ejecutar, escriba cmd y, a continuación, haga clic en Aceptar.

  2. Escriba el siguiente comando, sustituyendo los valores adecuados, como se describe en la tabla siguiente:

    BTSTask AddResource [/ApplicationName:value] /Type:System.BizTalk:Certificate [/Overwrite] /Thumbprint:"value" [/Server:value] [/Database:value]

    Ejemplo:

    BTSTask AddResource /ApplicationName:MyApplication /Type:System.BizTalk:Certificate /Overwrite /Thumbprint:"04 a2 8e 32 24 f9 36 b9 42 81 12 71 3a d2 ef db c7 9c 83 dc" /Server:MyDatabaseServer /Database:BizTalkMgmtDb

    Parámetro Importancia
    /ApplicationName Nombre de la aplicación de BizTalk a la que se va a agregar el certificado. Si no se especifica el nombre de la aplicación, se usa la aplicación predeterminada de BizTalk para el grupo. Si el nombre incluye espacios, debe incluirlo entre comillas dobles (").
    /Tipo System.BizTalk:Certificate (este valor no distingue mayúsculas de minúsculas).
    /Sobrescribir Opción para actualizar un certificado existente. Si no se especifica y ya existe un certificado en la aplicación que tiene la misma propiedad Huella digital que el certificado que se agrega, se produce un error en la operación Agregar. Puede ver la propiedad Huella Digital haciendo doble clic en el certificado en el complemento Certificados y haciendo clic en la pestaña Detalles. Para obtener más información, consulte "Visualización de la información del certificado" en la documentación del complemento Certificados.
    /Huella digital Propiedad de huella digital del certificado (una huella digital es un resumen de los datos). Este valor debe incluirse entre comillas dobles (").
    /Servidor Nombre de la instancia de SQL Server que hospeda la base de datos de administración de BizTalk, en el formulario NombreDeServidor\NombreDeInstancia,Puerto.

    El nombre de instancia solo es necesario cuando el nombre de instancia es diferente del nombre del servidor. El puerto solo es necesario cuando SQL Server usa un número de puerto distinto del predeterminado (1433).

    Ejemplos:

    Server=MyServer

    Servidor=MyServer\MySQLServer,1533

    Si no se proporciona, se usa el nombre de la instancia de SQL Server que se ejecuta en el equipo local.
    /Base de datos Nombre de la base de datos de administración de BizTalk. Si no se especifica, se usa la base de datos de administración de BizTalk que se ejecuta en la instancia local de SQL Server.

Véase también

Administración de ensamblados, certificados y otros recursos de .NET
Comando AddResource: Certificate
Crear y modificar aplicaciones de BizTalk