Skip to main content

Adding and Managing Listeners

This guide explains how to add listeners to load balancers, view the listener list, modify information, set rules and conditions, and manage listeners.

Add Listener​

Add HTTP Listener​

  1. Go to the KakaoCloud Console > Beyond Networking Service > Load Balancing > Load Balancers menu.

  2. Select the load balancer where you want to add an HTTP listener from the Load Balancer list.

  3. In the detail screen, click the Listener tab and then click the [Add Listener] button.

  4. In the Add Listener pop-up window, select the HTTP protocol and modify the port if necessary.

  5. Select the Default Forwarding Target and click the [Add] button.

Add HTTPS Listener​

  1. Go to the KakaoCloud Console > Beyond Networking Service > Load Balancing > Load Balancers menu.

  2. Select the load balancer where you want to add an HTTPS listener from the Load Balancer list.

  3. In the detail screen, click the Listener tab and then click the [Add Listener] button.

  4. In the Add Listener pop-up window, select the HTTPS protocol and modify the port if necessary.

  5. Select the Default Forwarding Target and Minimum TLS Version.

  6. Choose the Default SSL Certificate. If a certificate is already registered, select it. If not, click the dropdown button and then click the [Add New Certificate] button to go to Certificate Manager and register a new certificate.

Supported Cipher Suites by Minimum TLS Version​
Minimum TLS VersionTLSv1.0TLSv1.1TLSv1.2
TLS Protocol
TLSv1.0v
TLSv1.1vv
TLSv1.2vvv
Cipher Suite
ECDHE-RSA-AES128-GCM-SHA256v
ECDHE_RSA_AES128_CBC_SHAvvv
ECDHE-RSA-AES128-SHA256v
ECDHE-RSA-AES256-GCM-SHA384v
ECDHE_RSA_AES256_CBC_SHAvvv
ECDHE-RSA-AES256-SHA384v
AES128-GCM-SHA256v
AES128-SHAvvv
AES128-SHA256v
AES256-GCM-SHA384v
AES256-SHAvvv
AES256-SHA256v
CAMELLIA128-SHAvvv
CAMELLIA256-SHAvvv
DHE-RSA-AES128-GCM-SHA256v
DHE-RSA-AES128-SHAvvv
DHE-RSA-AES128-SHA256v
DHE-RSA-AES256-GCM-SHA384v
DHE-RSA-AES256-SHAvvv
DHE-RSA-AES256-SHA256v
DHE-RSA-CAMELLIA128-SHAvvv
DHE-RSA-CAMELLIA256-SHAvvv
ECDHE_ECDSA_AES128_SHAvvv
info

Once the listener is added, you can connect a target group via Listener Settings. If the default forwarding target is set to "None," errors will occur when accessing the service externally. Please connect a target group for smooth service operation.

View Listener​

In the load balancer detail screen, you can modify or delete existing listeners or add new listeners.

View Listener List​

  1. Go to the KakaoCloud Console > Beyond Networking Service > Load Balancing > Load Balancers menu.

  2. Select the load balancer whose listener list you want to view from the Load Balancer list.

  3. In the detail screen, click the Listener tab to view the list of listeners connected to the load balancer.

    ItemDescription
    Protocol:PortListener's protocol and port
    IDThe ID assigned at creation
    Provisioning StatusInformation on whether the listener was successfully created or is being modified or deleted
    Operational StatusInformation on whether the listener is in a usable state
    Minimum TLS VersionSecurity policy used for HTTPS communication between the client and the load balancer
    Default SSL CertificateCertificate used for HTTPS communication between the client and the load balancer
    Default ActionThe default action for handling incoming traffic to the listener. It is fixed to Forward.
    - If a target group is connected, the target group name is shown
    RulesNumber of rules added. One rule is applied by default
    [More options] IconProvides options for listener settings and deletion

View Listener Details​

  1. Go to the KakaoCloud Console > Beyond Networking Service > Load Balancing > Load Balancers menu.

  2. Select the load balancer whose listener details you want to view.

  3. In the load balancer detail screen, click the Listener tab and then select the listener whose details you want to view.

    Image Listener Details

    CategoryItemDescription
    RulesRule OrderThe order in which the rule is applied (lower numbers are applied first)
    ConditionWhen a rule has multiple conditions, it operates with AND for conditions within the rule and OR for conditions between rules. The rule applies when the final condition is TRUE.
    ActionThe action that occurs when the rule is applied
    Edit IconClick to open the rule edit pop-up window
    Delete IconClick to open the rule delete pop-up window
    AttributesHTTP/2Fixed to HTTP/2 not used
    Idle TimeoutIdle timeout setting
    X-Forwarded-For Header HandlingOptions for handling X-Forwarded-For header: Attach, Preserve, Delete
    X-Forwarded-Port ForwardingWhether to forward the X-Forwarded-Port header
    X-Forwarded-Proto ForwardingWhether to forward the X-Forwarded-Proto header
    Maximum Connection SettingDisplays the maximum value when enabled
    Certificate InformationDefaultWhether it is the default certificate
    Certificate IDThe ID assigned to the certificate upon registration
    DomainThe domain of the certificate
    Registration DateThe date the certificate was registered
    Expiration DateThe expiration date of the certificate
    Disconnect IconClick to open the disconnect pop-up window

Manage Listener​

Change Target Group​

  1. Go to the KakaoCloud Console > Beyond Networking Service > Load Balancing > Load Balancers menu.

  2. Select the load balancer that contains the listener you want to modify from the Load Balancer list.

  3. Click the Listener tab and then click the [More options] icon for the listener you want to modify.

  4. In the [More options] menu, select Listener Settings.

  5. In the Listener Settings pop-up window, select the target group you want to change and click [Save].

Set Minimum TLS Version​

If the listener protocol is set to HTTPS, you can set the minimum TLS version.

  1. Go to the KakaoCloud Console > Beyond Networking Service > Load Balancing > Load Balancers menu.

  2. Select the load balancer that contains the listener you want to modify from the Load Balancer list.

  3. In the detail screen, click the Listener tab and then click the [More options] icon for the listener you want to modify.

  4. In the [More options] menu, select Listener Settings.

  5. In the Minimum TLS Version section, select the version from the list and click [Save].

Change Default Certificate from All Certificates​

If the listener protocol is HTTPS, you must connect a default certificate. You can change the default certificate to another one among the connected certificates.

  1. Go to the KakaoCloud Console > Beyond Networking Service > Load Balancing > Load Balancers menu.

  2. Select the load balancer that contains the listener whose certificate you want to change.

  3. In the detail screen, click the Listener tab and then click the [More options] icon for the listener you want to modify.

  4. In the [More options] menu, select Listener Settings.

  5. In the Listener Settings modal, choose the certificate from the Default SSL Certificate list and click [Confirm].

caution

If there are no connected certificates or all certificates have been deleted, you cannot change the default certificate. Please add a certificate in Certificate Manager and retry.

Add Additional Certificates​

If the listener protocol is HTTPS, you can add up to 5 additional certificates excluding the default certificate.

  1. Go to the KakaoCloud Console > Beyond Networking Service > Load Balancing > Load Balancers menu.

  2. Select the load balancer that contains the listener you want to modify from the Load Balancer list.

  3. In the detail screen, click the Listener tab and then click the listener to which you want to add certificates.

  4. In the listener detail screen, click the [Add Certificate] button.

    ItemDescription
    Select Existing CertificateClick the dropdown button and select an existing certificate
    New Certificate1. Click the dropdown button and then click [Add New Certificate].
    2. In the certificate registration pop-up, enter the necessary information and click [Add].
    3. From the SSL certificate list, select the newly added certificate.

    Image Add Certificate to Listener

    Image Add New Certificate

  5. In the Add Certificate pop-up window, select the SSL certificate to connect.

  6. Click the [Connect] button.

Disconnect Certificate​

If the listener protocol is HTTPS, you can disconnect all certificates except the default certificate.

  1. Go to the KakaoCloud Console > Beyond Networking Service > Load Balancing > Load Balancers menu.

  2. Select the load balancer that contains the listener you want to modify from the Load Balancer list.

  3. In the detail screen, click the Listener tab and then click the expand button on the left of the displayed listener.

  4. If two or more certificates are connected under the [SSL Certificate] section, a [Disconnect] button will appear at the top right. You can disconnect certificates other than the default certificate.

  5. Check all the certificates you want to disconnect (excluding the default certificate) and click the [Disconnect] button.

  6. In the Disconnect Certificate modal, click [Disconnect].

caution

If any disconnected certificates are in a deleted state, please check all those certificates (except the default one) and try disconnecting them at once.

Set or Remove Maximum Connection Limit​

If the listener protocol is HTTP or HTTPS, you can set or remove the maximum connection limit.

  1. Go to the KakaoCloud Console > Beyond Networking Service > Load Balancing > Load Balancers menu.

  2. Select the load balancer that contains the listener you want to modify from the Load Balancer list.

  3. In the detail screen, click the Listener tab and then click the listener to which you want to apply the maximum connection limit.

  4. In the listener detail screen, click the [Set Maximum Connections] button at the top of the properties section.

  5. In the Maximum Connections pop-up window, make changes.

    • To set a limit: Enable the maximum connection option and enter the maximum allowed value (1-2,147,483,647).
    • To remove the limit: Disable the maximum connection option.

    Image Set Maximum Connections for Listener

  6. Click [Apply].

Set Idle Timeout​

  1. Go to the KakaoCloud Console > Beyond Networking Service > Load Balancing > Load Balancers menu.

  2. Select the load balancer that contains the listener you want to modify from the Load Balancer list.

  3. In the detail screen, click the Listener tab and then click the listener to modify the idle timeout.

  4. In the listener detail screen, click the [Set Properties] button at the top of the properties section.

  5. In the Listener Property Settings pop-up, modify the idle timeout.

    • Idle Timeout: Enter a value between 1 and 4000 (default: 50 seconds).

  6. Click the [Save] button.

Set Packet (X-Forwarded-For Header)​

  1. Go to the KakaoCloud Console > Beyond Networking Service > Load Balancing > Load Balancers menu.

  2. Select the load balancer that contains the listener you want to modify from the Load Balancer list.

  3. In the detail screen, click the Listener tab and then click the listener to modify the packet settings.

  4. In the listener detail screen, click the [Set Properties] button at the top of the properties section.

  5. In the Listener Property Settings pop-up, modify the packet settings.

    • X-Forwarded-For Header Processing
      Attach: Choose Attach to forward the client IP addresses stored in the X-Forwarded-For header.
      Preserve: Choose Preserve to leave the X-Forwarded-For header unchanged when forwarded.
      Delete: Choose Delete to remove the X-Forwarded-For header before forwarding.
    • X-Forwarded-Port Forwarding
      Turn on if you want to forward the port in the header.
      Turn off if you don't want to forward the port.
    • X-Forwarded-Proto Forwarding
      Turn on to forward the protocol in the header.
      Turn off to not forward the protocol.

    Image Set Listener Properties

  6. Click the [Save] button.

Delete Listener​

  1. Go to the KakaoCloud Console > Beyond Networking Service > Load Balancing > Load Balancers menu.

  2. Select the load balancer that contains the listener you want to delete from the Load Balancer list.

  3. In the detail screen, click the Listener tab.

  4. Click the [More options] icon for the listener you want to delete.

  5. In the [More options] menu, select Delete Listener.

  6. In the Delete Listener pop-up window, enter the confirmation text and click the [Delete] button.

Add ALB Rules​

ALB rules are only used in ALB listeners (HTTP, HTTPS) and define how the Application Load Balancer routes traffic to multiple targets within a target group.
One rule is automatically created when a listener is created, and this rule is applied last.

  1. Go to the KakaoCloud Console > Beyond Networking Service > Load Balancing > Load Balancers menu.

  2. Select the load balancer for which you want to add ALB rules.

  3. In the detail screen, click the Listener tab.

  4. Select the listener to which you want to add rules, then click the [Add Rule] button.

  5. In the Add Rule pop-up window, set the order, conditions, and actions of the rule.

    Image Add Listener Rule

    Condition Types​
    TypeComparison ModeKey ConditionValue Condition
    Host-HeaderMatch or Not MatchNo input requiredMust input
    - Maximum 63 characters excluding domain after dot
    - Supports uppercase/lowercase letters, numbers, and some special characters (-, .)
    PathContains, Does not contain, Matches, Does not match, Starts with, Does not start with, Ends with, Does not end withNo input requiredMust input
    - 1-255 characters
    - Supports uppercase/lowercase letters, numbers, and some special characters (-, _, ., /)
    HTTP-HeaderContains, Does not contain, Matches, Does not match, Starts with, Does not start with, Ends with, Does not end withMust input
    - 1-255 characters
    - Supports uppercase/lowercase letters, numbers, and some special characters (-, _)    		Must input
    - 1-255 characters
    - Supports uppercase/lowercase letters, numbers, and some special characters ((, ), -, =, *, ., ?, ;, +, :, &, _)
    File TypeMatch or Not MatchNo input requiredMust input
    - 1-255 characters
    - Supports uppercase/lowercase letters, numbers, and special characters (!, @, #, $, %, ^, &, {, }, _, +, -, =, ,, ., ~, ')
    CookieContains, Does not contain, Matches, Does not match, Starts with, Does not start with, Ends with, Does not end withMust input
    - 1-32 characters
    - Supports uppercase/lowercase letters, numbers, and some special characters (-, _)    		Must input
    - 1-255 characters
    - Supports uppercase/lowercase letters, numbers, and some special characters (-, /, +, =, _, ., \)
    Rule Actions​
    Action TypeSettings
    ForwardTarget Group Settings
    - HTTP: HTTP, PROXY
    - HTTPS: HTTP
    Redirect to URLProtocol Settings
    - HTTP: HTTP, HTTPS
    - HTTPS: HTTPS

    URL: Max 247 characters

    Response Code
    - 301: Moved Permanently
    - 302: Found (Default)
    - 303: See Other
    - 307: Temporary Redirect
    Redirect PrefixProtocol Settings
    - HTTP: HTTP, PROXY
    - HTTPS: HTTPS

    URL: Max 247 characters

    Response Code
    - 301: Moved Permanently
    - 302: Found (Default)
    - 303: See Other
    - 307: Temporary Redirect

  6. In Condition Settings, set the condition type, key, value, and comparison method. If necessary, click the [Add Condition] button to add more conditions, or click the delete icon next to a condition to remove it.

  7. In Action Settings, choose the action type and enter the corresponding settings, then click [Add].

Manage ALB Rules​

View Rules​

  1. Go to the KakaoCloud Console > Beyond Networking Service > Load Balancing > Load Balancers menu.

  2. Select the load balancer whose ALB listener rules you want to manage from the Load Balancer list.

  3. In the detail screen, click the Listener tab.

  4. Click the listener whose rules you want to view.

    ItemDescription
    Rule OrderThe order in which the rules are applied; the lower the number, the earlier the rule is applied.
    ConditionIf a rule has multiple conditions, it works with AND within a rule and OR between rules. The rule applies when the final condition is evaluated as TRUE.
    ActionThe action that occurs when the rule is applied.

Set Rule Order​

You can change the order of rules, except for the last automatically created rule.

  1. Go to the KakaoCloud Console > Beyond Networking Service > Load Balancing > Load Balancers menu.

  2. Select the load balancer whose ALB listener rules you want to manage from the Load Balancer list.

  3. In the detail screen, click the Listener tab.

  4. Select the listener whose rule order you want to change.

  5. In the listener detail screen, click the [Set Rule Order] button.

  6. In the Set Rule Order pop-up window, change the order and click [Save].

Modify Rule​

You can modify rules, except for the last automatically created rule.

  1. Go to the KakaoCloud Console > Beyond Networking Service > Load Balancing > Load Balancers menu.

  2. Select the load balancer whose ALB listener rules you want to manage from the Load Balancer list.

  3. In the detail screen, click the Listener tab.

  4. Select the listener whose rule you want to modify.

  5. In the listener detail screen, click the [Edit] icon for the rule you want to modify.

  6. In the Modify Rule pop-up window, modify the information and click [Confirm].

Delete Rule​

  1. Go to the KakaoCloud Console > Beyond Networking Service > Load Balancing > Load Balancers menu.

  2. Select the load balancer whose ALB listener rules you want to manage from the Load Balancer list.

  3. In the detail screen, click the Listener tab.

  4. Select the listener whose rule you want to delete.

  5. In the listener detail screen, click the [Delete] icon for the rule you want to delete.

  6. In the Delete Rule pop-up window, click [Delete].