Tüm Ürünler
Search
Belge Merkezi

ApsaraMQ for Kafka:Update the SSL certificate algorithm

Son Güncelleme:Oct 06, 2026

İnternet erişimine sahip ApsaraMQ for Kafka örnekleri, istemci-aracı iletişimini şifrelemek için SSL sertifikaları kullanır. Varsayılan olarak SSL sertifikası anahtar boyutu 1.024 bittir. Güvenliği artırmak için anahtar boyutunu 4.096 bite yükseltebilirsiniz.

Yükseltme işlemi iki aşamalıdır: önce tüm istemcilerdeki sertifikayı değiştirin, ardından konsoldaki anahtar boyutunu değiştirin.

Not

ApsaraMQ for Kafka konsolundaki örnek ayrıntıları sayfasında SSL sertifikası anahtar boyutunu değiştirmek, mevcut istemcilerin kullanılamaz hale gelmesine neden olur. Yükseltmeden önce bu konuda açıklandığı gibi yeni sertifikayı indirin, istemci sertifika yapılandırmalarını güncelleyin ve istemcileri yeniden başlatın.

Serverless örnekler varsayılan olarak 4.096 bit anahtar boyutu kullanır. Bu değer değiştirilemez. Aşağıdaki talimatlar yalnızca serverless olmayan örnekler için geçerlidir.

Ön koşullar

Başlamadan önce aşağıdakileri yaptığınızdan emin olun:

  • Satın alınan ve dağıtılan, İnternet erişimli bir ApsaraMQ for Kafka örneğinin Running durumunda olması

  • ApsaraMQ for Kafka konsoluna erişiminizin olması

Çalışma mantığı

Bir ApsaraMQ for Kafka örneğinde İnternet erişimini etkinleştirdiğinizde sistem SSL ile ilgili bağlantı noktalarını başlatır ve bir SSL sertifikası atar. Mevcut anahtar boyutunu Instance Details sayfasının Configurations bölümünde görüntüleyebilirsiniz.

1.024 bitten 4.096 bite yükseltme işlemi iki aşamadan oluşur:

  1. İstemci tarafı -- Hem 1.024 bit hem de 4.096 bit sertifikaları içeren bir geçiş sertifikası indirin, her bir istemciye dağıtın ve istemcileri yeniden başlatın.

  2. Sunucu tarafı -- Konsoldaki SSL Certificate Key Size (Bits) parametresini 4.096 olarak değiştirin.

Geçiş sertifikası (Java için mix.4096.client.truststore.jks, diğer diller için mix-4096-ca-cert) her iki anahtar boyutuyla da uyumludur. Bu sayede konsolda hala 1.024 gösteriliyor olsa bile veya zaten 4.096'ya geçilmiş olsa bile istemciler bağlı kalır.

Adım 1: SSL sertifikasını indirme

Dağıtım durumunuza ve programlama dilinize uygun sertifika dosyasını seçin.

Java istemcileri


Mevcut durum


Sertifika dosyası


Açıklama


Yeni örnek (henüz dağıtılmadı)


only.4096.client.truststore.jks


Yalnızca 4.096 bit sertifika


1.024 bit anahtara sahip dağıtılmış örnek


kafka.client.truststore.jks


1.024 bit sertifika


1.024 bitten 4.096 bite yükseltme


mix.4096.client.truststore.jks


Hem 1.024 bit hem de 4.096 bit sertifikalar

Java dışı istemciler


Mevcut durum


Sertifika dosyası


Açıklama


Yeni örnek (henüz dağıtılmadı)


only-4096-ca-cert


Yalnızca 4.096 bit sertifika


1.024 bit anahtara sahip dağıtılmış örnek


ca-cert.pem


1.024 bit sertifika


1.024 bitten 4.096 bite yükseltme


mix-4096-ca-cert


Hem 1.024 bit hem de 4.096 bit sertifikalar

Java dışı sertifika indirme bağlantıları için bkz. Genel Bakış konusundaki "SDKs" bölümü.

Not

Anahtar boyutu yükseltmesi için mix sertifikasını kullanın. Hem 1.024 bit hem de 4.096 bit anahtar boyutlarını desteklediğinden istemciler geçiş süreci boyunca bağlı kalır.

Adım 2: Sertifikayı değiştirme ve istemcileri yeniden başlatma

  1. İndirilen sertifika dosyasını istemcinizdeki SSL sertifika dizinine kopyalayın.

  2. Yeni sertifika dosyasına başvuracak şekilde istemci yapılandırmasını güncelleyin. Java istemcileri -- Kafka istemci yapılandırmanızda ssl.truststore.location özelliğini ayarlayın: Java dışı istemciler -- Yeni CA sertifika dosyasını işaret edin. Örneğin, confluent-kafka kullanan Python istemcileri için:

       ssl.truststore.location=/path/to/mix.4096.client.truststore.jks
       conf = {
           'bootstrap.servers': '<your-endpoint>',
           'security.protocol': 'SSL',
           'ssl.ca.location': '/path/to/mix-4096-ca-cert',
       }
  3. Yeni sertifikayı yüklemek için istemciyi yeniden başlatın.

  4. İnternet üzerinden örneğe bağlanan tüm istemciler için 1-3. adımları tekrarlayın.

Not

Her bir istemcinin yeniden başlatıldıktan sonra mesaj üretebildiğini ve tüketebildiğini doğrulayın. 3. Adıma geçmeden önce tüm istemcilerin çalıştığını onaylayın.

Adım 3: Konsoldaki anahtar boyutunu değiştirme

Tüm istemciler yeni sertifikayı kullanmaya başladıktan sonra:

  1. ApsaraMQ for Kafka konsolunda oturum açın.

  2. Örneğiniz için Instance Details sayfasını açın.

  3. Configuration Information bölümünde SSL Certificate Key Size (Bits) değerini 4096 olarak değiştirin. Ayrıntılı talimatlar için bkz. Mesaj yapılandırmalarını değiştirme.

Adım 4: Güncellemeyi doğrulama

  1. Instance Details sayfasında Configurations bölümünün SSL Certificate Key Size (Bits) değerinin 4096 olduğunu onaylayın.

  2. Tüm istemcilerin hatasız mesaj üretebildiğini ve tüketebildiğini kontrol edin.

  3. (İsteğe bağlı) mix geçiş sertifikasını kullandıysanız, eski 1.024 bit sertifikayı istemcilerinizden kaldırmak için bunu only.4096.client.truststore.jks (Java) veya only-4096-ca-cert (Java dışı) sertifikasıyla değiştirebilirsiniz.

SSL bağlantı hatalarını giderme

Handshake başarısız oldu

Bir ApsaraMQ for Kafka örneğine SSL üzerinden bağlanırken handshake failed hatası veya nodename nor servname provided gibi bir hata alırsanız sorunu şu şekilde giderin:

  1. Sertifika anahtar boyutunun örnek yapılandırmasıyla eşleştiğini doğrulayın. ApsaraMQ for Kafka konsolundaki Instance Details sayfasında Configurations bölümündeki SSL Certificate Key Size (Bits) değerini kontrol edin ve bu anahtar boyutuna uyan CA sertifikasını indirin.

  2. İstemcinin ApsaraMQ for Kafka örneğinin CA sertifikasına güvendiğinden emin olun. CA sertifikasını konsoldan indirin veya dışa aktarmak için aşağıdaki komutu çalıştırın:

    openssl s_client -connect <endpoint>:9093 -showcerts

Sertifika doğrulaması başarısız oldu (ana bilgisayar adı uyuşmazlığı)

SSL üzerinden bağlanırken certificate verify failed hatası veya ana bilgisayar adı uyuşmazlığı hatası alırsanız bunun nedeni SSL uç noktasının bir IP adresi olması, ancak örnek sertifikasının ortak ad (CN) olarak AliKafka kullanmasıdır. Sonuç olarak IP adresi sertifika ile eşleşmez.

İstemci yapılandırmasında ana bilgisayar adı doğrulamasını devre dışı bırakın:

  • Java istemcileri (kafka-clients): ssl.endpoint.identification.algorithm değerini boş bir dize olarak ayarlayın.

  • Python istemcileri (kafka-python): ssl_check_hostname=False olarak ayarlayın.

  • Python ssl modülü: context.check_hostname=False olarak ayarlayın.

Kafka Confluent için ssl.endpoint.identification.algorithm değerini none olarak ayarlayabilirsiniz.

Not

Ana bilgisayar adı doğrulamasının devre dışı bırakılması güvenliği azaltır. Üretim ortamlarında doğrulamayı devre dışı bırakmak yerine geçerli bir CA sertifikası ve DNS çözümlemesi yapılandırmanızı öneririz.