Adapt to changed Spring Framework 5 documentation structure.
Closes gh-147.
This commit is contained in:
@@ -4,6 +4,7 @@ Mark Paluch;
|
||||
:revdate: {localdate}
|
||||
:toc: macro
|
||||
:toc-placement!:
|
||||
:spring-framework-docs: http://docs.spring.io/spring/docs/{springVersion}/spring-framework-reference/
|
||||
|
||||
(C) 2016-2017 The original authors.
|
||||
|
||||
|
||||
@@ -21,7 +21,7 @@ as well as Spring concepts.
|
||||
[[get-started:first-steps:spring]]
|
||||
== Knowing Spring
|
||||
|
||||
Spring Vault uses Spring framework's http://docs.spring.io/spring/docs/4.2.x/spring-framework-reference/html/spring-core.html[core] functionality, such as the http://docs.spring.io/spring/docs/{springVersion}/spring-framework-reference/html/beans.html[IoC] container. While it is not important to know the Spring APIs, understanding the concepts behind them is. At a minimum, the idea behind IoC should be familiar for whatever IoC container you choose to use.
|
||||
Spring Vault uses Spring framework's {spring-framework-docs}core.html[core] functionality, such as {spring-framework-docs}/core.html[IoC] container. While it is not important to know the Spring APIs, understanding the concepts behind them is. At a minimum, the idea behind IoC should be familiar for whatever IoC container you choose to use.
|
||||
|
||||
The core functionality of the Vault support can be used directly, with no need to invoke the IoC services of the Spring Container. This is much like `RestTemplate` which can be used 'standalone' without any other services of the Spring container. To leverage all the features of Spring Vault document, such as the session support, you will need to configure some parts of the library using Spring.
|
||||
|
||||
|
||||
@@ -15,7 +15,7 @@ Disclosure of login credentials to any party allows login to Vault and access se
|
||||
are permitted by the underlying role. Picking the appropriate client authentication and
|
||||
injecting credentials into the application is subject to risk evaluation.
|
||||
|
||||
Spring's http://docs.spring.io/spring-framework/docs/current/spring-framework-reference/html/beans.html#beans-property-source-abstraction[PropertySource abstraction] is a natural fit
|
||||
Spring's {spring-framework-docs}core.html#beans-property-source-abstraction[PropertySource abstraction] is a natural fit
|
||||
to keep configuration outside the application code. You can use system properties, environment
|
||||
variables or property files to store login credentials. Each approach comes with its own properties.
|
||||
Keep in mind that the command line and environment properties can be introspected with appropriate
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
= Client support
|
||||
|
||||
Spring Vault supports various HTTP clients to access Vault's HTTP API. Spring Vault uses
|
||||
http://docs.spring.io/spring/docs/{springVersion}/spring-framework-reference/html/remoting.html#rest-resttemplate[`RestTemplate`] as primary interface accessing Vault.
|
||||
{spring-framework-docs}integration.html#rest-resttemplate[`RestTemplate`] as primary interface accessing Vault.
|
||||
Dedicated client support originates from <<vault.client-ssl,customized SSL configuration>>
|
||||
that is scoped only to Spring Vault's client components.
|
||||
|
||||
|
||||
@@ -38,7 +38,7 @@ Now let's look at a examples of how to work with Vault in the context of the Spr
|
||||
== Registering and configuring Spring Vault beans
|
||||
|
||||
Using Spring Vault does not require a Spring Context. However, instances of `VaultTemplate` and `SessionManager` registered inside a managed context will participate
|
||||
in http://docs.spring.io/spring/docs/current/spring-framework-reference/html/beans.html#beans-factory-nature[lifecycle events]
|
||||
in {spring-framework-docs}core.html#beans-factory-nature[lifecycle events]
|
||||
provided by the Spring IoC container. This is useful to dispose active Vault sessions upon
|
||||
application shutdown. You also benefit from reusing the same `VaultTemplate`
|
||||
instance across your application.
|
||||
|
||||
@@ -3,7 +3,7 @@
|
||||
|
||||
Vault can be used in many different ways. One specific use-case is using
|
||||
Vault to store encrypted properties. Spring Vault supports Vault as property
|
||||
source to obtain configuration properties using Spring's http://docs.spring.io/spring-framework/docs/current/spring-framework-reference/html/beans.html#beans-property-source-abstraction[PropertySource abstraction].
|
||||
source to obtain configuration properties using Spring's {spring-framework-docs}core.html#beans-property-source-abstraction[PropertySource abstraction].
|
||||
|
||||
NOTE: You can reference properties stored inside Vault in other property sources or use value injection with `@Value(…)`. Special attention is required when bootstrapping beans that require data stored inside of Vault. A `VaultPropertySource` must be initialized at that time to retrieve properties from Vault.
|
||||
|
||||
|
||||
@@ -58,7 +58,7 @@ Now let's look at a examples of how to work with Vault in the context of the Spr
|
||||
|
||||
Using Spring Vault does not require a Spring Context. However, instances of
|
||||
`ReactiveVaultTemplate` and `VaultTokenSupplier` registered inside a managed context will participate
|
||||
in http://docs.spring.io/spring/docs/current/spring-framework-reference/html/beans.html#beans-factory-nature[lifecycle events]
|
||||
in {spring-framework-docs}core.html#beans-factory-nature[lifecycle events]
|
||||
provided by the Spring IoC container. This is useful to dispose active Vault sessions upon
|
||||
application shutdown. You also benefit from reusing the same `ReactiveVaultTemplate`
|
||||
instance across your application.
|
||||
|
||||
Reference in New Issue
Block a user