Package net.shibboleth.idp.authn.duo.impl

Class ValidateDuoWebResponse

  • All Implemented Interfaces:
    net.shibboleth.idp.authn.principal.PrincipalSupportingComponent, net.shibboleth.utilities.java.support.component.Component, net.shibboleth.utilities.java.support.component.DestructableComponent, net.shibboleth.utilities.java.support.component.InitializableComponent, org.opensaml.profile.action.ProfileAction, Aware, MessageSource, MessageSourceAware, Action
    public class ValidateDuoWebResponse
extends net.shibboleth.idp.authn.AbstractValidationAction
    An action that validates a DuoWeb response message and produces an AuthenticationResult or records error state.

    The username to cross-check comes from a lookup strategy, by default a CanonicalUsernameLookupStrategy that returns a username produced by an earlier authentication flow, and on success the same name is populated into a SubjectCanonicalizationContext as a pre-established result for the login flow.

    Since:
    3.3.0
    Event:
    EventIds.PROCEED_EVENT_ID, EventIds.INVALID_PROFILE_CTX, AuthnEventIds.INVALID_CREDENTIALS, AuthnEventIds.NO_CREDENTIALS
    Postcondition:
    ProfileRequestContext.getSubcontext(SubjectCanonicalizationContext.class).getPrincipalName() != null

    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      protected void buildAuthenticationResult​(org.opensaml.profile.context.ProfileRequestContext profileRequestContext, net.shibboleth.idp.authn.context.AuthenticationContext authenticationContext)
      protected void doExecute​(org.opensaml.profile.context.ProfileRequestContext profileRequestContext, net.shibboleth.idp.authn.context.AuthenticationContext authenticationContext)
      protected boolean doPreExecute​(org.opensaml.profile.context.ProfileRequestContext profileRequestContext, net.shibboleth.idp.authn.context.AuthenticationContext authenticationContext)
      protected Subject populateSubject​(Subject subject)
      void setDuoIntegration​(net.shibboleth.idp.authn.duo.DuoIntegration duo)
      Set DuoIntegration details to use directly.
      void setDuoIntegrationLookupStrategy​(Function<org.opensaml.profile.context.ProfileRequestContext,​net.shibboleth.idp.authn.duo.DuoIntegration> strategy)
      Set DuoIntegration lookup strategy to use.
      void setUsernameLookupStrategy​(Function<org.opensaml.profile.context.ProfileRequestContext,​String> strategy)
      Set the lookup strategy to use for the username to match against Duo identity.

      • Methods inherited from class net.shibboleth.idp.authn.AbstractValidationAction

        addDefaultPrincipals, getClassifiedErrors, getMetricName, getRequesterLookupStrategy, getResponderLookupStrategy, getResultCachingPredicate, getSubject, getSupportedPrincipals, handleError, handleError, handleWarning, recordFailure, recordSuccess, setAddDefaultPrincipals, setClassifiedMessages, setMetricName, setRequesterLookupStrategy, setResponderLookupStrategy, setResultCachingPredicate, setSupportedPrincipals

      • Methods inherited from class net.shibboleth.idp.authn.AbstractAuthenticationAction

        doExecute, doPreExecute, setAuthenticationContextLookupStrategy

      • Methods inherited from class net.shibboleth.idp.profile.AbstractProfileAction

        doExecute, execute, getMessage, getMessage, getMessage, getProfileContextLookupStrategy, getRequestContext, getResult, setMessageSource, setProfileContextLookupStrategy

      • Methods inherited from class org.opensaml.profile.action.AbstractConditionalProfileAction

        getActivationCondition, setActivationCondition

      • Methods inherited from class org.opensaml.profile.action.AbstractProfileAction

        doPostExecute, doPostExecute, execute, getHttpServletRequest, getHttpServletResponse, getLogPrefix, setHttpServletRequest, setHttpServletResponse

      • Methods inherited from class net.shibboleth.utilities.java.support.component.AbstractInitializableComponent

        destroy, doDestroy, doInitialize, initialize, isDestroyed, isInitialized

      • Methods inherited from interface net.shibboleth.utilities.java.support.component.InitializableComponent

        initialize, isInitialized

    • Field Detail

      • RESPONSE_PARAM

        @Nonnull
@NotEmpty
public static final String RESPONSE_PARAM
        Signed response parameter name.
        See Also:
        Constant Field Values

      • DEFAULT_METRIC_NAME

        @Nonnull
@NotEmpty
private static final String DEFAULT_METRIC_NAME
        Default prefix for metrics.
        See Also:
        Constant Field Values

      • log

        @Nonnull
private final org.slf4j.Logger log
        Class logger.

      • duoIntegrationLookupStrategy

        @Nonnull
private Function<org.opensaml.profile.context.ProfileRequestContext,​net.shibboleth.idp.authn.duo.DuoIntegration> duoIntegrationLookupStrategy
        Lookp strategy for Duo integration.

      • usernameLookupStrategy

        @Nonnull
private Function<org.opensaml.profile.context.ProfileRequestContext,​String> usernameLookupStrategy
        Lookup strategy for username to match against Duo identity.

      • duoIntegration

        @Nullable
private net.shibboleth.idp.authn.duo.DuoIntegration duoIntegration
        Duo integration to use.

      • username

        @Nullable
@NotEmpty
private String username
        Attempted username.

      • signedResponse

        @Nullable
@NotEmpty
private String signedResponse
        Signed response string.

    • Constructor Detail

      • ValidateDuoWebResponse

        public ValidateDuoWebResponse()
        Constructor.

    • Method Detail

      • setDuoIntegrationLookupStrategy

        public void setDuoIntegrationLookupStrategy​(@Nonnull
                                            Function<org.opensaml.profile.context.ProfileRequestContext,​net.shibboleth.idp.authn.duo.DuoIntegration> strategy)
        Set DuoIntegration lookup strategy to use.
        Parameters:
        strategy - lookup strategy

      • setDuoIntegration

        public void setDuoIntegration​(@Nonnull
                              net.shibboleth.idp.authn.duo.DuoIntegration duo)
        Set DuoIntegration details to use directly.
        Parameters:
        duo - Duo integration details

      • setUsernameLookupStrategy

        public void setUsernameLookupStrategy​(@Nonnull
                                      Function<org.opensaml.profile.context.ProfileRequestContext,​String> strategy)
        Set the lookup strategy to use for the username to match against Duo identity.
        Parameters:
        strategy - lookup strategy

      • doPreExecute

        protected boolean doPreExecute​(@Nonnull
                               org.opensaml.profile.context.ProfileRequestContext profileRequestContext,
                               @Nonnull
                               net.shibboleth.idp.authn.context.AuthenticationContext authenticationContext)
        Overrides:
        doPreExecute in class net.shibboleth.idp.authn.AbstractValidationAction

      • doExecute

        protected void doExecute​(@Nonnull
                         org.opensaml.profile.context.ProfileRequestContext profileRequestContext,
                         @Nonnull
                         net.shibboleth.idp.authn.context.AuthenticationContext authenticationContext)
        Overrides:
        doExecute in class net.shibboleth.idp.authn.AbstractAuthenticationAction

      • populateSubject

        protected Subject populateSubject​(@Nonnull
                                  Subject subject)
        Specified by:
        populateSubject in class net.shibboleth.idp.authn.AbstractValidationAction

      • buildAuthenticationResult

        protected void buildAuthenticationResult​(@Nonnull
                                         org.opensaml.profile.context.ProfileRequestContext profileRequestContext,
                                         @Nonnull
                                         net.shibboleth.idp.authn.context.AuthenticationContext authenticationContext)
        Overrides:
        buildAuthenticationResult in class net.shibboleth.idp.authn.AbstractValidationAction