ACME DNS Providers

ACME DNS Provider Nedir?

ACME DNS Provider, SSL/TLS Certificates ekranındaki ACME.SH türü sertifikaların DNS-01 doğrulamasında kullanılacak DNS sağlayıcı kimlik bilgilerini tutan profildir. DNS-01 doğrulamasında sertifika otoritesi, alan adı sahipliğini alan adının DNS kayıtlarına eklenen geçici bir doğrulama kaydıyla kanıtlatır; TR7 bu kaydı, seçilen sağlayıcının API'siyle kendisi ekleyip kaldırır. Joker (*.) alan adları ve internete açık olmayan servisler için sertifika almanın tek yolu DNS-01 doğrulamasıdır.

Dört sağlayıcı türü desteklenir: Cloudflare, Amazon Route 53 ve Azure DNS için kimlik bilgileri adlandırılmış alanlarda girilir; diğer tüm sağlayıcılar Generic (acme.sh dnsapi) türüyle, cihazdaki 171 eklentilik sağlayıcı kataloğundan seçilerek ya da eklenti adı elle yazılarak tanımlanır. TR7, kimlik bilgilerini sertifika alma ve yenileme sırasında komut satırına yazmadan yalnızca ACME istemcisinin çalışma ortamına verir; ACME istemcisi bu değerleri kendi yapılandırma dosyalarına (eklentiye göre hesap ya da alan adı yapılandırmasına) yazar; bu dizin tanılama paketine alınmaz.

4

Sağlayıcı türü

Cloudflare, Amazon Route 53, Azure DNS, Generic (acme.sh dnsapi)

171

Katalog eklentisi

Generic türünde katalogdan seçilen eklentinin değişkenleri forma otomatik gelir

DNS-01

Doğrulama

Sertifika formunda Challenge Type: DNS-01 seçildiğinde profil zorunludur

*.alan

Joker sertifika

Joker alan adları yalnızca DNS-01 ile alınır

Ortam

Kimlik bilgisi aktarımı

Kimlik bilgileri yalnızca ACME istemcisinin çalışma ortamına verilir

07:00 / 22:00

Yenileme

Günlük yenileme kontrolünde aynı profildeki kimlik bilgileri kullanılır

Nasıl çalışır?

1. Profil bu ekranda tanımlanır: sağlayıcı türü seçilir ve o türün kimlik bilgileri girilir; Generic türünde katalogdan eklenti seçilir ve eklentinin beklediği ortam değişkenleri doldurulur.
2. Sertifika formunda Type: ACME.SH, Challenge Type: DNS-01 ve DNS Provider olarak bu profil seçilir; profil seçilmeden DNS-01 kaydedilmez.
3. Sertifika alınırken TR7, profildeki kimlik bilgilerini ACME istemcisinin çalışma ortamına verir; istemci doğrulama kaydını sağlayıcının API'si üzerinden ekler, otorite doğruladıktan sonra kaldırır.
4. Günlük yenileme kontrolünde aynı profil yeniden okunur; kimlik bilgileri değiştiğinde yeni değerler bir sonraki alma/yenileme işleminde kullanılır.

Provider Türleri

Provider Type	Kimlik bilgisi alanları	ACME istemcisine aktarılan değişkenler
Cloudflare	API Token (zorunlu), Account ID, Zone ID	CF_Token, CF_Account_ID, CF_Zone_ID (eklenti dns_cf)
Amazon Route 53	Access Key ID, Secret Access Key (ikisi de zorunlu)	AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY (eklenti dns_aws)
Azure DNS	Subscription ID, Tenant ID, Application (client) ID, Client Secret (tümü zorunlu)	AZUREDNS_SUBSCRIPTIONID, AZUREDNS_TENANTID, AZUREDNS_APPID, AZUREDNS_CLIENTSECRET (eklenti dns_azure)
Generic (acme.sh dnsapi)	DNS Provider (Catalog) ya da acme.sh dnsapi name, Environment Variables tablosu	Tablodaki ad kuralına uyan her satır (eklenti: seçilen dns_* adı); bkz. Çalışma Mekanizması

Cloudflare türü yalnızca API belirteci (token) ile çalışır; genel API anahtarı (CF_Key / CF_Email) kullanan hesaplar için Generic türünde dns_cf eklentisi seçilip bu değişkenler girilir.

Operasyonel En İyi Uygulamalar

• En az yetkili kimlik bilgisi. Sağlayıcı tarafında yalnızca ilgili bölgenin (zone) DNS kayıtlarını düzenleyebilen bir belirteç ya da hesap oluşturulmalı; sertifika alma dışında yetki verilmemelidir.
• Kimlik bilgileri görünür. Girilen belirteç ve gizli anahtarlar düzenleme formunda yeniden gösterilir (parola alanları maskeli, ortam değişkenleri açık) ve sayfayı görüntüleme yetkisi olan her kullanıcıya ulaşır; profil yalnızca gerekli kullanıcıların erişebildiği cihazlarda tutulmalıdır.
• İlk sertifika ile doğrulama. Bu ekranda test işlemi yoktur; kimlik bilgileri, profili kullanan ilk sertifika alındığında sertifika önizlemesindeki ACME.SH sekmesinden doğrulanır.
• Silmeden önce sertifikalar. Silme onayı kullanım yerlerini göstermez; profili seçen ACME.SH sertifikaları silmeden önce sertifika formlarından başka bir profile geçirilmelidir, aksi hâlde yenileme başarısız olur.
• Joker alan adı. *.alan biçimindeki alan adları için sertifika formunda DNS-01 seçilmeli ve bu ekrandan bir profil atanmalıdır.

Nasıl Eklenir?

Yeni bir ACME DNS Providers profili, TR7 web yönetim arayüzü üzerinden aşağıdaki adımlarla eklenir:

1. Sol altta bulunan TR7 logosuna tıklanarak Configuration Menu açılır.
2. Certificates & PKI → ACME DNS Providers → Add adımları takip edilir.
3. Profil için benzersiz ve açıklayıcı bir isim girilir.
4. Provider Type seçilir ve türe göre görünen kimlik bilgisi alanları doldurulur.
5. Add butonuna tıklanarak profil eklenir.

TIP

Hızlı arama ile sayfaya ulaşma

Menüde adım adım gezmek yerine, ekranın sol alt köşesindeki arama çubuğu kullanılarak ilgili sayfaya doğrudan ulaşılır. Arama çubuğu Windows'ta Alt + T, macOS'ta Opt + T kısayolu ile açılır; ardından aranan özelliğin adının yazılması yeterlidir.

Oluşturulan profil, bir veya birden fazla ACME.SH sertifikasında kullanılabilir.

Profil, sertifika formundaki DNS Provider alanının yanındaki ekleme simgesiyle Add - ACME DNS Provider penceresinde, sayfadan ayrılmadan da tanımlanabilir; oluşturulan profil alanda seçili gelir.

ACME DNS Providers Listeleme Ekranı

Certificates & PKI → ACME DNS Providers yolu izlenerek TR7 cihazı üzerinde ekli olan tüm ACME DNS Providers profillerinin listesine ulaşılır. Bu ekran üzerinden profil ekleme, düzenleme ve silme işlemleri yapılır.

ACME DNS Providers Profillerini Listeleme Formu

Tablo varsayılan olarak şu kolonlarla açılır:

Kolon	Açıklama
Provider Name	Profilin adı.
Provider Type	Kimlik bilgisi alanlarını belirleyen sağlayıcı türü: Cloudflare, Amazon Route 53, Azure DNS ya da Generic (acme.sh dnsapi).
acme.sh dnsapi name	Kimlik bilgilerinin aktarıldığı acme.sh eklentisi. Katalogda tanımlı eklentiler <katalogdaki sağlayıcı adı> — dns_x biçiminde (ör. CloudFlare — dns_cf), katalogda bulunmayanlar ham eklenti adıyla yazılır. Adlandırılmış türlerde eklenti türe göre sabittir ve aynı biçimde yazılır: CloudFlare — dns_cf, Amazon AWS Route53 domain API — dns_aws, Azure — dns_azure. Profilde eklenti adı saklanmıyorsa hücre - kalır.

Varsayılan olarak gizlenen kolon bulunmaz; kolon seçicisinde bu üç kolon yer alır. Kimlik bilgileri tabloda gösterilmez.

Araç çubuğundaki öğeler soldan sağa aşağıdaki sırayla yer alır; son iki öğe (Page Information ve Page Size) tablonun altındaki bilgi şeridinde bulunur.

Columns

Tabloda hangi kolonların gösterileceği seçilir; üç kolon da varsayılan olarak açıktır. Aynı panelde kolonlar sürüklenerek yeniden sıralanır, kolon başına hizalama seçilir, elle ayarlanmış kolon genişliği tıklanarak otomatik boyutlandırmaya döndürülür ve Reset butonuyla kolon düzeni varsayılana alınır. Düzen kullanıcı bazında saklanır.

Filter

Filter butonu, listede gösterilen profilleri belirli kriterlere göre süzmek için kullanılır. Şeritte iki kart bulunur: Provider Type ve Used in.

Used in kartı profiller için kullanım bilgisi sunmaz; profiller vService'lere doğrudan bağlanmadığından tümü Unused Entries altında listelenir. Bir profili hangi tanımların kullandığı, profilin kendi önizleme panelindeki Used in sekmesinden ve sertifika düzenleme formundaki DNS Provider alanından görülür; sertifika listesi ve sertifika önizlemesi kullanılan profili göstermez.

Export

Export butonuna tıklanarak tablo Excel, CSV veya PDF olarak dışa aktarılır. Açılan pencerede Filename, Format ve Data Source ile dışa aktarılacak Columns belirlenir; kalan alanlar biçime göre görüntülenir: CSV'de CSV Separator, Excel'de Excel Sheet Name, PDF'te Page Orientation ve Page Size.

Dışa aktarılan tabloda kimlik bilgisi bulunmaz.

Add

Add butonuna tıklanarak yeni bir profil oluşturma formu Add sekmesinde açılır.

Delete

Bir veya birden fazla profil seçilip Delete butonuna tıklandığında ilgili profiller silinir. Silmeden önce "Are you sure that you want to delete acme dns provider object?" (çoklu seçimde "Are you sure you want to delete N acme dns provider objects?") onayı istenir.

WARNING

Kullanımda olan bir profil de silinebilir ve onay penceresi kullanım yerlerini göstermez; silmeden önce önizleme panelindeki Used in sekmesi kontrol edilmelidir.

Profili seçen ACME.SH sertifikaları silinmez; ancak bir sonraki alma ya da yenileme işlemi profil bulunamadığı için başarısız olur ve User Logs ekranına başarısız alma/yenileme kaydı düşer. Bu sertifikalar düzenlenerek başka bir profil seçilmelidir. Silme işleminin kendisi de kullanıcı işlem kaydına yazılır.

Edit

Edit butonuna tıklanarak seçili profilin düzenleme formu Edit sekmesinde açılır. Buton yalnızca tek bir profil seçildiğinde etkinleşir.

Search

Tablodaki tüm bilgilerde arama yapmak için kullanılır.

RegExp Search

Tabloda bulunan tüm bilgilerde düzenli ifade (RegExp) ile arama yapmak için kullanılır.

Column Based Search

Tabloda bulunan bilgilerde sütun bazlı arama yapmak için kullanılır.

Usage Filter

Profillerin hangi vService'lere bağlı olduğunu filtrelemek için kullanılır. Bu koleksiyondaki profiller vService'lere doğrudan bağlanmadığından seçicide yalnızca Unused Entries seçeneği bulunur ve kendiliğinden seçilir; liste, hiçbir tanımda kullanılmayan kayıtlarla sınırlanır. Filtre etkinken arama kutusunun yerini seçici alır ve RegExp Search butonu gizlenir; simgeye yeniden tıklandığında arama kutusu geri döner.

Page Information

Tanımlı toplam profil sayısı ile listede görüntülenen profil sayısına ait bilgiler yer alır: Showing N-M of T records ve seçili profil sayısı (N selected, seçim yokken Nothing selected). Filtre şeridinde seçim yapılmışsa aynı satıra N filters · gösterilen/toplam rows bilgisi eklenir.

Page Size

Sayfada görüntülenecek maksimum profil sayısı seçilir. Varsayılan 20; seçenekler 5, 10, 20, 50, 100, 200, 500 ve All.

Sağ Tık Menüsü

Bir satıra sağ tıklandığında, başlığında profilin adı bulunan bir menü açılır. Menüdeki iki işlem de yalnızca sağ tıklanan profile uygulanır; listede yapılmış seçim menüyü etkilemez.

İşlem	Ne yapar
Edit	Profilin düzenleme formunu Edit sekmesinde açar; araç çubuğundaki Edit butonunun açtığı formun aynısıdır.
Delete	Sağ tıklanan profili siler; araç çubuğundaki silme ile aynı onay sorusu görüntülenir.

Seçilen Profilin Önizlemesi

Listede bir satıra tıklandığında ekranın sağında profilin önizlemesi açılır; seçili satıra yeniden tıklandığında panel kapanır. Başlıkta bulut simgesi, profilin adı ve ACME DNS Provider alt başlığı, sağ üstte ise tek bir işlem bulunur.

Seçilen Profilin Önizlemesi

İşlem	Ne yapar
Edit	Profilin düzenleme formunu Edit sekmesinde açar. Aynı form, araç çubuğundaki Edit butonu ve satırın sağ tık menüsündeki Edit ile de açılır.

Panelde üç sekme bulunur; sonuncusu yalnızca profili kullanan bir tanım varsa görüntülenir:

Details

Profilin kimlik bilgisi dışındaki tanımını listeler (aşağıdaki tablo).

Log

Profil üzerindeki kullanıcı işlemlerini (ekleme, düzenleme, silme) zaman çizelgesi olarak listeler.

Used in

Profili kullanan tanımları listeler. Sekme adının yanındaki rozet kullanım sayısını gösterir; profili kullanan bir tanım yoksa sekme hiç görüntülenmez.

Details sekmesindeki satırlar sırasıyla aşağıdaki gibidir:

Satır	Açıklama	Görünme koşulu
Provider Name	Profilin adı.	Her zaman
Provider Type	Cloudflare, Amazon Route 53, Azure DNS ya da Generic (acme.sh dnsapi).	Her zaman
acme.sh dnsapi name	Kimlik bilgilerinin aktarıldığı acme.sh eklentisi, katalogdaki adıyla birlikte; profilde eklenti adı saklanmıyorsa -.	Her zaman

Kimlik bilgileri önizlemede gösterilmez.

Profil Ekleme Formu

Certificates & PKI → ACME DNS Providers → Add adımları takip edilerek TR7 cihazı üzerine yeni bir ACME DNS Providers profili eklenir.

ACME DNS Providers Profili Ekleme Formu

INFO

Provider Name Zorunlu

Profilin adı girilir. Ad; listede, sertifika formundaki DNS Provider seçiminde ve loglarda profili tanımlar ve cihazda benzersiz olmalıdır; aynı ad girildiğinde form Name is used uyarısı verir.

INFO

Provider Type Varsayılan: Cloudflare

Sağlayıcı türü: Cloudflare, Amazon Route 53, Azure DNS ya da Generic (acme.sh dnsapi). Tür değiştirildiğinde yalnızca seçilen türün alanları görünür ve kaydedilir.

Cloudflare

INFO

API Token Zorunlu

Cloudflare API belirteci; maskeli alanda girilir. Belirtecin, sertifika alınacak alan adının bölgesinde (zone) DNS kaydı düzenleme yetkisi olmalıdır. Eklentiye CF_Token olarak aktarılır.

INFO

Account ID

Cloudflare hesabının kimliği; isteğe bağlıdır. Eklentiye CF_Account_ID olarak aktarılır.

INFO

Zone ID

Alan adının Cloudflare üzerindeki bölge (zone) kimliği; isteğe bağlıdır. Eklentiye CF_Zone_ID olarak aktarılır.

Amazon Route 53

INFO

Access Key ID Zorunlu

Route 53 üzerinde ilgili barındırılan bölgede (hosted zone) kayıt düzenleme yetkisi olan IAM erişim anahtarının kimliği. Eklentiye AWS_ACCESS_KEY_ID olarak aktarılır.

INFO

Secret Access Key Zorunlu

Erişim anahtarının gizli eşi; maskeli alanda girilir. Eklentiye AWS_SECRET_ACCESS_KEY olarak aktarılır.

Azure DNS

INFO

Subscription ID Zorunlu

DNS bölgesinin bulunduğu Azure aboneliğinin kimliği. Eklentiye AZUREDNS_SUBSCRIPTIONID olarak aktarılır.

INFO

Tenant ID Zorunlu

Uygulama kaydının bağlı olduğu kiracının (tenant) kimliği. Eklentiye AZUREDNS_TENANTID olarak aktarılır.

INFO

Application (client) ID Zorunlu

DNS bölgesinde kayıt düzenleme yetkisi verilmiş uygulama kaydının kimliği. Eklentiye AZUREDNS_APPID olarak aktarılır.

INFO

Client Secret Zorunlu

Uygulama kaydının istemci gizli anahtarı; maskeli alanda girilir. Eklentiye AZUREDNS_CLIENTSECRET olarak aktarılır.

Generic (acme.sh dnsapi)

INFO

DNS Provider (Catalog) Zorunlu

Cihazdaki sağlayıcı kataloğundan eklenti seçilir; liste <katalogdaki sağlayıcı adı> — dns_x biçiminde (örneğin GoDaddy.com — dns_gd) alfabetik sıralıdır ve sonunda Not in the list / custom plugin seçeneği bulunur. Katalog, cihazdaki eklentilerin tamamını kapsamaz; listede bulunmayan bir eklenti bu seçenekle, adı elle yazılarak tanımlanır. Katalog okunamadığında alan hiç görüntülenmez ve eklenti adı doğrudan acme.sh dnsapi name alanına girilir. Bir eklenti seçildiğinde acme.sh dnsapi name kendiliğinden dolar ve Environment Variables tablosuna eklentinin beklediği değişkenler birer satır olarak eklenir; önceki seçimden kalan satırlardan değeri doldurulmuş olanlar korunur, boş olanlar kaldırılır. Eklentinin alternatif bir kimlik bilgisi kümesi varsa alanın altında Alternative credential set — the plugin also accepts: … bilgisi görünür.

INFO

acme.sh dnsapi name Zorunlu

Yalnızca katalogda Not in the list / custom plugin seçildiğinde (ya da katalog yüklenemediğinde) görünür; eklenti adı dns_ ile başlamalı ve yalnızca harf, rakam ve alt çizgi içermelidir (dns_gd gibi), aksi hâlde form Must be an acme.sh dnsapi plugin name like dns_gd uyarısı verir. Eklenti betiğinin cihazdaki ACME istemcisinde bulunması gerekir.

INFO

Environment Variables

Eklentinin belgelediği kimlik bilgisi değişkenleri Variable / Value sütunlu tabloda girilir (GD_Key / GD_Secret gibi). Her satırda iki alan da zorunludur; değişken adı harfle başlamalı, yalnızca harf, rakam ve alt çizgi içermeli ve aynı profilde iki kez kullanılmamalıdır. Satırlar Environment Variables etiketinin yanındaki artı simgesiyle eklenir, satır sonundaki çarpı simgesiyle silinir ve baştaki tutamaçtan sürüklenerek yeniden sıralanır; tabloda tek satır kaldığında çarpı simgesi görüntülenmez. Tablo en az bir satır içermelidir, boş bırakıldığında form At least 1 must be selected uyarısı verir. Katalogdan gelen satırlarda Value alanının yer tutucusu değişkenin açıklamasını gösterir; isteğe bağlı değişkenler (optional) ekiyle işaretlenir, gereksizse satır silinir. Değerler maskelenmez.

INFO

Add

Add butonuna tıklanarak profil ekleme işlemi tamamlanır. Formda doğrulanmamış bir alan bulunduğu sürece buton pasif kalır.

Çalışma Mekanizması

INFO

• Kimlik bilgisi aktarımı. Sertifika alma ve yenileme sırasında profildeki kimlik bilgileri ACME istemcisinin çalışma ortamına ortam değişkeni olarak verilir, komut satırına yazılmaz; adlandırılmış türlerde alanlar sabit değişken adlarına eşlenir (bkz. Provider Türleri), Generic türünde tablodaki satırlar olduğu gibi aktarılır. Değişken adı harfle başlamalı ve yalnızca harf, rakam ve alt çizgi içermelidir; kurala uymayan satırlar aktarılmaz. ACME istemcisi doğrulama kaydını eklerken bu değerleri kendi yapılandırmasına yazar; eklentiye göre hesap yapılandırması ya da alan adı yapılandırması kullanılır. Bu dizin tanılama paketine alınmaz; kimlik bilgileri tanılama çıktılarında da maskelenir.
• Doğrulama akışı. DNS-01 seçili sertifikada istemci, sertifika otoritesinin verdiği doğrulama değerini sağlayıcı eklentisiyle alan adının DNS kayıtlarına yazar, otorite doğruladıktan sonra kaldırır. Bekleme süresi ACME istemcisinin varsayılanıdır; bu ekranda yayılma süresi ayarı yoktur.
• Yenileme. Günlük yenileme kontrolünde (07:00 ve 22:00) doğrulama yöntemi ACME istemcisinin kayıtlı alan yapılandırmasından gelir; profildeki kimlik bilgileri her çalışmada yeniden aktarılır. Sertifikanın doğrulama yöntemi DNS-01 ile HTTP-01 arasında değiştirildiğinde (her iki yönde) sertifika yeniden alınır; profilde yapılan değişiklik de sertifikanın başka bir profile geçirilmesi de sertifikayı yeniden aldırmaz. Bu nedenle hatalı girilen bir kimlik bilgisi kaydedildiği anda belli olmaz, ilk alma ya da yenileme denemesinde başarısızlık olarak ortaya çıkar.
• Joker alan adı. *. ile başlayan alan adları yalnızca DNS-01 ile alınır; sertifika formu HTTP-01 ile joker alan adını Wildcard domains require the DNS-01 challenge uyarısıyla reddeder, DNS-01 seçildiğinde profil seçimi zorunludur.
• Cluster. Profiller LB yapılandırmasıyla cihazlar arasında eşitlenir; doğrulama, sertifikanın Device alanında seçilen cihazda çalışır.
• Saklama. Kimlik bilgileri cihazda profil kaydı içinde düz metin olarak tutulur. Yedek dosyasına yazılırken yalnızca gizli alanlar (API Token, Secret Access Key, Client Secret) ile Environment Variables değerleri şifrelenir; kimlik ve hesap numarası niteliğindeki alanlar düz yazılır. Tanılama paketinde bu değerler maskelenir.
• Loglar. Profil ekleme, düzenleme ve silme User Logs ekranında ACME DNS Provider nesnesi olarak; sertifika alma ve yenileme sonuçları sertifikanın ACME kayıtları olarak izlenir.

Kapsam ve Sınırlar

INFO

• Yetki. Ekran certificate yetki alanına bağlıdır; yetkisi olmayan kullanıcıda sayfa yerine You don't have access to this page kartı görüntülenir.
• Ad benzersizdir. Aynı adı taşıyan ikinci bir profil kaydedilmez.
• Test işlemi yoktur. Kimlik bilgileri yalnızca gerçek bir sertifika alma işlemiyle doğrulanır.
• Yayılma süresi ayarı yoktur. DNS kaydının yayılma beklemesi ACME istemcisinin varsayılanıdır.
• Kimlik bilgileri düzenlemede gösterilir. Sayfayı görüntüleyebilen kullanıcılar kayıtlı kimlik bilgilerine düzenleme formundan erişebilir.
• Kullanım sayımı yoktur. Used in kartı ve önizleme bu koleksiyonda kullanım göstermez; onay penceresi silmeden önce kullanım yerlerini listelemez.
• Yalnızca ACME.SH sertifikalarında kullanılır. Profil, sertifika formunda Challenge Type: DNS-01 seçildiğinde DNS Provider alanında listelenir; başka bir ekranda seçilmez.

Kullanım Yeri

SSL/TLS Certificates ekranında Type: ACME.SH seçilen sertifikanın formunda Challenge Type alanı DNS-01 yapıldığında DNS Provider alanı görünür ve zorunlu olur; bu ekranda tanımlı profiller listelenir, alanın yanındaki ekleme simgesiyle yeni profil Add - ACME DNS Provider penceresinde tanımlanıp seçilir. Sertifikanın alma ve yenileme sonuçları sertifika önizlemesindeki ACME.SH sekmesinde izlenir.