Package pl.edu.icm.unity.engine.api.identity

Interface IdentityResolver

  • public interface IdentityResolver
    Allows for resolving an identity into entity, returning also its credential.

    This interface is intended for an internal use, as it performs all operations without any authorization. It should be used by the authentication related components as credential validators or authenticators.

    Author:
    K. Benedyczak

    • Method Detail

      • resolveIdentity

        EntityWithCredential resolveIdentity​(String identity,
                                     String[] identityTypes,
                                     String credentialName)
                              throws pl.edu.icm.unity.exceptions.EngineException
        Resolves an identity for performing authentication. It is guaranteed that the returned entity has not the disabled authentication state.
        Parameters:
        identity - raw identity value
        identityTypes - what are the types of the identity, in the preference order
        credentialName - what credential should be provided in the returned object. Can be null - then no credential is set in the returned object.
        Returns:
        the entity info with the credential value
        Throws:
        pl.edu.icm.unity.exceptions.IllegalIdentityValueException - if the given identity is not present in the db
        pl.edu.icm.unity.exceptions.EngineException

      • resolveEntity

        EntityWithCredential resolveEntity​(long entityId,
                                   String credentialName)
                            throws pl.edu.icm.unity.exceptions.EngineException
        Provides information about entity including its credential
        Throws:
        pl.edu.icm.unity.exceptions.EngineException

      • resolveSubject

        EntityWithCredential resolveSubject​(AuthenticationSubject subject,
                                    String[] identityTypes,
                                    String credentialName)
                             throws pl.edu.icm.unity.exceptions.IllegalIdentityValueException,
                                    pl.edu.icm.unity.exceptions.IllegalTypeException,
                                    pl.edu.icm.unity.exceptions.IllegalGroupValueException,
                                    pl.edu.icm.unity.exceptions.EngineException
        Provides information about subject including its credential
        Throws:
        pl.edu.icm.unity.exceptions.IllegalIdentityValueException
        pl.edu.icm.unity.exceptions.IllegalTypeException
        pl.edu.icm.unity.exceptions.IllegalGroupValueException
        pl.edu.icm.unity.exceptions.EngineException

      • resolveSubject

        pl.edu.icm.unity.types.basic.Identity resolveSubject​(AuthenticationSubject subject,
                                                     String identityType)
                                              throws pl.edu.icm.unity.exceptions.IllegalIdentityValueException,
                                                     pl.edu.icm.unity.exceptions.IllegalTypeException,
                                                     pl.edu.icm.unity.exceptions.IllegalGroupValueException,
                                                     pl.edu.icm.unity.exceptions.EngineException
        Provides information about subject including its credential
        Throws:
        pl.edu.icm.unity.exceptions.IllegalIdentityValueException
        pl.edu.icm.unity.exceptions.IllegalTypeException
        pl.edu.icm.unity.exceptions.IllegalGroupValueException
        pl.edu.icm.unity.exceptions.EngineException

      • resolveIdentity

        long resolveIdentity​(String identity,
                     String[] identityTypes,
                     String target,
                     String realm)
              throws pl.edu.icm.unity.exceptions.EngineException
        Simple version that only resolves, but doesn't establish any local credential. Useful for remote verificators.
        Throws:
        pl.edu.icm.unity.exceptions.EngineException

      • isEntityEnabled

        boolean isEntityEnabled​(long entity)

      • getDisplayedUserName

        String getDisplayedUserName​(pl.edu.icm.unity.types.basic.EntityParam entity)
                     throws pl.edu.icm.unity.exceptions.EngineException
        Throws:
        pl.edu.icm.unity.exceptions.EngineException

      • getIdentitiesForEntity

        List<pl.edu.icm.unity.types.basic.Identity> getIdentitiesForEntity​(pl.edu.icm.unity.types.basic.EntityParam entity)
                                                            throws pl.edu.icm.unity.exceptions.IllegalIdentityValueException
        Resolves EntityParam to list of all Identities, if missing throws exception
        Parameters:
        entity - Describes search criteria
        Returns:
        List of Identity
        Throws:
        pl.edu.icm.unity.exceptions.IllegalIdentityValueException - for missing entity

      • insertIdentity

        pl.edu.icm.unity.types.basic.Identity insertIdentity​(pl.edu.icm.unity.types.basic.IdentityParam toAdd,
                                                     pl.edu.icm.unity.types.basic.EntityParam entity)
                                              throws pl.edu.icm.unity.exceptions.IllegalIdentityValueException
        Insert identity in DB.
        Parameters:
        toAdd - Describes Identity details
        entity - EntityParam describing search criteria
        Returns:
        Created Identity
        Throws:
        pl.edu.icm.unity.exceptions.IllegalIdentityValueException - In case of basic rules check failure.