# WithGatewayTlsIssuer

- Module: [Aspire.Hosting.Kubernetes](/reference/api/go/aspire.hosting.kubernetes.md)
- Version: `13.6.5-preview.1.26559.7`
- Kind: `method`
- Defined on: [`KubernetesGatewayResource`](/reference/api/go/aspire.hosting.kubernetes/kubernetesgatewayresource.md)
- Source: [GitHub](https://github.com/microsoft/aspire/tree/b33d222049f1ecc3bc7257ec07b622fe550b2580)

Adds an HTTPS listener to the gateway and wires it to the supplied cert-manager `ClusterIssuer`. This adds the `cert-manager.io/cluster-issuer` annotation to the generated Gateway resource, causing cert-manager to provision and renew a certificate for each gateway listener hostname.

## Remarks

Equivalent to calling `WithTls()` followed by
`WithGatewayAnnotation("cert-manager.io/cluster-issuer", issuer.Resource.Name)`,
but type-safe and refactor-friendly. Throws if the gateway and the issuer's
cert-manager installation are not part of the same Kubernetes environment, since
cert-manager is per-cluster and would otherwise silently produce an unsatisfiable
TLS configuration.

## Definition

```go
func (KubernetesGatewayResource) WithGatewayTlsIssuer(issuer CertManagerIssuerResource) KubernetesGatewayResource
```

## Parameters

- `issuer` ([`CertManagerIssuerResource`](/reference/api/go/aspire.hosting.kubernetes/certmanagerissuerresource.md)) -- The cert-manager `ClusterIssuer` to issue certificates from.

## Returns

[`KubernetesGatewayResource`](/reference/api/go/aspire.hosting.kubernetes/kubernetesgatewayresource.md) -- The resource builder.

Returns a handle; failures surface later via `Err()`.

## Applies to

- [`KubernetesGatewayResource`](/reference/api/go/aspire.hosting.kubernetes/kubernetesgatewayresource.md)
