{ "info": { "author": "Apility.io Devops Team", "author_email": "devops@apility.io", "bugtrack_url": null, "classifiers": [ "Development Status :: 3 - Alpha", "Intended Audience :: Developers", "Intended Audience :: Science/Research", "License :: OSI Approved :: Apache Software License", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3.4", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6", "Topic :: Security", "Topic :: Software Development :: Libraries :: Python Modules" ], "description": "Apility.io Command Line Interface (CLI) tool\n============================================\n\n|Build Status|\n\nIntroduction\n------------\n\nApility.io can be defined as Threat Intelligence SaaS for developers and\nproduct companies that want to know in realtime if their existing or\npotential users have been classified as \u2018abusers\u2019 by one or more of\nthese lists.\n\nAutomatic extraction processes extracts all the information in realtime,\nkeeping the most up to date data available, saving yourself the hassle\nof extract and update regularly all these lists and the data.\n\nWhat does Apility.io offer?\n---------------------------\n\nApility.io offers an extremely simple and minimalistic API to access in\nrealtime to these lists and do the following simple question about the\nresource?\n\nIs this IP, domain or email stored in any blacklist?\n\nThe answers to this question can be:\n\n- YES: The resource can be found in an abusers\u2019 list. This is a bad\n resource.\n- NO: The resource cannot be found in any abusers\u2019 list. This is a\n clean resource.\n\nA bad resource implies some kind of action from developers\u2019 side. A\nclean resource does not need any action from their side.\n\nWhat does Apility.io CLI offer?\n-------------------------------\n\nThe Command Line Interface offers a tool to take advantage of all the\nfeatures of the API right from the command line interface of the user\u2019s\nfavourite Operating System. The Apility.io CLI has been tested on\nMicrosoft Windows, Apple macOS and several popular GNU/Linux\ndistributions. But if the Operating system can execute Python, it can\nrun the CLI.\n\nSupported Python Versions\n-------------------------\n\nThis client is supported for Python 2 and 3, for versions 2.7+ and 3.4+\nrespectively. It is recommended that Python 2 users use python 2.7.9+ to\ntake advantage of the SSL Certificate Validation feature that is not\nincluded in earlier versions.\n\nInstallation\n------------\n\nPIP\n~~~\n\nA user can install the Apility.io CLI with *pip*:\n\n::\n\n\n $ pip install apilityio-cli\n\nEASY_INSTALL\n~~~~~~~~~~~~\n\nA user install the Apility.io CLI with *easy_install* too:\n\n::\n\n\n $ easy_install apilityio-cli\n\nVerify installation\n-------------------\n\nTo verify if the command has been succesfully installed, the user can\nopen a terminal in the target Operating System and type the *apility*\ncommand as follows:\n\n::\n\n\n $ apility\n usage: apility [-h] [--apikey APIKEY] [--config CONFIG]\n [--format {XML,CSV,TEXT,JSON}]\n [--tableonly TABLEONLY] [--rows ROWS] [--page PAGE]\n [--timestamp TIMESTAMP]\n {badip,baddomain,bademail,geoip,asip,asnum,whoisip,historyip,historydomain,historyemail,getquarantine}\n parameter\n apility: error: the following arguments are required: command, parameter\n\nIf the command is not found in the PATH of the user\u2019s session probably\nthe tool has not been installed correctly. Please contact our support\nteam or `check our issue\ntracker `__.\n\nUse the CLI without an API KEY (anonymous mode)\n-----------------------------------------------\n\nIf the user does not provide a valid API KEY the CLI tool will work in\n*anonymous mode*. In this mode the API has a limit of 100 hits per day\nand per IP address, enough for quick testing and sporadic use. If the\nuser needs more hits then he/she has to `register in our\nsite `__ and `obtain a valid\nAPI KEY `__. The FREE plan\nallows 250 hits per day. If you need more hits per day you should\nconsider an upgrade to some our paid plans.\n\nUse the CLI with an API KEY\n---------------------------\n\nIf the user already has a valid API KEY then he/she has to pass it with\nthe CLI. There are three different ways to do it:\n\n- Use the *\u2013apikey* optional parameter in every single command\n executed.\n- Create an environment variable called APILITYIO_API_KEY and assign\n the API KEY before executing any command.\n- Write a configuration file readable by the command line tool.\n\n\u2013apikey optional parameter\n~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nThe easiest way to pass the API KEY to the command line has the trade\noff of adding parameters to the command that can be unnecesary. Example:\n\n::\n\n\n $ apility badip 1.2.3.4 --apikey=USER_API_KEY\n +---+------------+-------------------+\n | ! | IP ADDRESS | BLACKLISTS |\n +---+------------+-------------------+\n | ! | 1.2.3.4 | STOPFORUMSPAM-365 |\n | | | STOPFORUMSPAM-90 |\n | | | STOPFORUMSPAM-180 |\n +---+------------+-------------------+\n\nAPILITYIO_API_KEY environment variable.\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nUsing a environment variable hides the token from prying eyes. Example:\n\n::\n\n\n $ APILITYIO_API_KEY=USER_API_KEY\n $ apility badip 1.2.3.4\n +---+------------+-------------------+\n | ! | IP ADDRESS | BLACKLISTS |\n +---+------------+-------------------+\n | ! | 1.2.3.4 | STOPFORUMSPAM-365 |\n | | | STOPFORUMSPAM-90 |\n | | | STOPFORUMSPAM-180 |\n +---+------------+-------------------+\n\nConfiguration files\n~~~~~~~~~~~~~~~~~~~\n\nThe CLI try to read several configuration files following this workflow:\n\n1. *apilityio.conf* file in the same directory where the command is\n launched. It has the highest priority.\n2. *.apilityio* file in the same directory where the command is\n launched.\n3. *.apility.io* file in the $HOME directory of the user executing the\n command. It has the lowest priority.\n\nThis configuration file only contains a section *CLIENT* and several\nparameters:\n\n::\n\n\n [CLIENT]\n api_key=USER_API_KEY\n protocol=CONNECTION PROTOCOL: http OR https (LOWECASE)\n host=API ENDPOINT HOST. BY DEFAULT IS api.apility.net\n\nCLI Optional Parameters\n-----------------------\n\nThe mandatory parameters will be explained in detail in the next\nsection, but there are a set of optional parameters that are common to\nall or several mandatory parameters:\n\n- *\u2013apikey*: As explained before, it\u2019s possible to pass the API KEY\n right in the command line as a parameter.\n- *\u2013config*: If the configuration file is located or named not\n following the conventions.\n- *\u2013format*: The command line can export the information in four\n different formats:\n\n1. *TEXT*: Key/value or Tabular text output depending on the number of\n results and the parameter *\u2013tableonly*.\n2. *CSV*: Tabular comma-separated output. Strings are inside double\n quotes and lists of elements are separated by semicolons.\n3. *JSON*: Direct dump of the JSON format used by the REST API.\n4. *XML*: Transformation of the JSON format to XML.\n\n- *\u2013tableonly*: If the commands only return one result then the Text\n output is formated as a Key/Value table. If the command returns more\n than one result the Text output is formated as pure tabular format\n where the first row is the header with the field names. If this\n paramater is passed with the value TRUE then the Key/Value format is\n overriden even when the command only returns one result.\n- *\u2013rows*: If the command returns multiple items it can limit the\n number of items per page with this command. Only applies to some\n commands.\n- *\u2013page*: If the command returns multiple items it can paginate the\n results. Only applies to some commands.\n- *\u2013timestamp*: If the command returns multiple items it can limit the\n timestamp of the results. Only applies to some commands. In\n milliseconds.\n\nCLI commands\n------------\n\nbadip IP_ADDRESSES\n~~~~~~~~~~~~~~~~~~\n\nCheck if an IP address or a list of IP addresses belong to any list of\nthe blacklist databases of Apility.io. It also returns the blacklists\nwhere the IP addresses were found. IP addresses are passed as a\ncomma-separated list. For details about all fields returned by the call\nread https://apility.io/apidocs/#ip-check.\n\nExample single IP address:\n\n::\n\n\n $ apility badip 1.2.3.4\n +---+------------+-------------------+\n | ! | IP ADDRESS | BLACKLISTS |\n +---+------------+-------------------+\n | ! | 1.2.3.4 | STOPFORUMSPAM-365 |\n | | | STOPFORUMSPAM-90 |\n | | | STOPFORUMSPAM-180 |\n +---+------------+-------------------+\n\nExample multiple IP addresses:\n\n::\n\n\n $ apility badip 1.2.3.4,8.8.8.8,1.1.1.1,0.0.0.1\n +---+------------+-------------------+\n | ! | IP ADDRESS | BLACKLISTS |\n +---+------------+-------------------+\n | ! | 1.2.3.4 | STOPFORUMSPAM-365 |\n | | | STOPFORUMSPAM-90 |\n | | | STOPFORUMSPAM-180 |\n | | 1.1.1.1 | |\n | ! | 0.0.0.1 | TEAMCYMRU-BOGONS |\n | | | IANA-BOGONS |\n | | 8.8.8.8 | |\n +---+------------+-------------------+\n\nExample multiple IP addresses CSV output:\n\n::\n\n\n apility badip 1.2.3.4,8.8.8.8,1.1.1.1,0.0.0.1 --format=CSV\n \"IP ADDRESS\",\"BLACKLISTS\"\n \"1.1.1.1\",\"\"\n \"0.0.0.1\",\"TEAMCYMRU-BOGONS;IANA-BOGONS\"\n \"1.2.3.4\",\"STOPFORUMSPAM-365;STOPFORUMSPAM-90;STOPFORUMSPAM-180\"\n \"8.8.8.8\",\"\"\n\nExample multiple IP addresses JSON output:\n\n::\n\n\n apility badip 1.2.3.4,8.8.8.8,1.1.1.1,0.0.0.1 --format=JSON\n {\n \"response\": [\n {\n \"blacklists\": \"\",\n \"ip\": \"1.1.1.1\"\n },\n {\n \"blacklists\": \"TEAMCYMRU-BOGONS,IANA-BOGONS\",\n \"ip\": \"0.0.0.1\"\n },\n {\n \"blacklists\": \"STOPFORUMSPAM-365,STOPFORUMSPAM-90,STOPFORUMSPAM-180\",\n \"ip\": \"1.2.3.4\"\n },\n {\n \"blacklists\": \"\",\n \"ip\": \"8.8.8.8\"\n }\n ]\n }\n\nExample multiple IP addresses XML output:\n\n::\n\n\n apility badip 1.2.3.4,8.8.8.8,1.1.1.1,0.0.0.1 --format=XML\n \n \n \n \n \n \n \n TEAMCYMRU-BOGONS,IANA-BOGONS\n \n \n STOPFORUMSPAM-365,STOPFORUMSPAM-90,STOPFORUMSPAM-180\n \n \n \n \n \n \n\nbaddomain DOMAINS\n~~~~~~~~~~~~~~~~~\n\nCheck if a domain or a list of Domain and its MX and NS records belong\nto any list of the blacklist databases of Apility.io. It returns a list\nof the scoring and blacklists where the Domains info were found. For\ndetails about all fields returned by the call read\nhttps://apility.io/apidocs/#domain-check.\n\nExample single domain:\n\n::\n\n\n $ apility badip baddomain mailinator.com\n +-----------------------+-------------------------+\n | KEY | VALUE |\n +-----------------------+-------------------------+\n | SCORE | -2 |\n | DOMAIN | mailinator.com |\n | DOMAIN SCORE | -2 |\n | DOMAIN BLACKLISTS | LISINGE-DED |\n | | DEA |\n | | MARTENSON-DED |\n | | IVOLO-DED |\n | MX BLACKLISTS | LISINGE-DED |\n | | IVOLO-DED |\n | | MARTENSON-DED |\n | | DEA |\n | MX HOSTS | mail.mailinator.com |\n | | mail2.mailinator.com |\n | NS BLACKLISTS | |\n | NS HOSTS | james.ns.cloudflare.com |\n | | betty.ns.cloudflare.com |\n | DOMAIN IP | 104.25.199.31 |\n | DOMAIN IP SCORE | -1 |\n | DOMAIN IP BLACKLISTS | LISINGE-DED-IP |\n | | IVOLO-DED-IP |\n | | MARTENSON-DED-IP |\n | DOMAIN IP QUARANTINED | False |\n | SOURCE IP | 79.156.253.222 |\n | SOURCE IP SCORE | 0 |\n | SOURCE IP BLACKLISTS | |\n | SOURCE IP QUARANTINED | False |\n +-----------------------+-------------------------+\n\nExample multiple domains:\n\n::\n\n\n $ apility badip baddomain mailinator.com,apility.io,google.com\n +-------+----------------+--------------+-------------------+---------------+----------+-------------------------+-------------------------+----------------+-----------------+----------------------+-----------------------+----------------+-----------------+----------------------+-----------------------+\n | SCORE | DOMAIN | DOMAIN SCORE | DOMAIN BLACKLISTS | MX BLACKLISTS | MX HOSTS | NS BLACKLISTS | NS HOSTS | DOMAIN IP | DOMAIN IP SCORE | DOMAIN IP BLACKLISTS | DOMAIN IP QUARANTINED | SOURCE IP | SOURCE IP SCORE | SOURCE IP BLACKLISTS | SOURCE IP QUARANTINED |\n +-------+----------------+--------------+-------------------+---------------+----------+-------------------------+-------------------------+----------------+-----------------+----------------------+-----------------------+----------------+-----------------+----------------------+-----------------------+\n | -2 | mailinator.com | -1 | LISINGE-DED | LISINGE-DED | | mail2.mailinator.com | betty.ns.cloudflare.com | 104.25.198.31 | -1 | LISINGE-DED-IP | False | 79.156.253.222 | 0 | | False |\n | | | | DEA | IVOLO-DED | | mail.mailinator.com | james.ns.cloudflare.com | | | IVOLO-DED-IP | | | | | |\n | | | | MARTENSON-DED | MARTENSON-DED | | | | | | MARTENSON-DED-IP | | | | | |\n | | | | IVOLO-DED | DEA | | | | | | | | | | | |\n | 0 | apility.io | 0 | | | | aspmx.l.google.com | pam.ns.cloudflare.com | 35.189.121.53 | 0 | | False | 79.156.253.222 | 0 | | False |\n | | | | | | | alt1.aspmx.l.google.com | alex.ns.cloudflare.com | | | | | | | | |\n | | | | | | | alt2.aspmx.l.google.com | | | | | | | | | |\n | | | | | | | aspmx2.googlemail.com | | | | | | | | | |\n | | | | | | | aspmx3.googlemail.com | | | | | | | | | |\n | 0 | google.com | 0 | | | | alt4.aspmx.l.google.com | ns2.google.com | 209.85.202.113 | 0 | | False | 79.156.253.222 | 0 | | False |\n | | | | | | | aspmx.l.google.com | ns3.google.com | | | | | | | | |\n | | | | | | | alt1.aspmx.l.google.com | ns4.google.com | | | | | | | | |\n | | | | | | | alt2.aspmx.l.google.com | ns1.google.com | | | | | | | | |\n | | | | | | | alt3.aspmx.l.google.com | | | | | | | | | |\n +-------+----------------+--------------+-------------------+---------------+----------+-------------------------+-------------------------+----------------+-----------------+----------------------+-----------------------+----------------+-----------------+----------------------+-----------------------+\n\nTabular can be hard to read, but it\u2019s possible to export the data to\nCSV, JSON and XML to import in your favourite editor.\n\nbademail EMAILS\n~~~~~~~~~~~~~~~\n\nCheck if an email or a list of Emails including all tests performed to\nthe Domain plus a full SMTP test on the remote server. It returns the\nglobal scoring of each Email and each scoring per test performed. For\ndetails about all fields returned by the call read\nhttps://apility.io/apidocs/#email-check.\n\nExample single email:\n\n::\n\n\n $ apility badip bademail test@mailinator.com\n +------------------------+-------------------------+\n | KEY | VALUE |\n +------------------------+-------------------------+\n | SCORE | -3 |\n | EMAIL | test@mailinator.com |\n | DOMAIN SCORE | -1 |\n | DOMAIN BLACKLISTS | IVOLO-DED |\n | | DEA |\n | | LISINGE-DED |\n | | MARTENSON-DED |\n | MX BLACKLISTS | LISINGE-DED |\n | | DEA |\n | | MARTENSON-DED |\n | | IVOLO-DED |\n | MX HOSTS | mail.mailinator.com |\n | | mail2.mailinator.com |\n | NS BLACKLISTS | |\n | NS HOSTS | james.ns.cloudflare.com |\n | | betty.ns.cloudflare.com |\n | EMAIL SCORE | 0 |\n | EMAIL BLACKLISTS | |\n | DOMAIN IP | 104.25.199.31 |\n | DOMAIN IP SCORE | -1 |\n | DOMAIN IP BLACKLISTS | LISINGE-DED-IP |\n | | IVOLO-DED-IP |\n | | MARTENSON-DED-IP |\n | DOMAIN IP QUARANTINED | False |\n | SOURCE IP | 79.156.253.222 |\n | SOURCE IP SCORE | 0 |\n | SOURCE IP BLACKLISTS | |\n | SOURCE IP QUARANTINED | False |\n | ADDRESS SCORE | 0 |\n | ADDRESS IS ROLE | False |\n | ADDRESS IS WELL FORMED | True |\n | SMTP SCORE | 0 |\n | SMTP EXIST MX | True |\n | SMTP EXIST ADDRESS | True |\n | SMTP CATCH ALL | True |\n | IS FREEMAIL SCORE | 0 |\n | IS FREEMAIL | False |\n | IS DISPOSABLE SCORE | -1 |\n | IS DISPOSABLE | True |\n +------------------------+-------------------------+\n\nExample multiple emails:\n\n::\n\n\n $ apility badip bademail mailinator.com,apility.io,google.com\n +-------+-------------------------------------+--------------+-------------------+---------------+----------+-------------------------+-------------------------+-------------+------------------+---------------+-----------------+----------------------+-----------------------+----------------+-----------------+----------------------+-----------------------+---------------+-----------------+------------------------+------------+---------------+--------------------+----------------+-------------------+-------------+---------------------+---------------+\n | SCORE | EMAIL | DOMAIN SCORE | DOMAIN BLACKLISTS | MX BLACKLISTS | MX HOSTS | NS BLACKLISTS | NS HOSTS | EMAIL SCORE | EMAIL BLACKLISTS | DOMAIN IP | DOMAIN IP SCORE | DOMAIN IP BLACKLISTS | DOMAIN IP QUARANTINED | SOURCE IP | SOURCE IP SCORE | SOURCE IP BLACKLISTS | SOURCE IP QUARANTINED | ADDRESS SCORE | ADDRESS IS ROLE | ADDRESS IS WELL FORMED | SMTP SCORE | SMTP EXIST MX | SMTP EXIST ADDRESS | SMTP CATCH ALL | IS FREEMAIL SCORE | IS FREEMAIL | IS DISPOSABLE SCORE | IS DISPOSABLE |\n +-------+-------------------------------------+--------------+-------------------+---------------+----------+-------------------------+-------------------------+-------------+------------------+---------------+-----------------+----------------------+-----------------------+----------------+-----------------+----------------------+-----------------------+---------------+-----------------+------------------------+------------+---------------+--------------------+----------------+-------------------+-------------+---------------------+---------------+\n | 0 | company@apility.io | 0 | | | | aspmx.l.google.com | alex.ns.cloudflare.com | 0 | | 35.189.121.53 | 0 | | False | 79.156.253.222 | 0 | | False | 0 | False | True | 0 | True | True | False | 0 | False | 0 | False |\n | | | | | | | aspmx2.googlemail.com | pam.ns.cloudflare.com | | | | | | | | | | | | | | | | | | | | | |\n | | | | | | | aspmx3.googlemail.com | | | | | | | | | | | | | | | | | | | | | | |\n | | | | | | | alt2.aspmx.l.google.com | | | | | | | | | | | | | | | | | | | | | | |\n | | | | | | | alt1.aspmx.l.google.com | | | | | | | | | | | | | | | | | | | | | | |\n | -3 | test@mailinator.com | -1 | IVOLO-DED | LISINGE-DED | | mail.mailinator.com | james.ns.cloudflare.com | 0 | | 104.25.198.31 | -1 | LISINGE-DED-IP | False | 79.156.253.222 | 0 | | False | 0 | False | True | 0 | True | True | True | 0 | False | -1 | True |\n | | | | DEA | DEA | | mail2.mailinator.com | betty.ns.cloudflare.com | | | | | IVOLO-DED-IP | | | | | | | | | | | | | | | | |\n | | | | LISINGE-DED | MARTENSON-DED | | | | | | | | MARTENSON-DED-IP | | | | | | | | | | | | | | | | |\n | | | | MARTENSON-DED | IVOLO-DED | | | | | | | | | | | | | | | | | | | | | | | | |\n | -1 | joenqptami@539a685ce18.bounceme.net | 0 | | | | | | 0 | | | 0 | | False | 79.156.253.222 | 0 | | False | 0 | False | True | -1 | False | False | False | 0 | False | 0 | False |\n +-------+-------------------------------------+--------------+-------------------+---------------+----------+-------------------------+-------------------------+-------------+------------------+---------------+-----------------+----------------------+-----------------------+----------------+-----------------+----------------------+-----------------------+---------------+-----------------+------------------------+------------+---------------+--------------------+----------------+-------------------+-------------+---------------------+---------------+\n\nTabular can be hard to read, but it\u2019s possible to export the data to\nCSV, JSON and XML to import in your favourite editor.\n\ngeoip IP_ADDRESSES\n~~~~~~~~~~~~~~~~~~\n\nGet the IP address geo-location information of a given IP address or\nlist of IP addresses. For details about all fields returned by the call\nread https://apility.io/apidocs/#geo-ip-look-up.\n\nExample single IP address:\n\n::\n\n\n $ apility geoip 212.231.122.11\n +----------------------+-------------------+\n | KEY | VALUE |\n +----------------------+-------------------+\n | IP ADDRESS | 212.231.122.11 |\n | LONGITUDE | 40.4172 |\n | LATITUDE | -3.684 |\n | HOSTNAME | |\n | CONTINENT | EU |\n | COUNTRY | ES |\n | REGION | |\n | CITY | |\n | POSTAL CODE | |\n | TIME ZONE | |\n | ACCURACY RADIUS | 500 |\n | CONTINENT_GEONAME_ID | 6255148 |\n | COUNTRY_GEONAME_ID | 2510769 |\n | REGION_GEONAME_ID | -1 |\n | CITY_GEONAME_ID | -1 |\n | ASN | 15704 |\n | AS NAME | Xtra Telecom S.A. |\n | AS COUNTRY | ES |\n | AS NETWORKS | 31.222.80.0/20 |\n | | 31.222.88.0/24 |\n ...\n | | 212.231.250.0/24 |\n | | 213.94.0.0/18 |\n +----------------------+-------------------+\n\nExample multiple IP addresses:\n\n::\n\n\n $ apility geoip 9.9.9.9,8.8.8.8,1.1.1.1\n +------------+-----------+--------------------+----------+-----------+---------+----------+----------+-------------+---------------------+-----------------+----------------------+--------------------+-------------------+-----------------+-------+--------------------+------------+------------------+\n | IP ADDRESS | LONGITUDE | LATITUDE | HOSTNAME | CONTINENT | COUNTRY | REGION | CITY | POSTAL CODE | TIME ZONE | ACCURACY_RADIUS | CONTINENT_GEONAME_ID | COUNTRY_GEONAME_ID | REGION_GEONAME_ID | CITY_GEONAME_ID | ASN | AS NAME | AS COUNTRY | AS NETWORKS |\n +------------+-----------+--------------------+----------+-----------+---------+----------+----------+-------------+---------------------+-----------------+----------------------+--------------------+-------------------+-----------------+-------+--------------------+------------+------------------+\n | 9.9.9.9 | 48.8582 | 2.3387000000000002 | | EU | FR | | | | Europe/Paris | 1000 | 6255148 | 3017382 | -1 | -1 | 19281 | QUAD9-AS-1 - Quad9 | US | |\n | 8.8.8.8 | 37.751 | -97.822 | | NA | US | | | | | 1000 | 6255149 | 6252001 | -1 | -1 | 15169 | Google LLC | US | 8.8.4.0/24 |\n | | | | | | | | | | | | | | | | | | | 8.8.8.0/24 |\n ...\n | | | | | | | | | | | | | | | | | | | 216.252.220.0/24 |\n | | | | | | | | | | | | | | | | | | | 216.252.222.0/24 |\n | 1.1.1.1 | -37.7 | 145.1833 | | OC | AU | Victoria | Research | 3095 | Australia/Melbourne | 1000 | 6255151 | 2077456 | 2145234 | 2151718 | 13335 | Cloudflare Inc | US | 1.0.0.0/24 |\n | | | | | | | | | | | | | | | | | | | 1.1.1.0/24 |\n ...\n | | | | | | | | | | | | | | | | | | | 199.21.96.0/22 |\n | | | | | | | | | | | | | | | | | | | 199.27.132.0/24 |\n +------------+-----------+--------------------+----------+-----------+---------+----------+----------+-------------+---------------------+-----------------+----------------------+--------------------+-------------------+-----------------+-------+--------------------+------------+------------------+\n\nasip IP_ADDRESSES\n~~~~~~~~~~~~~~~~~\n\nGet the Autonomous System information of a given IP address or list of\nIP addresses. For details about all fields returned by the call read\nhttps://apility.io/apidocs/#autonomous-system-look-up.\n\nExample single IP address:\n\n::\n\n\n $ apility asip 9.9.9.9\n +-------------+--------------------+\n | KEY | VALUE |\n +-------------+--------------------+\n | IP ADDRESS | 9.9.9.9 |\n | ASN | 19281 |\n | AS NAME | QUAD9-AS-1 - Quad9 |\n | AS COUNTRY | US |\n | AS NETWORKS | |\n +-------------+--------------------+\n\nExample multiple IP addresses:\n\n::\n\n\n $ apility asip 9.9.9.9,8.8.8.8,1.1.1.1\n +------------+-------+--------------------+------------+------------------+\n | IP ADDRESS | ASN | AS NAME | AS COUNTRY | AS NETWORKS |\n +------------+-------+--------------------+------------+------------------+\n | 9.9.9.9 | 19281 | QUAD9-AS-1 - Quad9 | US | |\n | 8.8.8.8 | 15169 | Google LLC | US | 8.8.4.0/24 |\n | | | | | 8.8.8.0/24 |\n | | | | | 8.34.208.0/21 |\n ...\n | | | | | 216.252.220.0/24 |\n | | | | | 216.252.222.0/24 |\n | 1.1.1.1 | 13335 | Cloudflare Inc | US | 1.0.0.0/24 |\n | | | | | 1.1.1.0/24 |\n ...\n | | | | | 199.21.96.0/22 |\n | | | | | 199.27.132.0/24 |\n +------------+-------+--------------------+------------+------------------+\n\nasnum AS_NUMBERS\n~~~~~~~~~~~~~~~~\n\nGet the Autonomous System information of a given AS Number or list of AS\nNumbers. For details about all fields returned by the call read\nhttps://apility.io/apidocs/#autonomous-system-look-up.\n\nExample single AS number:\n\n::\n\n\n $ apility asnum 19281\n +-------------+--------------------+\n | KEY | VALUE |\n +-------------+--------------------+\n | ASN | 19281 |\n | AS NAME | QUAD9-AS-1 - Quad9 |\n | AS COUNTRY | US |\n | AS NETWORKS | |\n +-------------+--------------------+\n\nExample multiple AS numbers:\n\n::\n\n\n $ apility asnum 19281,15169,13335\n +-------+--------------------+------------+------------------+\n | ASN | AS NAME | AS COUNTRY | AS NETWORKS |\n +-------+--------------------+------------+------------------+\n | 19281 | QUAD9-AS-1 - Quad9 | US | |\n | 15169 | Google LLC | US | 8.8.4.0/24 |\n | | | | 8.8.8.0/24 |\n ...\n | | | | 216.252.220.0/24 |\n | | | | 216.252.222.0/24 |\n | 13335 | Cloudflare Inc | US | 1.0.0.0/24 |\n | | | | 1.1.1.0/24 |\n ...\n | | | | 199.21.96.0/22 |\n | | | | 199.27.132.0/24 |\n +-------+--------------------+------------+------------------+\n\nwhoisip IP_ADDRESS\n~~~~~~~~~~~~~~~~~~\n\nGet the WHOIS information of a given IP address. For details about all\nfields returned by the call read\nhttps://apility.io/apidocs/#whois-query.\n\nExample:\n\n::\n\n\n $ apility whoisip 9.9.9.9\n +-----------------------+----------------------------------------------------------------------------------------------------------+\n | KEY | VALUE |\n +-----------------------+----------------------------------------------------------------------------------------------------------+\n | IP ADDRESS | 9.9.9.9 |\n | ASN | 19281 |\n | ASN CIDR | 9.9.9.0/24 |\n ...\n | | Description: Copyright 1997-2018, American Registry for Internet Numbers, Ltd. |\n | | Links: |\n +-----------------------+----------------------------------------------------------------------------------------------------------+\n\nhistoryip IP_ADDRESS [\u2013page=PAGE_NUMBER] [\u2013rows=ROWS_PER_PAGE] [\u2013timestamp=END_SEARCH_TIME]\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nGet the list of transactions of a given IP address in our database. For\nexperts who wish to know the historical activity of the given IP address\nin our database. For details about all fields returned by the call read\nhttps://apility.io/apidocs/#resource-history.\n\nExample:\n\n::\n\n\n $ apility historyip 1.2.3.4 --rows=5\n +---------------+------------+---------+-------------------+-------------------+\n | TIMESTAMP | IP ADDRESS | COMMAND | BLACKLIST CHANGES | BLACKLISTS |\n +---------------+------------+---------+-------------------+-------------------+\n | 1531952716955 | 1.2.3.4 | rem | UCEPROTECT-LEVEL1 | STOPFORUMSPAM-365 |\n | | | | | STOPFORUMSPAM-180 |\n | | | | | STOPFORUMSPAM-90 |\n | 1530155042672 | 1.2.3.4 | rem | STOPFORUMSPAM-30 | STOPFORUMSPAM-365 |\n | | | | | UCEPROTECT-LEVEL1 |\n | | | | | STOPFORUMSPAM-180 |\n | | | | | STOPFORUMSPAM-90 |\n | 1529908758047 | 1.2.3.4 | add | UCEPROTECT-LEVEL1 | STOPFORUMSPAM-365 |\n | | | | | STOPFORUMSPAM-30 |\n | | | | | UCEPROTECT-LEVEL1 |\n | | | | | STOPFORUMSPAM-180 |\n | | | | | STOPFORUMSPAM-90 |\n | 1529893785318 | 1.2.3.4 | rem | UCEPROTECT-LEVEL1 | STOPFORUMSPAM-365 |\n | | | | | STOPFORUMSPAM-30 |\n | | | | | STOPFORUMSPAM-180 |\n | | | | | STOPFORUMSPAM-90 |\n | 1528081288202 | 1.2.3.4 | rem | STOPFORUMSPAM-7 | STOPFORUMSPAM-365 |\n | | | | | STOPFORUMSPAM-30 |\n | | | | | UCEPROTECT-LEVEL1 |\n | | | | | STOPFORUMSPAM-180 |\n | | | | | STOPFORUMSPAM-90 |\n +---------------+------------+---------+-------------------+-------------------+\n\nhistorydomain DOMAIN [\u2013page=PAGE_NUMBER] [\u2013rows=ROWS_PER_PAGE] [\u2013timestamp=END_SEARCH_TIME]\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nGet the list of transactions of a given Domain in our database. For\nexperts who wish to know the historical activity of the given domain in\nour database. For details about all fields returned by the call read\nhttps://apility.io/apidocs/#resource-history.\n\nExample:\n\n::\n\n\n $ apility historydomain historydomain getfortniteapk.com --rows=5\n +---------------+--------------------+---------+----------------------------------+----------------------------------+\n | TIMESTAMP | DOMAIN | COMMAND | BLACKLIST CHANGES | BLACKLISTS |\n +---------------+--------------------+---------+----------------------------------+----------------------------------+\n | 1533614590795 | getfortniteapk.com | add | SQUIDBLACKLIST-MALICIOUS-DOMAINS | SQUIDBLACKLIST-MALICIOUS-DOMAINS |\n | 1533528178680 | getfortniteapk.com | rem | SQUIDBLACKLIST-MALICIOUS-DOMAINS | |\n | 1533269082869 | getfortniteapk.com | add | SQUIDBLACKLIST-MALICIOUS-DOMAINS | SQUIDBLACKLIST-MALICIOUS-DOMAINS |\n | 1532923315824 | getfortniteapk.com | rem | SQUIDBLACKLIST-MALICIOUS-DOMAINS | |\n | 1532750773430 | getfortniteapk.com | add | SQUIDBLACKLIST-MALICIOUS-DOMAINS | SQUIDBLACKLIST-MALICIOUS-DOMAINS |\n +---------------+--------------------+---------+----------------------------------+----------------------------------+\n\nhistoryemail EMAIL [\u2013page=PAGE_NUMBER] [\u2013rows=ROWS_PER_PAGE] [\u2013timestamp=END_SEARCH_TIME]\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nGet the list of transactions of a given Email in our database. For\nexperts who wish to know the historical activity of the given Email in\nour database. For details about all fields returned by the call read\nhttps://apility.io/apidocs/#resource-history.\n\nExample:\n\n::\n\n\n $ apility historydomain historyemail test@mailinator.com --rows=5\n +---------------+---------------------+---------+-------------------+-------------------+\n | TIMESTAMP | EMAIL | COMMAND | BLACKLIST CHANGES | BLACKLISTS |\n +---------------+---------------------+---------+-------------------+-------------------+\n | 1533527521294 | test@mailinator.com | rem | STOPFORUMSPAM-365 | |\n | 1518463557410 | test@mailinator.com | add | STOPFORUMSPAM-365 | STOPFORUMSPAM-365 |\n +---------------+---------------------+---------+-------------------+-------------------+\n\ngetquarantine [IP|COUNTRY|CONTINENT|ASN]\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nGet the list of IP addresses, Countries, Continents or Autonoumous\nSystems in the quarantine. Quarantine is a private exclusion lists based\non user IP address properties. For details about all fields returned by\nthe call read https://apility.io/apidocs/#quarantined-objects.\n\nExample of IP addresses in the quarantine:\n\n::\n\n\n $ apility getquaratine ip\n +-----------------+-------+\n | IP | TTL |\n +-----------------+-------+\n | 104.128.136.110 | 80395 |\n | 203.122.33.35 | 80442 |\n | 1.2.3.4 | -1 |\n +-----------------+-------+\n\nThe TTL (Time To Live) column is the time in seconds that the resource\n(IP address, Country, Continent or AS) will stay in the quarantine. -1\nmeans forever and any positive number is a countdown until zero when the\nresource will expire.\n\nExample of countries in the quarantine:\n\n::\n\n\n $ apility getquaratine country\n +---------+-----+\n | COUNTRY | TTL |\n +---------+-----+\n | AQ | -1 |\n +---------+-----+\n\nCountries can be any ISO-3166-1 country code.\n\nExample of continents in the quarantine:\n\n::\n\n\n $ apility getquaratine continent\n +-----------+-----+\n | CONTINENT | TTL |\n +-----------+-----+\n | EU | -1 |\n +-----------+-----+\n\nContinents codes can be EU, AS, NA, AF, AN, SA, OC.\n\nExample of Autonomous Systems in the quarantine:\n\n::\n\n\n $ apility getquaratine asn\n +-------+-----+\n | ASN | TTL |\n +-------+-----+\n | 13339 | -1 |\n +-------+-----+\n\nAPI Documentation\n-----------------\n\nThis CLI has been built around the python library. You can read the\nPython Library documentation here:\nhttp://apilityio-python-lib.readthedocs.io/en/latest/\n\nYou can also read the original REST API specification here:\nhttps://apility.io/apidocs\n\nContact Us\n----------\n\nDo you have an issue using the Apilityio Client Libraries? Or perhaps\nsome feedback for how we can improve them? Feel free to let us know on\nour `issue tracker `__\n\n.. |Build Status| image:: https://travis-ci.org/Apilityio/python-cli.svg?branch=dev\n :target: https://travis-ci.org/Apilityio/python-cli\n\n\n", "description_content_type": "", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/Apilityio/python-cli", "keywords": "apilityio apility abuse malicious cli", "license": "Apache License 2.0", "maintainer": "", "maintainer_email": "", "name": "apilityio-cli", "package_url": "https://pypi.org/project/apilityio-cli/", "platform": "any", "project_url": "https://pypi.org/project/apilityio-cli/", "project_urls": { "Homepage": "https://github.com/Apilityio/python-cli" }, "release_url": "https://pypi.org/project/apilityio-cli/0.0.2/", "requires_dist": [ "apilityio-lib", "prettytable (>=0.7.2)", "dicttoxml (>=1.7.4)", "configparser; python_version < \"3.0\"" ], "requires_python": "", "summary": "Apility.io Command Line Interface", "version": "0.0.2" }, "last_serial": 4149322, "releases": { "0.0.1": [ { "comment_text": "", "digests": { "md5": "884751411f7cbb20a204b33de66f9470", "sha256": "b84f9009c220d214117b8f054699848f3ddddbf38d57499ea36bf006c6b87f3a" }, "downloads": -1, "filename": "apilityio_cli-0.0.1-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "884751411f7cbb20a204b33de66f9470", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 34242, "upload_time": "2018-08-08T14:29:49", "url": "https://files.pythonhosted.org/packages/40/7a/e84362fcf31cea7dea5cf33e6c22ae4ba48a0bb91b97de67f438e6d08897/apilityio_cli-0.0.1-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "5cb00e3517a30b0496f895ab4d7a14e4", "sha256": "63c7743185221e10b6548f2fd1f796eedcfd1fbc484fe6c0dfe936277dc57b62" }, "downloads": -1, "filename": "apilityio-cli-0.0.1.tar.gz", "has_sig": false, "md5_digest": "5cb00e3517a30b0496f895ab4d7a14e4", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 44038, "upload_time": "2018-08-08T14:29:51", "url": "https://files.pythonhosted.org/packages/ee/46/26041328d5b9b614ad203e2f3d31dd292724d4866913ff5b2664e809c70b/apilityio-cli-0.0.1.tar.gz" } ], "0.0.2": [ { "comment_text": "", "digests": { "md5": "aa6d521836664c516940bcab940cea5c", "sha256": "df03378f39b75484e724f6a9e176ac4160608b3d384737ddac0b7a46a155d30e" }, "downloads": -1, "filename": "apilityio_cli-0.0.2-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "aa6d521836664c516940bcab940cea5c", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 34256, "upload_time": "2018-08-08T15:02:53", "url": "https://files.pythonhosted.org/packages/e9/69/8120abfd53066ffdae8ed6782f784c0ee9a839d70ab7b5e2a78488dd8b24/apilityio_cli-0.0.2-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "a16cecf32193d9b5954a09fac01f44e4", "sha256": "1a869a096db6cbb67434fe8e0b760e90e72922b4d4085154de14c652963af141" }, "downloads": -1, "filename": "apilityio-cli-0.0.2.tar.gz", "has_sig": false, "md5_digest": "a16cecf32193d9b5954a09fac01f44e4", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 44049, "upload_time": "2018-08-08T15:02:55", "url": "https://files.pythonhosted.org/packages/1f/78/065e100ef88ac831ba7898ce9f9571eb42b50d7a7f27fa0cdb31728c5ccc/apilityio-cli-0.0.2.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "aa6d521836664c516940bcab940cea5c", "sha256": "df03378f39b75484e724f6a9e176ac4160608b3d384737ddac0b7a46a155d30e" }, "downloads": -1, "filename": "apilityio_cli-0.0.2-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "aa6d521836664c516940bcab940cea5c", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 34256, "upload_time": "2018-08-08T15:02:53", "url": "https://files.pythonhosted.org/packages/e9/69/8120abfd53066ffdae8ed6782f784c0ee9a839d70ab7b5e2a78488dd8b24/apilityio_cli-0.0.2-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "a16cecf32193d9b5954a09fac01f44e4", "sha256": "1a869a096db6cbb67434fe8e0b760e90e72922b4d4085154de14c652963af141" }, "downloads": -1, "filename": "apilityio-cli-0.0.2.tar.gz", "has_sig": false, "md5_digest": "a16cecf32193d9b5954a09fac01f44e4", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 44049, "upload_time": "2018-08-08T15:02:55", "url": "https://files.pythonhosted.org/packages/1f/78/065e100ef88ac831ba7898ce9f9571eb42b50d7a7f27fa0cdb31728c5ccc/apilityio-cli-0.0.2.tar.gz" } ] }