Step 6: Create TLS certificates

You are currently viewing version 1.5 of the Apigee hybrid documentation. This version is end of life. You should upgrade to a newer version. For more information, see Supported versions.

Version 1.5 (unsupported)

   Supported versions:

• v1.15 (latest)                        
• v1.14                        
• v1.13                         
• List of supported versions

   Unsupported versions:

• v1.12                         
• v1.11                         
• v1.10                                      
• v1.9                                         
• v1.8                                         
• v1.7                                         
• v1.6                                         
• v1.5                                         
• v1.4                                         
• v1.3                                         
• v1.2                                         
• v1.1                                         

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 is used to generate the self-signed credentials.

Note: In a production environment, you will need to use signed certificates. You can either 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.

In this step, you will create the TLS credential files and add them to the base_directory/hybrid-files/certs directory. In Step 7: Configure the hybrid runtime, you will add the file paths to the cluster configuration file.

1. Be sure that you are in the base_directory/hybrid-files directory you configured in Set up the project directory structure.
2. Make sure to save a domain name to the DOMAIN environment variable using the following command:

   echo $DOMAIN

3. Execute the following command from inside the hybrid-files directory:

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

   Where DOMAIN is the same one you used for your environment in Part 1, Step 5: Create an environment group.

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

4. Check to make sure the files are in the ./certs directory using the following command:

   ls ./certs
     keystore.pem
     keystore.key

   Where keystore.pem is the self-signed TLS certificate file and keystore.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 2 3 4 5 6 (NEXT) Step 7: Configure the hybrid runtime 8 9