Spring Cloud Vault Spring Connector


License

License

GroupId

GroupId

io.pivotal.spring.cloud
ArtifactId

ArtifactId

spring-cloud-vault-spring-connector
Last Version

Last Version

2.1.0.RELEASE
Release Date

Release Date

Type

Type

jar
Description

Description

Spring Cloud Vault Spring Connector
Spring Cloud Vault Spring Connector
Project URL

Project URL

https://github.com/pivotal-cf/spring-cloud-vault-connector
Project Organization

Project Organization

Spring IO
Source Code Management

Source Code Management

https://github.com/pivotal-cf/spring-cloud-vault-connector

Download spring-cloud-vault-spring-connector

How to add to project

<!-- https://jarcasting.com/artifacts/io.pivotal.spring.cloud/spring-cloud-vault-spring-connector/ -->
<dependency>
    <groupId>io.pivotal.spring.cloud</groupId>
    <artifactId>spring-cloud-vault-spring-connector</artifactId>
    <version>2.1.0.RELEASE</version>
</dependency>
// https://jarcasting.com/artifacts/io.pivotal.spring.cloud/spring-cloud-vault-spring-connector/
implementation 'io.pivotal.spring.cloud:spring-cloud-vault-spring-connector:2.1.0.RELEASE'
// https://jarcasting.com/artifacts/io.pivotal.spring.cloud/spring-cloud-vault-spring-connector/
implementation ("io.pivotal.spring.cloud:spring-cloud-vault-spring-connector:2.1.0.RELEASE")
'io.pivotal.spring.cloud:spring-cloud-vault-spring-connector:jar:2.1.0.RELEASE'
<dependency org="io.pivotal.spring.cloud" name="spring-cloud-vault-spring-connector" rev="2.1.0.RELEASE">
  <artifact name="spring-cloud-vault-spring-connector" type="jar" />
</dependency>
@Grapes(
@Grab(group='io.pivotal.spring.cloud', module='spring-cloud-vault-spring-connector', version='2.1.0.RELEASE')
)
libraryDependencies += "io.pivotal.spring.cloud" % "spring-cloud-vault-spring-connector" % "2.1.0.RELEASE"
[io.pivotal.spring.cloud/spring-cloud-vault-spring-connector "2.1.0.RELEASE"]

Dependencies

compile (2)

Group / Artifact Type Version
io.pivotal.spring.cloud : spring-cloud-vault-connector-core jar 2.1.0.RELEASE
org.springframework.cloud : spring-cloud-spring-service-connector jar 2.0.7.RELEASE

Project Modules

There are no modules declared in this project.

Spring Cloud Vault Connector

Spring Cloud Connector for using HashiCorp's Vault service broker on Cloud Foundry.

NOTE: This project is in maintenance mode, in favor of the newer Java CFEnv project. We will continue to release security-related updates but will not address enhancement requests.

Quick Start

Maven configuration

Add the Maven dependency:

<dependency>
  <groupId>io.pivotal.spring.cloud</groupId>
  <artifactId>spring-cloud-vault-spring-connector</artifactId>
  <version>${version}.RELEASE</version>
</dependency>

If you'd rather like the latest snapshots of the upcoming major version, use our Maven snapshot repository and declare the appropriate dependency version.

<dependency>
  <groupId>io.pivotal.spring.cloud</groupId>
  <artifactId>spring-cloud-vault-spring-connector</artifactId>
  <version>${version}.BUILD-SNAPSHOT</version>
</dependency>

<repository>
  <id>spring-libs-snapshot</id>
  <name>Spring Snapshot Repository</name>
  <url>https://repo.spring.io/libs-snapshot</url>
</repository>

Compatibility matrix

Component Version
Spring Vault 2.x (2.0 - 2.1)
Spring Cloud Vault 2.x (2.0 - 2.1)

Java Applications

Applications can use this connector to access the information in VCAP_SERVICES environment variable, necessary to connect to a Vault service.

CloudFactory cloudFactory = new CloudFactory();
Cloud cloud = cloudFactory.getCloud();
VaultServiceInfo myService = (VaultServiceInfo) cloud.getServiceInfo("MyService");
myService.getUri();
myService.getToken();

Spring Applications

Spring Application can use this connector to auto inject a VaultTemplate which enables the application to talk to the Vault server.

Spring Boot Applications with Spring Cloud Vault

Spring Boot Applications using Spring Cloud Vault are auto-reconfigured if a single Vault service is bound to the application.

Spring Vault is configured to use token authentication (using the provided token from the service broker), It loads by default secrets from the dedicated and shared generic backends:

spring.cloud.vault.generic.backends: generic, space, organization

You can override the configuration by setting the spring.cloud.vault.generic.backends property. Names specified in spring.cloud.vault.generic.backends are attempted to be resolved against shared_backends and backends maps from VCAP_SERVICES.

Supports port-less URL using scheme-specific port defaults.

io.pivotal.spring.cloud

Pivotal Cloud Foundry

Versions

Version
2.1.0.RELEASE
2.0.1.RELEASE
2.0.0.RELEASE
1.0.0.RELEASE