Otomatik SSL sertifika yönetimi

SSL sertifikalarını bir AWS S3 bucket'ına otomatik olarak nasıl dağıtırsınız.

Genel bakış

AutoSSL, SSL sertifikası dosyalarını bir Amazon S3 bucket'ına otomatik olarak yükleyebilir. Her sertifika sürümlü bir arşiv yolunda saklanır ve ayrıca latest/ yolunda güncellenir. Böylece sonraki tüketiciler (örneğin Nginx, Caddy veya S3'ten sertifika çeken özel betikler) güncel dosyayı kolayca bulur.

Bu dağıtımı nasıl yönetip çalıştıracağınız için Dağıtım yönetimi bölümüne bakın.

Yapılandırma parametreleri

Bu dağıtım hedefini AutoSSL konsolunda eklerken veya düzenlerken aşağıdaki parametreleri yapılandırırsınız:

Parametre	Açıklama	Örnek
Bölge	S3 bucket'ının bulunduğu AWS bölgesi.	`us-east-1`
Bucket adı	Sertifika dosyalarının yükleneceği S3 bucket'ının adı.	`my-ssl-certs`
Nesne anahtarı öneki	(İsteğe bağlı) Bucket içinde sertifika dosyalarını düzenlemek için önek. Ayarlanırsa dosyalar bu önek altında yüklenir. Sondaki eğik çizgi isteğe bağlıdır.	`certs/example.com/`

Nasıl çalışır

AutoSSL bir sertifikayı bir AWS S3 bucket'ına dağıttığında (örneğin my-ssl-certs (us-east-1 bölgesi, önek certs/example.com/)) şu adımları uygular:

Sertifika hazırlığı:
- Tam sertifika zincirini ayrı PEM dosyalarına böler: cert.pem (yaprak sertifika), privkey.pem (özel anahtar, PKCS#8 kodlu), chain.pem (ara zincir) ve fullchain.pem (tam zincir).
- İzlenebilirlik için sertifika üst verisini içeren bir README.md dosyası oluşturur ve https://autossl.dev bağlantısı ekler.
- Sertifikanın notBefore tarihini ve SHA1 parmak izini ayrıştırarak arşiv dizini adı üretir (biçim: YYYY-MM-DD_<first 8 chars of SHA1>).
Dosya yükleme:
- Sertifika dosyalarını (dört PEM dosyası ve README.md) bucket içindeki iki yola yükler:
  - Arşiv yolu — certs/example.com/2026-05-30_e5f6a7b8/cert.pem (ayrıca privkey.pem, chain.pem, fullchain.pem, README.md). Bu yol her sertifika verme işlemi için benzersizdir ve üzerine yazılmaz.
  - Güncel yol — certs/example.com/latest/cert.pem (ayrıca privkey.pem, chain.pem, fullchain.pem, README.md). Bu yol her zaman en son yüklenen sertifikayı gösterir.

latest/ yolu, sonraki hizmetlerin güncel sertifikayı her zaman sabit bir S3 anahtarından almasını sağlar. Eski sertifikalar sürümlenmiş arşiv dizinlerinde erişilebilir kalır.

Örnek bucket yapısı

Birden fazla sertifika yenilemesinden sonra bucket yapınız şöyle görünür:

certs/example.com/
├── 2026-03-01_a1b2c3d4/
│   ├── cert.pem
│   ├── privkey.pem
│   ├── chain.pem
│   ├── fullchain.pem
│   └── README.md
├── 2026-05-30_e5f6a7b8/
│   ├── cert.pem
│   ├── privkey.pem
│   ├── chain.pem
│   ├── fullchain.pem
│   └── README.md
└── latest/
    ├── cert.pem
    ├── privkey.pem
    ├── chain.pem
    ├── fullchain.pem
    └── README.md

Özel anahtar biçimi

privkey.pem, PKCS#8 biçiminde kodlanır (-----BEGIN PRIVATE KEY-----). Bu biçim modern web sunucuları ve araçlar (Nginx, Caddy, Traefik, OpenSSL 1.1+ vb.) tarafından yaygın olarak desteklenir.

Ortamınız PKCS#1 biçimi gerektiriyorsa (örneğin RSA anahtarları için -----BEGIN RSA PRIVATE KEY-----) kullanmadan önce yerelde dönüştürün:

openssl rsa -in privkey.pem -out privkey-pkcs1.pem

Erişim anahtarı gereksinimi

AWS API’si ile iletişim kurmak için bu sağlayıcı bir AWS erişim anahtarı gerektirir.

Gerekli izinler

Erişim anahtarı, hedef S3 bucket'ına nesne yükleme izni olan bir AWS IAM kullanıcısına ait olmalıdır.

Kullanıcınıza, hedef bucket öneki üzerinde en az şu eylemi içeren bir IAM ilkesi eklemeniz gerekir:

s3:PutObject

En küçük IAM ilkesi örneği:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": "s3:PutObject",
      "Resource": "arn:aws:s3:::my-ssl-certs/certs/example.com/*"
    }
  ]
}

IAM izinlerini yönetme hakkında daha fazla bilgi için AWS IAM belgelerine bakın.

AWS S3