Microsoft IIS

CertGuardian permite instalar certificados automáticamente en servidores Microsoft IIS mediante la configuración del archivo certificates.yaml.

Este archivo se encuentra dentro del directorio config del agente:

certguardian-agent/
├── certguardian-agent.exe
└── config/
    └── certificates.yaml

Ejemplo de Configuración

El siguiente ejemplo muestra un certificado que será instalado en dos sitios web diferentes de IIS:

certificates:
  - id: 1
    installations:
      - id: public-website
        type: iis
        config:
          site: "www.example.com"
          hostname: "www.example.com"

      - id: customer-portal
        type: iis
        config:
          site: "portal.example.com"
          hostname: "portal.example.com"

Estructura de la Configuración

id

Identificador del certificado dentro de la plataforma CertGuardian.

id: 1

Este identificador debe coincidir con el identificador del certificado configurado en la plataforma.

installations

Lista de instalaciones asociadas al certificado.

installations:

Un mismo certificado puede tener una o varias instalaciones.

installation.id

Identificador único de la instalación.

id: public-website

Este valor permite identificar la instalación dentro del archivo de configuración.

installation.type

Tipo de instalación que ejecutará el agente.

Para instalaciones IIS debe utilizarse:

type: iis

installation.config

Contiene los parámetros específicos de Microsoft IIS.

config:

Parámetros IIS

site

Nombre del sitio web de IIS donde se instalará el certificado.

site: "www.example.com"

El nombre debe coincidir exactamente con el nombre configurado en el Administrador de IIS.

hostname

Hostname o binding HTTPS sobre el que se aplicará el certificado.

hostname: "www.example.com"

El agente buscará el binding HTTPS correspondiente y actualizará el certificado asociado.

Múltiples Instalaciones

Un mismo certificado puede asociarse a múltiples instalaciones IIS.

Esto permite:

• Instalar el mismo certificado en varios sitios web.
• Instalar el mismo certificado en distintos hostnames.
• Gestionar múltiples bindings HTTPS utilizando una única definición de certificado.

En el ejemplo anterior, el certificado será instalado en dos sitios web distintos:

• www.example.com
• portal.example.com

Cada instalación es independiente y puede apuntar a un sitio web o hostname diferente.