{ "info": { "author": "Steve William, NETSCOUT Systems, Inc.", "author_email": "swilliam@netscout.com", "bugtrack_url": null, "classifiers": [ "License :: OSI Approved :: MIT License", "Operating System :: OS Independent", "Programming Language :: Python" ], "description": "Edge Defense Manager Client\n===========================\n\nThis simple client allows you to use Edge Defense Manager's public API.\n\nRequirements\n------------\n\n- Python (tested on Python 2.7 and Python 3.6.5)\n- Requests\n\nInstallation:\n-------------\n\n.. code:: bash\n\n sudo pip install edm-client\n\nSource code is available on `GitHub\n`_.\n\nGenerating an API Token From Edge Defense Manager\n-------------------------------------------------\n\nAccess to the Edge Defense Manager API requires an API token for authentication. You generate the token in the EDM command line interface (CLI).\n\nThe API token is associated with the user account under which it is generated. Any user can generate an EDM API token, except for the root user.\n\nTo generate an EDM API token:\n\n#. Establish an SSH connection to EDM.\n\n#. Log in to the operating system CLI with your EDM credentials.\n\n#. To create the token, enter **edm\\_apitoken\\_gen**.\n\n The system responds with the new API token, for example:\n\n .. code:: json\n\n { \"admin\": \"LMttPZ45FXnJT6IokVh6Px-otiKGDMkUdyQmJMWmWGz\" }\n\n\n#. For later use, copy the token and then paste it to a text file.\n\n#. To log out of the CLI, enter **exit**\n\nTo View or delete a token, use one of the following commands.\n\n* edm\\_apitoken\\_show\n\n* edm\\_apitoken\\_delete\n\nUsing the Client\n----------------\n\nImport the package:\n\n.. code:: python\n\n from edmclient.edm import EdgeDefenseManager\n dev = EdgeDefenseManager(, , api_version=, raise_on_error=)\n\nManaging Devices\n~~~~~~~~~~~~~~~~\n\nAdd a device:\n\n.. code:: python\n\n dev.devices.add(host='aed_1.example.com',\n apiToken='WWPi7_',\n name='AED_1')\n\nView devices:\n\n.. code:: python\n\n dev.devices.show()\n dev.devices.show(id=1)\n\nRemove devices:\n\n.. code:: python\n\n dev.devices.remove(id=1)\n\nUpdate a device:\n\n.. code:: python\n\n dev.devices.update(id=1,\n host='aed_1.example.com',\n apiToken='WWPi7_',\n name='AED_1')\n\nPartially update a device:\n\n.. code:: python\n\n dev.devices.update(id=1, name='NEW_AED_1')\n dev.devices.update(id=1, apiToken='sdf79_kjI')\n\nViewing Alerts\n~~~~~~~~~~~~~~\n\nView threats:\n\n.. code:: python\n\n dev.alerts.threats.show(start='2018-09-08T00:00:00Z')\n\nView DDoS alerts:\n\n.. code:: python\n\n dev.alerts.ddos.show(start='2018-09-08T00:00:00Z')\n\nView DDoS counts:\n\n.. code:: python\n\n dev.alerts.ddos.count.show(start='2018-09-08T00:00:00Z')\n\nViewing Traffic\n~~~~~~~~~~~~~~~\n\nView traffic:\n\n.. code:: python\n\n dev.traffic.edge.show(start='2018-09-08T00:00:00Z')\n\nViewing Contextual Threat Intelligence (CTI)\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nView CTI data:\n\n.. code:: python\n\n dev.cti.insights.show(indicatorValue='1.2.3.4')\n\nConfiguring CTI\n~~~~~~~~~~~~~~~\n\nView the CTI configuration:\n\n.. code:: python\n\n dev.configuration.cti.show()\n\nAdd or Update the CTI configuration:\n\n.. code:: python\n\n dev.configuration.cti.update(cti_token='ajfdgFJGFGmh27hnbv')\n\nRunning Unit Tests\n------------------\n\nIf ``nose`` is not installed, then run:\n\n.. code:: bash\n\n pip3 install nose\n\nRun the following command from the package directory:\n\n.. code:: bash\n\n nosetests\n\n\n\n", "description_content_type": "", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "", "keywords": "", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "edm-client", "package_url": "https://pypi.org/project/edm-client/", "platform": "", "project_url": "https://pypi.org/project/edm-client/", "project_urls": null, "release_url": "https://pypi.org/project/edm-client/1.1.0/", "requires_dist": [ "requests" ], "requires_python": "", "summary": "Edge Defense Manager Client", "version": "1.1.0" }, "last_serial": 5125881, "releases": { "1.0": [ { "comment_text": "", "digests": { "md5": "72e5aaedb28ea706690c7a80e0002251", "sha256": "9f7ab2b0085388f1c94fb290102d3e8e81221523345b00c4e5db14ebc469e4c9" }, "downloads": -1, "filename": "edm_client-1.0-py3-none-any.whl", "has_sig": false, "md5_digest": "72e5aaedb28ea706690c7a80e0002251", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 8961, "upload_time": "2019-03-07T20:38:40", "url": "https://files.pythonhosted.org/packages/cb/9a/143eabe79fc4c5ca9a2efaa6b3c4e67cad96f6d45e3a191f0c0aa372668d/edm_client-1.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "9dc15a5835f17ae813f57f7648498803", "sha256": "3b85501e658cb7e389e4146c0a0cf7a4867bfb458a7a1053faa7460a8e0b0616" }, "downloads": -1, "filename": "edm-client-1.0.tar.gz", "has_sig": false, "md5_digest": "9dc15a5835f17ae813f57f7648498803", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5789, "upload_time": "2019-03-07T20:38:42", "url": "https://files.pythonhosted.org/packages/92/81/25b68ca4ae9308b0697c833beda909fc2740e8b050f5e2d2f262d0f1d0fa/edm-client-1.0.tar.gz" } ], "1.0.1": [ { "comment_text": "", "digests": { "md5": "e86e1c4033ba78b7a0db334883ec2b03", "sha256": "55259e1f504d060e606caa878e1203a4cf232a23ea3ef55e27819eec634e99c3" }, "downloads": -1, "filename": "edm_client-1.0.1-py3-none-any.whl", "has_sig": false, "md5_digest": "e86e1c4033ba78b7a0db334883ec2b03", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 9099, "upload_time": "2019-03-20T19:00:37", "url": "https://files.pythonhosted.org/packages/3b/79/ca3aca2e9aa64419763d897378e35ace2c863e4f9df2e5c24a131ff4ce5f/edm_client-1.0.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "5a9f495cfb865c5efb5a4fde1fdca882", "sha256": "ca53369e320f9d7dbd8330369194dd14eea0f64cb2b004e8afb7e408a1247cb2" }, "downloads": -1, "filename": "edm-client-1.0.1.tar.gz", "has_sig": false, "md5_digest": "5a9f495cfb865c5efb5a4fde1fdca882", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5890, "upload_time": "2019-03-20T19:00:38", "url": "https://files.pythonhosted.org/packages/89/ca/8e64b4c84c883c9a88f9d1c342dd9459852c2e370d4d78940894e175e012/edm-client-1.0.1.tar.gz" } ], "1.0.2": [ { "comment_text": "", "digests": { "md5": "1be3b36dede225f67a6362ba6f29482b", "sha256": "9f5e7ed45db00ff5c21a724f7ed5b3867a1519ff010f8f2e1cd5f6f295aec09a" }, "downloads": -1, "filename": "edm_client-1.0.2-py3-none-any.whl", "has_sig": false, "md5_digest": "1be3b36dede225f67a6362ba6f29482b", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 9098, "upload_time": "2019-04-08T13:29:46", "url": "https://files.pythonhosted.org/packages/b5/79/7edd5d9107f0651424edbdca560fbac3b4d9771b2f735f24db66f9067e6d/edm_client-1.0.2-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "f7db2fb6dcd7073db52b5ae2b38fe2b3", "sha256": "b7b0708540f086cd010af868530d5b21ecb1de4b646ace90fedb57b284989aa1" }, "downloads": -1, "filename": "edm-client-1.0.2.tar.gz", "has_sig": false, "md5_digest": "f7db2fb6dcd7073db52b5ae2b38fe2b3", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5864, "upload_time": "2019-04-08T13:29:47", "url": "https://files.pythonhosted.org/packages/f3/57/34ffc82d2fe287de536ce01982a9b3c5408511b69b12b18cbbd48c41381d/edm-client-1.0.2.tar.gz" } ], "1.1.0": [ { "comment_text": "", "digests": { "md5": "45c73b20ed38c0cff43968cd9e1d80fb", "sha256": "732894be3a66db3b032977d2551143433d688b2815eb4cea1bd9f36b7248ebb4" }, "downloads": -1, "filename": "edm_client-1.1.0-py3-none-any.whl", "has_sig": false, "md5_digest": "45c73b20ed38c0cff43968cd9e1d80fb", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 9614, "upload_time": "2019-04-10T20:46:47", "url": "https://files.pythonhosted.org/packages/7f/58/722912fd797e98bb72d00ed8ea5ce861bad6b28435264357868b0c6a6a8d/edm_client-1.1.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "268715d2df5bcbc00491a29a54983df8", "sha256": "43e69994fb01cd893e8a260115437d037e4bf994897639f7eee85048b969b55b" }, "downloads": -1, "filename": "edm-client-1.1.0.tar.gz", "has_sig": false, "md5_digest": "268715d2df5bcbc00491a29a54983df8", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6179, "upload_time": "2019-04-10T20:46:48", "url": "https://files.pythonhosted.org/packages/f5/e2/d4dc97f833cdde9bc366a30bdc076f1a91217ab95be5070f27022732cbc5/edm-client-1.1.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "45c73b20ed38c0cff43968cd9e1d80fb", "sha256": "732894be3a66db3b032977d2551143433d688b2815eb4cea1bd9f36b7248ebb4" }, "downloads": -1, "filename": "edm_client-1.1.0-py3-none-any.whl", "has_sig": false, "md5_digest": "45c73b20ed38c0cff43968cd9e1d80fb", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 9614, "upload_time": "2019-04-10T20:46:47", "url": "https://files.pythonhosted.org/packages/7f/58/722912fd797e98bb72d00ed8ea5ce861bad6b28435264357868b0c6a6a8d/edm_client-1.1.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "268715d2df5bcbc00491a29a54983df8", "sha256": "43e69994fb01cd893e8a260115437d037e4bf994897639f7eee85048b969b55b" }, "downloads": -1, "filename": "edm-client-1.1.0.tar.gz", "has_sig": false, "md5_digest": "268715d2df5bcbc00491a29a54983df8", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6179, "upload_time": "2019-04-10T20:46:48", "url": "https://files.pythonhosted.org/packages/f5/e2/d4dc97f833cdde9bc366a30bdc076f1a91217ab95be5070f27022732cbc5/edm-client-1.1.0.tar.gz" } ] }