Sertifikaları desteklenen biçime dönüştürme

Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. bilgi

Bu belgede, TLS sertifikasının ve ilişkili özel anahtarın PEM veya PFX (PKCS #12) biçimlerine nasıl dönüştürüleceği açıklanmaktadır.

Apigee Edge, yalnızca PEM veya PFX biçimindeki sertifikaların anahtar depolarında ve güven depolarında saklanmasını destekler. Sertifikaları mevcut herhangi bir biçimden PEM veya PFX biçimlerine dönüştürmek için kullanılan adımlar OpenSSL araç setine dayanır ve OpenSSL'nin kullanılabildiği tüm ortamlarda geçerlidir.

Başlamadan önce

Bu belgedeki adımları kullanmadan önce aşağıdaki konuları anladığınızdan emin olun:

  • PEM veya PFX biçimi hakkında bilginiz yoksa TLS/SSL hakkında başlıklı makaleyi okuyun.
  • Sertifika biçimleri hakkında bilginiz yoksa SSL sertifika biçimleri başlıklı makaleyi okuyun.
  • OpenSSL kitaplığı hakkında bilginiz yoksa OpenSSL başlıklı makaleyi okuyun.
  • Bu kılavuzdaki komut satırı örneklerini kullanmak istiyorsanız OpenSSL istemcisinin en son sürümünü yükleyin veya bu sürüme güncelleyin.

Sertifikayı DER biçiminden PEM biçimine dönüştürme

Bu bölümde, sertifikayı ve ilişkili özel anahtarı DER biçiminden PEM biçimine dönüştürme açıklanmaktadır.

  1. PEM biçimine dönüştürmek istediğiniz tam sertifika zincirini (certificate.der) ve ilişkili özel anahtarı (private_key.der) içeren dosyayı scp, sftp veya başka bir yardımcı programı kullanarak OpenSSL'nin yüklü olduğu bir makineye aktarın.

    Örneğin, dosyayı OpenSSL'yi içeren sunucudaki /tmp dizinine aktarmak için scp komutunu aşağıdaki gibi kullanın: 

    scp certificate.der servername:/tmp
scp private_key.der servername:/tmp

    Burada servername, OpenSSL'yi içeren sunucunun adıdır.

  2. OpenSSL'nin yüklü olduğu makineye giriş yapın.
  3. Sertifikaların bulunduğu dizinde, sertifikayı ve ilişkili özel anahtarı DER biçiminden PEM biçimine dönüştürmek için aşağıdaki komutu çalıştırın: 
    openssl x509 -inform DER -in certificate.der -outform PEM -out certificate.pem
openssl rsa -inform DER -in private_key.der -outform PEM -out private.key
  4. Sertifikanın PEM biçimine dönüştürüldüğünü doğrulayın.

Sertifikayı P7B biçiminden PEM biçimine dönüştürme

Bu bölümde, sertifikaların P7B biçiminden PEM biçimine nasıl dönüştürüleceği açıklanmaktadır.

  1. PEM biçimine dönüştürmek istediğiniz, tam sertifika zincirini içeren dosyayı (certificate.p7b) OpenSSL'nin yüklü olduğu bir makineye scp, sftp veya başka bir yardımcı program kullanarak aktarın.

    Örneğin, dosyayı OpenSSL'yi içeren sunucudaki /tmp dizinine aktarmak için scp komutunu aşağıdaki gibi kullanın: 

    scp certificate.p7b servername:/tmp

    Burada servername, OpenSSL'yi içeren sunucunun adıdır.

  2. OpenSSL'nin yüklü olduğu makineye giriş yapın.
  3. Sertifikaların bulunduğu dizinde, sertifikayı P7B biçiminden PEM biçimine dönüştürmek için aşağıdaki komutu çalıştırın: 
    openssl pkcs7 -print_certs -in certificate.p7b -out certificate.pem
  4. Sertifikanın PEM biçimine dönüştürüldüğünü doğrulayın.

Sertifikayı PFX biçiminden PEM biçimine dönüştürme

Bu bölümde, TLS sertifikalarının PFX biçiminden PEM biçimine nasıl dönüştürüleceği açıklanmaktadır.

OpenSSL, bir PFX dosyasını PEM biçimine dönüştürürken tüm sertifikaları ve özel anahtarı tek bir dosyaya yerleştirir. Dosyayı bir metin düzenleyicide açmanız ve her sertifikayı ve özel anahtarı (BEGIN/END ifadeleri dahil) ayrı metin dosyalarına kopyalayıp bunları sırasıyla certificate.pfx, Intermediate.pfx (varsa), CACert.pfx ve privateKey.key olarak kaydetmeniz gerekir.

Apigee, PFX/PKCS #12 biçimini destekler ancak PEM biçimi doğrulama da dahil olmak üzere birçok nedenden dolayı daha uygundur.

  1. PEM biçimine dönüştürmek istediğiniz sertifikaları ve gizli anahtarı (certificate.pfx, Intermediate.pfx CACert.pfx, privateKey.key) scp, sftp veya başka bir yardımcı programı kullanarak OpenSSL'nin yüklü olduğu bir makineye aktarın.

    Örneğin, dosyayı OpenSSL'yi içeren sunucudaki /tmp dizinine aktarmak için scp komutunu aşağıdaki gibi kullanın: 

    scp certificate.pfx servername:/tmp

    Burada servername, OpenSSL'yi içeren sunucunun adıdır.

  2. OpenSSL'nin yüklü olduğu makineye giriş yapın.
  3. Sertifikaların bulunduğu dizinde, sertifikayı P7B biçiminden PEM biçimine dönüştürmek için aşağıdaki komutu çalıştırın: 
    openssl pkcs12 -in certificate.pfx -out certificate.pem -nodes
  4. Sertifikanın PEM biçimine dönüştürüldüğünü doğrulayın.

Sertifikayı P7B biçiminden PFX biçimine dönüştürme

Bu bölümde, TLS sertifikalarının P7B biçiminden PFX biçimine nasıl dönüştürüleceği açıklanmaktadır.

PFX biçimine dönüştürmek için özel anahtarı da almanız gerekir.

  1. PFX'e dönüştürmek istediğiniz sertifikayı (certificate.p7b) scp, sftp veya başka bir yardımcı programı kullanarak OpenSSL'in yüklü olduğu bir makineye aktarın.

    Örneğin, dosyayı OpenSSL'yi içeren sunucudaki /tmp dizinine aktarmak için scp komutunu aşağıdaki gibi kullanın: 

    scp certificate.p7b servername:/tmp
scp private_key.key servername:/tmp

    Burada servername, OpenSSL'yi içeren sunucunun adıdır.

  2. OpenSSL'nin yüklü olduğu makineye giriş yapın.
  3. Sertifikaların bulunduğu dizinde, sertifikayı P7B'den PFX biçimine dönüştürmek ve tüzel kişi ile ara CA sertifikalarını ayrı dosyalara aktarmak için aşağıdaki komutları çalıştırın: 
    openssl pkcs7 -print_certs -in certificate.p7b -out certificate.cer

openssl pkcs12 -export -in certificate.cer -inkey private_key.key -out certificate.pfx -certfile CACert.cer

Sertifikanın PEM biçiminde olduğunu doğrulama

Bu bölümde, sertifikanın PEM biçiminde olup olmadığını nasıl doğrulayacağınız açıklanmaktadır.

  1. PEM biçimindeki sertifikayı görüntülemek için aşağıdaki komutu çalıştırın: 
    openssl x509 -in certificate.pem -text -noout
  2. Sertifikanın içeriğini herhangi bir hata olmadan okunabilir biçimde görüntüleyebiliyorsanız sertifikanın PEM biçiminde olduğunu doğrulayabilirsiniz.
  3. Sertifika başka bir biçimdeyse aşağıdaki gibi hatalar görürsünüz: 
    unable to load certificate
12626:error:0906D06C:PEM routines:PEM_read_bio:no start line:pem_lib.c:647:Expecting: TRUSTED CERTIFICATE View DER encoded Certificate

PEM anahtar ve sertifika dosyalarını PKCS12/PFX'e paketleme

  1. Özel anahtar dosyasının PEM biçiminde olduğundan emin olun. Sertifika için zincirinize ait ayrı PEM dosyalarınız varsa her dosyayı bir metin düzenleyicide açın ve bunları aşağıdaki örnekte gösterildiği gibi tek bir dosyada birleştirin: 
    -----BEGIN CERTIFICATE-----
...
-----END CERTIFICATE-----
-----BEGIN CERTIFICATE-----
...
-----END CERTIFICATE-----
-----BEGIN CERTIFICATE-----
...
-----END CERTIFICATE-----
  2. Dosyaları scp, sftp veya başka bir yardımcı program kullanarak OpenSSL'nin yüklü olduğu bir makineye aktarın: 
    scp certificate.pem servername:/tmp
scp private.key servername:/tmp
  3. OpenSSL'nin yüklü olduğu makineye giriş yapın.
  4. Dosyaların bulunduğu dizinde, dosyaları myalias takma adıyla bir PKCS12 dosyasına paketlemek için aşağıdaki komutu çalıştırın. İstendiğinde uygun bir şifre girin: 
    openssl pkcs12 -export -in certificate.pem -inkey private.key -out keystore.pfx -name myalias