Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

5.3 Release #181

Merged
merged 5 commits into from
May 8, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 10 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
<img alt="SamuraiWTF Logo" src="http://tiny.si/images/owasp_samurai_v3.png" height="400"/>
</p>

## Samurai Web Training Framework 5.2
## Samurai Web Training Framework 5.3

<p align="center">
<a href="https://github.com/SamuraiWTF/samuraiwtf/releases"> <img alt="Github" src="https://img.shields.io/github/downloads/SamuraiWTF/samuraiwtf/total.svg?label=Github%20Downloads"/></a>
Expand Down Expand Up @@ -34,23 +34,26 @@ There are several options available to you. The quickest option is to download a
This option works best if you are not using Windows, or if you are using Windows without Hyper-V running.

[Download SamuraiWTF for VirtualBox](https://downloads-samuraiwtf-com.s3.us-west-2.amazonaws.com/SamuraiWTF.ova)
* MD5: `edbcb6dd46d31ad2ca7a813520eee7e4`
* SHA256: `f43d4c59bd49f032b5ae3b70a165398fa8dee68c88336c918c7b25f0ed633044`
* MD5: `1da174a13218ad60080d4666f305124d`
* SHA256: `92490a0f16584644ad681d94a3b144778fcb837a845a4f5f63d252e71d98ed4d`

For more information on removing or disabling Hyper-V, see [these instructions from Microsoft](https://support.microsoft.com/en-us/help/3204980/virtualization-applications-do-not-work-together-with-hyper-v-device-g).

### Option 2: Download Pre-Built VHDX (for Hyper-V)
This option works best if you are running Windows 10 or higher and already have Hyper-V installed. If you use the Windows Linux Subsystem (WLS), then you have Hyper-V installed.

[Download SamuraiWTF for Hyper-V](https://downloads-samuraiwtf-com.s3.us-west-2.amazonaws.com/SamuraiWTF_HyperV.zip)
* MD5: `93d262417fc0dd3a16c96b516be60d2e`
* SHA256: `d4aad0a92f94604e082f02b3247e9a1a1406aaad85f2c1114f2ae253cc5627fe`
* MD5: `B7B406D70956574CE29A83344CD59E97`
* SHA256: `9FD30B272A20CD3CA1003BAC0CEB180D18202F0A448FCFDEB0EDE52CA65DDA74`

Once it is downloaded, you will want to unzip the file and then create a new VM in Hyper-V. Attach the .hvdx drive and set the RAM to 4096.
Once it is downloaded, you will want to unzip the file and then create a new VM in Hyper-V. Attach the .hvdx drive and set the RAM to at least 4096.

### Option 3: Build an Amazon Workspace
### Option 3: Build an Amazon Workspace
This option works best if you are familiar with Amazon Web Services (AWS) and want your students to remote into the lab environments instead of running them as local virtual machines. This can be a great option when students are running potentially low-powered machines because it even works from a Chromebook. For details, view [/amazon-linux/README.md](https://github.com/SamuraiWTF/samuraiwtf/blob/main/amazon-linux/README.md).

Please note that once the Docker containers have been added to the Workspace instance, you can no longer create an image from the instance. While this won't affect most people using this as a training environment, it does break the ability to prebuild classroom labs using AWS Workspaces. We have reached out to AWS to see if there is a fix.


### Build on Hyper-V or VirtualBox with Vagrant
Currently, the most stable Vagrant build is the one for Ubuntu 20.04. Details are in the file [/amazon-linux/README.md](https://github.com/SamuraiWTF/samuraiwtf/blob/main/ubuntu-20/README.md).

Expand Down
2 changes: 1 addition & 1 deletion Vagrantfile
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ Vagrant.configure("2") do |config|
samuraiwtf.vm.provider "virtualbox" do |vb|
# Display the VirtualBox GUI when booting the machine
vb.gui = true
vb.name = "SamuraiWTF-5.1"
vb.name = "SamuraiWTF-5.3"

# Customize the amount of memory on the VM:
vb.memory = "4096"
Expand Down
2 changes: 1 addition & 1 deletion amazon-linux/Vagrantfile
Original file line number Diff line number Diff line change
Expand Up @@ -63,7 +63,7 @@ Vagrant.configure("2") do |config|
samuraiwtf.vm.provider "virtualbox" do |vb|
# Display the VirtualBox GUI when booting the machine
vb.gui = true
vb.name = "SamuraiWTF-5.2"
vb.name = "SamuraiWTF-5.3"
# Customize the amount of memory on the VM:
vb.memory = "4096"
vb.customize ["modifyvm", :id, "--vram", "128"]
Expand Down
2 changes: 1 addition & 1 deletion provision.sh
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ echo "Vagrant Provisioning for Ubuntu"
export DEBIAN_FRONTEND='noninteractive'
apt-get update

apt install -y python-is-python3 jq libnss3-tools gnome-shell-extension-arc-menu gnome-tweaks
apt install -y python-is-python3 jq libnss3-tools gnome-shell-extension-arc-menu gnome-tweaks openjdk-17-jre

chown samurai:samurai /opt/katana

Expand Down
4 changes: 2 additions & 2 deletions ubuntu-20/Vagrantfile
Original file line number Diff line number Diff line change
Expand Up @@ -59,7 +59,7 @@ Vagrant.configure("2") do |config|
samuraiwtf.vm.synced_folder "..", "/vagrant", type: "rsync", rsync_exclude: ".git/"

samuraiwtf.vm.provider "hyperv" do |hv|
hv.vmname = "SamuraiWTF-5.2.1"
hv.vmname = "SamuraiWTF-5.3"
hv.maxmemory = "4096"
hv.vm_integration_services = {
guest_service_interface: true
Expand All @@ -68,7 +68,7 @@ Vagrant.configure("2") do |config|

samuraiwtf.vm.provider "virtualbox" do |vb|
vb.gui = true
vb.name = "SamuraiWTF-5.2.1"
vb.name = "SamuraiWTF-5.3"
vb.memory = "4096"
vb.customize ["modifyvm", :id, "--vram", "128"]
vb.customize ["modifyvm", :id, "--cpus", "2"]
Expand Down
2 changes: 1 addition & 1 deletion ubuntu-20/local_playbook.yml
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,7 @@
- gnome-shell-extensions
- mate-tweak
- python-is-python3
- default-jre
- openjdk-17-jre
state: present
become: true

Expand Down