org.apache.jackrabbit.oak.spi.security.authentication.external

Interface PrincipalNameResolver

All Known Implementing Classes:

LdapIdentityProvider

public interface PrincipalNameResolver

Interface to obtain the name of the Principal from a given ExternalIdentityRef. The aim of this interface is to prevent potentially unnecessary round trips associated with the following sequence:

     String principalName = null;
     ExternalIdentity extId = externalIDP.getIdentity(externalIdentityRef);
     if (extId != null) {
         principalName = extid.getPrincipalName();
     }
 

This interface is expected to be implemented by ExternalIdentityProviders, that can deduce the principal name from the reference without the extra round trip.

Method Summary

Modifier and Type	Method and Description
String	fromExternalIdentityRef(ExternalIdentityRef externalIdentityRef) Deduce the name of the Principal associated with the ExternalIdentity represented by the given ExternalIdentityRef.

Method Detail

fromExternalIdentityRef

@Nonnull
String fromExternalIdentityRef(@Nonnull
                                         ExternalIdentityRef externalIdentityRef)
                                  throws ExternalIdentityException

Deduce the name of the Principal associated with the ExternalIdentity represented by the given ExternalIdentityRef.

Parameters:

externalIdentityRef - A valid ExternalIdentityRef to an existing ExternalIdentity

Returns:

The name of the Principal associated with the external identity referenced by the given externalIdentityRef.

Throws:

ExternalIdentityException - If the reference is not valid or another error occurs.