{"id":44040199,"url":"https://github.com/nuts-foundation/hashicorp-vault-proxy","last_synced_at":"2026-02-07T20:34:20.445Z","repository":{"id":97478448,"uuid":"588096092","full_name":"nuts-foundation/hashicorp-vault-proxy","owner":"nuts-foundation","description":"A small proxy server which implements the Nuts Storage API, forwarding calls to a Hashicorp Vault Server.","archived":false,"fork":false,"pushed_at":"2025-07-11T08:21:42.000Z","size":277,"stargazers_count":1,"open_issues_count":4,"forks_count":1,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-07-11T11:42:52.126Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nuts-foundation.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.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2023-01-12T10:11:15.000Z","updated_at":"2025-07-11T08:21:40.000Z","dependencies_parsed_at":"2023-11-08T07:55:22.871Z","dependency_job_id":"c8f58ba3-7264-41f2-b8bb-cce4dd5f172c","html_url":"https://github.com/nuts-foundation/hashicorp-vault-proxy","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/nuts-foundation/hashicorp-vault-proxy","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nuts-foundation%2Fhashicorp-vault-proxy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nuts-foundation%2Fhashicorp-vault-proxy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nuts-foundation%2Fhashicorp-vault-proxy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nuts-foundation%2Fhashicorp-vault-proxy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nuts-foundation","download_url":"https://codeload.github.com/nuts-foundation/hashicorp-vault-proxy/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nuts-foundation%2Fhashicorp-vault-proxy/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29208161,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-07T20:33:12.493Z","status":"ssl_error","status_checked_at":"2026-02-07T20:30:47.381Z","response_time":63,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":"2026-02-07T20:34:19.534Z","updated_at":"2026-02-07T20:34:20.439Z","avatar_url":"https://github.com/nuts-foundation.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n\n# hashicorp-vault-proxy\nA small proxy server which implements the Nuts Storage API, forwarding calls to a Hashicorp Vault Server.\n\n![e2e tests](https://github.com/nuts-foundation/hashicorp-vault-proxy/actions/workflows/api-spec-tests.yml/badge.svg?branch=main)\n[![Maintainability](https://api.codeclimate.com/v1/badges/292d76eac27521e95357/maintainability)](https://codeclimate.com/github/nuts-foundation/hashicorp-vault-proxy/maintainability)\n\n## Running\n\nTo build the application and start it with a Vault server, run:\n\n    $ make build start\n\nThe proxy will be available on port `8210`. The Vault server will run in development mode.\n\nTo stop the services, run:\n\n    $ make stop\n\nTo reset the services, effectively removing the Docker containers and volumes (including the stored private keys), run:\n\n    $ make reset\n\n## Configuring\n\nYou can configure the backing Vault by setting environment variables (e.g. `VAULT_ADDR`) for the Vault client.\nSee https://github.com/hashicorp/vault/blob/main/api/client.go for the available options.\n\nIn addition, the following environment variables can be set:\n\n- `VAULT_PATHPREFIX`: the path prefix to use for the Vault keys, which generally matches the secret store name (defaults to `kv`).\n- `VAULT_PATHNAME`: the path name to use for the Vault keys, which generally matches the secret store name (defaults to `nuts-private-keys`).\n- `LOG_FORMAT`: the log format to use, either `json` or `text` (defaults to `text`).\n\n## Backwards compatibility\n\nThe Vault proxy can be used as a drop-in replacement for the embedded Nuts node Vault secret storage engine. If you already have your keys in Hashicorp Vault and want to use the proxy, make sure to set the `VAULT_PATHPREFIX` to your nodes `crypto.vault.pathprefix` value of leave it empty for default and leave `VAULT_PATHNAME` empty.\n\n## Test suite\n\nTo run the test suite that tests compliance of the proxy with the Nuts Storage API, run:\n\n    $ make api-test\n\nIt starts the proxy, Vault and Postman in Docker and runs the test suite.\nIf the process exits with a non-zero exit code, the test suite failed.\nSee the Postman output for more information on the failure.\n\nNote: to build the proxy before running the test suite, run:\n\n    $ make build api-test\n\n## Code Generation\n\nGenerating code:\n\nTo regenerate all code run the ``run-generators`` target:\n\n    $ make run-generators\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnuts-foundation%2Fhashicorp-vault-proxy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnuts-foundation%2Fhashicorp-vault-proxy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnuts-foundation%2Fhashicorp-vault-proxy/lists"}