---
title: Charmhub | Deploy TLS Certificates Requirer using Charmhub - The Open Operator
  Collection
description: Deploy the latest version of TLS Certificates Requirer on any cloud.
url: https://charmhub.io/tls-certificates-requirer/configurations
---

# TLS Certificates Requirer

[Canonical Telco](https://charmhub.io/publisher/telco-charmers "View all packages from Canonical Telco")

* [Canonical Telco](https://charmhub.io/publisher/telco-charmers "View all packages from Canonical Telco")

Platform:

22.04

stable 142

```
juju deploy tls-certificates-requirer
```

[Learn to deploy on juju >](https://juju.is/docs/juju/manage-applications)

* [common\_name](https://charmhub.io/tls-certificates-requirer/configurations#common_name)
* [country\_name](https://charmhub.io/tls-certificates-requirer/configurations#country_name)
* [email\_address](https://charmhub.io/tls-certificates-requirer/configurations#email_address)
* [is\_ca](https://charmhub.io/tls-certificates-requirer/configurations#is_ca)
* [locality\_name](https://charmhub.io/tls-certificates-requirer/configurations#locality_name)
* [mode](https://charmhub.io/tls-certificates-requirer/configurations#mode)
* [num\_certificates](https://charmhub.io/tls-certificates-requirer/configurations#num_certificates)
* [organization\_name](https://charmhub.io/tls-certificates-requirer/configurations#organization_name)
* [sans\_dns](https://charmhub.io/tls-certificates-requirer/configurations#sans_dns)
* [state\_or\_province\_name](https://charmhub.io/tls-certificates-requirer/configurations#state_or_province_name)

[Learn about configurations >](https://juju.is/docs/juju/configuration#heading--application-configuration)

* common\_name | string

  This configuration option should not be set when `num_certificates` is greater than 1.
  Common name to be used in the certificate.
  If set, only the leader unit will request the certificate with this common name.
  Other units will not request certificates.
  If not set, the following value will be used (depending on the mode):

  + `unit`: `cert-<certificate number>.unit-<unit number>.<app name>.<model name>`
  + `app`: `cert-<certificate number>.<app name>.<model name>`
* country\_name | string

  Country name to be used in the certificate.
  If not set, no country name will be used.
* email\_address | string

  Email address to be used in the certificate.
  If not set, no email address will be used.
* is\_ca | boolean

  If set to true, the charm will request a certificate that can be used as a Certificate Authority (CA).
* locality\_name | string

  Locality name to be used in the certificate.
  If not set, no locality name will be used.
* mode | string

  Default: unit

  Mode in which the charm will request the certificate.
  Allowed values:

  + `unit`: Certificates are managed at the unit level. Each unit will have its own certificate.
  + `app`: Certificates are managed at the application level. The application can have 1 or more certificates.
* num\_certificates | int

  Default: 1

  Number of certificates to request.
  If the mode is set to `unit`, each unit will request this number of certificates.
* organization\_name | string

  Organization name to be used in the certificate.
  If not set, no organization name will be used.
* sans\_dns | string

  If set, only the leader unit will request the certificate with this list of DNS Subject Alternative Names (SAN's).
  Other units will not request certificates.
  Comma separated list of DNS Subject Alternative Names (SAN's) to be used in the certificate.
  If not set, the following value will be used (depending on the mode):

  + `unit`: `cert-<certificate number>.unit-<unit number>.<app name>.<model name>`
  + `app`: `cert-<certificate number>.<app name>.<model name>`
* state\_or\_province\_name | string

  State or province name to be used in the certificate.
  If not set, no state or province name will be used.