{"id":18284494,"url":"https://github.com/samuraiwtf/katana","last_synced_at":"2025-04-05T07:31:46.350Z","repository":{"id":40328506,"uuid":"291767580","full_name":"SamuraiWTF/katana","owner":"SamuraiWTF","description":"SamuraiWTF package management tool and interface.","archived":false,"fork":false,"pushed_at":"2025-02-11T21:26:08.000Z","size":3499,"stargazers_count":26,"open_issues_count":32,"forks_count":10,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-03-21T00:32:50.232Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SamuraiWTF.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-08-31T16:28:56.000Z","updated_at":"2025-03-18T05:36:42.000Z","dependencies_parsed_at":"2024-01-14T04:58:48.268Z","dependency_job_id":"3dce33e8-ce54-4d01-968b-263e220584f3","html_url":"https://github.com/SamuraiWTF/katana","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SamuraiWTF%2Fkatana","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SamuraiWTF%2Fkatana/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SamuraiWTF%2Fkatana/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SamuraiWTF%2Fkatana/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SamuraiWTF","download_url":"https://codeload.github.com/SamuraiWTF/katana/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247305872,"owners_count":20917197,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-05T13:13:44.358Z","updated_at":"2025-04-05T07:31:41.337Z","avatar_url":"https://github.com/SamuraiWTF.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"![Katana Logo](/html/images/katana-logo.svg)\n\n# Katana\nKatana is the package management tool and interface for SamuraiWTF 5.0+. Specifically Katana is intended to be used by instructors to set up a classroom lab that\nwill be distributed to their students, or by self-study students to install the tools and targets they desire to use.\n\n_IMPORTANT NOTES:_\n* _Katana runs as root. It is intended only to be used in a temporary classroom environment. Don't install it on any network that is important to you._\n* _Katana is installed as part of the [SamuraiWTF Distribution](https://github.com/SamuraiWTF/samuraiwtf) and is not intended to be installed or run on a \nnon-SamuraiWTF build._\n\n\n## Using Katana\nThere are two ways to use Katana:\n\n### Using Katana with the Web User Interface\nBy default, Katana should be running at `http://katana.wtf` from within your SamuraiWTF environment. Simply visit the Katana URL from any web browser inside the \nenvironment. From the. GUI you will be able to install, stop, and start any of the Katana-defined tools and targets. Note that an internet connection is required to\ninstall tools and targets.\n\n### Using Katana from the Command Line\nFrom a command line terminal inside your SamuraiWTF environment, simply type katana and the desired arguments. Katana supports the following arguments:\n\n| Argument | Description |\n| :------------- | ------------- |\n| `list` | List all available modules that are currently supported by Katana. |\n| `install \u003cname\u003e` | Install the supplied module by name. |\n| `remove \u003cname\u003e` | Remove the supplied module by name. |\n| `start \u003cname\u003e` | Start the supplied module, assuming it is startable. |\n| `stop \u003cname\u003e` | Stop the supplied module, assuming it is stopable. |\n| `status \u003cname\u003e` | Output the status of the supplied module. This will include whether or not it is installed and if it is running (if it is runnable). |\n| `lock` | Lock the current set of modules. This will require a restart of Katana. |\n| `--update` | This is a special argument for updating katana to the latest version from this repo. For development purposes, an optional second parameter to pull from a specific branch.  |\n\n## Locking Katana\nThis feature is for instructors who are setting up a lab environment for students. Once all the desired tools and targets are installed for the lab, running `katana lock` will lock the web UI in place so that \nany modules that have not been installed will no longer be listed, and installed modules cannot be removed.\n\nTo remove the lock, remove the `katana.lock` file from the Katana installation folder (usually `/opt/katana/katana.lock`).\n\nChanging the lock will require a restart of Katana. Note that the Katana web UI is itself a katana module, therefore `katana stop katana` followed by `katana start katana` will restart the web UI.\n\n# Development\n\nKatana is intended to be a framework so that SamuraiWTF can support a wide range of web targets for teaching application security lessons.\n(TODO: Write development guide)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsamuraiwtf%2Fkatana","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsamuraiwtf%2Fkatana","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsamuraiwtf%2Fkatana/lists"}