lb acme-dns-provider

lb acme-dns-provider komutu, ACME sertifikalarında DNS-01 doğrulamasının hangi DNS sağlayıcısı üzerinden yapılacağını tanımlar. DNS-01 doğrulamasında TR7, alan adının DNS kaydına geçici bir değer yazar; bunun için sağlayıcının API kimliğine ihtiyaç duyar. Panel karşılığı ACME DNS Providers ekranıdır.

İlk yazılan alanlar name ve providerType'tır

Sağlayıcı türü seçilmeden kimlik alanları listelenmez; her türün kendi alanları vardır.

Komut Özeti

TR7 WEB-CLI · lb acme-dns-provider

# komuttan sonra Tab

admin@TR7LBWAF01> lb acme-dns-provider

add delete list show update

 

admin@TR7LBWAF01> lb acme-dns-provider list # hepsini listele

admin@TR7LBWAF01> lb acme-dns-provider show <kimlik> # birini göster

admin@TR7LBWAF01> lb acme-dns-provider add name <ad> providerType <tür> …

admin@TR7LBWAF01> lb acme-dns-provider update id <kimlik> …

admin@TR7LBWAF01> lb acme-dns-provider delete <kimlik>

admin@TR7LBWAF01>  

Zorunlu Alanlar

Sıra	Alan	Durum	Ne yapar	Arkasına ne yazılır
1	name	Zorunlu	Sağlayıcı kaydına ad verir	Kaydın adı; koleksiyonda benzersiz olmalı
2	providerType	Zorunlu	Hangi DNS sağlayıcısının kullanılacağını seçer	cloudflare · route53 · azure · generic
3	cfToken	Koşullu zorunlu	Yalnız cloudflare; kayıt yazma yetkisi olan API belirteci	Cloudflare API belirteci
3 · 4	awsAccessKeyId · awsSecretAccessKey	Koşullu zorunlu	Yalnız route53; erişim anahtarı	Anahtar kimliği ve gizli değeri
3–6	azureSubscriptionId · azureTenantId · azureAppId · azureClientSecret	Koşullu zorunlu	Yalnız azure; abonelik, kiracı ve uygulama kimliği	Kimlik değerleri ve istemci gizli anahtarı
3	dnsApiName	Koşullu zorunlu	Yalnız generic; kullanılacak acme.sh DNS eklentisi	Eklenti adı

Sağlayıcıya özel zorunlu alanlar satırda -- ile başlayan alan yoksa öneksiz, varsa -- önekiyle yazılır.

Sağlayıcı Türleri

cloudflare

Alan	Ne yapar	Arkasına ne yazılır
--cfToken	DNS kaydını yazma yetkisi olan API belirtecini taşır	Cloudflare API belirteci. Zorunludur (bkz. Zorunlu Alanlar)
--cfAccountId	Hesabı belirtir	Hesap kimliği
--cfZoneId	Kaydın yazılacağı bölgeyi belirtir	Bölge kimliği

route53

Alan	Ne yapar	Arkasına ne yazılır
--awsAccessKeyId	Erişim anahtarının kimliğini taşır	Erişim anahtarı kimliği. Zorunludur (bkz. Zorunlu Alanlar)
--awsSecretAccessKey	Erişim anahtarının gizli değerini taşır	Gizli anahtar. Zorunludur (bkz. Zorunlu Alanlar)

azure

Alan	Ne yapar	Arkasına ne yazılır
--azureSubscriptionId	Aboneliği belirtir	Abonelik kimliği. Zorunludur (bkz. Zorunlu Alanlar)
--azureTenantId	Kiracıyı belirtir	Kiracı kimliği. Zorunludur (bkz. Zorunlu Alanlar)
--azureAppId	Uygulama (istemci) kimliğini taşır	Uygulama kimliği. Zorunludur (bkz. Zorunlu Alanlar)
--azureClientSecret	Uygulamanın gizli anahtarını taşır	İstemci gizli anahtarı. Zorunludur (bkz. Zorunlu Alanlar)

generic

Alan	Ne yapar	Arkasına ne yazılır
--dnsApiName	Hangi acme.sh DNS eklentisinin kullanılacağını belirler	Eklenti adı. Zorunludur (bkz. Zorunlu Alanlar)

Ortam Değişkenleri

Her türde yazılabilir; sağlayıcı eklentisinin beklediği ek değerleri taşır.

Alan	Ne yapar	Arkasına ne yazılır
--envVars.N.key	Değişkenin adını belirler	Değişken adı
--envVars.N.value	Değişkenin değerini belirler	Değişkenin değeri

Özellikle generic türünde, eklentinin istediği bütün değerler bu çiftlerle verilir.

Örnekler

TR7 WEB-CLI · sağlayıcı tanımlama ve kullanma

admin@TR7LBWAF01> lb acme-dns-provider add name cf-kurum providerType cloudflare \

--cfToken <belirteç> --cfZoneId <bölge>

 

admin@TR7LBWAF01> lb acme-dns-provider add name genel-dns providerType generic \

--dnsApiName <eklenti> --envVars.0.key <değişken> --envVars.0.value <değer>

 

# DNS-01 doğrulamasında seçilir

admin@TR7LBWAF01> lb certificate add type acmeSh name joker-cert \

--acmeShChallengeType dns01 acmeShDnsProviderId <sağlayıcı> --acmeShDomains.0.domain "*.kurum.com.tr"

admin@TR7LBWAF01>  

Bilinmesi Gerekenler

• Sağlayıcı yalnız DNS-01'de kullanılır. lb certificate komutunda --acmeShChallengeType dns01 seçildiğinde acmeShDnsProviderId alanı zorunlu olur; sertifika türü bir ayırıcı olduğundan bu alan satırda -- olsa bile öneksiz yazılır.
• Joker sertifikalar DNS doğrulaması ister. *.alanadı biçimindeki sertifikalar HTTP-01 ile alınamaz.
• Kimlik alanları türe bağlıdır. Tür değiştirildiğinde önceki türün alanları listeden düşer, yeni türün alanları açılır.
• Yetki dar tutulmalıdır. Sağlayıcıda yalnız doğrulama kaydını yazma yetkisi olan bir belirteç kullanılması önerilir.
• Ad benzersizdir. Aynı ada sahip ikinci bir sağlayıcı kaydı oluşturulamaz.