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_20081215
password: YOwkwvyDeYIl2Zs5lECyGg
exim
username: these_exim_credentials_will_expire_20081215
password: dFgFULDzb5TzCRGf+18CbQ
postfix
username: these_postfix_credentials_will_expire_20081215
password: 4NHlR92/sAjbK5i6KDf3JQ
qpsmtpd
username: these_qpsmtpd_credentials_will_expire_20081215
password: CfpN+n3vaYnA0iYHrkTqaQ
sendmail
username: these_sendmail_credentials_will_expire_20081215
password: bG09aWDBjauxlbeJ73/ScA
spamassassin
username: these_spamassassin_credentials_will_expire_20081215
password: hxdZ10kUDWdfOqFooZHELQ
generic_bquery
username: these_generic_bquery_credentials_will_expire_20081215
password: chHhWMsk5syjl1ssB2/o2A
generic_c
username: these_generic_c_credentials_will_expire_20081215
password: H9vHeSloW0ZHGlTHswRKkw
generic_perl
username: these_generic_perl_credentials_will_expire_20081215
password: xwE3iii3UIo1XE4suhgfVA
generic_ruby
username: these_generic_ruby_credentials_will_expire_20081215
password: VHjvbp0vzetmC92IMbHWag
generic_xmlrpc
username: these_generic_xmlrpc_credentials_will_expire_20081215
password: GePpvqJPYH2bFrT/q3flhA