Files
shankar0123 21aeed4f4e legal: addlicense headers + normalize legacy variants (Phase 0 RED-4)
Phase 0 closure (Path B2, post-rewrite):

addlicense sweep — adds the canonical certctl LLC copyright + BUSL-1.1
SPDX header to every production Go file. Template:

  // Copyright 2026 certctl LLC. All rights reserved.
  // SPDX-License-Identifier: BUSL-1.1

Coverage: 338 / 338 production Go files (cmd/ + internal/, excluding
*_test.go and **/testdata/**). Pre-sweep coverage was 22 / 338 (6.5%);
post-sweep is 338 / 338 (100%).

Normalized 22 pre-existing legacy headers (`// Copyright (c) certctl`
+ `// SPDX-License-Identifier: BSL-1.1`) and 1 file using a
`Certctl Contributors` attribution. The legacy SPDX ID `BSL-1.1`
is non-standard; the official SPDX identifier for Business Source
License 1.1 is `BUSL-1.1` (capital U). All 338 files now share the
canonical form.

Generated via:
  addlicense -c "certctl LLC" -y 2026 \
    -f cowork/legal/copyright-header.tpl \
    -ignore '**/testdata/**' -ignore '**/*_test.go' \
    cmd/ internal/

Verification:
  find cmd internal -name '*.go' -not -name '*_test.go' \
    -not -path '*/testdata/*' \
    -exec grep -L '^// Copyright 2026 certctl LLC' {} \; | wc -l

  Returns: 0

gofmt clean. Header additions are comments only, no compile impact.

Closes: cowork/certctl-architecture-diligence-audit.html#fix-RED-4
2026-05-13 21:23:35 +00:00

44 lines
1.7 KiB
Go

// Copyright 2026 certctl LLC. All rights reserved.
// SPDX-License-Identifier: BUSL-1.1
package iis
import (
"context"
"fmt"
"github.com/certctl-io/certctl/internal/connector/target"
)
// ValidateOnly — Phase 8 of the deploy-hardening I master bundle.
// IIS already has explicit pre-deploy backup + post-rollback
// re-import semantics in DeployCertificate. Phase 8 adds an
// explicit dry-run via a PowerShell health probe: if the agent
// can run a `Get-WebSite` cmdlet, the IIS PowerShell module is
// loaded and the agent has the right permissions; ValidateOnly
// returns nil. Otherwise it returns the wrapped script error so
// operators can preview a deploy without touching the live cert
// store.
//
// Note: a true cert-bind dry-run would require IIS to expose a
// no-commit `New-WebBinding` mode (it does not). For V2 the
// permission + module probe is the load-bearing safety check.
// V3-Pro can extend this with a temporary cert install + immediate
// remove.
func (c *Connector) ValidateOnly(ctx context.Context, request target.DeploymentRequest) error {
if c.executor == nil {
return target.ErrValidateOnlyNotSupported
}
// Probe `Get-WebSite -Name <SiteName>` to confirm the IIS
// PowerShell module is loaded AND the configured site exists.
// Failure here means the agent isn't on a Windows host with
// IIS installed, the site name is wrong, or the agent is
// running as a user without IIS administration privileges.
script := fmt.Sprintf(`Get-WebSite -Name %q | Select-Object -ExpandProperty Name`, c.config.SiteName)
out, err := c.executor.Execute(ctx, script)
if err != nil {
return fmt.Errorf("IIS ValidateOnly: %w (output: %s)", err, out)
}
return nil
}