> [!CAUTION]
> You are currently viewing version 1.11 of the Apigee hybrid documentation. **This version is end of life.** You should upgrade to a newer version. For more information, see [Supported versions](https://docs.cloud.google.com/apigee/docs/hybrid/supported-platforms.md.txt#supported-versions).

<button class="button button-with-icon cloud-select-dropdown__button button-primary" aria-haspopup="true">Version 1.11 </button>

- Supported versions:
- [v1.17 (latest)](https://docs.cloud.google.com/apigee/docs/hybrid/v1.17/install-create-tls-certificates.md.txt)
- [v1.16](https://docs.cloud.google.com/apigee/docs/hybrid/v1.16/install-create-tls-certificates.md.txt)
- [v1.15](https://docs.cloud.google.com/apigee/docs/hybrid/v1.15/install-create-tls-certificates.md.txt)
- [v1.14](https://docs.cloud.google.com/apigee/docs/hybrid/v1.14/install-create-tls-certificates.md.txt)
- [List of supported versions](https://docs.cloud.google.com/apigee/docs/hybrid/supported-platforms.md.txt#supported-versions)
- Unsupported versions:
- [v1.13](https://docs.cloud.google.com/apigee/docs/hybrid/v1.13/install-create-tls-certificates.md.txt)
- [v1.12](https://docs.cloud.google.com/apigee/docs/hybrid/v1.12/install-create-tls-certificates.md.txt)
- [v1.11](https://docs.cloud.google.com/apigee/docs/hybrid/v1.11/install-create-tls-certificates.md.txt)
- [v1.10](https://docs.cloud.google.com/apigee/docs/hybrid/v1.10/install-create-tls-certificates.md.txt)
- [v1.9](https://docs.cloud.google.com/apigee/docs/hybrid/v1.9/install-create-tls-certificates.md.txt)
- [v1.8](https://docs.cloud.google.com/apigee/docs/hybrid/v1.8/install-create-tls-certificates.md.txt)
- [v1.7](https://docs.cloud.google.com/apigee/docs/hybrid/v1.7/install-create-tls-certificates.md.txt)
- [v1.6](https://docs.cloud.google.com/apigee/docs/hybrid/v1.6/install-create-tls-certificates.md.txt)
- [v1.5](https://docs.cloud.google.com/apigee/docs/hybrid/v1.5/install-create-tls-certificates.md.txt)
- [v1.4](https://docs.cloud.google.com/apigee/docs/hybrid/v1.4/install-create-tls-certificates)
- [v1.3](https://docs.cloud.google.com/apigee/docs/hybrid/v1.3/install-create-tls-certificates)
- [v1.2](https://docs.cloud.google.com/apigee/docs/hybrid/v1.2/install-create-tls-certificates)
- [v1.1](https://docs.cloud.google.com/apigee/docs/hybrid/v1.1/install-create-tls-certificates)

This step explains how to create the TLS credentials
that are required for Apigee hybrid to operate.

## Create TLS certificates


You are required to provide TLS certificates for the runtime ingress gateway in your
Apigee hybrid configuration. For the purpose of this quickstart (a non-production trial installation),
the runtime gateway can accept self-signed credentials. In the following steps,
[openssl](https://www.openssl.org/) is used to generate the self-signed credentials.

> [!NOTE]
> **Note:** In a production environment, you will need to use signed certificates. You can use either a certificate and key pair or a Kubernetes secret. For an example on how to obtain a TLS certificate from the *Lets Encrypt* certificate authority (CA), see [Obtain TLS credentials: An example](https://docs.cloud.google.com/apigee/docs/hybrid/v1.11/lets-encrypt.md.txt).


In this step, you will create the TLS credential files and add them to
the `$HYBRID_FILES/certs` directory.
In [Step 6: Configure the cluster](https://docs.cloud.google.com/apigee/docs/hybrid/v1.11/install-configure-cluster.md.txt), you will add the file paths to the cluster
configuration file.

1. Execute the following command to create the credential files and store them in your `$HYBRID_FILES/certs` directory:

   ```
   openssl req  -nodes -new -x509 -keyout $HYBRID_FILES/certs/keystore_$ENV_GROUP.key -out \
       $HYBRID_FILES/certs/keystore_$ENV_GROUP.pem -subj '/CN='$DOMAIN'' -days 3650
   ```


   Where:
   - <var translate="no">DOMAIN</var> is the domain you provided as the hostname for the environment group you created in [Create an environment group](https://docs.cloud.google.com/apigee/docs/hybrid/v1.11/precog-add-environment.md.txt#create-an-environment-group).
   - <var translate="no">ENV_GROUP</var> is the name of the environment group where the domain is specified as a hostname. It's a good practice to include the environment group name in the key and keystore name to avoid accidentally reusing the same domain value if you create keys for multiple environment groups.


   This command creates a self-signed certificate/key pair that you can use for the quickstart
   installation.


   If you have additional environment groups with unique domain names, repeat this step
   for each environment group. You will reference these groups and certificates in the cluster
   configuration step.
2. Check to make sure the files are in the `$HYBRID_FILES/certs` directory using the following command:

   ```
   ls $HYBRID_FILES/certs
   ```

   ```
    keystore_ENV_GROUP.key
    keystore_ENV_GROUP.pem
   ```


   Where `keystore_ENV_GROUP.pem` is the self-signed TLS certificate file and `keystore_ENV_GROUP.key`
   is the key file.


You now have the credentials needed to manage Apigee hybrid
in your Kubernetes cluster. Next, you will create a file that is used by Kubernetes
to deploy the hybrid runtime components to the cluster.
[1](https://docs.cloud.google.com/apigee/docs/hybrid/v1.11/install-create-cluster.md.txt) [2](https://docs.cloud.google.com/apigee/docs/hybrid/v1.11/install-cert-manager.md.txt) [3](https://docs.cloud.google.com/apigee/docs/hybrid/v1.11/install-apigeectl.md.txt) [4](https://docs.cloud.google.com/apigee/docs/hybrid/v1.11/install-service-accounts.md.txt) [5](https://docs.cloud.google.com/apigee/docs/hybrid/v1.11/install-create-tls-certificates.md.txt) [(NEXT) Step 6: Configure the cluster](https://docs.cloud.google.com/apigee/docs/hybrid/v1.11/install-configure-cluster.md.txt) [7](https://docs.cloud.google.com/apigee/docs/hybrid/v1.11/install-enable-synchronizer-access.md.txt) [8](https://docs.cloud.google.com/apigee/docs/hybrid/v1.11/install-check-cluster.md.txt) [9](https://docs.cloud.google.com/apigee/docs/hybrid/v1.11/install-hybrid-runtime.md.txt) [10](https://docs.cloud.google.com/apigee/docs/hybrid/v1.11/install-workload-identity.md.txt)

<br />