Merge pull request #14 from virtual-labs/testing

Testing to main

Author: ravikiran2020

.github/workflows/deployment-script.yml

@@ -15,21 +15,21 @@ jobs:
     - name: Setup node
       uses: actions/setup-node@v2
       with:
-            node-version: '12'
+            node-version: '16'
             check-latest: true
     - run: |
-        git clone https://github.com/virtual-labs/ph3-lab-mgmt
+        git clone --depth=1 https://github.com/virtual-labs/ph3-lab-mgmt
         cd ph3-lab-mgmt
         npm install
-        node exp.js
+        npm run build-exp
         cd ../
         git config --local user.email "admin@vlabs.ac.in"
         git config --local user.name "vleadadmin"
         git checkout --orphan gh-pages
         git reset
         git add build/* -f
         git mv build/* ./ -f
-        git commit -m "https://virtual-labs.github.io/${{ github.repository }} click on the link to test your code."
+        git commit -m "https://virtual-labs.github.io/${{ github.event.repository.name }} click on the link to test your code."
     - uses: ad-m/github-push-action@master
       with:
         github_token: ${{ secrets.ORG_OWNER_GITHUB_TOKEN }}

.gitignore

@@ -0,0 +1,6 @@
+package.json
+package-lock.json
+build/
+plugins/
+node_modules/
+.DS_Store

experiment-descriptor.json

@@ -2,6 +2,7 @@
   "unit-type": "lu",
   "label": "",
   "basedir": ".",
+  "LaTeXinMD": "true",
   "units": [
     {
       "unit-type": "aim"
@@ -36,10 +37,10 @@
     },
     {
       "target": "assignment.html",
-      "source": "assignment/index.html",
+      "source": "assignment.md",
       "label": "Assignment",
       "unit-type": "task",
-      "content-type": "simulation"
+      "content-type": "text"
     },
     {
       "target": "references.html",
@@ -50,4 +51,3 @@
     }
   ]
 }
-

experiment/README.md

@@ -1,21 +1,19 @@
 A private-key encryption scheme consists of a set of all possible messages, called the message space **M**, and three algorithms, namely,
 
- (a) **Gen**
+(a) **Gen**
 
- (b) **Enc**
+(b) **Enc**
 
- (c) **Dec**
+(c) **Dec**
 
-The algorithm for key generation **Gen** is used to choose a key **k** at random from the set of all possible secert keys, denoted by the key space **K**.
+The algorithm for key generation **Gen** is used to choose a key **k** at random from the set of all possible secret keys, denoted by the key space **K**.
 
 The algorithm for encryption **Enc** takes as inputs the message **m** and the secret key **k** and outputs the ciphertext **c**.
 
 The algorithm for decryption **Dec** inputs the ciphertext **c** and the key **k** and outputs the message **m**.
 
-**About the experiment:**
-
-Apparently, the system is easily broken if the total number of distinct secret keys is small, that is the key space **K** is small.
+We are able to break many classical ciphers because of their vulnerabilities. In cryptography, we learn that a large key space is necessary for secrecy, but understanding how small key spaces make ciphers vulnerable is equally important for learning cryptographic principles.
 
-In this experiment, we work with a well-known historical encryption scheme, namely the shift cipher, that has a very small key space.
+**About the experiment:**
 
-Your task is to break the shift cipher. Specifically, given (only) the ciphertext in some instance of a shift cipher, you need to find the plaintext and the secret key. 
+In this experiment, we work with a well-known historical encryption scheme, namely the shift cipher (also known as Caesar cipher), that has a very small key space. The shift cipher is easily broken using brute force attack methods because it has only 26 possible keys for the English alphabet. Your task is to break this cipher. Specifically, given (only) the ciphertext in some instance of a shift cipher, you need to find the plaintext and the secret key.

experiment/aim.md

@@ -0,0 +1,25 @@
+Use the **PART III** provided in the simulation page to solve the following problems. The tool includes a shift cipher calculator and a workspace for your analysis.
+
+**1. Encrypt the following plaintext using key k= 7.**
+
+Given:
+
+- **Plaintext:** `Lord Rama was a good king.`
+- **Key:** k = 7
+
+**2.Given a plaintext and its corresponding ciphertext, determine the key used for encryption.**
+
+Given:
+
+- **Plaintext:** `abcdefghijklmnopqrstuvwxyz`
+- **Ciphertext:** `tuvwxyzabcdefghijklmnopqrs`
+
+Hint: Compare the first few letters: a→t, b→u, c→v...
+
+**3. How many different keys are possible with an n-letter alphabet?**
+
+**4. For English alphabet (n=26): How many distinct keys exist?**
+
+**5. Decrypt the following ciphertext using brute force attack.**
+
+Given: Ciphertext: `HAAHJR HA KHDU`

experiment/assignment.md

@@ -1,2 +1,30 @@
-- To understand that secure encryption is not possible with small keyspace. This is more popularly known as the principle of large key space
+After completing this experiment, you will be able to:
 
+1. **Understand Basic Cryptography Concepts**
+
+   - Comprehend the fundamental principles of encryption and decryption
+   - Recognize the importance of key space in cryptographic systems
+   - Understand why secure encryption is not possible with small keyspace (principle of large key space)
+
+2. **Master Shift Cipher Operations**
+
+   - Perform encryption using the shift cipher algorithm
+   - Execute decryption using the shift cipher algorithm
+   - Calculate the total number of possible keys for a given alphabet
+
+3. **Analyze Cryptographic Security**
+
+   - Identify vulnerabilities in the shift cipher
+   - Understand why the shift cipher is considered insecure
+   - Recognize the importance of key space size in cryptographic security
+
+4. **Develop Cryptanalysis Skills**
+
+   - Apply brute force attacks to break shift cipher encryption
+   - Use frequency analysis to decrypt messages
+   - Determine encryption keys from known plaintext-ciphertext pairs
+
+5. **Apply Practical Knowledge**
+   - Implement shift cipher operations manually
+   - Solve real-world cryptographic challenges
+   - Evaluate the security of simple encryption schemes