Awesome
<!-- Image sourced from https://blog.1password.com/introducing-secrets-automation/ --> <img alt="" role="img" src="https://blog.1password.com/posts/2021/secrets-automation-launch/header.svg"/> <div align="center"> <h1>1Password Connect SDK for Go</h1> <p>Access your 1Password items in your Go applications through your self-hosted <a href="https://developer.1password.com/docs/connect">1Password Connect server</a>.</p> <a href="#-quickstart"> <img alt="Get started" src="https://user-images.githubusercontent.com/45081667/226940040-16d3684b-60f4-4d95-adb2-5757a8f1bc15.png" height="37"/> </a> </div>The 1Password Connect Go SDK provides access to the 1Password Connect API, to facilitate communication with the Connect server hosted on your infrastructure and 1Password. The library is intended to be used by your applications, pipelines, and other automations to simplify accessing items stored in your 1Password vaults.
✨ Quickstart
-
Download and install the 1Password Connect Go SDK:
go get github.com/1Password/connect-sdk-go
-
Export the
OP_CONNECT_HOST
andOP_CONNECT_TOKEN
environment variables:export OP_CONNECT_HOST=<your-connect-host> && \ export OP_CONNECT_TOKEN=<your-connect-token>
-
Use it in your code
-
Read a secret:
import "github.com/1Password/connect-sdk-go/connect" func main () { client := connect.NewClientFromEnvironment() item, err := client.GetItem("<item-uuid>", "<vault-uuid>") if err != nil { log.Fatal(err) } }
-
Write a secret:
import ( "github.com/1Password/connect-sdk-go/connect" "github.com/1Password/connect-sdk-go/onepassword" ) func main () { client := connect.NewClientFromEnvironment() item := &onepassword.Item{ Title: "Secret String", Category: onepassword.Login, Fields: []*onepassword.ItemField{{ Value: "mysecret", Type: "STRING", }}, } postedItem, err := client.CreateItem(item, "<vault-uuid>") if err != nil { log.Fatal(err) } }
-
For more examples, check out USAGE.md.
💙 Community & Support
- File an issue for bugs and feature requests.
- Join the Developer Slack workspace.
- Subscribe to the Developer Newsletter.
🔐 Security
1Password requests you practice responsible disclosure if you discover a vulnerability.
Please file requests via BugCrowd.
For information about security practices, please visit the 1Password Bug Bounty Program.