Process and verify data from SNDS easily
Project description
SNDS LIB
Process and verify data from Microsoft's Smart Network Data Service (SNDS) API easily.
SNDSLIB is a wrapper around SNDS Automated Data Access API to facilitate fast data process and analysis.
What is SNDS?
Smart Network Data Service (SNDS) is a platform to monitor data from IPs that send emails to Microsoft's servers.
If you send more than 100 messages per day from your IPs, your can get valuable information about IP reputation, possible blocks, spam complaints and spamtraps hits.
Talk is cheap. Show me the code!
Installation:
SNDSLIB has no external dependancies. It runs just with python 3.6 or higher.
pip install sndslib
Simple example of library usage:
>>> from sndslib import sndslib
>>> r = sndslib.get_ip_status('mykey')
>>> blocked_ips = sndslib.list_blocked_ips(r)
>>> print(blocked_ips)
['1.1.1.1', '1.1.1.2']
>>> list_blocked_ips_rdns(blocked_ips)
[{'ip': '1.1.1.1', 'rdns': 'foo.bar.exemple.com'},
{'ip': '1.1.1.2', 'rdns': 'foo2.bar.exemple.com'}]
>>> r = sndslib.get_data('mykey')
>>> sndslib.summarize(r)
{'red': 272, 'green': 710, 'yellow': 852, 'traps': 1298, 'ips': 1834, 'date': '12/31/2019'}
>>> sndslib.search_ip_status('1.1.1.1', r)
{'activity_end': '12/31/2019 7:00 PM',
'activity_start': '12/31/2019 10:00 AM',
'comments': '',
'complaint_rate': '< 0.1%',
'data_commands': '1894',
'filter_result': 'GREEN',
'ip_address': '1.1.1.1',
'message_recipients': '1894',
'rcpt_commands': '1895',
'sample_helo': '',
'sample_mailfrom': '',
'trap_message_end': '',
'trap_message_start': '',
'traphits': '0'}
CLI
This library contains a CLI to facilitate fast operations in the terminal. Here are some examples of their usage:
Summary of all IPs status
snds -k 'your-key-here' -s
Example output:
Date: 12/31/2020
IPs: 1915
Green: 250
Yellow: 1175
Red: 490
Trap Hits: 990
Blocked: 193
Individual report of a IP
snds -k 'your-key-here' -ip '1.1.1.1'
Example output:
Activity: 1/31/2020 11:59 AM until 1/31/2020 11:59 PM
IP: 1.1.1.1
Messages: 183057
Filter: GREEN
Complaint: < 0.1%
Trap Hits: 3
List all IPs blocked
snds -k 'your-key-here' -l
Example output:
1.1.1.1
1.1.1.2
1.1.1.3
...
List all IPs blocked with rDNS
snds -k 'your-key-here' -r
Example output:
1.1.1.1;example.domain1.com
1.1.1.2;example.domain2.com
1.1.1.3;example.domain3.com
...
You can get more information about SNDS features in the Microsoft's official pages for SNDS and SNDS Automated Data Access.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.