{"id":18896163,"url":"https://github.com/tenable/security-hub","last_synced_at":"2025-04-09T16:14:06.723Z","repository":{"id":34769550,"uuid":"158442265","full_name":"tenable/Security-Hub","owner":"tenable","description":"For use in our Tenable.IO to AWS Security Hub integration","archived":false,"fork":false,"pushed_at":"2025-03-17T21:22:17.000Z","size":113,"stargazers_count":28,"open_issues_count":1,"forks_count":21,"subscribers_count":12,"default_branch":"main","last_synced_at":"2025-04-09T16:13:58.497Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tenable.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2018-11-20T19:41:01.000Z","updated_at":"2025-03-17T21:20:01.000Z","dependencies_parsed_at":"2023-12-07T21:27:15.523Z","dependency_job_id":"f76a72c4-138a-45a0-9747-6017aa56bdea","html_url":"https://github.com/tenable/Security-Hub","commit_stats":null,"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tenable%2FSecurity-Hub","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tenable%2FSecurity-Hub/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tenable%2FSecurity-Hub/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tenable%2FSecurity-Hub/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tenable","download_url":"https://codeload.github.com/tenable/Security-Hub/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248065282,"owners_count":21041872,"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":[],"created_at":"2024-11-08T08:32:43.612Z","updated_at":"2025-04-09T16:14:06.706Z","avatar_url":"https://github.com/tenable.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Tenable Vulnerability Management to AWS Transformer\n\n| :exclamation: | If upgrading from v1 please read the upgrade section |\n| --------------|:---------------------------------------------------- |\n\nThis tool is designed to consume Tenable.io asset and vulnerability data,\ntransform that data into the AWS Security Hub Finding format, and then upload\nthe resulting data into AWS Security Hub.\n\nThe tool can be run as either a one-shot docker container or as a command-line\ntool. To run as a docker image, you'll need to build the image and then pass\nthe config file to the container.\n\n## Requirements\n\n- The Tenable Vulnerability Management Integration for Security Hub must be\n  configured to accept findings from the integration.\n- At a minimum the configuration file must have the account id that the events\n  will be sent to.  Ideally the region should be configured as well.\n- A set of API Keys within TVM should be configured to allow exportation of\n  assets and vulnerability findings from the platform.  These keys should be\n  wither configured within the configuration file or as environment variables\n\n## Installation\n\n```\npip install tenable_aws_sechub\n```\n\n## Upgrading from v1\n\nIf you are upgrading from the original version of the integration, please note\nthat there are some additional steps that need to be taken as the ARN that is\nused has changed.\n\n1. Disable the Tenable.io SecurityHub integration\n2. Enable the Tenable Vulnerability Management integration\n3. Configure and run the updated integration (this code)\n\n## Configuration\n\nSimply build a configuration file (or use the [example file][cfg] provided)\nwith the following details:\n\n```toml\naws_account_id = 12344567890\naws_region = \"us-east-1\"\naccess_key = \"1234567890abcdef1234567890\"\nsecret_key = \"1234567890abcdef1234567890\"\n```\n\nOnce the configuration file is saved, go ahead and ensure that the AWS CLI can\ncommunicate to AWS, or generate the appropriate configuration parameters that\nAWS needs for their boto3 client.  Details for how to do this is documented\nbelow:\n\n1. [Boto3 Configuration](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html#configuration)\n2. [AWS CLI Config](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html)\n\n## Running the integration\n\n```\n❯ tvm2aws --configfile /path/to/config.toml\n```\n\n\n## Commandline options\n\n```\n❯ tvm2aws --help\n\n Usage: tvm2aws [OPTIONS]\n\n Tenable to AWS Security Hub vulnerability finding importer.\n\n╭─ Options ───────────────────────────────────────────────────────────────────╮\n│ --configfile          PATH                  [default: tvm2aws.toml]         │\n│ --verbose     -v      INTEGER RANGE [x\u003c=5]  [default: 2]                    │\n│ --help                                      Show this message and exit.     │\n╰─────────────────────────────────────────────────────────────────────────────╯\n```\n\n[cfg]: tvm2aws.toml\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftenable%2Fsecurity-hub","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftenable%2Fsecurity-hub","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftenable%2Fsecurity-hub/lists"}