{"id":28300844,"url":"https://github.com/eduolihez/bincat","last_synced_at":"2026-04-29T01:05:04.102Z","repository":{"id":177308742,"uuid":"600097123","full_name":"eduolihez/BinCat","owner":"eduolihez","description":"BinCat, is designed to manage and generate secure tokens for authentication purposes. It provides a simple interface to generate, validate, and revoke tokens, ensuring secure access to various systems. The project is built using Python and SQLite, showcasing skills in database management, token security, and Python programming.","archived":false,"fork":false,"pushed_at":"2025-09-28T20:52:21.000Z","size":310,"stargazers_count":0,"open_issues_count":2,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-28T22:17:26.781Z","etag":null,"topics":["python","sqlite","token-authetication","token-based-authentication","token-gen"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/eduolihez.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-02-10T15:21:54.000Z","updated_at":"2025-09-28T20:52:24.000Z","dependencies_parsed_at":null,"dependency_job_id":"6cf5675d-59c4-4a03-a142-3765a3f7523c","html_url":"https://github.com/eduolihez/BinCat","commit_stats":null,"previous_names":["titodelas/bincat","eduolihez/bincat"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/eduolihez/BinCat","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eduolihez%2FBinCat","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eduolihez%2FBinCat/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eduolihez%2FBinCat/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eduolihez%2FBinCat/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/eduolihez","download_url":"https://codeload.github.com/eduolihez/BinCat/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eduolihez%2FBinCat/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32405905,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-28T19:38:08.556Z","status":"ssl_error","status_checked_at":"2026-04-28T19:37:55.688Z","response_time":56,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["python","sqlite","token-authetication","token-based-authentication","token-gen"],"created_at":"2025-05-23T19:11:56.844Z","updated_at":"2026-04-29T01:05:04.087Z","avatar_url":"https://github.com/eduolihez.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# BinCat | NewGen\n\n## Overview\nBinCat is a robust token management system designed for secure token generation, validation, and database handling. This project leverages encryption, logging, and modular Python components to offer a flexible solution for managing tokens in various applications. It includes tools to maintain system integrity and ensures ease of use for developers.\n\n---\n## Features\n- **Secure Token Generation**:\n  - Generates unique, encrypted tokens using the Fernet encryption standard.\n  - Ensures tokens cannot be reverse-engineered or tampered with.\n\n- **Token Validation**:\n  - Validates token authenticity and checks expiration status.\n\n- **Efficient Database Handling**:\n  - SQLite-based database to store tokens with timestamps.\n  - Supports token revocation for added security.\n\n- **Utilities**:\n  - Purge script to clear logs and database entries.\n  - Tool to generate new encryption keys safely.\n\n- **Modular Design**:\n  - Separated components for token generation, validation, and management.\n  - Easy to extend and integrate with other systems.\n\n---\n\n## Project Structure\n```\n.env\n.gitignore\napi.py\nbincat_tokens.db\nLICENSE\nmain.py\nREADME.md\nrequirements.txt\nsetup.py\n\n.github/\n  dependabot.yml\n\nbincat/\n  token_generator.py\n  token_manager.py\n  token_validator.py\n  __init__.py\n\ntools/\n  encryption_key_gen.py\n  purge.py\n\ntests/\n  test_bincat.py\n  test_token_manager.py\n  __init__.py\n```\n\n---\n\n## Installation\n### Prerequisites\n- Python 3.10 or later\n- SQLite (built into Python)\n- `pip` for package management\n\n### Steps\n1. Clone the repository:\n   ```bash\n   git clone https://github.com/your-username/BinCat.git\n   cd BinCat\n   ```\n\n2. Set up a virtual environment (optional but recommended):\n   ```bash\n   python -m venv venv\n   source venv/bin/activate  # On Windows: venv\\Scripts\\activate\n   ```\n\n3. Install dependencies:\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n4. Generate an encryption key (if not already generated):\n   ```bash\n   python tools/encryption_key_gen.py\n   ```\n   This will create a `.env` file containing the encryption key.\n\n---\n\n## Usage\n### Running the Application\nExecute the main script:\n```bash\npython main.py\n```\n\n### Available Functionalities\n- **Generate Token**: Automatically creates a new secure token.\n- **Validate Token**: Checks if a token is valid and not expired.\n- **Revoke Token**: Marks a token as revoked to prevent its further use.\n\n### Maintenance Tools\n- **Purge Logs and Database**:\n  Clear all logs and reset the database:\n  ```bash\n  python tools/purge.py\n  ```\n- **Generate New Encryption Key**:\n  Create a new encryption key for enhanced security:\n  ```bash\n  python tools/encryption_key_gen.py\n  ```\n  \u003e Note: Changing the encryption key will invalidate all existing tokens.\n\n---\n\n## Technologies Used\n- **Python**: Core language for development.\n- **SQLite**: Lightweight database for token storage.\n- **Cryptography**: Secure encryption and decryption.\n- **Colorama**: Console color formatting.\n\n---\n\n## Testing\nUnit tests are located in the `tests` folder. To run the tests:\n```bash\npython -m unittest discover -s tests\n```\n\n---\n\n## Contributing\nContributions are welcome! Follow these steps to contribute:\n1. Fork the repository.\n2. Create a new branch for your feature or bug fix:\n   ```bash\n   git checkout -b feature-name\n   ```\n3. Commit your changes:\n   ```bash\n   git commit -m \"Description of changes\"\n   ```\n4. Push the branch:\n   ```bash\n   git push origin feature-name\n   ```\n5. Open a Pull Request.\n\n---\n\n## License\nThis project is licensed under the MIT License. See the `LICENSE` file for details.\n\n---\n\n## Contact\nFor questions or suggestions, feel free to reach out:\n- **GitHub**: [eduolihez](https://github.com/eduolihez)\n- **Telegram**: [eduolihez](t.me/eduolihez)\n\nIf you found this project helpful, consider giving it a ⭐ on GitHub!\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feduolihez%2Fbincat","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Feduolihez%2Fbincat","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feduolihez%2Fbincat/lists"}