{"id":13842961,"url":"https://github.com/swimlane/soc-faker","last_synced_at":"2025-04-06T18:14:25.207Z","repository":{"id":44735353,"uuid":"186499592","full_name":"swimlane/soc-faker","owner":"swimlane","description":"A python package for use in generating fake data for SOC and security automation.","archived":false,"fork":false,"pushed_at":"2023-03-01T00:46:14.000Z","size":11060,"stargazers_count":158,"open_issues_count":10,"forks_count":25,"subscribers_count":22,"default_branch":"master","last_synced_at":"2024-04-14T06:41:25.147Z","etag":null,"topics":["hacktoberfest"],"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/swimlane.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","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}},"created_at":"2019-05-13T21:41:38.000Z","updated_at":"2024-05-07T01:42:10.069Z","dependencies_parsed_at":"2024-05-07T01:52:18.401Z","dependency_job_id":null,"html_url":"https://github.com/swimlane/soc-faker","commit_stats":{"total_commits":141,"total_committers":10,"mean_commits":14.1,"dds":0.7021276595744681,"last_synced_commit":"d9384b357ecd31ecf3aad89ce7e19a9b2ecae295"},"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/swimlane%2Fsoc-faker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/swimlane%2Fsoc-faker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/swimlane%2Fsoc-faker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/swimlane%2Fsoc-faker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/swimlane","download_url":"https://codeload.github.com/swimlane/soc-faker/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247526762,"owners_count":20953143,"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":["hacktoberfest"],"created_at":"2024-08-04T17:01:52.360Z","updated_at":"2025-04-06T18:14:25.186Z","avatar_url":"https://github.com/swimlane.png","language":"Python","funding_links":[],"categories":["Python","Python (1887)"],"sub_categories":[],"readme":"# soc-faker\n\nsoc-faker is used to generate fake data for use by Security Operation Centers, Information security professionals, product teams, and many more.\n\n## Getting Started\n\n`soc-faker` works with Python 3.6 or greater. You can install `soc-faker` using `pip` as well as cloning this repository directly.\n\nAt the time of writing this document, `soc-faker` has the ability to fake data for the following main categories.  You can find specific details for each category by selecting the links below:\n\n* [Agent](docs/source/faker/agent.md)\n* [Alert](docs/source/faker/alert.md)\n* [Application](docs/source/faker/application.md)\n* [Cloud](docs/source/faker/cloud.md)\n* [Computer](docs/source/faker/computer.md)\n* [Container](docs/source/faker/container.md)\n* [DNS](docs/source/faker/dns.md)\n* [Email](docs/source/faker/email.md)\n* [Employee](docs/source/faker/employee.md)\n* [File](docs/source/faker/file.md)\n* [HTTP](docs/source/faker/http.md)\n* [Location](docs/source/faker/location.md)\n* [Logs](docs/source/faker/logs.md)\n    * [SysMon](docs/source/faker/sysmon.md)\n    * [Windows Event Logs](docs/source/faker/eventlog.md)\n* [Network](docs/source/faker/network.md)\n* [Operating System](docs/source/faker/operating_system.md)\n* [Organization](docs/source/faker/organization.md)\n* [PCAP](docs/source/faker/pcap.md)\n* [Process](docs/source/faker/process.md)\n* Products\n    * [AlienVault USM](docs/source/faker/alienvaultusm.md)\n    * [Azure](docs/source/faker/azure.md)\n    * [Elastic](docs/source/faker/elastic.md)\n    * [QualysGuard](docs/source/faker/qualysguard.md)\n    * [ServiceNow](docs/source/faker/servicenow.md)\n* [Registry](docs/source/faker/registry.md)\n* [Timestamp](docs/source/faker/timestamp.md)\n* [Url](docs/source/faker/url.md)\n* [User Agent](docs/source/faker/useragent.md)\n* [Vulnerability](docs/source/faker/vulnerability)\n* [Words](docs/source/faker/words.md)\n\n\n### Installing soc-faker\n\n```bash\npip install soc-faker --user\n```\n\n### Installing from source\n\n```bash\ngit clone https://github.com/swimlane/soc-faker.git\ncd soc-faker\npython setup.py install\n```\n\n### Prerequisites\n\nThe following libraries are required and installed by soc-faker\n\n```\nrequests==2.23.0\npendulum==2.1.2\nipaddress==1.0.23\nbs4==0.0.1\nxmltodict==0.12.0\nnetaddr==0.7.20\nfire==0.3.1\n```\n\n## Usage\n\n`soc-faker` is a Python package that can be imported or be used via the command line utility to generate fake data related to security tools, products, and general data related to security.\n\n### Importing soc-faker\n\nAfter you have installed `soc-faker` from source or using `pip` you can import and instantiate it by doing the following:\n\n```python\nfrom socfaker import SocFaker\n\nsc = SocFaker()\n```\n\nOnce you have instantiated an instance of `soc-faker` you can then access any of the [different properties and methods](docs/source/index.md) avaialble based on your needs. If you would like to see soc-faker in action, then please see the [bin/test.py](bin/test.py) script in the repository under the `bin` folder for an example of all avaialble properties and methods.\n\nAdditionally, please read the [documentation](docs/source/index.md) for more details about each avaialble property and method.\n\n### Command-Line Usage\n\nWhen `soc-faker` is installed, it automatically creates a command-line utility for your use.  This utility can be accessed by simply typing `soc-faker` in your shell of choice.  \n\nTo see `soc-faker` help type:\n\n```bash\nsoc-faker\n# or\nsoc-faker --help\n```\n\nYou can access each property just like you can from the library, the only difference is you replace a `.` between properties with a space.  For example, if you wanted to get some randomly generated `hashes` quickly you can run:\n\n```bash\nsoc-faker file hashes\n```\n\nThis will return the following to your shell:\n\n\n```output\nmd5:    aa3150ac34ee6a5911e61ab6a5052a6d\nsha1:   de5c15f64d979ed84bac340c334a63d94401059d\nsha256: 118a9f9de8f3dd6471ef113959485ecbaf66368dea16758eab4e22da182d0e9f\n```\n\nIf you run into any issues, just type what you think is correct and the built-in help will guide you through all available groups, commands, etc. for each data point within `soc-faker`.\n\n### Development\n\nYou can use the provided [Dockerfile](Dockerfile) to get a development and testing environment up and running for `soc-faker`.\n\nTo use the `Dockerfile` run, cd to this repositories directory and run:\n\n```\ndocker build --force-rm -t socfaker .\n```\n\nOnce it is built, then run the docker container:\n\n```\ndocker run -p 7001:7001 -ti socfaker\n```\n\nRunning this will call the test python file in [bin\\test.py](bin\\test.py).  Modify this file for additional testing and development.\n\n\n## Running the tests\n\nTests within this project should cover all available properties and methods.  As this project grows the tests will become more robust but for now we are testing that they exist and return outputs.\n\n## Built With\n\n* [carcass](https://github.com/MSAdministrator/carcass) - Python packaging template\n\n## Contributing\n\nPlease read [CONTRIBUTING.md](CONTRIBUTING.md) for details on our code of conduct, and the process for submitting pull requests to us.\n\n## Versioning\n\nWe use [SemVer](http://semver.org/) for versioning. \n\n## Change Log\n\nPlease read [CHANGELOG.md](CHANGELOG.md) for details on features for a specific version of `soc-faker`\n\n## Authors\n\n* Josh Rickard - *Initial work* - [MSAdministrator](https://github.com/msadministrator)\n* Nick Tausek\n\nSee also the list of [contributors](https://github.com/{github_username}/{package_name}/contributors) who participated in this project.\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE.md) file for details\n\n## Credits\n\n`soc-faker` is a [Swimlane](https://swimlane.com) open-source project; we believe in giving back to the open-source community by sharing some of the projects we build for our application. Swimlane is an automated cyber security operations and incident response platform that enables cyber security teams to leverage threat intelligence, speed up incident response and automate security operations.\n\n[SecOps Hub](https://secopshub.com) is an open, product-agnostic, online community for security professionals to share ideas, use cases, best practices, and incident response strategies.\n\n## Acknowledgments\n\n* This project utilizes data from the OSSEM project by [hunters-forge](https://github.com/hunters-forge/OSSEM)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fswimlane%2Fsoc-faker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fswimlane%2Fsoc-faker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fswimlane%2Fsoc-faker/lists"}