1Password Connect SDK for Go 安装与配置指南

2025-04-19 08:45:54作者：裘晴惠Vivianne

1. 项目基础介绍

1Password Connect SDK for Go 是一个开源项目，它提供了一个Go语言的SDK（软件开发工具包），允许开发者通过自托管的1Password Connect服务器，在Go应用程序中访问1Password条目。这个SDK简化了与1Password Connect API的通信，使得应用程序、管道和其他自动化流程可以轻松访问存储在1Password保险库中的项目。

主要编程语言：Go

2. 关键技术和框架

该项目使用的关键技术是Go语言的标准库，以及1Password Connect API。它不依赖于特定的框架，而是提供了与1Password Connect服务器的直接接口，让开发者能够进行密钥的读取和写入操作。

3. 安装和配置

准备工作

在开始安装之前，请确保您的系统中已经安装了以下软件：

Go语言环境（至少1.12版本以上）
Git版本控制系统

安装步骤

克隆项目仓库

打开终端（或命令提示符），执行以下命令以克隆项目仓库：
```
git clone https://github.com/1Password/connect-sdk-go.git
```
这将在当前目录下创建一个名为 connect-sdk-go 的文件夹，其中包含项目的所有文件。
安装SDK

进入项目文件夹：
```
cd connect-sdk-go
```
使用 go get 命令安装SDK：
```
go get
```
这将下载并安装所有依赖项。
设置环境变量

为了使用SDK，需要设置两个环境变量：OP_CONNECT_HOST 和 OP_CONNECT_TOKEN。这些值由您的1Password Connect服务器提供。

在终端中执行以下命令，替换 <your-connect-host> 和 <your-connect-token> 为实际的值：
```
export OP_CONNECT_HOST=<your-connect-host>
export OP_CONNECT_TOKEN=<your-connect-token>
```
对于Windows系统，您可以使用以下命令：
```
set OP_CONNECT_HOST=<your-connect-host>
set OP_CONNECT_TOKEN=<your-connect-token>
```

测试安装

在项目文件夹中，您可以创建一个Go文件，例如 main.go，并编写简单的代码来测试SDK是否工作：

package main

import (
    "github.com/1Password/connect-sdk-go/connect"
    "log"
)

func main() {
    client := connect.NewClientFromEnvironment()
    item, err := client.GetItem("<item-uuid>", "<vault-uuid>")
    if err != nil {
        log.Fatal(err)
    }

    // 这里可以进行进一步的操作，例如打印出item的内容
    log.Println(item)
}