此版本仍在开发中，尚未被视为稳定版本。对于最新的稳定版本，请使用 Spring Vault 3.1.2！spring-doc.cn

身份验证方法

不同的组织对安全性有不同的要求和身份验证。Vault 通过提供多重身份验证来反映这一需求方法。Spring Vault 支持多种身份验证机制。spring-doc.cn

外部化登录凭证

首次访问安全系统称为安全引入。任何客户端都需要临时或永久凭证才能访问 Vault。外部化凭证是保持代码可维护性的良好模式，但存在增加泄露的风险。spring-doc.cn

向任何一方泄露登录凭证允许登录 Vault 并访问以下 Secret 由基础角色允许。选择适当的客户端身份验证，然后将凭证注入应用程序需要接受风险评估。spring-doc.cn

Spring 的 PropertySource 抽象是天作之合将配置保留在应用程序代码之外。您可以使用系统属性、环境变量或属性文件来存储登录凭据。每种方法都有自己的属性。请记住，命令行和环境属性可以通过适当的 OS 访问级别。spring-doc.cn

示例 1.外部化到属性文件vault.token

@PropertySource("configuration.properties")
@Configuration
public class Config extends AbstractVaultConfiguration {

    @Override
    public ClientAuthentication clientAuthentication() {
        return new TokenAuthentication(getEnvironment().getProperty("vault.token"));
    }
}

Spring 允许通过多种方式获取 .使用， inject via 时，将不会提供，因为环境 bean 仍在构建中，并且自动装配将在稍后阶段进行。您的配置类应该实现并获取 from .EnvironmentVaultPropertySource@Autowired Environment environmentEnvironmentApplicationContextAwareEnvironmentApplicationContext

有关在组件和其他属性源中引用属性的示例，请参阅 SecurePropertyUsage.java。spring-doc.cn

Token 鉴权

令牌是 Vault 中身份验证的核心方法。 Token 身份验证需要提供静态 Token。spring-doc.cn

Token authentication 是默认的身份验证方法。如果令牌被披露为非预期方，则它将获得对 Vault 的访问权限，并且可以访问预期客户端的密钥。

通常，令牌身份验证用于创建和更新令牌的方案外部（例如 HashiCorp Vault 服务代理）。根据实际设置，您可能希望也可能不希望令牌续订和撤销。有关 TTL 和 Token 撤销的详细信息，请参阅 LifecycleAwareSessionManager。spring-doc.cn

@Configuration
class AppConfig extends AbstractVaultConfiguration {

    // …

    @Override
    public ClientAuthentication clientAuthentication() {
        return new TokenAuthentication("…");
    }

    // …
}

另请参阅：spring-doc.cn

AppId 鉴权

Vault 已弃用 AppId 身份验证。请改用 AppRole 身份验证。

Vault 支持由两个难以猜测的令牌组成的 AppId 身份验证。The AppId defaults 设置为 static-configured。第二个 Token 是 UserId，它是应用程序确定的一部分，通常与运行时环境相关。IP 地址、Mac 地址或 Docker 容器名称就是很好的示例。Spring Vault 支持 IP 地址、Mac 地址和静态 UserId（例如，通过系统属性提供）。 IP 和 Mac 地址表示为十六进制编码的 SHA256 哈希。spring.application.namespring-doc.cn

基于 IP 地址的 UserId 使用本地主机的 IP 地址。spring-doc.cn

@Configuration
class AppConfig extends AbstractVaultConfiguration {

    // …

    @Override
    public ClientAuthentication clientAuthentication() {
        AppIdAuthenticationOptions options = AppIdAuthenticationOptions.builder()
                .appId("myapp")
                .userIdMechanism(new IpAddressUserId())
                .build();

        return new AppIdAuthentication(options, restOperations());
    }

    // …
}

从命令行生成 IP 地址 UserId 的相应命令是：spring-doc.cn

$ echo -n 192.168.99.1 | sha256sum

包括指向不同哈希值的潜在客户的换行符因此，请确保包含该标志。echo-n

基于 Mac 地址的 UserId 从 localhost 绑定的设备。该配置还允许指定选择正确设备的提示。的值是可选的，可以是接口名称或接口索引（从 0 开始）。network-interfacenetwork-interfacespring-doc.cn

@Configuration
class AppConfig extends AbstractVaultConfiguration {

    // …

    @Override
    public ClientAuthentication clientAuthentication() {

        AppIdAuthenticationOptions options = AppIdAuthenticationOptions.builder()
                .appId("myapp")
                .userIdMechanism(new MacAddressUserId())
                .build();

        return new AppIdAuthentication(options, restOperations());
    }

    // …
}

从命令行生成 Mac 地址 UserId 的相应命令是：spring-doc.cn

$ echo -n 0AFEDE1234AC | sha256sum

Mac 地址指定为大写，不带冒号。包括指向不同哈希值的潜在客户的换行符因此，请确保包含该标志。echo-n

自定义 UserId

更高级的方法允许您实现自己的 . 此类必须位于您的 Classpath 上，并且必须实现界面和方法。Spring Vault 将获取 UserId 每次使用 AppId 进行身份验证时调用获取 Token。AppIdUserIdMechanismorg.springframework.vault.authentication.AppIdUserIdMechanismcreateUserIdcreateUserIdspring-doc.cn

MyUserIdMechanism.java

public class MyUserIdMechanism implements AppIdUserIdMechanism {

  @Override
  public String createUserId() {

    String userId = …
    return userId;
  }
}

另请参阅：Vault 文档：使用 App ID 身份验证后端 spring-doc.cn

AppRole 身份验证

AppRole 允许计算机身份验证，就像已弃用的（自 Vault 0.6.1 起）AppId 身份验证一样。 AppRole 身份验证由两个难以猜测的（秘密）令牌组成：RoleId 和 SecretId。spring-doc.cn

Spring Vault 通过仅提供 RoleId 来支持 AppRole 身份验证或者与提供的 SecretId 一起从 Vault 获取 RoleId/SecretId （带有响应展开的推拉模式）。spring-doc.cn

@Configuration
class AppConfig extends AbstractVaultConfiguration {

    // …

    @Override
    public ClientAuthentication clientAuthentication() {

        AppRoleAuthenticationOptions options = AppRoleAuthenticationOptions.builder()
                .roleId(RoleId.provided("…"))
                .secretId(SecretId.wrapped(VaultToken.of("…")))
                .build();

        return new AppRoleAuthentication(options, restOperations());
    }

    // …
}

Spring Vault 也支持全量拉取模式：如果未提供 RoleId 和 SecretId， Spring Vault 将使用角色名称和初始令牌来检索它们。这初始令牌可能与 TTL 和使用限制相关联。spring-doc.cn

@Configuration
class AppConfig extends AbstractVaultConfiguration {

    // …

    @Override
    public ClientAuthentication clientAuthentication() {

        VaultToken initialToken = VaultToken.of("…");
        AppRoleAuthenticationOptions options = AppRoleAuthenticationOptions.builder()
                .appRole("…")
                .roleId(RoleId.pull(initialToken))
                .secretId(SecretId.pull(initialToken))
                .build();

        return new AppRoleAuthentication(options, restOperations());
    }

    // …
}

另请参阅：Vault 文档：使用 AppRole 身份验证后端 spring-doc.cn

AWS-EC2 身份验证

aws-ec2 auth 后端提供了一种安全的引入机制对于 AWS EC2 实例，允许自动检索文件库令牌。与大多数 Vault 身份验证后端不同，此后端不需要首先部署或预置安全敏感型凭据（令牌、用户名/密码、客户端证书等）。相反，它将 AWS 视为受信任的第三方，并使用加密签名的动态元数据信息，该信息具有唯一性表示每个 EC2 实例。spring-doc.cn

@Configuration
class AppConfig extends AbstractVaultConfiguration {

    // …

    @Override
    public ClientAuthentication clientAuthentication() {
        return new AwsEc2Authentication(restOperations());
    }

    // …
}

AWS-EC2 身份验证默认启用 nonce 跟随首次使用时信任（TOFU）原则。任何意外的一方获得对 PKCS#7 身份元数据的访问权限可以进行身份验证对抗 Vault。spring-doc.cn

在第一次登录期间， Spring Vault 会生成一个 nonce ，该实例 ID 存储在 auth 后端中。重新身份验证需要发送相同的 nonce。任何其他参与方没有 nonce，并且可以在 Vault 中引发警报进一步调查。spring-doc.cn

nonce 保存在内存中，并在应用程序重启期间丢失。spring-doc.cn

从 Spring Vault 3.2 开始，AWS-EC2 身份验证支持请求/响应（IMDSv1）元数据检索和基于会话的变体（IMDSv2）。spring-doc.cn

AWS-EC2 身份验证角色是可选的，默认为 AMI。您可以通过设置它在 .AwsEc2AuthenticationOptionsspring-doc.cn

另请参阅：文件库文档：使用 AWS-EC2 身份验证后端 spring-doc.cn

AWS-IAM 身份验证

aws auth 后端允许使用现有 AWS IAM 凭证登录 Vault。spring-doc.cn

AWS IAM 身份验证会创建一个签名的 HTTP 请求，该请求是由 Vault 执行，以使用 AWS STS 方法获取签名者的身份。AWSv4 签名需要 IAM 凭证。GetCallerIdentityspring-doc.cn

IAM 凭证可以从运行时环境中获取或外部供应。运行时环境，例如 AWS-EC2、具有分配的 IAM 委托人的 Lambda 和 ECS 不需要特定于客户端的配置凭证，但可以从其元数据源获取这些凭证。spring-doc.cn

@Configuration
class AppConfig extends AbstractVaultConfiguration {

    // …

    @Override
    public ClientAuthentication clientAuthentication() {

        AwsIamAuthenticationOptions options = AwsIamAuthenticationOptions.builder()
                .credentials(new BasicAWSCredentials(…)).build();

        return new AwsIamAuthentication(options, restOperations());
    }

    // …
}

示例 2.使用 AWS-EC2 实例配置文件作为凭证源

@Configuration
class AppConfig extends AbstractVaultConfiguration {

    // …

    @Override
    public ClientAuthentication clientAuthentication() {

        AwsIamAuthenticationOptions options = AwsIamAuthenticationOptions.builder()
                .credentialsProvider(InstanceProfileCredentialsProvider.getInstance()).build();

        return new AwsIamAuthentication(options, restOperations());
    }

    // …
}

AwsIamAuthentication需要 AWS Java 开发工具包依赖项（）因为身份验证实施使用 AWS 开发工具包类型进行凭证和请求签名。com.amazonaws:aws-java-sdk-corespring-doc.cn

您可以通过配置身份验证。AwsIamAuthenticationOptionsspring-doc.cn

另请参阅：spring-doc.cn

Azure （MSI）身份验证

azure auth 后端提供了一种安全的引入机制对于 Azure VM 实例，允许自动检索 Vault 令牌。与大多数 Vault 身份验证后端不同，此后端不需要首先部署或预置安全敏感型凭据（令牌、用户名/密码、客户端证书等）。相反，它将 Azure 视为受信任的第三方，并使用托管服务身份和实例元数据信息，可以是绑定到 VM 实例。spring-doc.cn

@Configuration
class AppConfig extends AbstractVaultConfiguration {

    // …

    @Override
    public ClientAuthentication clientAuthentication() {

        AzureMsiAuthenticationOptions options = AzureMsiAuthenticationOptions.builder()
                    .role(…).build();

        return new AzureMsiAuthentication(options, restOperations());
    }

    // …
}

Azure 身份验证需要有关 VM 环境的详细信息（订阅 ID、资源组名称、VM 名称）。这些详细信息可以通过进行配置。如果未配置，则查询 Azure 的实例元数据服务以获取这些详细信息。AzureMsiAuthenticationOptionsBuilderAzureMsiAuthenticationspring-doc.cn

另请参阅：spring-doc.cn

GCP-GCE 身份验证

gcp auth 后端允许使用现有的 GCP （Google Cloud Platform） IAM 和 GCE 凭证登录 Vault。spring-doc.cn

GCP GCE （Google Compute Engine）身份验证以服务账户的 JSON Web 令牌（JWT）。Compute Engine 实例的 JWT 使用实例标识从 GCE 元数据服务获取。此 API 创建可用于确认实例身份的 JSON Web 令牌。spring-doc.cn

与大多数 Vault 身份验证后端不同，此后端不需要首先部署或预置安全敏感型凭据（令牌、用户名/密码、客户端证书等）。相反，它将 GCP 视为受信任的第三方，并使用加密签名的动态元数据信息，该信息具有唯一性表示每个 GCP 服务帐户。spring-doc.cn

您可以通过配置身份验证。GcpComputeAuthenticationOptionsspring-doc.cn

@Configuration
class AppConfig extends AbstractVaultConfiguration {

    // …

    @Override
    public ClientAuthentication clientAuthentication() {

        GcpComputeAuthenticationOptions options = GcpComputeAuthenticationOptions.builder()
				.role(…).build();

		GcpComputeAuthentication authentication = new GcpComputeAuthentication(options,
				restOperations());
    }

    // …
}

另请参阅：spring-doc.cn

GCP-IAM 身份验证

gcp auth 后端允许使用现有的 GCP （Google Cloud Platform） IAM 和 GCE 凭证登录 Vault。spring-doc.cn

GCP IAM 身份验证以 JSON Web 令牌（JWT）的形式创建签名对于服务帐户。服务帐户的 JWT 由调用 GCP IAM 的 projects.serviceAccounts.signJwt API。调用方根据 GCP IAM 进行身份验证并由此证明了它的身份。此保险柜后端将 GCP 视为受信任的第三方。spring-doc.cn

IAM 凭证可以从运行时环境中获取或作为 e.g. JSON 从外部供应。JSON 是首选形式，因为它包含调用所需的项目 ID 和服务帐户标识符。projects.serviceAccounts.signJwtspring-doc.cn

@Configuration
class AppConfig extends AbstractVaultConfiguration {

    // …

    @Override
    public ClientAuthentication clientAuthentication() {

        GcpIamCredentialsAuthenticationOptions options = GcpIamCredentialsAuthenticationOptions.builder()
				.role(…).credential(GoogleCredentials.getApplicationDefault()).build();

		GcpIamCredentialsAuthentication authentication = new GcpIamCredentialsAuthentication(options,
				restOperations());
    }

    // …
}

GcpIamCredentialsAuthenticationOptions需要 Google Cloud Java SDK 依赖项 () 因为身份验证实施使用 Google API 进行凭据和 JWT 签名。com.google.cloud:google-cloud-iamcredentialsspring-doc.cn

您可以通过配置身份验证。GcpIamCredentialsAuthenticationOptionsspring-doc.cn

Google 凭据需要 OAuth 2 令牌来维护令牌生命周期。所有 API 是同步的，因此不支持哪个是对于反应式使用是必需的。GcpIamCredentialsAuthenticationAuthenticationSteps

GcpIamCredentialsAuthentication使用 IAM 凭证 API，并且是使用已弃用的 IAM API 替换已弃用的。GcpIamAuthentication

另请参阅：spring-doc.cn

GitHub 身份验证

github auth 后端提供了基于 GitHub 令牌的鉴权机制。 Vault 不支持使用 OAuth 工作流程生成 GitHub 令牌，因此它不充当 GitHub 应用程序。spring-doc.cn

身份验证机制需要 GitHub 令牌（或供应商）将令牌传递给 Vault，然后 Vault 根据你的 GitHub 进行身份验证帐户。spring-doc.cn

@Configuration
class AppConfig extends AbstractVaultConfiguration {

    // …

    @Override
    public ClientAuthentication clientAuthentication() {

        GitHubAuthentication options = GitHubAuthentication.builder()
                    .token(…).build();

        return new GitHubAuthentication(options, restOperations());
    }

    // …
}

另请参阅：spring-doc.cn

Vault 文档：GitHub 身份验证方法 spring-doc.cn

PCF 身份验证

pcf auth 后端允许 PCF 实例的 Vault 登录。它利用 PCF 的应用程序和容器身份保证。spring-doc.cn

PCF 身份验证使用实例密钥和证书创建由 Vault 验证的签名。如果签名匹配，并且可能绑定的 organization/space/application ID 匹配，则 Vault 会颁发适当范围的令牌。spring-doc.cn

实例凭证可从 files at 和 variables.CF_INSTANCE_CERTCF_INSTANCE_KEYspring-doc.cn

@Configuration
class AppConfig extends AbstractVaultConfiguration {

    // …

    @Override
    public ClientAuthentication clientAuthentication() {

        PcfAuthenticationOptions options = PcfAuthenticationOptions.builder()
                .role(…).build();

        PcfAuthentication authentication = new PcfAuthentication(options,
                restOperations());
    }

    // …
}

PcfAuthenticationOptions需要 BouncyCastle 库来创建 RSA-PSS 签名。spring-doc.cn

您可以通过配置身份验证。PcfAuthenticationOptionsspring-doc.cn

另请参阅：spring-doc.cn

Vault 文档：使用 PCF 身份验证后端 spring-doc.cn

TLS 证书认证

身份验证后端允许使用 SSL/TLS 客户端进行身份验证由 CA 签名或自签名的证书。certspring-doc.cn

要启用身份验证，您需要：certspring-doc.cn

使用 SSL，请参阅 [vault.client-ssl]spring-doc.cn
配置包含客户端的 Java certificate 和私有密钥Keystorespring-doc.cn

@Configuration
class AppConfig extends AbstractVaultConfiguration {

    // …

    @Override
    public ClientAuthentication clientAuthentication() {

        ClientCertificateAuthenticationOptions options = ClientCertificateAuthenticationOptions.builder()
                .path(…).build();

        return new ClientCertificateAuthentication(options, restOperations());
    }

    // …
}

另请参阅：Vault 文档：使用 Cert auth 后端 spring-doc.cn

Cubbyhole 身份验证

Cubbyhole 身份验证使用 Vault 原语来提供安全的身份验证工作流。Cubbyhole 身份验证使用令牌作为主要登录方法。临时令牌用于从 Vault 的 Cubbyhole 秘密后端。登录令牌的生命周期通常更长，并且用于与 Vault 交互。登录令牌可以从包装的响应或从该部分。dataspring-doc.cn

创建包装令牌spring-doc.cn

用于创建令牌的响应包装需要 Vault 0.6.0 或更高版本。

例 3.装箱和存储令牌

$ vault token-create -wrap-ttl="10m"
Key                            Value
---                            -----
wrapping_token:                397ccb93-ff6c-b17b-9389-380b01ca2645
wrapping_token_ttl:            0h10m0s
wrapping_token_creation_time:  2016-09-18 20:29:48.652957077 +0200 CEST
wrapped_accessor:              46b6aebb-187f-932a-26d7-4f3d86a68319

示例 4.包装令牌响应用法

@Configuration
class AppConfig extends AbstractVaultConfiguration {

    // …

    @Override
    public ClientAuthentication clientAuthentication() {

        CubbyholeAuthenticationOptions options = CubbyholeAuthenticationOptions
                .builder()
                .initialToken(VaultToken.of("…"))
                .wrapped()
                .build();

        return new CubbyholeAuthentication(options, restOperations());
    }

    // …
}

使用存储的令牌spring-doc.cn

例 5.装箱和存储令牌

$ vault token create
Key                    Value
---                    -----
token                  f9e30681-d46a-cdaf-aaa0-2ae0a9ad0819
token_accessor         4eee9bd9-81bb-06d6-af01-723c54a72148
token_duration         0s
token_renewable        false
token_policies         [root]

$ vault token create -use-limit=2 -orphan -no-default-policy -policy=none
Key                    Value
---                    -----
token                  895cb88b-aef4-0e33-ba65-d50007290780
token_accessor         e84b661c-8aa8-2286-b788-f258f30c8325
token_duration         0s
token_renewable        false
token_policies         [none]

$ export VAULT_TOKEN=895cb88b-aef4-0e33-ba65-d50007290780
$ vault write cubbyhole/token token=f9e30681-d46a-cdaf-aaa0-2ae0a9ad0819

例 6.存储令牌响应使用情况

@Configuration
class AppConfig extends AbstractVaultConfiguration {

    // …

    @Override
    public ClientAuthentication clientAuthentication() {

        CubbyholeAuthenticationOptions options = CubbyholeAuthenticationOptions
                .builder()
                .initialToken(VaultToken.of("…"))
                .path("cubbyhole/token")
                .build();

        return new CubbyholeAuthentication(options, restOperations());
    }

    // …
}

剩余 TTL/可续订性spring-doc.cn

从与非零 TTL 关联的 Cubbyhole 中检索的令牌从令牌创建时间。该时间不一定与申请相同启动。为了补偿初始延迟，Cubbyhole 身份验证会执行 self lookup 查找与非零 TTL 关联的令牌以检索剩余的 TTL。 Cubbyhole 身份验证不会在没有 TTL 的情况下自查找包装的令牌，因为零 TTL 表示没有关联的 TTL。spring-doc.cn

未包装的令牌不会仅提供有关可续订性和 TTL 的详细信息检索令牌。自查找将查找可续订性和剩余的 TTL。spring-doc.cn

另请参阅：spring-doc.cn

JWT 身份验证

配置 JWT 身份验证需要令牌或 JWT 供应商。您可以通过配置身份验证。JwtAuthenticationOptionsspring-doc.cn

在 Vault 端，您可以通过启用 JWT auth 后端并创建角色来配置 JWT 后端。您可以使用，也可以配置 JWT 后端。oidc_discovery_urljwks_urljwt_validation_pubkeysspring-doc.cn

@Configuration
class AppConfig extends AbstractVaultConfiguration {

    // …

    @Override
    public ClientAuthentication clientAuthentication() {

        JwtAuthenticationOptions options = JwtAuthenticationOptions.builder()
                .role(…).jwt(…).path(…).build();

        return new JwtAuthentication(options, restOperations());
    }

    // …
}

另请参阅：spring-doc.cn

Vault 文档：使用 JWT 身份验证后端 spring-doc.cn

Kubernetes 身份验证

Vault 从 0.8.3 开始支持使用 Kubernetes 令牌进行基于 kubernetes 的身份验证。spring-doc.cn

使用 Kubernetes 身份验证需要 Kubernetes 服务帐户令牌，通常安装在。该文件包含读取并发送到 Vault 的令牌。 Vault 在登录期间使用 Kubernetes 的 API 验证其有效性。/var/run/secrets/kubernetes.io/serviceaccount/tokenspring-doc.cn

配置 Kubernetes 身份验证至少需要提供角色名称：spring-doc.cn

@Configuration
class AppConfig extends AbstractVaultConfiguration {

    // …

    @Override
    public ClientAuthentication clientAuthentication() {

        KubernetesAuthenticationOptions options = KubernetesAuthenticationOptions.builder()
                .role(…).jwtSupplier(…).build();

        return new KubernetesAuthentication(options, restOperations());
    }

    // …
}

您可以通过配置身份验证。KubernetesAuthenticationOptionsspring-doc.cn

另请参阅：spring-doc.cn

用户名/密码身份验证

用户名/密码通常是最终用户身份验证方案。多个 Vault 身份验证后端支持使用 username 和 password：spring-doc.cn

用户名和密码（userpass)spring-doc.cn
LDAP （ldap)spring-doc.cn
Okta（支持额外的基于时间的一次性令牌）oktaspring-doc.cn
半径（radius)spring-doc.cn

UserPasswordAuthenticationOptions可以与上述所有身份验证后端一起使用，因为 Login API 在所有机制中都是相似的。请确保在配置时使用适当的 auth 挂载路径。UserPasswordAuthenticationOptionsspring-doc.cn

例 7.配置UserPasswordAuthentication

@Configuration
class AppConfig extends AbstractVaultConfiguration {

    // …

    @Override
    public ClientAuthentication clientAuthentication() {

        UserPasswordAuthenticationOptions options = UserPasswordAuthenticationOptions.builder()
                .username(…).password(…).build();

        return new UserPasswordAuthentication(options, restOperations());
    }

    // …
}

另请参阅：spring-doc.cn

身份验证步骤

ClientAuthentication对象描述身份验证流程并执行实际的身份验证步骤。预先组合的身份验证易于使用和配置与同步执行的紧密绑定。spring-doc.cn

身份验证方法的组合和重用常见步骤，例如发布登录 payload 添加到 Vault 或从 HTTP 源检索身份验证输入 with 对象。ClientAuthenticationspring-doc.cn

身份验证步骤提供常见身份验证活动的可重用性。通过描述函数中的身份验证流创建的步骤样式将实际的身份验证执行留给特定的执行程序。AuthenticationStepsspring-doc.cn

例 8.存储令牌身份验证流程。

AuthenticationSteps.just(VaultToken.of(…));                              (1)

1	仅从 .`AuthenticationStepsVaultToken`

可以从单个输入创建单步身份验证流程。声明多个身份验证步骤以或开头，提供 authentication state 对象，该对象可用于 Map 或 post 到 Vault 进行登录。SupplierHttpRequestspring-doc.cn

例 9.AppRole 身份验证流程

AuthenticationSteps.fromSupplier(                                       (1)

    () -> getAppRoleLogin(options.getRoleId(), options.getSecretId()))  (2)

    .login("auth/{mount}/login", options.getPath());                    (3)

1	开始声明接受 . 状态对象类型取决于响应类型，该类型可在后续步骤中映射。`AuthenticationStepsSupplier<T>Supplier`
2	实际实现。在本例中创建一个。`SupplierMap`
3	通过将状态对象（）发布到 Vault 端点以创建 Vault 令牌来执行 Vault 登录。请注意，模板变量受 URL 转义的约束。`Map`

身份验证流需要执行程序来执行实际登录。我们提供两个 executor 对于不同的执行模型：spring-doc.cn

AuthenticationStepsExecutor作为 SYNCHRONOUS 的直接替代品。ClientAuthenticationspring-doc.cn
AuthenticationStepsOperator进行响应式执行。spring-doc.cn

许多都带有静态工厂方法，用于为其特定于身份验证的选项创建：ClientAuthenticationAuthenticationStepsspring-doc.cn

例 10.同步执行AuthenticationSteps

CubbyholeAuthenticationOptions options = …
RestOperations restOperations = …

AuthenticationSteps steps = CubbyholeAuthentication.createAuthenticationSteps(options);

AuthenticationStepsExecutor executor = new AuthenticationStepsExecutor(steps, restOperations);

VaultToken token = executor.login();

Token 生命周期

Vault 的令牌可以与生存时间相关联。通过身份验证方法获取的令牌只要会话处于活动状态，就可以使用，并且在应用程序处于活动状态时不应过期。spring-doc.cn

Spring Vault 为LifecycleAwareSessionManager提供了一个会话管理器，该管理器可以更新令牌，直到它到达其终端 TTL，然后执行另一次登录以获取与会话关联的下一个令牌。spring-doc.cn

根据身份验证方法，登录可以创建两种类型的令牌：spring-doc.cn

VaultToken：封装实际 Token 的通用 Token。spring-doc.cn
LoginToken：与 renewability/TTL 关联的 Token。spring-doc.cn

TokenAuthentication 等身份验证方法只是创建一个不携带任何可续订性/TTL 详细信息的身份验证方法。LifecycleAwareSessionManager 将对 Token 运行自查找，以从 Vault 中检索可续订性和 TTL。如果启用了自查找，则会定期续订。请注意，永远不会撤销，只会被撤销。VaultTokenVaultTokenVaultTokenLoginTokenspring-doc.cn

直接创建的身份验证方法（所有基于登录的身份验证方法）已经提供了设置令牌续订所需的所有详细信息。如果会话管理器已关闭，则从登录中获取的令牌将被撤销。LoginTokenLifecycleAwareSessionManagerspring-doc.cn

身份验证方法

外部化登录凭证

Token 鉴权

AppId 鉴权

自定义 UserId

AppRole 身份验证

AWS-EC2 身份验证

AWS-IAM 身份验证

Azure （MSI） 身份验证

GCP-GCE 身份验证

GCP-IAM 身份验证

GitHub 身份验证

PCF 身份验证

TLS 证书认证

Cubbyhole 身份验证

JWT 身份验证

Kubernetes 身份验证

用户名/密码身份验证

身份验证步骤

Token 生命周期

Azure （MSI）身份验证