org.pentaho.platform.api.mt

Interface ITenantedPrincipleNameResolver

public interface ITenantedPrincipleNameResolver

Utility to go between principal IDs (user/role IDs) and principal name and tenant. To illustrate, if user "admin" belongs to tenant "acme," this resolver class determines the user's unique ID within a multi-tenanted environment where multiple users with the same name might exist across tenants. Conversely this class must be able to convert a unique user ID to a user name & tenant.

Author:

rmansoor

Method Summary

Modifier and Type	Method and Description
String	getPrincipleId(ITenant tenant, String principalName) Constructs a principle ID from tenant and principle name.
String	getPrincipleName(String principleId) Extracts the principle name from the principleId.
ITenant	getTenant(String principleId) Extracts the tenant from the principleId.
boolean	isValid(String principleId) Returns flag indicating that principleId is a valid tenanted string.

Method Detail

getTenant

ITenant getTenant(String principleId)

Extracts the tenant from the principleId.

Parameters:

principleId - Principle ID.

Returns:

Returns tenant that corresponds to the id.

getPrincipleName

String getPrincipleName(String principleId)

Extracts the principle name from the principleId.

Parameters:

principleId - Principle ID.

Returns:

Returns principle name that matches the principle ID.

getPrincipleId

String getPrincipleId(ITenant tenant,
                      String principalName)

Constructs a principle ID from tenant and principle name.

Parameters:

tenant - Tenant to be used for ID construction.

principalName - Name of the principle.

Returns:

Returns Unique ID for the specified principle name and tenant across all the tenants.

isValid

boolean isValid(String principleId)

Returns flag indicating that principleId is a valid tenanted string.

Parameters:

principleId - ID of the principle.

Returns:

Teturns True if the ID provided is a valid principle ID.