Google Cloud Storage

SSL sertifikalarını bir Google Cloud Storage bucket'ına otomatik olarak nasıl dağıtırsınız.

Genel bakış

AutoSSL, SSL sertifikası dosyalarını bir Google Cloud Storage 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 Cloud Storage'tan 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
Bucket adı	Sertifika dosyalarının yükleneceği Cloud Storage 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 Cloud Storage bucket'ına 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 Cloud Storage 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

Cloud Storage'ın S3 uyumlu API’si ile iletişim kurmak için bu sağlayıcı Google Cloud Storage HMAC kimlik bilgileri gerektirir.

Gerekli izinler

HMAC anahtarı, hedef bucket'a nesne yükleme izni olan bir hizmet hesabıyla ilişkili olmalıdır.

Hizmet hesabına hedef bucket üzerinde en az şu IAM rolünü (veya eşdeğer izinleri olan özel bir rolü) vermeniz gerekir:

roles/storage.objectCreator (storage.objects.create izni)

En küçük özel IAM rolü izinleri örneği:

storage.objects.create

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