Skip to content

Commit fef52e4

Browse files
Use xref anchor id
1 parent 5cc296d commit fef52e4

File tree

1 file changed

+8
-8
lines changed
  • docs/modules/ROOT/pages/servlet/authentication

1 file changed

+8
-8
lines changed

docs/modules/ROOT/pages/servlet/authentication/mfa.adoc

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -44,14 +44,14 @@ The `@EnableMultiFactorAuthentication` `authorities` property is just a shortcut
4444
When an `AuthorizationManagerFactory` Bean is available, it is used by Spring Security to create authorization rules, like `hasAnyRole(String)`, that are defined on the `AuthorizationManagerFactory` Bean interface.
4545
The implementation published by `@EnableMultiFactorAuthentication` will ensure that each authorization is combined with the requirement of having the specified factors.
4646

47-
The `AuthorizationManagerFactory` Bean below is what is published in the previously discussed <<emfa, `@EnableMultiFactorAuthentication` example>>.
47+
The `AuthorizationManagerFactory` Bean below is what is published in the previously discussed xref:emfa[`@EnableMultiFactorAuthentication` example].
4848

4949
include-code::./UseAuthorizationManagerFactoryConfiguration[tag=authorizationManagerFactoryBean,indent=0]
5050

5151
[[selective-mfa]]
5252
== Selectively Requiring MFA
5353

54-
We have demonstrated how to configure an entire application to require MFA by using <<emfa, ``@EnableMultiFactorAuthentication``s>> `authorities` property.
54+
We have demonstrated how to configure an entire application to require MFA by using xref:emfa[``@EnableMultiFactorAuthentication``s] `authorities` property.
5555
However, there are times that an application only wants parts of the application to require MFA.
5656
Consider the following requirements:
5757

@@ -61,7 +61,7 @@ Consider the following requirements:
6161

6262
In this case, some URLs require MFA while others do not.
6363
This means that the global approach that we saw before does not work.
64-
Fortunately, we can use what we learned in <<authorization-manager-factory>> to solve this in a concise manner.
64+
Fortunately, we can use what we learned in xref:authorization-manager-factory[] to solve this in a concise manner.
6565

6666
Start by specifying `@EnableMultiFactorAuthentication` without any authorities.
6767
By doing so we enable MFA support, but no `AuthorizationManagerFactory` Bean is published.
@@ -121,7 +121,7 @@ include-code::./AdminMfaAuthorizationManagerConfiguration[tag=authorizationManag
121121
This instructs `DefaultAuthorizationManagerFactory` that any authorization rule should apply our custom `AuthorizationManager` along with any authorization requirements defined by the application (e.g. `hasRole("ADMIN")`).
122122
<2> Publish `DefaultAuthorizationManagerFactory` as a Bean, so it is used globally
123123

124-
This should feel very similar to our previous example in <<authorization-manager-factory>>.
124+
This should feel very similar to our previous example in xref:authorization-manager-factory[].
125125
The difference is that in the previous example, the `AuthorizationManagerFactories` is setting `DefaultAuthorization.additionalAuthorization` with a built in `AuthorizationManager` that always requires the same authorities.
126126

127127
We can now define our authorization rules which are combined with `AdminMfaAuthorizationManager`.
@@ -138,10 +138,10 @@ If we preferred, we could change our logic to enable MFA based upon the roles ra
138138
[[raam-mfa]]
139139
== RequiredAuthoritiesAuthorizationManager
140140

141-
We've demonstrated how we can dynamically determine the authorities for a particular user in <<programmatic-mfa>> using a custom `AuthorizationManager`.
141+
We've demonstrated how we can dynamically determine the authorities for a particular user in xref:programmatic-mfa[] using a custom `AuthorizationManager`.
142142
However, this is such a common scenario that Spring Security provides built in support using javadoc:org.springframework.security.authorization.RequiredAuthoritiesAuthorizationManager[] and javadoc:org.springframework.security.authorization.RequiredAuthoritiesRepository[].
143143

144-
Let's implement the same requirement that we did in <<programmatic-mfa>> using the built-in support.
144+
Let's implement the same requirement that we did in xref:programmatic-mfa[] using the built-in support.
145145

146146
We start by creating the `RequiredAuthoritiesAuthorizationManager` Bean to use.
147147

@@ -168,7 +168,7 @@ Our example uses an in memory mapping of usernames to the additional required au
168168
For more dynamic use cases that can be determined by the username, a custom implementation of javadoc:org.springframework.security.authorization.RequiredAuthoritiesRepository[] can be created.
169169
Possible examples would be looking up if a user has enabled MFA in an explicit setting, determining if a user has registered a passkey, etc.
170170

171-
For cases that need to determine MFA based upon the `Authentication`, a custom `AuthorizationManger` can be used as demonstrated in <<programmatic-mfa>>.
171+
For cases that need to determine MFA based upon the `Authentication`, a custom `AuthorizationManger` can be used as demonstrated in xref:programmatic-mfa[].
172172

173173

174174
[[hasallauthorities]]
@@ -197,7 +197,7 @@ Can you imagine what it would be like to declare hundreds of rules like this?
197197
What's more that it becomes difficult to express more complicated authorization rules.
198198
For example, how would you require two factors and either `ROLE_ADMIN` or `ROLE_USER`?
199199

200-
The answer to these questions, as we have already seen, is to use <<emfa>>
200+
The answer to these questions, as we have already seen, is to use xref:emfa[]
201201

202202
[[re-authentication]]
203203
== Re-authentication

0 commit comments

Comments
 (0)