{"id":13832089,"url":"https://github.com/secrethub/secrethub-go","last_synced_at":"2025-07-09T16:33:58.965Z","repository":{"id":47637552,"uuid":"160810197","full_name":"secrethub/secrethub-go","owner":"secrethub","description":"Golang SDK for the SecretHub Secrets Management API","archived":true,"fork":false,"pushed_at":"2022-12-30T19:24:40.000Z","size":1798,"stargazers_count":59,"open_issues_count":3,"forks_count":10,"subscribers_count":11,"default_branch":"master","last_synced_at":"2024-11-20T14:47:42.874Z","etag":null,"topics":["devops","go","golang","hacktoberfest","secrets","secrets-management","security"],"latest_commit_sha":null,"homepage":"https://secrethub.io","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/secrethub.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null}},"created_at":"2018-12-07T10:38:19.000Z","updated_at":"2024-03-12T12:43:58.000Z","dependencies_parsed_at":"2023-01-31T14:31:29.614Z","dependency_job_id":null,"html_url":"https://github.com/secrethub/secrethub-go","commit_stats":null,"previous_names":[],"tags_count":19,"template":false,"template_full_name":null,"purl":"pkg:github/secrethub/secrethub-go","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/secrethub%2Fsecrethub-go","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/secrethub%2Fsecrethub-go/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/secrethub%2Fsecrethub-go/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/secrethub%2Fsecrethub-go/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/secrethub","download_url":"https://codeload.github.com/secrethub/secrethub-go/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/secrethub%2Fsecrethub-go/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264495020,"owners_count":23617479,"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":["devops","go","golang","hacktoberfest","secrets","secrets-management","security"],"created_at":"2024-08-04T10:01:50.497Z","updated_at":"2025-07-09T16:33:58.129Z","avatar_url":"https://github.com/secrethub.png","language":"Go","readme":"\u003chr/\u003e\n\u003cp align=\"center\"\u003e\n  \u003csub\u003e\u003cimg src=\"https://1password.com/img/logo-v1.svg\" alt=\"1Password\" width=\"20\" /\u003e\u003c/sub\u003e \u003cb\u003eSecretHub has joined 1Password!\u003c/b\u003e Find out more on the \u003ca href=\"https://secrethub.io/blog/secrethub-joins-1password/\"\u003eSecretHub blog\u003c/a\u003e. 🎉\n\u003c/p\u003e\n\u003chr/\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca name=\"secrethub\"\u003e\n    \u003cimg src=\"https://secrethub.io/img/secrethub-logo.svg\" alt=\"SecretHub\" width=\"380px\"/\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\u003ch1 align=\"center\"\u003e\n  \u003ci\u003eGo Client\u003c/i\u003e\n\u003c/h1\u003e\n\n[![GoDoc](https://img.shields.io/badge/godoc-reference-blue.svg)][godoc]\n[![CircleCI](https://circleci.com/gh/secrethub/secrethub-go.svg?style=shield)][circle-ci]\n[![Go Report Card](https://goreportcard.com/badge/github.com/secrethub/secrethub-go)][goreportcard]\n[![Version]( https://img.shields.io/github/release/secrethub/secrethub-go.svg)][latest-version]\n[![Discord](https://img.shields.io/badge/chat-on%20discord-7289da.svg?logo=discord)][discord]\n\n`secrethub-go` provides a client for various SecretHub APIs.\n\n\u003e [SecretHub][secrethub] is a secrets management tool that works for every engineer. Securely provision passwords and keys throughout your entire stack with just a few lines of code.\n\n\u003cimg src=\"https://secrethub.io/img/secrethub-gopher.png\" alt=\"Gopher\" width=\"160px\"/\u003e\n\n## Usage\n\nYou can install secrethub-go with:\n\n```sh\ngo get github.com/secrethub/secrethub-go\n```\n\nOr install a specific version with:\n\n```sh\ngo get github.com/secrethub/secrethub-go@vX.Y.Z\n```\n\nThen, import it using:\n\n``` go\nimport (\n    \"github.com/secrethub/secrethub-go/pkg/secrethub\"\n)\n```\n\n\u003e **Note:** only packages inside the `/pkg` directory should be considered library code that you can use in your projects. \n\u003e All other code is not guaranteed to be backwards compatible and may change in the future.\n\n### Examples\n\nFor details on all functionality of this library, see the [GoDoc][godoc] documentation.\n\nBelow are a few simple examples:\n\n#### Read Secrets\n```go\npackage main\n\nimport (\n    \"fmt\"\n\n    \"github.com/secrethub/secrethub-go/pkg/secrethub\"\n)\n\nfunc main() {\n    client, _ := secrethub.NewClient()\n    secret, _ := client.Secrets().ReadString(\"path/to/db/pass\")\n    fmt.Println(secret)\n    // Output: wFc16W#96N1$\n}\n```\n\n#### Write Secrets\n```go\npackage main\n\nimport (\n    \"fmt\"\n\n    \"github.com/secrethub/secrethub-go/pkg/secrethub\"\n)\n\nfunc main() {\n    client, _ := secrethub.NewClient()\n    _, _ = client.Secrets().Write(\"path/to/secret\", []byte(\"password123\"))\n}\n```\n\n#### Generate Secrets\n```go\npackage main\n\nimport (\n    \"fmt\"\n\n    \"github.com/secrethub/secrethub-go/pkg/randchar\"\n    \"github.com/secrethub/secrethub-go/pkg/secrethub\"\n)\n\nfunc main() {\n    client, _ := secrethub.NewClient()\n    data, _ := randchar.Generate(30)\n    _, _ = client.Secrets().Write(\"path/to/secret\", data)\n}\n```\n\n### Credential\n\nTo use the SecretHub Go client, you need to provide a credential for your __SecretHub__ account.\nYou can create a free developer account by [signing up through the CLI](https://secrethub.io/docs/getting-started/).\n\nAfter signup, the credential is located at `$HOME/.secrethub/credential` by default.\n`secrethub.NewClient()` automatically uses this credential.\n\n## Development\n\nPull requests from the community are welcome.\nIf you'd like to contribute, please checkout [the contributing guidelines](./CONTRIBUTING.md).\n\n## Testing\n\nRun all tests:\n\n    make test\n\nRun tests for one package:\n\n    go test ./pkg/secrethub\n\nRun a single test:\n\n    go test ./pkg/secrethub -run TestSignup\n\nFor any requests, bug or comments, please [open an issue][issues] or [submit a\npull request][pulls].\n\n## Getting help\n\nIf you get stuck or just want advice, come chat with the engineers on [Discord][discord] or send an email to [support@secrethub.io](mailto:support@secrethub.io)\n\n## Attributions\n\n[\"gopher.png\"][original-gopher] by [Takuya Ueda][tenntenn] is licensed under [CC BY 3.0][creative-commons-3.0]\n\n[original-gopher]: https://camo.githubusercontent.com/98ed65187a84ecf897273d9fa18118ce45845057/68747470733a2f2f7261772e6769746875622e636f6d2f676f6c616e672d73616d706c65732f676f706865722d766563746f722f6d61737465722f676f706865722e706e67\n[creative-commons-3.0]: https://creativecommons.org/licenses/by/3.0/\n[tenntenn]: https://twitter.com/tenntenn\n\n[secrethub]: https://secrethub.io\n[latest-version]: https://github.com/secrethub/secrethub-go/releases/latest\n[issues]: https://github.com/secrethub/secrethub-go/issues/new\n[pulls]: https://github.com/secrethub/secrethub-go/pulls\n[godoc]: https://pkg.go.dev/github.com/secrethub/secrethub-go?tab=overview\n[goreportcard]: https://goreportcard.com/report/github.com/secrethub/secrethub-go\n[circle-ci]: https://circleci.com/gh/secrethub/secrethub-go\n[discord]: https://discord.gg/EQcE87s\n","funding_links":[],"categories":["Go"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsecrethub%2Fsecrethub-go","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsecrethub%2Fsecrethub-go","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsecrethub%2Fsecrethub-go/lists"}