{"id":19432798,"url":"https://github.com/brightspace/vault-ec2auth","last_synced_at":"2025-04-24T20:31:05.833Z","repository":{"id":64307128,"uuid":"88756433","full_name":"Brightspace/vault-ec2auth","owner":"Brightspace","description":"A simple agent to authenticate an AWS EC2 instance against Hashicorp Vault","archived":false,"fork":false,"pushed_at":"2017-07-14T12:42:02.000Z","size":16,"stargazers_count":13,"open_issues_count":1,"forks_count":3,"subscribers_count":9,"default_branch":"master","last_synced_at":"2025-04-03T10:01:32.234Z","etag":null,"topics":["aws","ec2","vault"],"latest_commit_sha":null,"homepage":"","language":"Go","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/Brightspace.png","metadata":{"files":{"readme":"readme.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-04-19T14:46:30.000Z","updated_at":"2023-10-02T05:08:51.000Z","dependencies_parsed_at":"2023-01-15T11:00:32.126Z","dependency_job_id":null,"html_url":"https://github.com/Brightspace/vault-ec2auth","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Brightspace%2Fvault-ec2auth","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Brightspace%2Fvault-ec2auth/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Brightspace%2Fvault-ec2auth/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Brightspace%2Fvault-ec2auth/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Brightspace","download_url":"https://codeload.github.com/Brightspace/vault-ec2auth/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250704548,"owners_count":21473710,"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":["aws","ec2","vault"],"created_at":"2024-11-10T14:37:13.280Z","updated_at":"2025-04-24T20:31:05.580Z","avatar_url":"https://github.com/Brightspace.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Vault-EC2Auth\n\nThis agent is intended to make EC2 authentication against Vault as simple as possible. Simply launch the agent in the\nbackground and anytime you need to access vault, your token is available at `~/.vault-token` which is the default location \nthat the `vault` CLI looks for its access token. \n\n## Quick start\n\nOptions for getting started:\n\n* [Download the latest release](../../releases).\n* Clone the repo: `git clone https://github.com/Brightspace/vault-ec2auth.git`.\n\nTypical usage:\n\n* Run once and exit: `vault-ec2auth -role my_role` \n* Run as agent: `vault-ec2auth -agent -role my_role`\n\n\n## How it works\n\nUpon launch, the agent will immediately attempt to connect to Vault at `https://vault.service.consul:8200` to retrieve \na token for the requested role.\n \nThe token is written to `~/.vault-token` and the nonce to `~/.vault-nonce`.\n\nIf running in agent mode, it will then block for half of the lease duration before attempting to reauthenticate with Vault \nusing the nonce value stored in `~/.vault-nonce`.\n\n## Documentation\n\n* Additional options can be seen by running the tool with no parameters.\n\n### Running as an agent\n\nBy providing the `-agent` argument the agent will block until cancelled with `ctrl+c`. In this mode leases will be automatically\nrenewed at the half-life of the lease.\n\n## Versioning\n\nVault EC2Auth Agent releases are maintained under [the Semantic Versioning guidelines](http://semver.org/).\n\n## Contributing\n\nPlease read through our [contributing guidelines](CONTRIBUTING.md). Included are directions for opening issues, coding standards, and notes on development.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrightspace%2Fvault-ec2auth","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbrightspace%2Fvault-ec2auth","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrightspace%2Fvault-ec2auth/lists"}