Documentation

Plugins

Client libraries

Publishing

FAQs


BQuery client configuration

Config item Recommended Value Details
Server query.karmasphere.com unless you have installed a private node for your own use, specify the public node.
Port 8666
TCP or UDP? UDP

We recommend UDP, which is faster (we estimate a factor of 3).

But your circumstances may require TCP.

For example, some organizational firewalls (notably those without connection tracking, or those where connection tracking is misconfigured) can only use TCP. Or you may be on a lossy network.

XML/RPC client configuration

Our XML/RPC interface lives at http://query.karmasphere.com:8008/.

It comes with a Javascript library.

DNS client configuration

To your MTA, Karmasphere can appear as just another DNSBL.

No special clients are needed. Just use dig or nslookup.

Each feed or feedset has its own pair of zones. They look like: karmasphere.email-sender-ip.dnswl.karmasphere.com.

To find the appropriate zone for a given feedset, you must subscribe to it first.

Note that queries will only work from IPs you have designated.

Credentials

Credentials are required for authentication. FAQ: Network queries require authentication. What's that about?

If you've registered for an account, you should you use your permanent credentials. Those credentials do not expire. When you configure your client, plug those credentials in, then forget about them.


Quickstart Credentials

We provide temporary credentials for people who are too impatient to register.

They will expire within a few days. Replace them with your permanent credentials when you sign up.

Temporary Credentials – choose carefully

exchange
username: these_exchange_credentials_will_expire_20080801
password: gtLpp+CcYeQIE0pV53R1vg
exim
username: these_exim_credentials_will_expire_20080801
password: o/as1RcKMs/E0Hwg+8axyw
postfix
username: these_postfix_credentials_will_expire_20080801
password: jH0MbuDmGTPylVWN61nDTw
qpsmtpd
username: these_qpsmtpd_credentials_will_expire_20080801
password: hhyaLMmtFPHKX2PvJHkd6g
sendmail
username: these_sendmail_credentials_will_expire_20080801
password: GuwunCc3SANH5S6yHqXxxg
spamassassin
username: these_spamassassin_credentials_will_expire_20080801
password: 5Cshx27mKldFdaAK9hmBrg
generic_bquery
username: these_generic_bquery_credentials_will_expire_20080801
password: WgSxRJMGCJVUecoMDD0icw
generic_c
username: these_generic_c_credentials_will_expire_20080801
password: dgh8jyKG2fN6ydW571Fk9w
generic_perl
username: these_generic_perl_credentials_will_expire_20080801
password: /3UI/WnUHd7LrPr2h3aIyQ
generic_ruby
username: these_generic_ruby_credentials_will_expire_20080801
password: Vufpw612pusCf3X4GHtN1A
generic_xmlrpc
username: these_generic_xmlrpc_credentials_will_expire_20080801
password: ZO1IRFwtsV8rhqMOdqy34A