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

Interface PrincipalNameResolver

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	Description
@NotNull java.lang.String	fromExternalIdentityRef(@NotNull ExternalIdentityRef externalIdentityRef)	Deduce the name of the Principal associated with the ExternalIdentity represented by the given ExternalIdentityRef.

Method Detail

fromExternalIdentityRef

@NotNull
@NotNull java.lang.String fromExternalIdentityRef(@NotNull
                                                  @NotNull 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.