Download the PHP package sham3r/cipher-bsk without Composer
On this page you can find all versions of the php package sham3r/cipher-bsk. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download sham3r/cipher-bsk
More information about sham3r/cipher-bsk
Files in sham3r/cipher-bsk
Package cipher-bsk
Short Description A lightweight encryption library implementing techniques from the research paper 'A Hybrid Cryptographic Scheme of Modified Vigenère Cipher using Randomized Approach for Enhancing Data Security' by Sazzad Saju. This library provides robust data security with secure hashing capabilities and Laravel-native support. For more details, visit: https://bit.ly/cipher-bsk
License MIT
Informations about the package cipher-bsk
Cipher BSK — PHP and Laravel Encryption Package
sham3r/cipher-bsk is the Composer package for Cipher BSK (Bornomala Symmetric Key), developed by Sazzad Hossain Saju. It brings the cipher model, originally implemented in C++, to PHP applications through a reusable API for text encryption and decryption.
The package works in standalone PHP projects and integrates with Laravel through configuration, a service provider, and a facade. Version 1.1.1 added secureHash() and verifyHash(), combining bcrypt password hashing with Cipher BSK encryption while retaining the existing encrypt() and decrypt() methods.
View on Packagist · Try Cipher BSK Web · Read the project story on Medium
Research Background
The underlying cipher model is documented in A Hybrid Cryptographic Scheme of Modified Vigenère Cipher using Randomized Approach for Enhancing Data Security, authored by Sazzad Hossain Saju, Sayed Mahmudul Haque, and Liakot Hossain Lingcon.
Published in the International Journal of Computer Applications, Volume 183, Number 2, May 2021, pages 1–8, the paper explores a modified Vigenère-based symmetric cipher using key generation, substitution, rearrangement, and padding. It combines that cipher with RSA to encrypt the symmetric key for its intended recipient.
DOI: 10.5120/ijca2021921290 · Find the paper on Google Scholar
This Composer package implements the PHP Cipher BSK component and adds application-level helpers and Laravel integration. The password helpers are later package features; RSA and the planned image-steganography integration are separate parts of the wider project.
The paper documents the experimental design and its analysis. Publication and observed output behavior do not establish blanket immunity to cryptographic attacks.
If you use or build on this model in your research, please cite the original paper.
Package at a Glance
| Capability | API or integration |
|---|---|
| Text encryption and decryption | encrypt($message, $key) and decrypt($ciphertext, $key) |
| Password protection and verification | secureHash($password) and verifyHash($password, $storedValue) |
| Standalone PHP usage | Composer autoloading and the CipherBsk\\CipherBsk class |
| Laravel usage | Auto-discovery, facade, service container, and published configuration |
| Key configuration for password helpers | CIPHER_BSK_KEY with APP_KEY as fallback |
🔐 New in v1.1.1
- Added
secureHash()andverifyHash()for dual-layer password encryption. - Added Laravel integration (config, service provider, and facade).
- Backward compatible with v1.0.
Installation/Launch
Install the package via Composer:
Usage
Basic Encryption/Decryption (Existing functionality)
🆕 Secure Password Hashing (v1.1.1)
Note: You must set an environment variable for secure hashing:
🆕 Laravel Integration (v1.1.1)
Auto-Discovery Setup
The package automatically registers itself in Laravel applications. No manual setup required!
Using the Facade:
Laravel Configuration:
-
Publish the config file (optional):
-
Set your environment variables in
.env: - Configuration file (
config/cipher-bsk.php):
Laravel Service Container:
Features
- Avalanche effect - Small changes in input create large changes in output
- Immune from frequency analysis attack - Secure against cryptographic attacks
- Output ranges from ASCII(0-255) - Full character space utilization
- 🆕 Dual-layer password hashing (CipherBSK + bcrypt) - Enhanced security
- 🆕 Laravel integration with auto-discovery - Seamless framework integration
- 🆕 Environment-based key management - Secure configuration
- ✅ Backward compatible with existing code - No breaking changes
Important Security Notes
For Secure Hashing Features
- MUST set
CIPHER_BSK_KEYorAPP_KEYenvironment variable - Never commit keys to version control
- Use different keys for different environments (dev, staging, production)
Example Environment Setup:
Error Handling:
If no key is configured, the package will throw a RuntimeException with helpful instructions:
Documentation
- Published paper: DOI: 10.5120/ijca2021921290
- Online tool: Cipher BSK Web
- GitHub Repository: cipher-bsk-composer-package
The Cipher BSK Ecosystem
This package is part of a series of open-source implementations and applications built around the same cipher model:
- C++ console application: the original symmetric cipher implementation.
- RSA component in Python: public-key encryption of the Cipher BSK symmetric key.
- JavaScript npm package: reusable encryption and decryption for JavaScript applications.
- Cipher BSK Web: a browser interface for experimenting with text encryption.
- Browser encryption extension and password manager extension.
The planned image-steganography extension would embed both the BSK-encrypted message and the RSA-encrypted symmetric key inside an image. It is not included in this Composer package.
Read how the university experiment developed into this ecosystem on Medium.
Testing
Run All Tests:
Test Specific Features:
Test Coverage:
- 25 tests total - Comprehensive coverage
- 71 assertions - Thorough validation
- Core encryption - Original CipherBSK algorithm
- Secure hashing - New dual-layer password security
- Environment handling - Key resolution and error cases
- Laravel integration - Framework-specific features
Contributing
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Run tests (
vendor/bin/phpunit) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
License
This project is licensed under the MIT License - see the LICENSE file for details.
Authors
- Sazzad Saju - Initial work and research - GitHub
- Email: [email protected]
Acknowledgments
- Based on the research paper: "A Hybrid Cryptographic Scheme of Modified Vigenère Cipher using Randomized Approach for Enhancing Data Security"
- Hajee Mohammad Danesh Science and Technology University
- Laravel community for framework integration patterns