All Products
Search
Document Center

CDN:Client authentication certificates

Last Updated:Apr 01, 2026

By default, HTTPS uses one-way authentication: the client verifies the server's identity. Alibaba Cloud CDN supports client certificate authentication, which lets the server verify the client using a custom Certificate Authority (CA) certificate. This enables mutual authentication and strengthens communication security.

Prerequisites

Before you begin, ensure that you have:

  • Configured an HTTPS certificate for the domain name

  • A custom Client CA Certificate, including the public key

How it works

When you enable client certificate authentication, CDN acts as the server during the TLS handshake. Every incoming HTTPS request must include a client certificate. CDN validates the certificate against the CA certificate you provide:

  • Valid certificate: CDN allows the request through.

  • Invalid certificate: CDN rejects the request.

Enable client certificate authentication

  1. Log on to the CDN console.

  2. In the left navigation pane, click Domain Names.

  3. On the Domain Names page, find the domain name you want to manage and click Manage in the Actions column.

  4. In the left navigation pane for the domain name, click HTTPS.

  5. Enable Client Certificate Authentication, then paste your Client CA Certificate in the field that appears.

    Toggle switch for client certificate authentication

    The certificate must meet the following requirements:

    RequirementDetail
    FormatContent must be enclosed between -----BEGIN CERTIFICATE----- and -----END CERTIFICATE-----
    Line lengthEach line must contain exactly 64 characters, except the last line, which may be shorter

    Client certificate authentication enabled

  6. Click OK.

What's next