whatportis

.. image:: https://github.com/opencve/opencve/workflows/Tests/badge.svg :target: https://github.com/ncrocfer/whatportis/actions/workflows/tests.yml

.. image:: https://badge.fury.io/py/whatportis.svg :target: https://pypi.python.org/pypi/whatportis/

.. image:: https://img.shields.io/badge/python-3.6%2B-blue.svg :target: https://pypi.python.org/pypi/whatportis/

.. image:: https://img.shields.io/github/license/ncrocfer/whatportis.svg :target: https://github.com/ncrocfer/whatportis/blob/master/LICENSE.txt

.. image:: https://img.shields.io/badge/code%20style-black-000000.svg :target: https://github.com/python/black

إنها مهمة شائعة البحث عن رقم المنفذ الافتراضي لخدمة ما. بعض المنافذ متوفرة في ملف :code:/etc/services، لكن القائمة غير كاملة وهذا الحل غير محمول.

Whatportis هي أداة بسيطة تقوم بتنزيل قاعدة بيانات Iana.org <http://www.iana.org/assignments/port-numbers>_ وتستخدمها لاستكشاف القائمة الرسمية للمنافذ.

الاستخدام

تتيح لك Whatportis معرفة المنفذ المرتبط بخدمة:

.. code-block:: shell

$ whatportis redis
+-------+------+----------+---------------------------------------+
| Name  | Port | Protocol | Description                           |
+-------+------+----------+---------------------------------------+
| redis | 6379 |   tcp    | An advanced key-value cache and store |
+-------+------+----------+---------------------------------------+

أو، بالعكس، معرفة الخدمة المرتبطة برقم منفذ:

.. code-block:: shell

$ whatportis 5432
+------------+------+----------+---------------------+
| Name       | Port | Protocol | Description         |
+------------+------+----------+---------------------+
| postgresql | 5432 | tcp, udp | PostgreSQL Database |
+------------+------+----------+---------------------+

يمكنك أيضًا البحث بنمط دون معرفة الاسم الدقيق بإضافة الخيار :code:--like:

.. code-block:: shell

$ whatportis mysql --like
+----------------+-------+----------+-----------------------------------+
| Name           |  Port | Protocol | Description                       |
+----------------+-------+----------+-----------------------------------+
| mysql-cluster  |  1186 | tcp, udp | MySQL Cluster Manager             |
| mysql-cm-agent |  1862 | tcp, udp | MySQL Cluster Manager Agent       |
| mysql-im       |  2273 | tcp, udp | MySQL Instance Manager            |
| mysql          |  3306 | tcp, udp | MySQL                             |
| mysql-proxy    |  6446 | tcp, udp | MySQL Proxy                       |
| mysqlx         | 33060 |   tcp    | MySQL Database Extended Interface |
+----------------+-------+----------+-----------------------------------+

التثبيت

.. code-block:: shell

$ pip install whatportis

مزامنة قاعدة البيانات

تستخدم Whatportis ملف JSON محلي (:code:~/.whatportis_db.json) لاستكشاف قائمة المنافذ. الاستخدام الأول سينشئه لك، ثم يمكنك استخدام الخيار :code:--update لمزامنته:

.. code-block:: shell

$ whatportis --update
Previous database will be updated, do you want to continue? [y/N]: y
Downloading https://www.iana.org/assignments/service-names-port-numbers/service-names-port-numbers.csv...
Populating database...
14145 ports imported.

إخراج JSON

يمكنك عرض النتائج بصيغة JSON باستخدام الخيار :code:--json:

.. code-block:: shell

$ whatportis 5432 --json
[
    {
        "name": "postgresql",
        "port": "5432",
        "protocol": "tcp, udp",
        "description": "PostgreSQL Database"
    }
]

واجهة REST API

يمكن أيضًا تشغيل Whatportis كخادم واجهة برمجة تطبيقات RESTful. هذه الميزة غير مفعلة افتراضيًا، يجب تثبيت حزمة إضافية:

.. code-block:: shell

$ pip install whatportis[server]
$ whatportis --server localhost 8080
 * Serving Flask app "whatportis.server" (lazy loading)
 * Environment: prod
 * Debug mode: off
 * Running on http://127.0.0.1:8080/ (Press CTRL+C to quit)

نقاط النهاية هي :code:/ports للقائمة الكاملة (قد تكون طويلة) و :code:/ports/<search> للبحث عن منفذ محدد:

.. code-block:: shell

$ curl http://127.0.0.1:8080/ports/3306
{"ports":[{"description":"MySQL","name":"mysql","port":"3306","protocol":"tcp, udp"}]}

$ curl http://localhost:8080/ports/redis
{"ports":[{"description":"An advanced key-value cache and store","name":"redis","port":"6379","protocol":"tcp"}]}

يمكنك استخدام المعامل :code:?like للبحث بنمط.