src/python/location-query.in

   1 #!/usr/bin/python3
   2 ###############################################################################
   3 #                                                                             #
   4 # libloc - A library to determine the location of someone on the Internet     #
   5 #                                                                             #
   6 # Copyright (C) 2017 IPFire Development Team <info@ipfire.org>                #
   7 #                                                                             #
   8 # This library is free software; you can redistribute it and/or               #
   9 # modify it under the terms of the GNU Lesser General Public                  #
  10 # License as published by the Free Software Foundation; either                #
  11 # version 2.1 of the License, or (at your option) any later version.          #
  12 #                                                                             #
  13 # This library is distributed in the hope that it will be useful,             #
  14 # but WITHOUT ANY WARRANTY; without even the implied warranty of              #
  15 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU           #
  16 # Lesser General Public License for more details.                             #
  17 #                                                                             #
  18 ###############################################################################
  19
  20 import argparse
  21 import ipaddress
  22 import os
  23 import socket
  24 import sys
  25 import time
  26
  27 # Load our location module
  28 import location
  29 from location.i18n import _
  30
  31 # Output formatters
  32
  33 class OutputFormatter(object):
  34         def __init__(self, ns):
  35                 self.ns = ns
  36
  37         def __enter__(self):
  38                 # Open the output
  39                 self.open()
  40
  41                 return self
  42
  43         def __exit__(self, type, value, tb):
  44                 if tb is None:
  45                         self.close()
  46
  47         @property
  48         def name(self):
  49                 if "country_code" in self.ns:
  50                         return "networks_country_%s" % self.ns.country_code[0]
  51
  52                 elif "asn" in self.ns:
  53                         return "networks_AS%s" % self.ns.asn[0]
  54
  55         def open(self):
  56                 pass
  57
  58         def close(self):
  59                 pass
  60
  61         def network(self, network):
  62                 print(network)
  63
  64
  65 class IpsetOutputFormatter(OutputFormatter):
  66         """
  67                 For nftables
  68         """
  69         def open(self):
  70                 print("create %s hash:net family inet hashsize 1024 maxelem 65536" % self.name)
  71
  72         def network(self, network):
  73                 print("add %s %s" % (self.name, network))
  74
  75
  76 class NftablesOutputFormatter(OutputFormatter):
  77         """
  78                 For nftables
  79         """
  80         def open(self):
  81                 print("define %s = {" % self.name)
  82
  83         def close(self):
  84                 print("}")
  85
  86         def network(self, network):
  87                 print(" %s," % network)
  88
  89
  90 class XTGeoIPOutputFormatter(OutputFormatter):
  91         """
  92                 Formats the output in that way, that it can be loaded by
  93                 the xt_geoip kernel module from xtables-addons.
  94         """
  95         def network(self, network):
  96                 n = ipaddress.ip_network("%s" % network)
  97
  98                 for address in (n.network_address, n.broadcast_address):
  99                         bytes = socket.inet_pton(
 100                                 socket.AF_INET6 if address.version == 6 else socket.AF_INET,
 101                                 "%s" % address,
 102                         )
 103
 104                         os.write(1, bytes)
 105
 106
 107 class CLI(object):
 108         output_formats = {
 109                 "ipset"    : IpsetOutputFormatter,
 110                 "list"     : OutputFormatter,
 111                 "nftables" : NftablesOutputFormatter,
 112                 "xt_geoip" : XTGeoIPOutputFormatter,
 113         }
 114
 115         def parse_cli(self):
 116                 parser = argparse.ArgumentParser(
 117                         description=_("Location Database Command Line Interface"),
 118                 )
 119                 subparsers = parser.add_subparsers()
 120
 121                 # Global configuration flags
 122                 parser.add_argument("--debug", action="store_true",
 123                         help=_("Enable debug output"))
 124                 parser.add_argument("--quiet", action="store_true",
 125                         help=_("Enable quiet mode"))
 126
 127                 # version
 128                 parser.add_argument("--version", action="version",
 129                         version="%(prog)s @VERSION@")
 130
 131                 # database
 132                 parser.add_argument("--database", "-d",
 133                         default="@databasedir@/database.db", help=_("Path to database"),
 134                 )
 135
 136                 # public key
 137                 parser.add_argument("--public-key", "-k",
 138                         default="@databasedir@/signing-key.pem", help=_("Public Signing Key"),
 139                 )
 140
 141                 # Show the database version
 142                 version = subparsers.add_parser("version",
 143                         help=_("Show database version"))
 144                 version.set_defaults(func=self.handle_version)
 145
 146                 # lookup an IP address
 147                 lookup = subparsers.add_parser("lookup",
 148                         help=_("Lookup one or multiple IP addresses"),
 149                 )
 150                 lookup.add_argument("address", nargs="+")
 151                 lookup.set_defaults(func=self.handle_lookup)
 152
 153                 # Dump the whole database
 154                 dump = subparsers.add_parser("dump",
 155                         help=_("Dump the entire database"),
 156                 )
 157                 dump.add_argument("output", nargs="?", type=argparse.FileType("w"))
 158                 dump.set_defaults(func=self.handle_dump)
 159
 160                 # Get AS
 161                 get_as = subparsers.add_parser("get-as",
 162                         help=_("Get information about one or multiple Autonomous Systems"),
 163                 )
 164                 get_as.add_argument("asn", nargs="+")
 165                 get_as.set_defaults(func=self.handle_get_as)
 166
 167                 # Search for AS
 168                 search_as = subparsers.add_parser("search-as",
 169                         help=_("Search for Autonomous Systems that match the string"),
 170                 )
 171                 search_as.add_argument("query", nargs=1)
 172                 search_as.set_defaults(func=self.handle_search_as)
 173
 174                 # List all networks in an AS
 175                 list_networks_by_as = subparsers.add_parser("list-networks-by-as",
 176                         help=_("Lists all networks in an AS"),
 177                 )
 178                 list_networks_by_as.add_argument("asn", nargs=1, type=int)
 179                 list_networks_by_as.add_argument("--family", choices=("ipv6", "ipv4"))
 180                 list_networks_by_as.add_argument("--output-format",
 181                         choices=self.output_formats.keys(), default="list")
 182                 list_networks_by_as.set_defaults(func=self.handle_list_networks_by_as)
 183
 184                 # List all networks in a country
 185                 list_networks_by_cc = subparsers.add_parser("list-networks-by-cc",
 186                         help=_("Lists all networks in a country"),
 187                 )
 188                 list_networks_by_cc.add_argument("country_code", nargs=1)
 189                 list_networks_by_cc.add_argument("--family", choices=("ipv6", "ipv4"))
 190                 list_networks_by_cc.add_argument("--output-format",
 191                         choices=self.output_formats.keys(), default="list")
 192                 list_networks_by_cc.set_defaults(func=self.handle_list_networks_by_cc)
 193
 194                 # List all networks with flags
 195                 list_networks_by_flags = subparsers.add_parser("list-networks-by-flags",
 196                         help=_("Lists all networks with flags"),
 197                 )
 198                 list_networks_by_flags.add_argument("--anonymous-proxy",
 199                         action="store_true", help=_("Anonymous Proxies"),
 200                 )
 201                 list_networks_by_flags.add_argument("--satellite-provider",
 202                         action="store_true", help=_("Satellite Providers"),
 203                 )
 204                 list_networks_by_flags.add_argument("--anycast",
 205                         action="store_true", help=_("Anycasts"),
 206                 )
 207                 list_networks_by_flags.add_argument("--family", choices=("ipv6", "ipv4"))
 208                 list_networks_by_flags.add_argument("--output-format",
 209                         choices=self.output_formats.keys(), default="list")
 210                 list_networks_by_flags.set_defaults(func=self.handle_list_networks_by_flags)
 211
 212                 args = parser.parse_args()
 213
 214                 # Configure logging
 215                 if args.debug:
 216                         location.logger.set_level(logging.DEBUG)
 217                 elif args.quiet:
 218                         location.logger.set_level(logging.WARNING)
 219
 220                 # Print usage if no action was given
 221                 if not "func" in args:
 222                         parser.print_usage()
 223                         sys.exit(2)
 224
 225                 return args
 226
 227         def run(self):
 228                 # Parse command line arguments
 229                 args = self.parse_cli()
 230
 231                 # Open database
 232                 try:
 233                         db = location.Database(args.database)
 234                 except FileNotFoundError as e:
 235                         sys.stderr.write("location-query: Could not open database %s: %s\n" \
 236                                 % (args.database, e))
 237                         sys.exit(1)
 238
 239                 # Translate family (if present)
 240                 if "family" in args:
 241                         if args.family == "ipv6":
 242                                 args.family = socket.AF_INET6
 243                         elif args.family == "ipv4":
 244                                 args.family = socket.AF_INET
 245                         else:
 246                                 args.family = 0
 247
 248                 # Call function
 249                 ret = args.func(db, args)
 250
 251                 # Return with exit code
 252                 if ret:
 253                         sys.exit(ret)
 254
 255                 # Otherwise just exit
 256                 sys.exit(0)
 257
 258         def handle_version(self, db, ns):
 259                 """
 260                         Print the version of the database
 261                 """
 262                 t = time.strftime(
 263                         "%a, %d %b %Y %H:%M:%S GMT", time.gmtime(db.created_at),
 264                 )
 265
 266                 print(t)
 267
 268         def handle_lookup(self, db, ns):
 269                 ret = 0
 270
 271                 format = "  %-24s: %s"
 272
 273                 for address in ns.address:
 274                         try:
 275                                 network = db.lookup(address)
 276                         except ValueError:
 277                                 print(_("Invalid IP address: %s") % address, file=sys.stderr)
 278
 279                         args = {
 280                                 "address" : address,
 281                                 "network" : network,
 282                         }
 283
 284                         # Nothing found?
 285                         if not network:
 286                                 print(_("Nothing found for %(address)s") % args, file=sys.stderr)
 287                                 ret = 1
 288                                 continue
 289
 290                         print("%s:" % address)
 291                         print(format % (_("Network"), network))
 292
 293                         # Print country
 294                         if network.country_code:
 295                                 country = db.get_country(network.country_code)
 296
 297                                 print(format % (
 298                                         _("Country"),
 299                                         country.name if country else network.country_code),
 300                                 )
 301
 302                         # Print AS information
 303                         if network.asn:
 304                                 autonomous_system = db.get_as(network.asn)
 305
 306                                 print(format % (
 307                                         _("Autonomous System"),
 308                                         autonomous_system or "AS%s" % network.asn),
 309                                 )
 310
 311                         # Anonymous Proxy
 312                         if network.has_flag(location.NETWORK_FLAG_ANONYMOUS_PROXY):
 313                                 print(format % (
 314                                         _("Anonymous Proxy"), _("yes"),
 315                                 ))
 316
 317                         # Satellite Provider
 318                         if network.has_flag(location.NETWORK_FLAG_SATELLITE_PROVIDER):
 319                                 print(format % (
 320                                         _("Satellite Provider"), _("yes"),
 321                                 ))
 322
 323                         # Anycast
 324                         if network.has_flag(location.NETWORK_FLAG_ANYCAST):
 325                                 print(format % (
 326                                         _("Anycast"), _("yes"),
 327                                 ))
 328
 329                 return ret
 330
 331         def handle_dump(self, db, ns):
 332                 # Use output file or write to stdout
 333                 f = ns.output or sys.stdout
 334
 335                 # Format everything like this
 336                 format = "%-24s %s\n"
 337
 338                 # Write metadata
 339                 f.write("#\n# Location Database Export\n#\n")
 340
 341                 f.write("# Generated: %s\n" % time.strftime(
 342                         "%a, %d %b %Y %H:%M:%S GMT", time.gmtime(db.created_at),
 343                 ))
 344
 345                 if db.vendor:
 346                         f.write("# Vendor:    %s\n" % db.vendor)
 347
 348                 if db.license:
 349                         f.write("# License:   %s\n" % db.license)
 350
 351                 f.write("#\n")
 352
 353                 if db.description:
 354                         for line in db.description.splitlines():
 355                                 f.write("# %s\n" % line)
 356
 357                         f.write("#\n")
 358
 359                 # Iterate over all ASes
 360                 for a in db.ases:
 361                         f.write("\n")
 362                         f.write(format % ("aut-num:", "AS%s" % a.number))
 363                         f.write(format % ("name:", a.name))
 364
 365                 flags = {
 366                         location.NETWORK_FLAG_ANONYMOUS_PROXY    : "is-anonymous-proxy:",
 367                         location.NETWORK_FLAG_SATELLITE_PROVIDER : "is-satellite-provider:",
 368                         location.NETWORK_FLAG_ANYCAST            : "is-anycast:",
 369                 }
 370
 371                 # Iterate over all networks
 372                 for n in db.networks:
 373                         f.write("\n")
 374                         f.write(format % ("net:", n))
 375
 376                         if n.country_code:
 377                                 f.write(format % ("country:", n.country_code))
 378
 379                         if n.asn:
 380                                 f.write(format % ("aut-num:", n.asn))
 381
 382                         # Print all flags
 383                         for flag in flags:
 384                                 if n.has_flag(flag):
 385                                         f.write(format % (flags[flag], "yes"))
 386
 387         def handle_get_as(self, db, ns):
 388                 """
 389                         Gets information about Autonomous Systems
 390                 """
 391                 ret = 0
 392
 393                 for asn in ns.asn:
 394                         try:
 395                                 asn = int(asn)
 396                         except ValueError:
 397                                 print(_("Invalid ASN: %s") % asn, file=sys.stderr)
 398                                 ret = 1
 399                                 continue
 400
 401                         # Fetch AS from database
 402                         a = db.get_as(asn)
 403
 404                         # Nothing found
 405                         if not a:
 406                                 print(_("Could not find AS%s") % asn, file=sys.stderr)
 407                                 ret = 1
 408                                 continue
 409
 410                         print(_("AS%(asn)s belongs to %(name)s") % { "asn" : a.number, "name" : a.name })
 411
 412                 return ret
 413
 414         def handle_search_as(self, db, ns):
 415                 for query in ns.query:
 416                         # Print all matches ASes
 417                         for a in db.search_as(query):
 418                                 print(a)
 419
 420         def __get_output_formatter(self, ns):
 421                 try:
 422                         cls = self.output_formats[ns.output_format]
 423                 except KeyError:
 424                         cls = OutputFormatter
 425
 426                 return cls(ns)
 427
 428         def handle_list_networks_by_as(self, db, ns):
 429                 with self.__get_output_formatter(ns) as f:
 430                         for asn in ns.asn:
 431                                 # Print all matching networks
 432                                 for n in db.search_networks(asn=asn, family=ns.family):
 433                                         f.network(n)
 434
 435         def handle_list_networks_by_cc(self, db, ns):
 436                 with self.__get_output_formatter(ns) as f:
 437                         for country_code in ns.country_code:
 438                                 # Print all matching networks
 439                                 for n in db.search_networks(country_code=country_code, family=ns.family):
 440                                         f.network(n)
 441
 442         def handle_list_networks_by_flags(self, db, ns):
 443                 flags = 0
 444
 445                 if ns.anonymous_proxy:
 446                         flags |= location.NETWORK_FLAG_ANONYMOUS_PROXY
 447
 448                 if ns.satellite_provider:
 449                         flags |= location.NETWORK_FLAG_SATELLITE_PROVIDER
 450
 451                 if ns.anycast:
 452                         flags |= location.NETWORK_FLAG_ANYCAST
 453
 454                 with self.__get_output_formatter(ns) as f:
 455                         for n in db.search_networks(flags=flags, family=ns.family):
 456                                 f.network(n)
 457
 458
 459 def main():
 460         # Run the command line interface
 461         c = CLI()
 462         c.run()
 463
 464 main()