{ "info": { "author": "TagCube", "author_email": "support@tagcube.io", "bugtrack_url": null, "classifiers": [ "Development Status :: 5 - Production/Stable", "Intended Audience :: Developers", "License :: OSI Approved :: GNU General Public License v2 (GPLv2)", "Natural Language :: English", "Operating System :: POSIX :: Linux", "Programming Language :: Python", "Programming Language :: Python :: 2.7", "Topic :: System :: Monitoring" ], "description": "TagCube's CLI tool\n==================\n\nLaunch web application security scans using `TagCube's REST API `_,\ncommonly used in continuous delivery scripts.\n\n.. image:: https://circleci.com/gh/tagcubeio/tagcube-cli.png?circle-token=5317e457dceef210130d20e0452eff7abf1d195b\n :alt: Build Status\n :align: right\n :target: https://circleci.com/gh/tagcubeio/tagcube-cli\n \nUsage\n=====\n\nThe easiest way to start a new scan is to call ``tagcube`` with the target\nURL as parameter:\n\n::\n\n $ export TAGCUBE_EMAIL=user@example.com\n $ export TAGCUBE_API_KEY=`cat key.txt`\n $ tagcube scan --root-url http://domain.com\n Web application scan for \"http://domain.com/\" successfully started at TagCube cloud.\n\nThis will create the new domain resource in TagCube's REST API and start a new\nscan using these defaults:\n\n- Bootstrap paths: ``/``\n- Web application scan profile: ``full_audit``\n\nWhen the scan has finished an email will be sent to the user's email address.\n\n**Important**: depending on TagCube's license quotas and privileges you might need to\nuse the REST API or Web application to *create and verify the ownership of the\ntarget domain* before running the first scan against it.\n\nAdvanced usage\n==============\n\nRun a scan to ``http://target.com/``, notify the REST API username email address\nwhen it finishes\n\n::\n\n $ tagcube scan --root-urls http://target.com\n\n\nRun a scan with a custom profile, enabling verbose mode and notifying a\ndifferent email address when the scan finishes\n\n::\n\n $ tagcube scan --root-urls http://target.com --email-notify=other@example.com \\\n --scan-profile=fast_scan -v\n\nProvide TagCube's REST API credentials as command line arguments. Read the\ndocumentation to find how to provide REST API credentials using environment\nvariables or the .tagcube file\n\n::\n\n $ tagcube scan --root-urls http://target.com --tagcube-email=user@example.com \\\n --tagcube-api-key=...\n\nVerify that the configured credentials are working\n\n::\n\n $ tagcube auth\n\n\nConfiguration file\n==================\n\nIt is always a good idea to avoid hardcoded credentials in source code and deploy\nscripts. This tool can get the credentials from a YAML file in the current directory\nor the user's home. The filename should be named ``.tagcube`` and have the following\nformat:\n\n::\n\n credentials:\n email: ...\n api_key: ...\n\nOnce the file is in place, the tool can be run:\n\n::\n\n $ tagcube auth\n Successfully authenticated against TagCube's API.\n $\n\n\nConfiguration through environment variables\n===========================================\n\nAnother way to provide ``tagcube-cli`` with the REST API credentials is to set\nthe ``TAGCUBE_EMAIL`` and ``TAGCUBE_API_KEY`` environment variables. These are\nconvenient to avoid hard-coding credentials in scripts or source code.\n\nIntegration with continuous delivery\n====================================\n\nAdding security to your continuous delivery process is trivial using TagCube,\nwe recommend adding these two lines after the code is pushed to the servers:\n\n::\n\n pip install --upgrade tagcube-cli\n tagcube scan --root-url http://target.com\n\nWhile in most cases its recommend to be specific about the version of any\nexternal package installed using ``pip``, we recommend a more relaxed installation\nprocess for ``tagcube-cli`` which allows us to frequently push upgrades to our\ncustomers.\n\nMore info\n=========\n\nA more detailed documentation which includes tutorials and example usages can\nbe found at `TagCube's site `_\n\nReporting bugs\n==============\n\nReport your issues and feature requests in `tagcube-cli's issue\ntracker `_ and we'll\nbe more than glad to fix them.\n\nPull requests are more than welcome!", "description_content_type": null, "docs_url": null, "download_url": "UNKNOWN", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/tagcubeio/tagcube-cli/", "keywords": null, "license": "GNU General Public License v2 (GPLv2)", "maintainer": null, "maintainer_email": null, "name": "tagcube-cli", "package_url": "https://pypi.org/project/tagcube-cli/", "platform": "Linux", "project_url": "https://pypi.org/project/tagcube-cli/", "project_urls": { "Download": "UNKNOWN", "Homepage": "https://github.com/tagcubeio/tagcube-cli/" }, "release_url": "https://pypi.org/project/tagcube-cli/1.0.7/", "requires_dist": null, "requires_python": null, "summary": "CLI to launch web application security scans usingTagCube's REST API", "version": "1.0.7" }, "last_serial": 1638642, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "md5": "99c9f44fe012918bfc5c536fb95dc4de", "sha256": "3925e34e12f3eb760c1b9dd9a7787087652116ed4c8f6b836654941b4c6bcccd" }, "downloads": -1, "filename": "tagcube-cli-0.1.0.tar.gz", "has_sig": false, "md5_digest": "99c9f44fe012918bfc5c536fb95dc4de", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 22222, "upload_time": "2014-07-21T19:34:36", "url": "https://files.pythonhosted.org/packages/6b/fc/185b7cfe14b4b40c5f18695e711545ef847ecea065b59f4d339c9f0d70c7/tagcube-cli-0.1.0.tar.gz" } ], "0.1.1": [ { "comment_text": "", "digests": { "md5": "f10949908214542932ead7582361dd5e", "sha256": "6b6506126274ad40fce24873e1defba1369fd4f97d54c978ae996d6bab7486a9" }, "downloads": -1, "filename": "tagcube-cli-0.1.1.tar.gz", "has_sig": false, "md5_digest": "f10949908214542932ead7582361dd5e", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 22205, "upload_time": "2014-07-21T19:49:31", "url": "https://files.pythonhosted.org/packages/7b/e5/330d034a800ef96f5809e3056d0953e9eb80ef8b383b1e93fbd915c873d4/tagcube-cli-0.1.1.tar.gz" } ], "0.1.2": [ { "comment_text": "", "digests": { "md5": "990c89e18d578303671278c206a85a99", "sha256": "97f956c6779d24823f4d3f2db44a726379c417e3da6628b84714783199c3ed1a" }, "downloads": -1, "filename": "tagcube-cli-0.1.2.tar.gz", "has_sig": false, "md5_digest": "990c89e18d578303671278c206a85a99", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 13968, "upload_time": "2014-08-21T12:44:38", "url": "https://files.pythonhosted.org/packages/e8/1d/76df7922f6e6cd498bdb4add406bb2fc90f925a684949e2c5e5cdc0f9962/tagcube-cli-0.1.2.tar.gz" } ], "0.1.3": [ { "comment_text": "", "digests": { "md5": "42ca1ec987db5adf73069728aecfa97c", "sha256": "14fcdc340837de17b9084578f1b335f424e92fc6f8928ea1287bee2bd6b72133" }, "downloads": -1, "filename": "tagcube-cli-0.1.3.tar.gz", "has_sig": false, "md5_digest": "42ca1ec987db5adf73069728aecfa97c", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14544, "upload_time": "2014-08-21T19:31:44", "url": "https://files.pythonhosted.org/packages/65/93/8bf02073039b0577de9d8c52ea5d902095d5cbd56bfa8ad74d24ed7380b1/tagcube-cli-0.1.3.tar.gz" } ], "0.1.4": [ { "comment_text": "", "digests": { "md5": "2c8313a9a3907df972b76a3d67e3e0b6", "sha256": "c4e1d79b4f62b347b3837b0f276978f136f2e8653c9efe91379b43169b9246e2" }, "downloads": -1, "filename": "tagcube-cli-0.1.4.tar.gz", "has_sig": false, "md5_digest": "2c8313a9a3907df972b76a3d67e3e0b6", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14616, "upload_time": "2014-08-21T21:22:13", "url": "https://files.pythonhosted.org/packages/54/43/2a5fa195d21991bd42ab2cb7903255b2e13b7d0421fb2dc32ffcbf9eb7c3/tagcube-cli-0.1.4.tar.gz" } ], "0.1.5": [ { "comment_text": "", "digests": { "md5": "861973fed63eee7d8ed43109b7cb9ad8", "sha256": "f68daf9ca31f1ce699dd29d4de9219eea29be25734f3ac0f6caaf5afb9c30c56" }, "downloads": -1, "filename": "tagcube-cli-0.1.5.tar.gz", "has_sig": false, "md5_digest": "861973fed63eee7d8ed43109b7cb9ad8", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 15283, "upload_time": "2014-11-13T21:47:30", "url": "https://files.pythonhosted.org/packages/f0/de/d3b7f1d5d53e535af691cf61f61d4b200c4263c3e77c4b3b7bd616e79fc0/tagcube-cli-0.1.5.tar.gz" } ], "1.0.1": [ { "comment_text": "", "digests": { "md5": "bda565a669cdc05b7c4923fc87c3da2e", "sha256": "e89ffcf7ee5afcce3db4a14b416d84c9b301350b2251f08c818c1cce7655d095" }, "downloads": -1, "filename": "tagcube-cli-1.0.1.tar.gz", "has_sig": false, "md5_digest": "bda565a669cdc05b7c4923fc87c3da2e", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 16862, "upload_time": "2015-07-15T17:20:55", "url": "https://files.pythonhosted.org/packages/18/ca/87fb32767dad494c9b80f5be0728b5ac90b50aa343d628cb401c7b5f2081/tagcube-cli-1.0.1.tar.gz" } ], "1.0.2": [ { "comment_text": "", "digests": { "md5": "a521159414fc61d491b81ac7de9c5130", "sha256": "725f4c2074c111bd42d3b4f148f8610cdcd12c79fab1a95ab7a50a15e9c34b22" }, "downloads": -1, "filename": "tagcube-cli-1.0.2.tar.gz", "has_sig": false, "md5_digest": "a521159414fc61d491b81ac7de9c5130", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 16981, "upload_time": "2015-07-16T13:29:15", "url": "https://files.pythonhosted.org/packages/03/8c/f07b428c7d5e1743f667f58809bc32a1f643821e6758d181e30bad31279d/tagcube-cli-1.0.2.tar.gz" } ], "1.0.3": [ { "comment_text": "", "digests": { "md5": "e249884511f55e7a5e8c99ade76c8025", "sha256": "f66e557121564459eccb37feedf24131b1085ea5cb0a125e79539b45882b098e" }, "downloads": -1, "filename": "tagcube-cli-1.0.3.tar.gz", "has_sig": false, "md5_digest": "e249884511f55e7a5e8c99ade76c8025", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 17211, "upload_time": "2015-07-16T14:15:20", "url": "https://files.pythonhosted.org/packages/53/9e/057fd1ac85b97dbbadd0a8b1da2078ba92a70364901ea126802e0791e3f9/tagcube-cli-1.0.3.tar.gz" } ], "1.0.4": [ { "comment_text": "", "digests": { "md5": "90cac6d35bc05895a42ab4cec5b27b3e", "sha256": "bb9d50e70d74788f60f69452525d402cc8b4c907f5128134be1d996261d38d75" }, "downloads": -1, "filename": "tagcube-cli-1.0.4.tar.gz", "has_sig": false, "md5_digest": "90cac6d35bc05895a42ab4cec5b27b3e", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 17223, "upload_time": "2015-07-16T14:28:38", "url": "https://files.pythonhosted.org/packages/99/e6/cd11dfc84173b0831cf679741bed525ed4cb29ff9501f99699dd01fbf23a/tagcube-cli-1.0.4.tar.gz" } ], "1.0.5": [ { "comment_text": "", "digests": { "md5": "725d6ff4056bc790b1928c3b9fded070", "sha256": "9cbf3af7e442618e61c771760809743a2358fdee13dcae7256b029e1e786b730" }, "downloads": -1, "filename": "tagcube-cli-1.0.5.tar.gz", "has_sig": false, "md5_digest": "725d6ff4056bc790b1928c3b9fded070", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 17585, "upload_time": "2015-07-17T19:25:25", "url": "https://files.pythonhosted.org/packages/88/b8/5080626719e288dcce2571b7ae6554be6911f157eb9841b62a38151a51c5/tagcube-cli-1.0.5.tar.gz" } ], "1.0.6": [ { "comment_text": "", "digests": { "md5": "86eea522c1872eaa2c8f79c877d1b305", "sha256": "211c2c6065cf10dbb778f764b4f832066491b5641bc3289addab3b1e5b665d1e" }, "downloads": -1, "filename": "tagcube-cli-1.0.6.tar.gz", "has_sig": false, "md5_digest": "86eea522c1872eaa2c8f79c877d1b305", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 17601, "upload_time": "2015-07-17T19:40:12", "url": "https://files.pythonhosted.org/packages/a0/c2/664017ce276cad4e25c7886c09000063e4c6b1c4d618574b87200a9df030/tagcube-cli-1.0.6.tar.gz" } ], "1.0.7": [ { "comment_text": "", "digests": { "md5": "7cdbc184ab98ea2938916e6dddeba4a0", "sha256": "b8bef73b7094caf4281886ba478c31121bccb1dc21365fd91352bda42626f34d" }, "downloads": -1, "filename": "tagcube-cli-1.0.7.tar.gz", "has_sig": false, "md5_digest": "7cdbc184ab98ea2938916e6dddeba4a0", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 17721, "upload_time": "2015-07-18T00:50:31", "url": "https://files.pythonhosted.org/packages/4b/16/be7dc21f634d2d3c33a3f79ae97a75bff6017aec00a6d41abca586c907bd/tagcube-cli-1.0.7.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "7cdbc184ab98ea2938916e6dddeba4a0", "sha256": "b8bef73b7094caf4281886ba478c31121bccb1dc21365fd91352bda42626f34d" }, "downloads": -1, "filename": "tagcube-cli-1.0.7.tar.gz", "has_sig": false, "md5_digest": "7cdbc184ab98ea2938916e6dddeba4a0", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 17721, "upload_time": "2015-07-18T00:50:31", "url": "https://files.pythonhosted.org/packages/4b/16/be7dc21f634d2d3c33a3f79ae97a75bff6017aec00a6d41abca586c907bd/tagcube-cli-1.0.7.tar.gz" } ] }