Skip to content

Latest commit

 

History

History
47 lines (34 loc) · 1.38 KB

README.md

File metadata and controls

47 lines (34 loc) · 1.38 KB

python-dnsdist

Python library to talk to dnsdist

Since version 1.2.0, dnsdist uses merged nonces to send and receive messages, while pre 1.2.0 dnsdist does not.

The default is to use the pre-1.2.0 behaviour. To enable, set the merge_nonces argument to True.

Requirements

  • libnacl is required if you need to talk to a dnsdist instance that is compiled with libsodium support

    pip install libnacl

Example

from DNSDist import Console

# Connect to dnsdist on localhost:5199 without a key
console = Console()
print console.execute('showServers()')
from DNSDist import Console

# Connect to dnsdist 1.2.0+ instance on 10.100.1.2:3200 with supplied key
console = Console(key='tZ+bElqKb+moWK1BAAlSjIjAdVb9zTXT7Ziqj/lw/R8=', host='10.100.1.2', port=3200, merge_nonces=True)
print console.execute('showServers()')
from DNSDist import Console

# Connect to dnsdist pre 1.2.0 instance on 10.100.1.2:3200 with supplied key
console = Console(key='tZ+bElqKb+moWK1BAAlSjIjAdVb9zTXT7Ziqj/lw/R8=', host='10.100.1.2', port=3200)
print console.execute('showServers()')
from DNSDist import Console

# Connect to dnsdist instance on 10.100.1.2 and do not use libsodium even if its available
console = Console(host='10.100.1.2', have_sodium=False)
print console.execute('showServers()')