man/network
man · Ağ

$ spfquery

Bölüm 1 · Ağ

(Mail::SPF) - Belirli bir e-posta parametreleri kümesinin bir alan adının SPF politikasıyla eşleşip eşleşmediğini kontrol eder

Sürüm

2.501

Kullanım

       Tercih edilen kullanım:
	   spfquery [--versions|-v 1|2|1,2] [--scope|-s helo|mfrom|pra] --identity|--id identity
	   --ip-address|--ip ip-address [--helo-identity|--helo-id helo-identity] [OPTIONS]

	   spfquery [--versions|-v 1|2|1,2] [--scope|-s helo|mfrom|pra] --file|-f filename|-
	   [OPTIONS]

       Eski kullanım:
	   spfquery --helo helo-identity --ip-address|--ip ip-address [OPTIONS]

	   spfquery --mfrom mfrom-identity --ip-address|--ip ip-address [--helo helo-identity]
	   [OPTIONS]

	   spfquery --pra pra-identity --ip-address|--ip ip-address [OPTIONS]

       Diğer kullanım:
	   spfquery --version|-V

	   spfquery --help

Açıklama

spfquery, belirli bir e-posta parametreleri kümesinin (örneğin SMTP göndericisinin IP adresi) sorumlu alan adının Sender Policy Framework (SPF) politikasıyla eşleşip eşleşmediğini kontrol eder. SPF hakkında daha fazla bilgi için http://www.openspf.org adresine bakın.

Tercih Edilen Kullanım Aşağıdaki kullanım biçimleri, eski spfquery sürümleri tarafından kullanılan eski biçimlere tercih edilir:

--identity biçimi, --scope seçeneğinin değerine bağlı olarak (belirtilmemişse varsayılan olarak mfrom'dur) verilen ip-address değerinin; verilen "helo" ana makine adı, "mfrom" zarf gönderici e-posta adresi veya "pra" (sözde sorumlu adres olarak adlandırılan) e-posta adresi için yetkili bir SMTP göndericisi olup olmadığını kontrol eder.

--file biçimi, belirtilen filename adına sahip dosyadan veya filename - ise standart girdiden "ip-address identity [helo-identity]" demetlerini okur ve bunları belirtilen kapsama (varsayılan olarak mfrom) göre kontrol eder.

Her iki biçim de, kullanılabilecek SPF kayıtlarının SPF sürüm numaralarının virgülle ayrılmış bir listesini belirten isteğe bağlı bir --versions seçeneğini destekler. 1, "v=spf1" kayıtlarının kullanılması gerektiği anlamına gelir. 2, "spf2.0" kayıtlarının kullanılması gerektiği anlamına gelir. Varsayılan değer 1,2'dir; yani mevcut olan tüm SPF kayıtlarını kullanır. Daha yüksek sürümdeki kayıtlar tercih edilir.

Eski Kullanım 2.500'den önceki spfquery sürümleri aşağıdaki kullanım biçimlerine sahipti; bunlar önerilmez ancak geriye dönük uyumluluk için hâlâ desteklenmektedir:

--helo biçimi, verilen ip-address değerinin kimlik olarak verilen "HELO" ana makine adı için yetkili bir SMTP göndericisi olup olmadığını kontrol eder (sözde "HELO" kontrolü).

--mfrom biçimi, verilen ip-address değerinin kimlik olarak verilen zarf gönderici e-posta adresi (veya alan adı) için yetkili bir SMTP göndericisi olup olmadığını kontrol eder (sözde "MAIL FROM" kontrolü). E-posta adresi yerine bir alan adı verilirse, yerel kısım (localpart) yerine "postmaster" konulacaktır.

--pra biçimi, verilen ip-address değerinin kimlik olarak verilen PRA (Sözde Sorumlu Adres) e-posta adresi için yetkili bir SMTP göndericisi olup olmadığını kontrol eder.

Diğer Kullanım --version biçimi spfquery'nin sürüm bilgilerini yazdırır. --help biçimi spfquery için kullanım bilgilerini yazdırır.

Seçenekler

Standart Seçenekler Tercih edilen ve eski biçimler isteğe bağlı olarak aşağıdaki SEÇENEKLERDEN (OPTIONS) herhangi birini alabilir:

--default-explanation string --def-exp string Yetkili alan adı kendi açıklama dizesini belirtmemişse, varsayılan açıklama olarak belirtilen dizeyi kullanın.

--hostname hostname Otomatik olarak algılamak yerine, yerel sistemin ana makine adı olarak hostname değerini kullanın.

--keep-comments --no-keep-comments Bir dosyadan veya standart girdiden okuma yaparken bulunan yorumları yazdırın (veya yazdırmayın).

--sanitize (şu anda yoksayılıyor) --no-sanitize (şu anda yoksayılıyor) Ardışık boşlukları tek bir boşluğa indirgeyerek ve yazdırılamayan karakterleri soru işaretleriyle değiştirerek çıktıyı temizleyin (veya temizlemeyin). Varsayılan olarak etkindir.

--debug (şu anda yoksayılıyor) Hata ayıklama bilgilerini yazdırın.

Kara Büyü Seçenekleri spfquery'nin önceki sürümleri tarafından desteklenen bazı seçenekler kara büyü olarak kabul edilir (yani masum kullanıcı için potansiyel olarak tehlikelidir) ve bu nedenle varsayılan olarak devre dışıdır. Eğer Mail::SPF::BlackMagic Perl modülü kuruluysa, --enable-black-magic belirtilerek etkinleştirilebilirler.

--max-dns-interactive-terms n SPF kontrolü başına en fazla n adet DNS etkileşimli mekanizma ve değiştiriciyi değerlendirin. Varsayılan değer 10'dur. Ne yaptığınızı tam olarak bilmiyorsanız varsayılan değeri geçersiz kılmayın!

--max-name-lookups-per-term n Mekanizma veya değiştirici başına en fazla n adet DNS ad araması gerçekleştirin. Varsayılan değer 10'dur. Ne yaptığınızı tam olarak bilmiyorsanız varsayılan değeri geçersiz kılmayın!

--authorize-mxes-for email-address|domain,... Virgülle ayrılmış e-posta adresleri ve alan adları listesindeki tüm MX'leri doğası gereği yetkilendirilmiş olarak kabul edin.

--tfwl "trusted-forwarder.org" akreditasyon kontrolünü gerçekleştirin.

--guess spf-terms Hiçbir SPF kaydı bulunamazsa, varsayılan kayıt olarak spf-terms kullanın.

--local spf-terms Varsayılan bir sonuca (alan adının SPF kaydının sonundaki örtük veya açık "all" mekanizması) başvurmadan önce spf-terms parametresini yerel politika olarak işleyin. Örneğin bu, ikincil MX'leri güvenli listeye almak için kullanılabilir: "mx:mydomain.example.org".

--override domain=spf-record --fallback domain=spf-record Geçersiz kılmaları (override) ve geri dönüşleri (fallback) ayarlayın. Her seçenek birden fazla kez belirtilebilir. Örneğin:

--override example.org='v=spf1 -all' --override '*.example.net'='v=spf1 a mx -all' --fallback example.com='v=spf1 -all'

Sonuç Kodları

pass Belirtilen IP adresi, kimlik için yetkili bir SMTP göndericisidir.

fail Belirtilen IP adresi, kimlik için yetkili bir SMTP göndericisi değildir.

softfail Belirtilen IP adresi, kimlik için yetkili bir SMTP göndericisi değildir; ancak yetkili alan adı SPF politikasını hâlâ test etmektedir.

neutral Kimliğin yetkili alan adı, IP adresinin durumu hakkında hiçbir beyanda bulunmaz.

permerror Yetkili alan adının politikası değerlendirilirken kalıcı bir hata oluştu (örneğin SPF kaydında bir söz dizimi hatası). Yetkili alan adının manuel müdahalesi gereklidir.

temperror Yetkili alan adının politikası değerlendirilirken geçici bir hata oluştu (örneğin bir DNS hatası). Daha sonra tekrar deneyin.

none Kimlik alan adı için geçerli bir SPF politikası yoktur.

Çıkış Kodları

Sonuç | Çıkış kodu -----------+----------- pass | 0 fail | 1 softfail | 2 neutral | 3 permerror | 4 temperror | 5 none | 6

Örnekler

	   spfquery --scope mfrom --id user@example.com --ip 1.2.3.4
	   spfquery --file test_data
	   echo "127.0.0.1 user@example.com helohost.example.com" | spfquery -f -

Uyumluluk

spfquery, önceki sürümlere kıyasla aşağıdaki arayüz değişikliklerinden geçmiştir:

2.500 • Tekil SPF kontrolleri gerçekleştirmek için yeni bir tercih edilen kullanım stili sunulmuştur. Yeni stil, birleşik bir --identity seçeneği ve kimliğin türünü (kapsamını) belirten isteğe bağlı bir --scope seçeneği kabul eder. Buna karşın, eski kullanım stili desteklenen her kapsam için ayrı bir kullanım biçimi gerektirir. Ayrıntılar için "Tercih edilen kullanım" ve "Eski kullanım" bölümlerine bakın.

• Eski "unknown" ve "error" sonuç kodları, RFC 4408 terminolojisine uymak amacıyla sırasıyla "permerror" ve "temperror" olarak yeniden adlandırılmıştır.

• Boş bir kimliğe sahip SPF kontrolleri artık desteklenmemektedir. Boş bir "MAIL FROM" SMTP işlem parametresi olması durumunda, doğrudan "helo" kapsamıyla bir kontrol gerçekleştirin.

• --debug ve --(no-)sanitize seçenekleri şu anda spfquery'nin bu sürümü tarafından yoksayılmaktadır. Gelecekte tekrar destekleneceklerdir.

• spfquery'nin önceki sürümleri tarafından desteklenen bazı özellikler kara büyü olarak kabul edilir ve bu nedenle artık varsayılan olarak devre dışıdır. Bkz. "Kara Büyü Seçenekleri".

• Bazı seçenek adları kullanımdan kaldırılmıştır (deprecated). Aşağıda bunların ve tercih edilen eş anlamlılarının bir listesi yer almaktadır:

Kullanımdan kaldırılan seçenekler | Tercih edilen seçenekler ---------------------+----------------------------- --sender, -s | --mfrom --ipv4, -i | --ip-address, --ip --name | --hostname --max-lookup-count, | --max-dns-interactive-terms

  • --max-lookup: | --rcpt-to, -r | --authorize-mxes-for --trusted | --tfwl

Ayrıca Bakınız

Mail::SPF, spfd(8)

http://tools.ietf.org/html/rfc4408

Yazarlar

spfquery'nin bu sürümü, Meng Weng Wong mengwong+spf@pobox.com ve Wayne Schlitt wayne@schlitt.net tarafından yazılan daha önceki bir sürüme dayanarak Julian Mehnle julian@mehnle.net tarafından tamamen yeniden yazılmıştır.