Configuring an HTTPS Listener

Last updated: 2021-04-19 16:28:34

    HTTPS Listener Overview

    You can create an HTTPS listener to a CLB instance to forward HTTPS requests from the client. HTTPS is suitable for HTTP applications where data transfer needs to be encrypted.


    You need to create a CLB instance first.

    Configuring an HTTPS Listener

    Step 1. Open the Listener Management tab

    1. Log in to the CLB console.
    2. Select CLB Instance List on the left sidebar.
    3. In the instance list, click an instance ID to enter the details page.
    4. Open the Listener Management tab. You can also enter the page by clicking Configure Listener under the Operation column of an instance.
    5. The "Listener Management" page is as shown below:

    Step 2. Configure a listener

    Click Create in HTTP/HTTPS Listener and configure an HTTPS listener in the pop-up window.

    1. Create a listener

    Configuration Item Description Example
    Name Listener name test-https-443
    Listening protocol and port Listening protocol and port of a listener:
    • Listening protocol: CLB supports various protocols, including TCP, UDP, TCP SSL, HTTP, and HTTPS. HTTPS is used in this example.
    • Listening port: A port used to receive requests and forward them to the real server. Port range: 1 - 65535. These ports are reserved and currently unavailable to users: 843, 1020, 1433, 1434, 3306, 3389, 6006, 20000, 36000, 42222, 48369, 56000, and 65010.
    • Listening ports of each CLB instance must be unique.
    Enable SNI If SNI is enabled, multiple domain names of a listener can be configured with different certificates; if it is disabled, multiple domain names of a listener can be configured with one certificate only. Disabled
    SSL parsing method One-way authentication and mutual authentication are supported One-way authentication
    Server certificate You can select an existing certificate in the SSL certificate service or upload a certificate Select the existing certificate cc/UzxFoXsE

    The specific configuration of the created HTTPS listener is as shown below:

    2. Create a forwarding rule

    Configuration Item Description Example
    Domain name Forwarding domain name:
    • Length: 1 - 80 characters.
    • Underscores (_) cannot be the first character.
    • Exact and wildcard domain names are supported.
    • Regex is supported.
    • For detailed configuration rules, please see Layer-7 Domain Name Forwarding and URL Rules.
    Default domain name
  • If all domain names of the listener are not matched, the system will direct requests to the default domain name, making default access controllable.
  • Each listener can be configured with one default domain name only.
  • Enabled
    HTTP 2.0 After HTTP 2.0 is enabled, CLB instances can receive HTTP 2.0 requests. CLB instances access real servers over HTTP 1.1 no matter what HTTP version the client uses to access CLB instances. Enabled
    URL path Forwarding URL path: /index
    Balancing method For HTTPS listeners, CLB supports three scheduling algorithms: weighted round robin (WRR), weighted least connections (WLC), and IP hash.
    • WRR: Requests are sequentially delivered to different real servers according to their weights. Scheduling is done based on the number of new connections, where servers with higher weights will undergo more polls (i.e., a higher probability), while servers with the same weight process the same number of connections.
    • WLC: Loads of servers are estimated according to the number of active connections to the servers. Scheduling is done based on server loads and weights. If their weights are the same, servers with fewer active connections will undergo more polls (i.e., a higher probability).
    • IP hash: Hash keys are used to locate the corresponding servers in the static hash table based on the source IPs of requests. If a server is available and not overloaded, requests will be delivered to it; otherwise, a null value will be returned.
    Backend protocol Backend protocol is deployed between a CLB instance and a real server:
    • If HTTP is selected as the backend protocol, HTTP service should be deployed on the real server.
    • If HTTPS is selected as the backend protocol, HTTPS service should be deployed on the real server, and the encryption and decryption of the HTTPS service will consume more resources on the real server.
    Getting client IP Enabled by default Enabled
    Gzip compression Enabled by default Enabled

    Select the HTTPS listener for which to create a forwarding rule and click + on the right. The specific configuration is as shown below:

    3. Health check

    Configuration Item Description Example
    Health check status Health check can be enabled or disabled. In HTTPS listeners, CLB instances send HTTPS requests to the specified server port to perform health checks. Enabled
    Check domain name Health check domain name:
    • Length: 1 - 80 characters.
    • It defaults to the forwarding domain name.
    • Regex is not supported. If your forwarding domain name is a wildcard one, you should specify a fixed one (non-regex) as the health check domain name.
    • Supported characters: a-z 0-9 . -. (default value)
    Check path Health check path:
    • Length: 1 - 200 characters.
    • It defaults to / and must start with /.
    • Regex is not supported. We recommend specifying a fixed URL path (static page) for health checks.
    • Supported characters: a-z A-Z 0-9 . - _ / = ?.
    / (default value)
    Response timeout
  • Maximum response timeout for health checks.
  • If a real server fails to respond within the timeout period, the health check is considered abnormal.
  • Value range: 2 - 60 seconds. Default value: 2 seconds.
  • 2 seconds
    Check interval
    • Interval between two health checks.
    • Value range: 5 - 300 seconds. Default value: 5 seconds.
    5 seconds
    Unhealthy threshold
    • If the health check result has been failed for n (a custom value) consecutive times, the real server is unhealthy and Abnormal is displayed in the console.
    • Value range: 2 - 10 times. Default value: 3 times
    3 times
    Healthy threshold
    • If the health check result has been successful for n (a custom value) consecutive times, the real server is healthy and Healthy is displayed in the console.
    • Value range: 2 - 10 times. Default value: 3 times
    3 times
    HTTP request method HTTP request method for health checks. Valid values: GET (default value) and HEAD:
    • If HEAD is used, the server will only return the HTTP header information, which can reduce backend overheads and improve request efficiency. The real server must support HEAD.
    • If GET is used, the real server must support GET.
    HTTP status code check If the status code is of the selected ones, the real server is considered alive (healthy). Value range: http_1xx, http_2xx, http_3xx, http_4xx, and http_5xx. Multiple ones are selected: http_1xx, http_2xx, http_3xx, and http_4xx.

    The specific configuration of health check is as shown below:

    4. Session persistence

    Configuration Item Description Example
    Session persistence status Session persistence can be enabled or disabled:
    • If session persistence is enabled, the CLB listener will deliver access requests from the same client to the same real server.
    • HTTPS session persistence is implemented based on cookies, which are implanted into the client by the CLB instance.
    • Session persistence can be enabled for WRR scheduling but not for WLC or IP hash scheduling.
    Session persistence period Session persistence period:
    • If there is no new request in the connection within the session persistence period, the session will be automatically disconnected.
    • Value range: 30 - 3600 seconds.
    30 seconds

    The specific configuration of session persistence is as shown below:

    Step 3. Bind a real server

    1. On the "Listener Management" page, select the created listener HTTPS:443. Click + on the left to expand the domain names and URL paths, select the desired URL path, and view the real servers bound to the path on the right of the listener.
    2. Click Bind, select the target real server, configure the server port and weight in the pop-up window.
      ① Add port: In the "Selected" box on the right, click Add Port to add multiple ports for the same CVM instance, such as ports 80, 81, and 82.
      ② Default port: Enter the Default Port first and then select the CVM instance. The port of every CVM instance is the default port.

    After these three steps are completed, the HTTPS listener rule has been configured as shown below:

    Step 4. Security group (optional)

    You can configure a CLB security group to isolate public network traffic. For more information, see CLB Security Group Configuration.

    Step 5. Modify and delete a listener (optional)

    If you need to modify or delete a created listener, click the listener/domain name/URL path on the Listener Management tab and select Modify or Delete.