{"id":13602687,"url":"https://github.com/entitleio/beam","last_synced_at":"2026-01-20T12:07:00.438Z","repository":{"id":191917916,"uuid":"685545246","full_name":"entitleio/beam","owner":"entitleio","description":"AWS SSM made easy","archived":false,"fork":false,"pushed_at":"2023-11-19T14:23:02.000Z","size":111,"stargazers_count":61,"open_issues_count":3,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-18T14:26:44.844Z","etag":null,"topics":["audit","aws","aws-ssm","bastion","database-access","firewalls","iam","identity-aware-proxy","jumpserver","kubernetes","kubernetes-access","pam","postgres","postgresql","ssh-tunnel","zero-trust"],"latest_commit_sha":null,"homepage":"https://beam.entitle.io","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/entitleio.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2023-08-31T13:23:16.000Z","updated_at":"2025-02-17T11:26:24.000Z","dependencies_parsed_at":"2024-01-14T04:37:33.776Z","dependency_job_id":"8ae6e68e-1cb5-4b84-87fa-3cca0aeda58f","html_url":"https://github.com/entitleio/beam","commit_stats":null,"previous_names":["entitleio/beam"],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/entitleio%2Fbeam","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/entitleio%2Fbeam/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/entitleio%2Fbeam/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/entitleio%2Fbeam/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/entitleio","download_url":"https://codeload.github.com/entitleio/beam/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248368179,"owners_count":21092314,"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":["audit","aws","aws-ssm","bastion","database-access","firewalls","iam","identity-aware-proxy","jumpserver","kubernetes","kubernetes-access","pam","postgres","postgresql","ssh-tunnel","zero-trust"],"created_at":"2024-08-01T18:01:33.818Z","updated_at":"2026-01-20T12:07:00.398Z","avatar_url":"https://github.com/entitleio.png","language":"Python","readme":"\u003cdiv style=\"text-align: center;\"\u003e\n\u003ca href=\"https://beam.entitle.io\"\u003e\n    \u003cimg width=\"800\" src=\"https://entitle-public.s3.amazonaws.com/beam.svg\" alt=\"Beam Logo\"\u003e\n\u003c/a\u003e\n\u003c/div\u003e\n\n# Beam: Securely Connect to Your Infrastructure\n\nBeams helps you to connect easily \u0026 securely to internal AWS resources using AWS SSM Session Manager.\n\n**Currently supported infrastructure:**\n* AWS: SSM, EKS, RDS\n* _GCP: Coming soon 🎉_\n\n## Installation and initial configuration\n\n#### Step 1: Install Beam\nStart with installing beam\n```shell\npip install https://github.com/entitleio/beam/releases/latest/download/beam.tar.gz\n```\n\n#### Step 2: Configure SSO\nRun the following command to configure Single Sign-On (SSO):\n\n```shell\nbeam configure --sso-url SSO_URL --sso-region SSO_REGION\n```\nFollow the Single Sign-On (SSO) and Multi-Factor Authentication (MFA) prompts until you approve.\n\n#### Step 3: Select Accounts and Permissions\n- Select the accounts you want to access.\n- Choose the permission sets you require.\n\n#### Step 4: Specify Regions and Infrastructure\n- Select the regions where your infrastructure is located.\n- Specify the regular expression (regex) for your bastion host.\n- Choose your default Kubernetes namespace.\n- Decide if you want to use Amazon Elastic Kubernetes Service (EKS) and specify the regex.\n- Decide if you want to connect to Amazon Relational Database Service (RDS).\n\n#### Step 5: Approve Configuration\nApprove the configuration. This will generate a configuration file in your current user folder.\n\n#### Step 6: Run Beam\nNow you can run the following command:\n\n```shell\nsudo beam run\n```\n*Note: The first run will take some time as it scans your entire infrastructure.*\n\n*Note: Beam requires sudo because it edits the hosts file.*\n\nCongratulations! You have successfully configured your DevOps environment.\n\n## Documentation\n\n[Documentation] for the current version of Beam is available from the [official website].\n\n## Contribute\n\nFollow the [contributing guidelines](CONTRIBUTING.md) if you want to propose a change in Beam.\n\n## Resources\n\n* [Releases][PyPI Releases]\n* [Official Website]\n* [Documentation]\n* [Issue Tracker]\n\n  [PyPI]: https://pypi.org/project/beam/\n  [PyPI Releases]: https://pypi.org/project/beam/#history\n  [Official Website]: https://beam.entitle.io\n  [Documentation]: https://beam.entitle.io/docs\n  [Issue Tracker]: https://github.com/entitleio/beam/issues\n  [Contributing Documentation]: CONTRIBUTING.md\n","funding_links":[],"categories":["aws"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fentitleio%2Fbeam","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fentitleio%2Fbeam","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fentitleio%2Fbeam/lists"}