S3 Compatible Storage

SSL sertifikalarını herhangi bir S3 uyumlu nesne depolama bucket'ına otomatik olarak nasıl dağıtırsınız.

Genel bakış

AutoSSL, SSL sertifikası dosyalarını herhangi bir S3 uyumlu nesne depolama bucket'ına otomatik olarak yükleyebilir. Özel bir HTTPS uç noktası ve bucket adı verirsiniz. Bu sağlayıcı, ayrı bir sağlayıcının kapsamadığı MinIO, Wasabi, Ceph ve diğer S3 uyumlu hizmetler için uygundur.

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 nesne depolamadan 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
Uç nokta	S3 uyumlu API'nin HTTPS adresi. HTTP uç noktaları desteklenmez.	`https://minio.example.com`
Bölge	(İsteğe bağlı) İstek imzalamada kullanılan bölge. Varsayılan `us-east-1` değeridir. Sağlayıcınızın istediği değeri kullanın.	`us-east-1`
Bucket adı	Sertifika dosyalarının yükleneceği bucket'ı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/`
Force Path Style	(İsteğe bağlı) Yol biçimli URL'leri etkinleştirir (`https://endpoint/bucket/key`). MinIO ve bazı kendi barındırdığınız S3 uyumlu hizmetler için açın.	`true` (MinIO için)

Uç nokta HTTPS kullanmalıdır. AutoSSL, güvenlik nedeniyle HTTP uç noktalarını reddeder.

Nasıl çalışır

AutoSSL bir sertifikayı S3 uyumlu bir bucket'a dağıttığında (örneğin my-ssl-certs, ö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 nesne 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

Bu sağlayıcı S3 uyumlu depolama kimlik bilgileri gerektirir.

Gerekli izinler

Erişim anahtarının hedef bucket'a nesne yükleme izni olmalıdır. En az şu S3 eylemi gerekir:

Hedef bucket (veya bucket öneki) üzerinde s3:PutObject

MinIO için kullanıcıya hedef bucket üzerinde s3:PutObject izni veren bir ilke atayın.

Sorun giderme

Belirti	Olası çözüm
Bağlantı reddedildi veya DNS hatası	Uç nokta adresinin doğru olduğunu ve AutoSSL'den erişilebildiğini doğrulayın.
Erişim reddedildi	Erişim anahtarının bucket üzerinde `PutObject` izni olduğunu denetleyin.
İmza uyuşmazlığı	Sağlayıcınızın istediği farklı bir Bölge değerini deneyin.
Özel uç noktada bucket bulunamadı	Force Path Style seçeneğini açın (MinIO için yaygındır).

S3 Compatible Storage

Bu sayfada