Fileguard

Abstract

1. Introduction

🔐 Lightweight & secure file encryption/decryption CLI and library in Go.

2. Objective

🔐 Lightweight & secure file encryption/decryption CLI and library in Go.

This project demonstrates how Go can be applied to a real-world Cybersecurity & Ethical Hacking problem.

3. Key Features / Modules

• AES-based file encryption and decryption
• Simple, clean public API
• Optional CLI for quick usage
• Easy to integrate into any Go project

4. Technology Stack

• Go to the Releases section of this repository.
• Download the latest release for your operating system.
• Follow the instructions provided in the Usage section or run the downloaded file.

5. System Requirements

General requirements for this technology stack — check the README for exact versions.

• Go 1.20 or later
• Git (to clone the repository)

6. Installation & Setup

git clone https://github.com/seponik/fileguard.git
cd fileguard

package main

import (
	"fmt"

	"github.com/seponik/fileguard/pkg/fileguard"
)

func main() {
  // Encrypting file using fileguard
  err := fileguard.EncryptFile("file.txt", "secretkey")
  if err != nil {
    fmt.Println(err)
  }

  // Decrypting file using fileguard
  err = fileguard.DecryptFile("file.txt.fg", "secretkey")
  if err != nil {
    fmt.Println(err)
  }
}

./fileguard -e example.txt

./fileguard -d example.txt.fg

Full setup instructions are in the project README.

7. Future Enhancements

Suggested extensions you can add to make this your own project.

• Add logging and alert notifications (email / Telegram)
• Write a threat model document for the tool
• Package it with Docker for safe lab testing

8. Viva / Review Questions

Common questions examiners ask for projects in this domain.

1. Which threat or attack does this project defend against?
2. What detection or protection technique is used and what are its limits?
3. How are false positives and false negatives handled?
4. Which cryptographic algorithms or security standards are involved?
5. What legal and ethical rules apply when testing a tool like this?

9. Source Code & License

This project is developed by seponik and published on GitHub under the MIT License. Please follow the license terms and credit the original author when you use or modify this code.