使用Vault API软件包的身份验证方法



我正在尝试使用Vault Golang软件包使用API进行身份验证。

我创建了一个新客户,然后可以设置我的令牌:

client, err := api.NewClient(&api.Config{Address: vaultAddr, HttpClient: httpClient})
 if err != nil {
   return nil, errors.Wrap(err, "could not create vault client")
 }
client.SetToken(token)

这太好了,但是我想使用其他AUTH方法之一(LDAP,USERPASS等)对API进行验证

这甚至可能吗?如何使用API检索令牌?

我想我可以使用api呼叫使用NET/HTTP来检索令牌,但是是否有任何方法可以以其他方式进行验证?

我最终设法解决了这个问题。这并不是很明显,但很有意义。

Vault具有用于编写数据的通用写入方法。您可以通过简单地构建URL并将PUT请求发送到该端点

来使用API执行API登录

看起来有点像这样:

// create a vault client
client, err := api.NewClient(&api.Config{Address: url, HttpClient: httpClient})
if err != nil {
    panic(err)
}
// to pass the password
options := map[string]interface{}{
   "password": password,        
}
// the login path
// this is configurable, change userpass to ldap etc
path := fmt.Sprintf("auth/userpass/login/%s", username)
// PUT call to get a token
secret, err := client.Logical().Write(path, options)

没有足够的声誉在此处添加额外提示,而不是在接受的答案中注释。可以从验证响应中提取令牌:

client.SetToken(secret.Auth.ClientToken)

相关接口在这里记录:

https://godoc.org/github.com/hashicorp/vault/api#secret

https://godoc.org/github.com/hashicorp/vault/api#secretauth

我写了一个github gist,其中包含一个函数,可以使用AWS IAM角色来验证您的GO程序。这是一个链接。

注意:对金库的身份验证只能使您获得令牌。如果AWS IAM角色允许。

您需要创建一个AWS STS请求,从中提取一些信息,然后将其发送给Vault。

这是GitHub Gist的功能。它将消除AWS IAM角色和一些保险库环境变量,例如VAULT_ADDR。这是Vault Golang库可能会读取的其他一些环境变量。它产生了身份验证的*api.Client,代币和身份验证请求的响应。

它基于此GitHub项目。

package vault
import (
    "encoding/base64"
    "encoding/json"
    "fmt"
    "io/ioutil"
    "github.com/aws/aws-sdk-go/aws/session"
    "github.com/aws/aws-sdk-go/service/sts"
    "github.com/hashicorp/vault/api"
)
// AWSLogin will create a Vault client, login via an AWS role, and return a valid Vault token and client that can be
// used to get secrets.
// The authProvider is likely "aws". It's the "Path" column as described in these docs:
// https://www.vaultproject.io/api/auth/aws#login.
// The serverID is an optional value to be placed in the X-Vault-AWS-IAM-Server-ID header of the HTTP request.
// The role is an AWS IAM role. It needs to be able to read secrets from Vault.
func AWSLogin(authProvider, serverID, role string) (client *api.Client, token string, secret *api.Secret, err error) {
    // Create the Vault client.
    //
    // Configuration is gathered from environment variables by upstream vault package. Environment variables like
    // VAULT_ADDR and VAULT_SKIP_VERIFY are relevant. The VAULT_TOKEN environment variable shouldn't be needed.
    // https://www.vaultproject.io/docs/commands#environment-variables
    if client, err = api.NewClient(nil); err != nil {
        return nil, "", nil, fmt.Errorf("failed to create Vault client: %w", err)
    }
    // Acquire an AWS session.
    var sess *session.Session
    if sess, err = session.NewSession(); err != nil {
        return nil, "", nil, fmt.Errorf("failed to create AWS session: %w", err)
    }
    // Create a Go structure to talk to the AWS token service.
    tokenService := sts.New(sess)
    // Create a request to the token service that will ask for the current host's identity.
    request, _ := tokenService.GetCallerIdentityRequest(&sts.GetCallerIdentityInput{})
    // Add an server ID IAM header, if present.
    if serverID != "" {
        request.HTTPRequest.Header.Add("X-Vault-AWS-IAM-Server-ID", serverID)
    }
    // Sign the request to the AWS token service.
    if err = request.Sign(); err != nil {
        return nil, "", nil, fmt.Errorf("failed to sign AWS identity request: %w", err)
    }
    // JSON marshal the headers.
    var headers []byte
    if headers, err = json.Marshal(request.HTTPRequest.Header); err != nil {
        return nil, "", nil, fmt.Errorf("failed to JSON marshal HTTP headers for AWS identity request: %w", err)
    }
    // Read the body of the request.
    var body []byte
    if body, err = ioutil.ReadAll(request.HTTPRequest.Body); err != nil {
        return nil, "", nil, fmt.Errorf("failed to JSON marshal HTTP body for AWS identity request: %w", err)
    }
    // Create the data to write to Vault.
    data := make(map[string]interface{})
    data["iam_http_request_method"] = request.HTTPRequest.Method
    data["iam_request_url"] = base64.StdEncoding.EncodeToString([]byte(request.HTTPRequest.URL.String()))
    data["iam_request_headers"] = base64.StdEncoding.EncodeToString(headers)
    data["iam_request_body"] = base64.StdEncoding.EncodeToString(body)
    data["role"] = role
    // Create the path to write to for Vault.
    //
    // The authProvider is the value referenced in the "Path" column in this documentation. It's likely "aws".
    // https://www.vaultproject.io/api/auth/aws#login
    path := fmt.Sprintf("auth/%s/login", authProvider)
    // Write the AWS token service request to Vault.
    if secret, err = client.Logical().Write(path, data); err != nil {
        return nil, "", nil, fmt.Errorf("failed to write data to Vault to get token: %w", err)
    }
    if secret == nil {
        return nil, "", nil, fmt.Errorf("failed to get token from Vault: %w", ErrSecret)
    }
    // Get the Vault token from the response.
    if token, err = secret.TokenID(); err != nil {
        return nil, "", nil, fmt.Errorf("failed to get token from Vault response: %w", err)
    }
    // Set the token for the client as the one it just received.
    client.SetToken(token)
    return client, token, secret, nil
}

api软件包中有一个标准的AuthMethod接口。

type AuthMethod interface {
    Login(ctx context.Context, client *Client) (*Secret, error)
}

一个人可以使用任何登录方法实现此接口。这是基本用户名/密码登录的示例

type CredentialsAuthMethod struct {
    username string
    password string
}
func (m *CredentialsAuthMethod) Login(ctx context.Context, client *api.Client) (*api.Secret, error) {
    options := map[string]any{
        "password": m.password,
    }
    path := fmt.Sprintf("auth/userpass/login/%s", m.username)
    secret, err := client.Logical().WriteWithContext(ctx, path, options)
    if err != nil {
        return nil, errorx.EnhanceStackTrace(err, "failed to authorize in vault with credentials")
    }
    return secret, nil
}

一旦实现了新的Authmethod,它可用于为客户端获得令牌:

    client, err := api.NewClient(&api.Config{Address: "https://vault.local"})
    if err != nil {
        return nil, errorx.EnhanceStackTrace(err, "failed to initialize vault client")
    }
    
    secret, err := client.Auth().Login(context.Background(), &CredentialsAuthMethod{
        username: c.username,
        password: c.password,
    })
    if err != nil {
        return nil, errorx.EnhanceStackTrace(err, "failed to login in vault")
    }
    token := secret.Auth.ClientToken
    client.SetToken(token)

相关内容

最新更新