Posté le 24 septembre 2025 - 09:36
# Manual de Uso do WAS Orchestrator Kit v5.1

**Autor:** Manus AI

## Índice

1. [Finalidade](#finalidade)
2. [Visão Geral do Kit](#visão-geral-do-kit)
* [Estrutura de Arquivos](#estrutura-de-arquivos)
* [Componentes Principais](#componentes-principais)
3. [Descrição Detalhada dos Scripts](#descrição-detalhada-dos-scripts)
* [`WAS-Orchestrator.ps1`](#was-orchestratorps1)
* [`Metrics-Exporter.ps1`](#metrics-exporterps1)
* [`Metrics-Exporter-Service.ps1`](#metrics-exporter-serviceps1)
* [`Metrics-Exporter-Wrapper.ps1`](#metrics-exporter-wrapperps1)
* [`DR-Plan.ps1`](#dr-planps1)
* [`Sign-All.ps1`](#sign-allps1)
* [`Validate-Install.ps1`](#validate-installps1)
* [`Load-Config.ps1`](#load-configps1)
* [`Orchestrator-API.ps1`](#orchestrator-apips1)
* [`Cert-Watch.ps1`](#cert-watchps1)
4. [Exemplos de Uso](#exemplos-de-uso)
* [Executando o Menu Principal](#executando-o-menu-principal)
* [Instalando o Metrics Exporter como Serviço](#instalando-o-metrics-exporter-como-serviço)
* [Executando um Plano de DR](#executando-um-plano-de-dr)
* [Validando a Integridade do Kit](#validando-a-integridade-do-kit)
* [Gerando Inventário de Certificados](#gerando-inventário-de-certificados)
5. [Conclusão](#conclusão)




## Finalidade

O WAS Orchestrator Kit v5.1 é um conjunto de scripts PowerShell projetado para simplificar e automatizar a manutenção, monitoramento e gerenciamento de ambientes que utilizam o Microsoft Internet Information Services (IIS) e o Windows Activation Service (WAS). Em ambientes de produção, a estabilidade e a segurança desses serviços são cruciais. Este kit visa fornecer aos administradores de sistema e engenheiros de DevOps um conjunto de ferramentas robustas para garantir a operação contínua, a conformidade de segurança e a capacidade de resposta a incidentes, tudo isso através de uma interface de linha de comando ou via API. Ele consolida diversas tarefas rotineiras e complexas em scripts fáceis de usar, reduzindo a chance de erros manuais e otimizando o tempo de gerenciamento. A capacidade de exportar métricas, validar a integridade da instalação e gerenciar certificados são exemplos de como o kit aborda as necessidades críticas de um ambiente de servidor moderno. Além disso, a inclusão de um plano de recuperação de desastres (DR-Plan) e funcionalidades de endurecimento (hardening) demonstra uma abordagem proativa para a resiliência e segurança do sistema. O kit é uma solução abrangente para o gerenciamento eficiente e seguro de infraestruturas baseadas em IIS e WAS, permitindo que as equipes se concentrem em tarefas de maior valor agregado, enquanto as operações de rotina são automatizadas e monitoradas de forma eficaz.




## Visão Geral do Kit

O WAS Orchestrator Kit v5.1 é estruturado de forma modular para facilitar o gerenciamento e a extensão. Ele agrupa scripts, configurações e documentação em diretórios lógicos, permitindo que os administradores naveguem e utilizem as ferramentas de forma eficiente. A arquitetura do kit reflete uma abordagem prática para o gerenciamento de sistemas, onde diferentes aspectos da manutenção e monitoramento são tratados por componentes especializados, mas interconectados. Essa modularidade não apenas melhora a organização, mas também permite que cada script seja focado em uma tarefa específica, tornando o kit mais robusto e fácil de depurar. A inclusão de arquivos de configuração externos, como YAML, demonstra uma preocupação com a flexibilidade e a capacidade de adaptação a diferentes ambientes sem a necessidade de modificar o código-fonte dos scripts. Além disso, a presença de um catálogo de integridade e scripts de assinatura de código ressalta a importância da segurança e da confiança na execução desses utilitários em ambientes de produção. A seguir, detalhamos a estrutura de arquivos e os componentes principais que compõem este kit.

### Estrutura de Arquivos

O kit é organizado em um diretório `Bundle` com as seguintes subpastas:

* **`Bundle/Scripts`**: Este diretório é o coração do kit, contendo todos os scripts PowerShell que realizam as operações de gerenciamento, monitoramento e automação. Cada script é projetado para uma funcionalidade específica, promovendo a modularidade e a reutilização de código. Exemplos incluem scripts para iniciar/parar serviços, exportar métricas, gerenciar certificados e executar planos de recuperação de desastres.
* **`Bundle/Config`**: Armazena arquivos de configuração em formato YAML, como `orchestrator.yaml`. Esses arquivos são utilizados pelos scripts para carregar parâmetros e configurações específicas do ambiente, permitindo uma personalização fácil sem a necessidade de alterar o código dos scripts. Isso é particularmente útil para adaptar o kit a diferentes cenários de implantação.
* **`Bundle/Profiles`**: Contém perfis e definições para funcionalidades específicas, como o `DR-Plan.yaml`, que descreve os passos e recursos envolvidos em um plano de recuperação de desastres. A separação dos perfis de configuração dos scripts principais permite que os administradores definam e gerenciem diferentes estratégias de DR de forma independente.
* **`Bundle/Docs`**: Inclui a documentação básica do kit, como o `README-v5.1.txt`. Embora este manual forneça uma visão mais aprofundada, o README original oferece um ponto de partida rápido para entender o propósito e as funcionalidades básicas do kit.
* **`Bundle/Catalog`**: Contém o arquivo `WAS-CATALOG-SHA256.txt`, que é um catálogo de hashes SHA256 de todos os arquivos do kit. Este arquivo é crucial para a funcionalidade de validação de integridade, garantindo que os scripts e outros componentes não foram adulterados ou corrompidos.

### Componentes Principais

Os principais componentes do kit são os scripts PowerShell, cada um com uma função específica:

* **`WAS-Orchestrator.ps1`**: O script principal que atua como um menu interativo, centralizando o acesso a diversas funcionalidades do kit.
* **`Metrics-Exporter.ps1`**: Exporta métricas de desempenho e status do IIS/WAS/TLS no formato Prometheus, facilitando a integração com sistemas de monitoramento.
* **`Metrics-Exporter-Service.ps1`**: Gerencia a instalação e o ciclo de vida do `Metrics-Exporter.ps1` como um serviço Windows, garantindo sua execução contínua.
* **`Metrics-Exporter-Wrapper.ps1`**: Um script que monitora e reinicia o `Metrics-Exporter.ps1` caso ele pare, assegurando a disponibilidade da exportação de métricas.
* **`DR-Plan.ps1`**: Executa planos de recuperação de desastres definidos em arquivos YAML, automatizando a resposta a falhas.
* **`Sign-All.ps1`**: Assina digitalmente todos os scripts PowerShell do kit, aumentando a segurança e a conformidade em ambientes restritivos.
* **`Validate-Install.ps1`**: Verifica a integridade dos arquivos do kit usando hashes SHA256, detectando qualquer alteração ou corrupção.
* **`Load-Config.ps1`**: Um utilitário para carregar configurações de arquivos YAML, usado por outros scripts para obter parâmetros de execução.
* **`Orchestrator-API.ps1`**: Expõe uma API HTTP local para permitir a interação programática com as funcionalidades do Orchestrator, facilitando a automação e integração.
* **`Cert-Watch.ps1`**: Gera um inventário de certificados SSL/TLS instalados, monitorando suas datas de expiração e alertando sobre certificados próximos ao vencimento.




## Descrição Detalhada dos Scripts

Esta seção oferece uma análise aprofundada de cada script PowerShell incluído no WAS Orchestrator Kit v5.1, detalhando suas funcionalidades, parâmetros e o papel que desempenham no ecossistema de gerenciamento de IIS e WAS. Compreender o propósito e a operação de cada script é fundamental para utilizar o kit de forma eficaz e para solucionar problemas que possam surgir. Cada script foi projetado com um objetivo específico em mente, contribuindo para a completude e a versatilidade do kit. A interconexão entre alguns desses scripts, como o `WAS-Orchestrator.ps1` que invoca outros scripts, demonstra uma arquitetura bem pensada para centralizar o controle e a execução de tarefas. Além disso, a inclusão de mecanismos de logging e tratamento de erros em muitos dos scripts reflete uma preocupação com a robustez e a capacidade de auditoria das operações realizadas. A seguir, exploraremos cada script individualmente, fornecendo informações essenciais para sua compreensão e uso.

### `WAS-Orchestrator.ps1`

O `WAS-Orchestrator.ps1` é o ponto de entrada principal para a maioria das operações manuais do kit. Ele apresenta um menu interativo que permite ao usuário selecionar diversas ações relacionadas ao gerenciamento do IIS e WAS. Este script é ideal para administradores que preferem uma interface baseada em menu para executar tarefas comuns ou para explorar as capacidades do kit. Ele encapsula a lógica de chamada para outros scripts e funções, tornando a experiência do usuário mais coesa e simplificada. A estrutura do menu é intuitiva, guiando o usuário através das opções disponíveis e fornecendo feedback sobre o sucesso ou falha das operações. A capacidade de iniciar e parar serviços, aplicar configurações de segurança e executar diagnósticos a partir de um único ponto centralizado é um dos grandes benefícios deste script.

**Funcionalidades Principais:**

* **Iniciar/Parar IIS**: Controla o serviço `W3SVC` (World Wide Web Publishing Service).
* **Iniciar/Parar WAS**: Controla os serviços `WD*AWP` (Windows Process Activation Service).
* **Safe Test Mode**: Um recurso para abrir portas de firewall específicas (4900, 4901, 4902, 4910, 4920) e desativar o firewall temporariamente para facilitar testes. Inclui uma opção para reverter essas configurações.
* **Hardening Max**: Aplica configurações de segurança a um pool de aplicativos IIS (`WebdevAppPool`), garantindo que ele esteja sempre ativo (`AlwaysRunning`), sem tempo limite de inatividade (`idleTimeout`) ou reinícios periódicos (`recycling.periodicRestart.time`).
* **Diagnósticos**: Realiza verificações de status para o IIS e WAS, e lista o estado de todos os sites configurados no IIS.
* **Executar DR-Plan**: Invoca o script `DR-Plan.ps1` para iniciar um plano de recuperação de desastres.
* **Validação de Integridade**: Invoca o script `Validate-Install.ps1` para verificar se os arquivos do kit foram alterados.
* **Status do Exporter**: Verifica o status do serviço `WASExporter`, que é gerenciado pelo `Metrics-Exporter-Service.ps1`.

**Exemplo de Uso (interativo):**

```powershell
.\WAS-Orchestrator.ps1
```

Ao executar, um menu será exibido, e o usuário poderá digitar o número da opção desejada.

### `Metrics-Exporter.ps1`

O `Metrics-Exporter.ps1` é um componente vital para o monitoramento de ambientes IIS/WAS, projetado para expor métricas no formato compatível com Prometheus. Ele opera como um servidor HTTP leve, ouvindo em uma porta específica (padrão: 4900) e respondendo a requisições `/metrics` com dados de telemetria. A capacidade de integrar essas métricas com sistemas de monitoramento modernos, como Prometheus e Grafana, permite a criação de dashboards detalhados e alertas proativos sobre a saúde e o desempenho dos serviços. Este script coleta informações cruciais sobre o estado dos serviços, a configuração de sites e a segurança de protocolos TLS, fornecendo uma visão abrangente do ambiente.

**Métricas Exportadas:**

* **`was_iis_status`**: Status do serviço IIS (1 para ativo, 0 para parado).
* **`was_service_status{name="<nome_do_serviço_WAS>"}`**: Status de cada serviço WAS individualmente.
* **`was_sites_total`**: Número total de sites IIS configurados.
* **`was_site_status{name="<nome_do_site>"}`**: Status de cada site IIS (1 para iniciado, 0 para parado).
* **`was_https_bindings_total`**: Número total de bindings HTTPS configurados.
* **`was_tls10_enabled`, `was_tls11_enabled`, `was_tls12_enabled`, `was_tls13_enabled`**: Indica se as versões específicas do TLS estão habilitadas no servidor (1 para habilitado, 0 para desabilitado), lendo diretamente do registro do Windows.

**Endpoint Padrão:** `http://localhost:4900/metrics`

**Exemplo de Uso (execução direta):**

```powershell
.\Metrics-Exporter.ps1
```

Este script geralmente é executado como um serviço em segundo plano, gerenciado pelo `Metrics-Exporter-Service.ps1` ou monitorado pelo `Metrics-Exporter-Wrapper.ps1`.

### `Metrics-Exporter-Service.ps1`

Para garantir a execução contínua e confiável do `Metrics-Exporter.ps1`, o `Metrics-Exporter-Service.ps1` oferece funcionalidades para instalar, gerenciar e remover o exportador como um serviço Windows. Ele utiliza o NSSM (Non-Sucking Service Manager), uma ferramenta de terceiros, para transformar o script PowerShell em um serviço persistente. Isso é fundamental para ambientes de produção, onde a disponibilidade do exportador de métricas é crítica para o monitoramento ininterrupto. O script simplifica o processo de configuração do serviço, abstraindo a complexidade da interação direta com o NSSM.

**Ações Suportadas:**

* **`Install`**: Instala o `Metrics-Exporter.ps1` como um serviço Windows (`WASExporter`) e o inicia. Requer que o NSSM esteja disponível no caminho `C:\nssm\nssm.exe`.
* **`Uninstall`**: Para e remove o serviço `WASExporter`.
* **`Start`**: Inicia o serviço `WASExporter`.
* **`Stop`**: Para o serviço `WASExporter`.
* **`Restart`**: Reinicia o serviço `WASExporter`.
* **`Status`**: Exibe o status atual do serviço `WASExporter`.

**Parâmetros:**

* `-Action <Install|Uninstall|Start|Stop|Restart|Status>`: Ação a ser executada no serviço.

**Exemplo de Uso (instalar o serviço):**

```powershell
.\Metrics-Exporter-Service.ps1 -Action Install
```

### `Metrics-Exporter-Wrapper.ps1`

O `Metrics-Exporter-Wrapper.ps1` atua como um guardião para o `Metrics-Exporter.ps1`. Em cenários onde o exportador de métricas não é executado como um serviço Windows (ou mesmo como uma camada adicional de resiliência), este wrapper garante que o `Metrics-Exporter.ps1` esteja sempre em execução. Ele monitora ativamente o processo do exportador e, caso detecte que ele parou, tenta reiniciá-lo automaticamente. Isso é particularmente útil para manter a continuidade da coleta de métricas sem intervenção manual, aumentando a robustez do sistema de monitoramento. Todas as ações do wrapper são logadas em um arquivo `Metrics-Exporter-Wrapper.log` para auditoria e depuração.

**Funcionalidade:**

* Monitora o processo do `Metrics-Exporter.ps1`.
* Reinicia o `Metrics-Exporter.ps1` automaticamente se ele não estiver em execução.
* Registra todas as ações e eventos em um arquivo de log.

**Exemplo de Uso:**

```powershell
.\Metrics-Exporter-Wrapper.ps1
```

Este script é projetado para ser executado continuamente em segundo plano.

### `DR-Plan.ps1`

O `DR-Plan.ps1` é um script crucial para a resiliência do ambiente, permitindo a execução automatizada de um plano de recuperação de desastres. Ele lê as instruções de um arquivo YAML (`DR-Plan.yaml`) e executa ações predefinidas, como iniciar sites críticos e parar outros sites não essenciais, além de reiniciar pools de aplicativos em uma ordem específica. A automação do DR-Plan reduz significativamente o tempo de recuperação (RTO) e minimiza o impacto de falhas, garantindo que os serviços mais importantes sejam restaurados rapidamente. A dependência de um arquivo YAML externo para a configuração do plano oferece flexibilidade, permitindo que diferentes planos de DR sejam definidos e executados conforme a necessidade.

**Funcionalidades:**

* Lê o plano de DR de um arquivo YAML (padrão: `..\Profiles\DR-Plan.yaml`).
* Inicia um site IIS crítico especificado no plano.
* Opcionalmente, para todos os outros sites IIS que não são o site crítico.
* Reinicia pools de aplicativos em uma ordem definida no arquivo YAML.
* Registra todas as ações em um arquivo `DR-Plan.log`.

**Parâmetros:**

* `-PlanFile <caminho_para_yaml>`: Caminho opcional para o arquivo YAML do plano de DR.

**Pré-requisitos:**

* PowerShell 7+ é recomendado para a função `ConvertFrom-Yaml`. O script inclui um fallback básico, mas a funcionalidade completa pode exigir a versão mais recente do PowerShell.

**Exemplo de Uso:**

```powershell
.\DR-Plan.ps1
```

Ou com um arquivo de plano específico:

```powershell
.\DR-Plan.ps1 -PlanFile "C:\MyDRPlans\MyCriticalDR.yaml"
```

### `Sign-All.ps1`

Em ambientes corporativos com políticas de segurança rigorosas, a execução de scripts PowerShell não assinados pode ser bloqueada. O `Sign-All.ps1` resolve esse problema, permitindo que todos os scripts do kit sejam assinados digitalmente usando um certificado Authenticode. Isso garante a autenticidade e a integridade dos scripts, permitindo sua execução em sistemas com políticas de execução restritivas (por exemplo, `AllSigned` ou `RemoteSigned`). A assinatura de código é uma prática de segurança essencial que ajuda a proteger contra a execução de scripts maliciosos ou adulterados, fornecendo uma camada de confiança para os administradores.

**Funcionalidades:**

* Localiza todos os arquivos `.ps1` dentro do `BundlePath` (padrão: `C:\WAS\Bundle`).
* Assina os scripts com um certificado Authenticode especificado.
* Permite a inclusão de um servidor de carimbo de data/hora (timestamp server) para garantir a validade da assinatura mesmo após a expiração do certificado.
* Pode forçar a re-assinatura de scripts já assinados.
* Registra o processo de assinatura em um arquivo de log.

**Parâmetros:**

* `-BundlePath <caminho>`: Caminho para o diretório raiz do kit (padrão: `C:\WAS\Bundle`).
* `-StoreLocation <CurrentUser|LocalMachine>`: Localização do armazenamento de certificados (padrão: `LocalMachine`).
* `-StoreName <nome_do_store>`: Nome do armazenamento de certificados (padrão: `My`).
* `-Thumbprint <thumbprint_do_certificado>`: O thumbprint do certificado de assinatura de código a ser usado. Se não for fornecido, o script tentará selecionar o certificado mais recente de "Code Signing".
* `-TimestampServer <url_do_servidor>`: URL de um servidor de carimbo de data/hora.
* `-Force`: Força a re-assinatura de scripts já assinados.

**Exemplo de Uso (assinando com um thumbprint específico):**

```powershell
.\Sign-All.ps1 -Thumbprint "SEU_THUMBPRINT_DO_CERTIFICADO" -TimestampServer "http://timestamp.digicert.com"
```

### `Validate-Install.ps1`

O `Validate-Install.ps1` é uma ferramenta de auditoria e segurança que verifica a integridade da instalação do WAS Orchestrator Kit. Ele compara os hashes SHA256 de todos os arquivos do kit com um catálogo de hashes pré-calculados (`WAS-CATALOG-SHA256.txt`). Essa validação é crucial para detectar qualquer modificação não autorizada, corrupção de arquivos ou infecção por malware. Em ambientes de alta segurança, a verificação regular da integridade dos arquivos é uma prática recomendada para garantir que as ferramentas de gerenciamento permaneçam confiáveis. O script pode gerar um relatório HTML detalhado, facilitando a visualização e o compartilhamento dos resultados da auditoria.

**Funcionalidades:**

* Calcula o hash SHA256 de cada arquivo do kit.
* Compara os hashes calculados com os hashes listados no `WAS-CATALOG-SHA256.txt`.
* Identifica arquivos com hashes diferentes (`Mismatch`), arquivos ausentes (`Missing`) e arquivos extras (`Extra`).
* Gera um relatório HTML com os resultados da validação, incluindo detalhes sobre quaisquer inconsistências.
* Registra todas as ações em um arquivo de log.

**Parâmetros:**

* `-BundlePath <caminho>`: Caminho para o diretório raiz do kit (padrão: `C:\WAS\Bundle`).
* `-Catalog <caminho>`: Caminho para o arquivo de catálogo SHA256 (padrão: `C:\WAS\Bundle\Catalog\WAS-CATALOG-SHA256.txt`).
* `-Exclude <padrões>`: Padrões de exclusão para arquivos que não devem ser validados (por exemplo, arquivos de log ou o próprio catálogo).
* `-HtmlReport <caminho_do_relatório>`: Caminho para salvar o relatório HTML de validação.
* `-Quiet`: Suprime a saída para o console, apenas registrando no log.

**Exemplo de Uso (gerando relatório HTML):**

```powershell
.\Validate-Install.ps1 -HtmlReport "C:\Reports\IntegrityReport.html"
```

### `Load-Config.ps1`

O `Load-Config.ps1` é um script utilitário interno, projetado para carregar configurações de arquivos YAML. Ele é utilizado por outros scripts do kit, como `DR-Plan.ps1` e `Orchestrator-API.ps1`, para obter parâmetros de configuração de forma estruturada. A utilização de arquivos YAML para configuração externa promove a flexibilidade, permitindo que os administradores ajustem o comportamento dos scripts sem modificar seu código-fonte. O script é inteligente o suficiente para detectar se o PowerShell 7+ está disponível (que inclui o cmdlet `ConvertFrom-Yaml`) e, caso contrário, oferece um fallback básico para parsing de YAML, garantindo compatibilidade com versões mais antigas do PowerShell, embora com suporte limitado a estruturas YAML complexas.

**Funcionalidades:**

* Lê e faz o parse de arquivos de configuração YAML.
* Suporta `ConvertFrom-Yaml` no PowerShell 7+.
* Inclui um fallback básico para parsing de YAML em versões anteriores do PowerShell.

**Parâmetros:**

* `-ConfigPath <caminho_para_yaml>`: Caminho para o arquivo de configuração YAML (padrão: `..\Config\orchestrator.yaml`).

**Exemplo de Uso (interno, geralmente chamado por outros scripts):**

```powershell
$config = .\Load-Config.ps1 -ConfigPath "..\Config\orchestrator.yaml"
```

### `Orchestrator-API.ps1`

O `Orchestrator-API.ps1` estende as capacidades do kit, expondo uma API HTTP local que permite a interação programática com as funcionalidades do Orchestrator. Isso é particularmente útil para integração com sistemas de automação externos, ferramentas de orquestração ou scripts personalizados que precisam acionar ações no ambiente IIS/WAS sem a necessidade de interação manual com o menu do `WAS-Orchestrator.ps1`. A API oferece endpoints para verificar o status dos serviços, iniciar/parar componentes e executar planos de DR ou auditorias, transformando o kit em um recurso programável.

**Endpoints da API:**

* **`/status`**: Retorna o status atual dos serviços IIS e WAS em formato JSON.
* **`/start-iis`**: Inicia o serviço IIS.
* **`/stop-iis`**: Para o serviço IIS.
* **`/start-was`**: Inicia os serviços WAS.
* **`/stop-was`**: Para os serviços WAS.
* **`/dr`**: Executa o `DR-Plan.ps1`.
* **`/audit`**: Executa o `Validate-Install.ps1`.

**Porta Padrão:** Definida no arquivo `orchestrator.yaml` (ex: 4900).

**Exemplo de Uso (execução direta para iniciar a API):**

```powershell
.\Orchestrator-API.ps1
```

Após a execução, a API estará disponível em `http://localhost:<porta_da_api>/`.

### `Cert-Watch.ps1`

O `Cert-Watch.ps1` é uma ferramenta essencial para a gestão proativa de certificados SSL/TLS. Ele escaneia os armazenamentos de certificados configurados no sistema, coleta informações sobre cada certificado (assunto, thumbprint, datas de validade) e calcula os dias restantes para a expiração. Com base em limites configuráveis (dias para aviso e dias para crítico), o script classifica a severidade de cada certificado e gera um relatório HTML detalhado. Este relatório é inestimável para evitar interrupções de serviço causadas por certificados expirados, permitindo que os administradores renovem os certificados com antecedência. A capacidade de gerar um relatório visualmente amigável torna a auditoria de certificados uma tarefa muito mais simples e eficiente.

**Funcionalidades:**

* Escaneia armazenamentos de certificados (configuráveis via `orchestrator.yaml`).
* Coleta detalhes de certificados, incluindo datas de validade.
* Calcula os dias restantes para a expiração.
* Classifica a severidade (OK, Aviso, Crítico) com base em limites configuráveis.
* Gera um relatório HTML com o inventário de certificados, incluindo formatação visual para severidade.

**Parâmetros:**

* `-ConfigPath <caminho_para_yaml>`: Caminho opcional para o arquivo de configuração YAML (padrão: `..\Config\orchestrator.yaml`).

**Configuração (via `orchestrator.yaml`):**

```yaml
certwatch:
warn_days: 30
crit_days: 7
html_report: "C:\Reports\CertInventory.html"
stores:
- location: LocalMachine
name: My
- location: CurrentUser
name: My
```

**Exemplo de Uso:**

```powershell
.\Cert-Watch.ps1
```

Este script gerará um arquivo HTML no caminho especificado na configuração, que pode ser aberto em um navegador para visualização.



## Exemplos de Uso

Esta seção fornece exemplos práticos de como utilizar os scripts do WAS Orchestrator Kit v5.1. Os exemplos são projetados para ilustrar as operações mais comuns e demonstrar a flexibilidade e o poder do kit na automação de tarefas de gerenciamento e monitoramento de IIS/WAS. É importante notar que, para a execução de muitos desses scripts, é necessário ter privilégios de administrador no sistema Windows onde o IIS e o WAS estão instalados. Além disso, a política de execução do PowerShell pode precisar ser ajustada (por exemplo, para `RemoteSigned` ou `Bypass`) para permitir a execução de scripts baixados da internet. Recomenda-se sempre revisar o código dos scripts antes da execução em um ambiente de produção. Os exemplos a seguir cobrem desde a interação com o menu principal até a instalação de serviços e a geração de relatórios, fornecendo um guia passo a passo para as funcionalidades chave do kit.

### Executando o Menu Principal

O script `WAS-Orchestrator.ps1` oferece uma interface de menu interativa para acessar rapidamente as principais funcionalidades do kit. É a maneira mais simples de começar a usar o kit para tarefas manuais.

1. **Abra o PowerShell como Administrador.**
2. **Navegue até o diretório `Bundle/Scripts`** onde o kit foi extraído:

```powershell
cd C:\caminho\para\WAS_Orchestrator_Kit_v5.1_FULL\Bundle\Scripts
```

3. **Execute o script principal:**

```powershell
.\WAS-Orchestrator.ps1
```

4. Um menu será exibido, permitindo que você escolha entre opções como iniciar/parar serviços, executar diagnósticos ou ativar o modo de teste seguro. Digite o número correspondente à opção desejada e pressione Enter.

```
=== WAS Orchestrator v5.1 ===
1. Iniciar IIS
2. Parar IIS
3. Iniciar WAS
4. Parar WAS
5. Safe Test Mode
6. Hardening Max
7. Diagnósticos
8. Executar DR-Plan
9. Validação de Integridade
10. Status do Exporter
0. Sair
Escolha: _
```

### Instalando o Metrics Exporter como Serviço

Para garantir que as métricas do IIS/WAS sejam exportadas continuamente, é recomendável instalar o `Metrics-Exporter.ps1` como um serviço Windows usando o `Metrics-Exporter-Service.ps1`. Este processo requer o NSSM (Non-Sucking Service Manager).

1. **Certifique-se de que o NSSM esteja disponível.** Por padrão, o script espera que o `nssm.exe` esteja em `C:\nssm\nssm.exe`. Se não estiver, você precisará baixá-lo e colocá-lo nesse local ou modificar o script `Metrics-Exporter-Service.ps1` para apontar para o caminho correto.
2. **Abra o PowerShell como Administrador.**
3. **Navegue até o diretório `Bundle/Scripts`**:

```powershell
cd C:\caminho\para\WAS_Orchestrator_Kit_v5.1_FULL\Bundle\Scripts
```

4. **Instale o serviço:**

```powershell
.\Metrics-Exporter-Service.ps1 -Action Install
```

5. Após a instalação, o serviço `WAS Metrics Exporter Service` será iniciado automaticamente. Você pode verificar seu status através do Gerenciador de Serviços do Windows ou usando o próprio script:

```powershell
.\Metrics-Exporter-Service.ps1 -Action Status
```

6. Para desinstalar o serviço, use:

```powershell
.\Metrics-Exporter-Service.ps1 -Action Uninstall
```

### Executando um Plano de DR

O `DR-Plan.ps1` permite automatizar a execução de um plano de recuperação de desastres definido em um arquivo YAML. Este exemplo assume que você tem um `DR-Plan.yaml` configurado no diretório `Bundle/Profiles`.

1. **Abra o PowerShell como Administrador.**
2. **Navegue até o diretório `Bundle/Scripts`**:

```powershell
cd C:\caminho\para\WAS_Orchestrator_Kit_v5.1_FULL\Bundle\Scripts
```

3. **Execute o script `DR-Plan.ps1`:**

```powershell
.\DR-Plan.ps1
```

O script lerá o `DR-Plan.yaml` padrão e executará as ações definidas (iniciar site crítico, parar outros sites, reiniciar pools de aplicativos).

4. Você pode especificar um arquivo de plano diferente, se necessário:

```powershell
.\DR-Plan.ps1 -PlanFile "C:\MyCustomPlans\EmergencyDR.yaml"
```

### Validando a Integridade do Kit

Para garantir que os arquivos do kit não foram adulterados, o `Validate-Install.ps1` pode ser usado para verificar sua integridade. Ele pode gerar um relatório HTML para fácil visualização.

1. **Abra o PowerShell como Administrador.**
2. **Navegue até o diretório `Bundle/Scripts`**:

```powershell
cd C:\caminho\para\WAS_Orchestrator_Kit_v5.1_FULL\Bundle\Scripts
```

3. **Execute o script `Validate-Install.ps1` para gerar um relatório HTML:**

```powershell
.\Validate-Install.ps1 -HtmlReport "C:\Reports\IntegrityReport_$(Get-Date -Format 'yyyyMMdd_HHmmss').html"
```

4. Um arquivo HTML será gerado no caminho especificado (neste caso, `C:\Reports\`). Abra este arquivo em um navegador para visualizar o relatório de integridade, que detalhará quaisquer arquivos ausentes, extras ou com hashes inconsistentes.

### Gerando Inventário de Certificados

O `Cert-Watch.ps1` é útil para monitorar a validade dos certificados SSL/TLS instalados no sistema, gerando um relatório HTML que destaca certificados próximos da expiração.

1. **Abra o PowerShell como Administrador.**
2. **Navegue até o diretório `Bundle/Scripts`**:

```powershell
cd C:\caminho\para\WAS_Orchestrator_Kit_v5.1_FULL\Bundle\Scripts
```

3. **Execute o script `Cert-Watch.ps1`:**

```powershell
.\Cert-Watch.ps1
```

4. O script gerará um arquivo HTML (caminho configurado em `orchestrator.yaml`, por padrão `C:\Reports\CertInventory.html`) com uma tabela listando todos os certificados encontrados, suas datas de validade e a severidade (OK, Aviso, Crítico) com base nos dias restantes para expiração. Abra este arquivo em um navegador para revisar o inventário.



## Conclusão

O WAS Orchestrator Kit v5.1 representa uma solução abrangente e bem estruturada para o gerenciamento e monitoramento de ambientes IIS e WAS. Através de uma coleção de scripts PowerShell modulares, o kit aborda uma vasta gama de necessidades operacionais, desde o controle básico de serviços até funcionalidades avançadas como exportação de métricas para sistemas de monitoramento, automação de planos de recuperação de desastres, validação de integridade de arquivos e gerenciamento proativo de certificados SSL/TLS. A análise estática dos scripts revelou uma arquitetura robusta, com clara separação de responsabilidades e a inclusão de boas práticas de segurança, como a assinatura de código e a verificação de integridade. A disponibilidade de uma API HTTP local expande ainda mais as possibilidades de automação e integração com outras ferramentas de orquestração, tornando o kit uma peça valiosa em qualquer pipeline de DevOps ou estratégia de gerenciamento de infraestrutura. Embora a dependência de ferramentas externas como NSSM e a preferência por PowerShell 7+ para certas funcionalidades sejam pontos a serem considerados, o kit oferece soluções eficazes para mitigar esses aspectos, como o fallback básico para parsing de YAML. Em suma, o WAS Orchestrator Kit v5.1 é uma ferramenta poderosa que capacita administradores e engenheiros a manterem seus ambientes IIS/WAS seguros, eficientes e resilientes, minimizando a intervenção manual e otimizando a resposta a eventos críticos. Sua completude e a profundidade de suas funcionalidades o tornam um recurso indispensável para qualquer equipe que gerencie esses serviços em escala.




## Complementaridade com o Script `Setup-WAS-IIS.ps1`

É importante notar a existência de scripts complementares que, embora não façam parte do WAS Orchestrator Kit v5.1, desempenham um papel crucial na configuração inicial de ambientes IIS/WAS, especialmente para o WebDev Application Server. Um exemplo notável é o script `Setup-WAS-IIS.ps1`, discutido em um fórum da PC SOFT [1]. Este script tem uma finalidade distinta do kit de orquestração, focando na instalação e configuração inicial do ambiente, enquanto o kit se concentra na manutenção e monitoramento contínuos.

### `Setup-WAS-IIS.ps1` (Script de Instalação e Configuração)

O `Setup-WAS-IIS.ps1` é um script PowerShell projetado para automatizar a configuração completa do IIS para o WebDev Application Server. Ele aborda os desafios comuns encontrados durante a instalação e garante que o ambiente esteja otimizado para o funcionamento do WebDev. Suas funcionalidades são essenciais para estabelecer uma base sólida antes que as ferramentas de manutenção e orquestração do kit possam ser plenamente utilizadas.

**Funcionalidades Principais:**

* **Instalação de Recursos do IIS**: Garante que todos os componentes necessários do IIS para o WebDev/WAS estejam instalados e configurados corretamente.
* **Criação e Configuração de Usuário Local**: Opcionalmente, cria um usuário local dedicado (`WebdevAdmin`) e o associa aos grupos de segurança apropriados (`Administrators` e `IIS_IUSRS`), seguindo as melhores práticas de segurança e isolamento.
* **Configuração de Application Pool**: Cria e configura Application Pools com identidades específicas, otimizando o desempenho e a segurança das aplicações WebDev.
* **Registro de ISAPI/Handlers**: Configura os handlers e módulos ISAPI necessários para que o IIS processe corretamente as extensões de arquivo do WebDev (`.awp`, `.awws`, `.wb`).
* **Permissões NTFS**: Aplica as permissões de sistema de arquivos (NTFS) adequadas nas pastas do IIS e do PC SOFT, resolvendo problemas comuns de acesso.
* **Correções para DISM**: Inclui lógica para corrigir problemas relacionados ao Deployment Image Servicing and Management (DISM) que podem impactar a funcionalidade do WAS em certos ambientes.
* **Criação e Teste de Aplicação Virtual**: Automatiza a criação de aplicações virtuais no IIS e realiza testes de URL para validar a configuração e acessibilidade.
* **Diagnóstico Abrangente**: Oferece um diagnóstico detalhado do ambiente, fornecendo um resumo percentual da prontidão do servidor para o WebDev/WAS.

### Relação com o WAS Orchestrator Kit v5.1

É crucial entender que o `Setup-WAS-IIS.ps1` e o WAS Orchestrator Kit v5.1 são **complementares**, e não substitutos um do outro. O `Setup-WAS-IIS.ps1` atua como uma ferramenta de **provisionamento e configuração inicial**, garantindo que o ambiente IIS/WAS esteja corretamente instalado e otimizado para o WebDev. Uma vez que essa base é estabelecida, o WAS Orchestrator Kit v5.1 assume o papel de **gerenciamento contínuo**, oferecendo as ferramentas necessárias para monitorar, manter, proteger e garantir a resiliência do ambiente ao longo do tempo.

Em um ciclo de vida típico de um servidor, o `Setup-WAS-IIS.ps1` seria executado uma vez (ou sempre que uma reconfiguração completa fosse necessária) para preparar o ambiente. Posteriormente, o WAS Orchestrator Kit v5.1 seria empregado diariamente para operações como monitoramento de métricas, execução de planos de DR, validação de integridade e gerenciamento de certificados. Juntos, eles fornecem uma solução completa para o ciclo de vida de ambientes IIS/WAS com WebDev.

**Referência:**

[1] Boller, A. J. (2025, 22 de setembro). *SUPER SCRIPT PARA VALIDAR W.A.S. E Ms Internet Information Server (Msiis)*. Fóruns desenvolvedores PC SOFT. Disponível em: [https://forum.pcsoft.fr/fr-FR/pcsoft.br.windev/5311-super-script-para-validar-internet-information-server-msiis/read.awp](https://forum.pcsoft.fr/fr-FR/pcsoft.br.windev/5311-super-script-para-validar-internet-information-server-msiis/read.awp)

--
Adriano José Boller
______________________________________________
Consultor e Representante Oficial da
PcSoft no Brasil
+55 (41) 99949 1800
adrianoboller@gmail.com
skype: adrianoboller
http://wxinformatica.com.br/


# Análise de Completude e Funcionalidades do WAS Orchestrator Kit v5.1

Com base na análise estática dos scripts PowerShell e do arquivo README, o kit WAS Orchestrator v5.1 oferece um conjunto robusto de ferramentas para a manutenção e monitoramento de ambientes IIS (Msiis) e WAS (Windows Activation Service).

## Estrutura do Kit

O kit é organizado da seguinte forma:

* **Bundle/Scripts**: Contém todos os scripts PowerShell principais.
* **Bundle/Config**: Contém arquivos de configuração, como `orchestrator.yaml`.
* **Bundle/Profiles**: Contém perfis para planos de DR, como `DR-Plan.yaml`.
* **Bundle/Docs**: Contém documentação básica, como `README-v5.1.txt`.
* **Bundle/Catalog**: Contém o catálogo SHA256 para validação de integridade, `WAS-CATALOG-SHA256.txt`.

## Análise de Funcionalidades por Script

### `WAS-Orchestrator.ps1`

Este é o script principal, funcionando como um menu interativo para gerenciar as operações. Suas funcionalidades incluem:

* **Controle de Serviços**: Iniciar e parar os serviços IIS (W3SVC) e WAS (serviços `WD*AWP`).
* **Safe Test Mode**: Um modo para abrir portas específicas e desativar o firewall temporariamente para testes, com opção de reversão.
* **Hardening Max**: Configurações de endurecimento para um pool de aplicativos IIS (`WebdevAppPool`), garantindo que ele esteja sempre em execução, sem tempo limite de inatividade ou reinício periódico.
* **Diagnósticos**: Verifica o status dos serviços IIS e WAS, e lista o estado de todos os sites IIS.
* **Execução de DR-Plan**: Invoca o script `DR-Plan.ps1` para executar um plano de recuperação de desastres.
* **Validação de Integridade**: Invoca o script `Validate-Install.ps1` para verificar a integridade dos arquivos do kit.
* **Status do Exporter**: Verifica o status do serviço `WASExporter`.

### `Metrics-Exporter.ps1`

Este script atua como um exportador de métricas no formato Prometheus para monitoramento. Ele expõe um endpoint HTTP (`http://localhost:4900/metrics`) que fornece:

* Status do serviço IIS.
* Status dos serviços WAS.
* Contagem total de sites IIS e status individual de cada site.
* Contagem de bindings HTTPS.
* Status de ativação de protocolos TLS (1.0, 1.1, 1.2, 1.3) via registro do Windows.

### `Metrics-Exporter-Service.ps1`

Gerencia a instalação e o ciclo de vida do `Metrics-Exporter.ps1` como um serviço Windows, utilizando o NSSM (Non-Sucking Service Manager). As ações suportadas são:

* Instalar o serviço.
* Desinstalar o serviço.
* Iniciar o serviço.
* Parar o serviço.
* Reiniciar o serviço.
* Verificar o status do serviço.

### `Metrics-Exporter-Wrapper.ps1`

Um script wrapper que monitora a execução do `Metrics-Exporter.ps1` e o reinicia automaticamente caso ele pare. Isso garante a continuidade da exportação de métricas.

### `DR-Plan.ps1`

Executa um plano de recuperação de desastres definido em um arquivo YAML (`DR-Plan.yaml`). As funcionalidades incluem:

* Inicia um site IIS crítico especificado no plano.
* Opcionalmente, para todos os outros sites IIS.
* Reinicia pools de aplicativos específicos em uma ordem definida.

### `Sign-All.ps1`

Assina digitalmente todos os scripts PowerShell (`.ps1`) do kit usando um certificado Authenticode. Isso é crucial para ambientes com políticas de execução de PowerShell restritivas, garantindo a confiança nos scripts.

### `Validate-Install.ps1`

Valida a integridade dos arquivos do kit comparando seus hashes SHA256 com um catálogo (`WAS-CATALOG-SHA256.txt`). Ele pode:

* Identificar arquivos com hashes diferentes (mismatch).
* Identificar arquivos ausentes.
* Identificar arquivos extras.
* Gerar um relatório HTML detalhado sobre a validação.

### `Load-Config.ps1`

Um script utilitário para carregar configurações de arquivos YAML, como `orchestrator.yaml`. Ele suporta PowerShell 7+ para `ConvertFrom-Yaml` e inclui um fallback para versões anteriores.

### `Orchestrator-API.ps1`

Expõe uma API HTTP local para interagir com as funcionalidades do Orchestrator. Isso permite a automação e integração com outras ferramentas. As rotas incluem:

* `/status`: Retorna o status do IIS e WAS.
* `/start-iis`, `/stop-iis`, `/start-was`, `/stop-was`: Controla os serviços IIS e WAS.
* `/dr`: Executa o plano de DR.
* `/audit`: Executa a validação de instalação.

### `Cert-Watch.ps1`

Gera um inventário de certificados SSL/TLS instalados no sistema, verificando sua validade e emitindo alertas (crítico, aviso, ok) com base nos dias restantes para expiração. Ele pode gerar um relatório HTML.

## Completude e Avaliação Geral

O kit parece ser **muito completo** para a finalidade proposta de manutenção e monitoramento de ambientes IIS/WAS. Ele aborda diversas áreas críticas:

* **Operações Básicas**: Iniciar/parar serviços.
* **Segurança**: Hardening, assinatura de scripts.
* **Monitoramento**: Exportação de métricas para Prometheus, inventário de certificados.
* **Resiliência**: Plano de recuperação de desastres.
* **Automação**: API HTTP para integração.
* **Integridade**: Validação de instalação.

A inclusão de um wrapper para o exportador de métricas e a capacidade de assinar scripts são pontos fortes que indicam uma preocupação com a robustez e segurança do ambiente. A dependência de `ConvertFrom-Yaml` para PowerShell 7+ em alguns scripts é uma consideração importante, mas o `Load-Config.ps1` oferece um fallback básico.

**Pontos Fortes:**

* **Abrangente**: Cobre um amplo espectro de tarefas de manutenção e monitoramento.
* **Modular**: Scripts bem separados por funcionalidade.
* **Automatizável**: A API e os scripts de serviço permitem automação.
* **Seguro**: Assinatura de código e validação de integridade são boas práticas.
* **Monitorável**: Exportação de métricas e inventário de certificados são essenciais para ambientes de produção.

**Possíveis Melhorias/Considerações (sem execução):**

* **Documentação Detalhada**: Embora haja um README, um manual mais aprofundado com exemplos e pré-requisitos seria benéfico (o que será gerado).
* **Gerenciamento de Dependências**: A dependência do NSSM para o serviço do exporter e do PowerShell 7+ para `ConvertFrom-Yaml` deve ser claramente documentada.
* **Configuração Centralizada**: O uso de arquivos YAML para configuração é bom, mas a forma como esses arquivos são gerenciados e distribuídos em um ambiente de produção pode ser explorada.

Em resumo, o kit é uma solução bem pensada e completa para o gerenciamento de ambientes IIS/WAS, oferecendo ferramentas essenciais para operação, segurança e monitoramento.



## Análise do Script Complementar: `Setup-WAS-IIS.ps1`

O script `Setup-WAS-IIS.ps1`, encontrado no fórum da PC SOFT [1], difere significativamente do WAS Orchestrator Kit v5.1 em sua finalidade principal. Enquanto o kit original foca na **manutenção, monitoramento e orquestração** de ambientes IIS/WAS já existentes, o `Setup-WAS-IIS.ps1` é um script de **instalação e configuração completa** do IIS especificamente para o WebDev Application Server (WAS) da PC SOFT. Ele é projetado para preparar um servidor Windows do zero ou para corrigir configurações problemáticas relacionadas à integração do WebDev com o IIS.

**Funcionalidades Principais do `Setup-WAS-IIS.ps1`:**

* **Instalação de Recursos do IIS**: Garante que todos os recursos necessários do IIS para o WebDev/WAS estejam instalados.
* **(Opcional) Criação de Usuário Local Dedicado**: Cria um usuário local (`WebdevAdmin` por padrão) e o adiciona aos grupos `Administrators` e `IIS_IUSRS`, o que é uma prática comum para isolamento de privilégios.
* **Configuração de Application Pool**: Cria e configura um Application Pool com identidade específica.
* **Configuração de ISAPI/Handlers**: Registra os handlers (`.awp`, `.awws`, `.wb`) e o ISAPI do `WDxxAWP.exe` para o WebDev.
* **Permissões NTFS**: Aplica as permissões de sistema de arquivos necessárias nas pastas do IIS/PC SOFT.
* **(Opcional) Correções para DISM**: Tenta corrigir problemas de acesso ao DISM que podem afetar o funcionamento do WAS em alguns ambientes.
* **Criação e Teste de Aplicação Virtual**: Cria uma aplicação virtual no IIS e testa sua URL para verificar a configuração.
* **Diagnóstico Abrangente**: Executa um diagnóstico detalhado com um resumo percentual da prontidão do ambiente.
* **"Guard Rails" e Idempotência**: O script é projetado para ser idempotente (pode ser executado múltiplas vezes sem efeitos colaterais indesejados) e inclui "guard rails" (mecanismos de segurança) para evitar ações arriscadas, a menos que explicitamente habilitadas por switches.

**Diferenças e Complementaridade:**

Característica / Script | WAS Orchestrator Kit v5.1 | `Setup-WAS-IIS.ps1` (do fórum) |
:---------------------------- | :--------------------------------------------------------- | :----------------------------------------------------------- |
**Finalidade Principal** | Manutenção, monitoramento, orquestração de ambientes existentes. | Instalação e configuração inicial do IIS para WebDev/WAS. |
**Foco** | Operações contínuas, segurança, resiliência, automação. | Preparação do ambiente, correção de problemas de instalação. |
**Recursos Chave** | Menu interativo, exportação de métricas, DR-Plan, validação de integridade, API, monitoramento de certificados. | Instalação de componentes IIS, criação de usuário, configuração de handlers, permissões, diagnóstico de prontidão. |
**Público-alvo** | Administradores de sistema, equipes de DevOps. | Desenvolvedores WebDev, administradores que configuram novos servidores ou solucionam problemas de instalação. |


**Conclusão sobre a Complementaridade:**

O `Setup-WAS-IIS.ps1` é um excelente script para a fase inicial de **configuração e validação de um ambiente IIS/WAS para WebDev**. Ele garante que a base esteja corretamente estabelecida. Uma vez que o ambiente esteja configurado e funcionando com sucesso por meio deste script, o **WAS Orchestrator Kit v5.1 entra em cena para gerenciar e monitorar esse ambiente em sua operação diária**. Ou seja, os dois scripts são complementares: o `Setup-WAS-IIS.ps1` prepara o terreno, e o WAS Orchestrator Kit v5.1 mantém o jardim. Não há sobreposição direta de funcionalidades, mas sim uma sequência lógica de uso para um ciclo de vida completo de um ambiente IIS/WAS com WebDev.

**Referência:**

[1] Boller, A. J. (2025, 22 de setembro). *SUPER SCRIPT PARA VALIDAR W.A.S. E Ms Internet Information Server (Msiis)*. Fóruns desenvolvedores PC SOFT. Disponível em: [https://forum.pcsoft.fr/fr-FR/pcsoft.br.windev/5311-super-script-para-validar-internet-information-server-msiis/read.awp](https://forum.pcsoft.fr/fr-FR/pcsoft.br.windev/5311-super-script-para-validar-internet-information-server-msiis/read.awp)

--
Adriano José Boller
______________________________________________
Consultor e Representante Oficial da
PcSoft no Brasil
+55 (41) 99949 1800
adrianoboller@gmail.com
skype: adrianoboller
http://wxinformatica.com.br/