{"id":18951379,"url":"https://github.com/adorsys/datasafe","last_synced_at":"2025-10-26T10:16:23.799Z","repository":{"id":34558465,"uuid":"177560704","full_name":"adorsys/datasafe","owner":"adorsys","description":"Datasafe - flexible and secure data storage and document sharing using cryptographic message syntax for data encryption","archived":false,"fork":false,"pushed_at":"2024-04-13T22:11:56.000Z","size":45565,"stargazers_count":45,"open_issues_count":57,"forks_count":22,"subscribers_count":6,"default_branch":"develop","last_synced_at":"2024-04-14T07:12:39.448Z","etag":null,"topics":["cloud-storage","cryptographic-message-system","cryptography","data-encryption","document-storage","encrypted-store","file-sharing","graal-native","java","library","privacy","s3-encryption","security","vault"],"latest_commit_sha":null,"homepage":"https://adorsys.github.io/datasafe/","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/adorsys.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":"SECURITY.WHITEPAPER.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2019-03-25T10:06:15.000Z","updated_at":"2024-04-16T14:31:46.655Z","dependencies_parsed_at":"2024-01-19T12:51:04.232Z","dependency_job_id":"6a0c8d54-8865-4148-801a-76bd094b897b","html_url":"https://github.com/adorsys/datasafe","commit_stats":null,"previous_names":["adorsys/docusafe2"],"tags_count":32,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adorsys%2Fdatasafe","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adorsys%2Fdatasafe/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adorsys%2Fdatasafe/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adorsys%2Fdatasafe/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/adorsys","download_url":"https://codeload.github.com/adorsys/datasafe/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":230388131,"owners_count":18217755,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["cloud-storage","cryptographic-message-system","cryptography","data-encryption","document-storage","encrypted-store","file-sharing","graal-native","java","library","privacy","s3-encryption","security","vault"],"created_at":"2024-11-08T13:27:46.225Z","updated_at":"2025-10-26T10:16:23.683Z","avatar_url":"https://github.com/adorsys.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![codecov](https://codecov.io/gh/adorsys/datasafe/branch/develop/graph/badge.svg)](https://codecov.io/gh/adorsys/datasafe)\n[![Maintainability](https://codeclimate.com/github/adorsys/datasafe.png)](https://codeclimate.com/github/adorsys/datasafe/maintainability)\n\n# Secure, Encrypted and Versioned Data Storage Library\n\n## Overview\nDatasafe is a robust library tailored for developers and enterprises, offering encrypted and versioned data storage. It enhances the security of data-sensitive applications, making it ideal for mission-critical usage.\n\n### Key Features\n- **Enhanced Security**: Each user gets unique key encryption keys, reducing the risk of widespread data breaches.\n- **Full Confidentiality**: Offers full or partial file path encryption.\n- **Ransomware Protection**: Versioned storage safeguards against ransomware attacks.\n- **Secure File Exchange**: Features asynchronous inboxes for safe user-to-user file transfers.\n- **Zero Trust Environments**: Ideal as a data encryption layer in critical data processing backends.\n\n## Technical Specifications\nDatasafe uses AES-GCM (and Chacha-Poly for large files) for encryption, with CMS-envelopes ([RFC 5652](https://www.rfc-editor.org/rfc/rfc8933#RFC5652)) for encrypted content wrapping. The library's flexible design allows seamless integration and customization. For more details, refer to our [Security Whitepaper](SECURITY.WHITEPAPER.md).\n\n### Highlights\n- **Configurability**: Dagger2 for dependency injection and modular design.\n- **Storage Compatibility**: Tested with Amazon S3, Minio, CEPH, and local filesystems.\n- **User Privacy**: Encrypts both the document and its path in each user's private space.\n- **Versioning Support**: Provides application layer versioning for systems lacking native versioning support.\n\n## Getting Started\n\n### Building the Project\nWithout tests:\n```bash\nmvn clean install -DskipTests=true\n```\n\nFull Build:\n```bash\nmvn clean install\n```\n\n### Adding Datasafe to Your Project\nInclude Datasafe in your Maven project:\n\n```xml\n\u003c!-- Datasafe Business Module --\u003e\n\u003cdependency\u003e\n    \u003cgroupId\u003ede.adorsys\u003c/groupId\u003e\n    \u003cartifactId\u003edatasafe-business\u003c/artifactId\u003e\n    \u003cversion\u003e{datasafe.version}\u003c/version\u003e\n\u003c/dependency\u003e\n\n\u003c!-- S3 Storage Provider --\u003e\n\u003cdependency\u003e\n    \u003cgroupId\u003ede.adorsys\u003c/groupId\u003e\n    \u003cartifactId\u003edatasafe-storage-impl-s3\u003c/artifactId\u003e\n    \u003cversion\u003e{datasafe.version}\u003c/version\u003e\n\u003c/dependency\u003e\n\n\u003c!-- Filesystem Storage Provider for Tests--\u003e\n\u003cdependency\u003e\n    \u003cgroupId\u003ede.adorsys\u003c/groupId\u003e\n    \u003cartifactId\u003edatasafe-storage-impl-fs\u003c/artifactId\u003e\n    \u003cversion\u003e{datasafe.version}\u003c/version\u003e\n    \u003cscope\u003etest\u003c/scope\u003e\n\u003c/dependency\u003e\n```\n\n## In-depth Insights\n- **Performance Analysis**: Tested on AWS, Datasafe achieves up to 50 MiB/s write and 80 MiB/s read throughput with Amazon S3. [See full report](datasafe-long-run-tests/README.md).\n- **Quick Demo**: Explore Datasafe's capabilities through our [quick demo](./docs/readme/Demo.md).\n- **Deployment Models**: Followings are among others [possible deployment models](./docs/readme/DeploymentModels.md).\n- **How It Works**: Get a look at [detailed integration information](./docs/readme/HowItWorks.md).\n\n## Additional Resources\n- **Project Homepage**: Visit [adorsys.github.io/datasafe](https://adorsys.github.io/datasafe) for more information.\n- **JavaDoc**: Access our detailed [JavaDoc here](https://adorsys.github.io/datasafe/javadoc/latest/index.html).\n\n## Contributing to Datasafe\n- **Contributor License**: See [Developer Certificate of Origin (DCO) Enforcement](https://github.com/adorsys/datasafe/discussions/253)\n- **Coding Guidelines**: [CodingRules](docs/codingrules/CodingRules.md)\n- **Branching and Committing Practices**: [Branching Guide](docs/branching/branch-and-commit.md)\n- **Deployment Process**: [Maven Central Deployment](docs/general/deployment_maven_central.md)\n- **Feature Requests and Comments**: [Open a Discussion Ticket](https://github.com/adorsys/datasafe/discussions)\n\n## Dual-Licensing\nDatasafe is available under two licenses:\n- **Open-Source Projects**: [AGPL v3 License](https://www.gnu.org/licenses/agpl-3.0.en.html)\n- **Commercial License**: Proprietary license available. Contact [sales@adorsys.com](mailto:sales@adorsys.com) for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadorsys%2Fdatasafe","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fadorsys%2Fdatasafe","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadorsys%2Fdatasafe/lists"}