com.openkm.sdk4j.definition

Interface BaseAuth

All Known Implementing Classes:

AuthImpl, OKMWebservices

public interface BaseAuth

BaseAuth

Author:

jllort

Method Summary

Modifier and Type	Method and Description
void	assignRole(String userId, String roleId) Method to assign a role
void	changeSecurity(String uuid, ChangeSecurity changeSecurity) Change several security permissions in the same call.
void	createRole(String roleId, boolean active) Method to create a new role
void	createUser(String userId, String password, String email, String name, boolean active) Method to create a new user
void	deleteRole(String roleId) Method to create a delete a role
void	deleteUser(String userId) Method to delete a user
String	disable2FA() Disable 2FA
String	generate2FASecret() Generate 2FA secret
Map<String,Integer>	getGrantedRoles(String uuid) Get roles permissions from am item (document or folder).
Map<String,Integer>	getGrantedUsers(String uuid) Get user permissions from am item (document or folder).
GrantedUsersAndRolesItem	getGrantedUsersAndRoles(String uuid) Get granted users and roles
List<Profile>	getProfiles(boolean filterByActive) Get all profiles
List<String>	getRoles(boolean showAll) Retrieves a list of repository roles.
List<String>	getRolesByUser(String userId) Retrieves a list of roles by user.
String	getSessionId() Get session
InputStream	getTwoFactorQR(String secret) Get 2FA
CommonUser	getUser(String userId) Retrieve information of a given user
Profile	getUserProfile(String userId) Get user profile
List<CommonUser>	getUsers(boolean showAll) Retrieve information of a given user
List<CommonUser>	getUsersByRole(String roleId) Retrieves a list of users by role.
List<Tenant>	getUserTenants() Get a list of available tenants for a user.
String	getUserToken(String userId) Get user token
void	grantRole(String uuid, String roleId, int permissions, boolean recursive) Grant role permissions for a node.
void	grantUser(String uuid, String userId, int permissions, boolean recursive) Add user permissions to a node.
boolean	hasSecurityRecursive() Has security recursive
boolean	isAdmin() Is admin
boolean	isLoginLowercase() Is login lowercase
boolean	isPasswordExpired() Check the password of the user expiration
boolean	isTwoFactorAuthentication() Is two factor authentication
void	overwriteSecurity(String uuid, ChangeSecurity changeSecurity) Change several security permissions in the same call.
void	removeRole(String userId, String roleId) Method to remove a role
void	revokeRole(String uuid, String roleId, int permissions, boolean recursive) Revoke role permissions from a node.
void	revokeUser(String uuid, String userId, int permissions, boolean recursive) Revoke user permissions from a node.
void	setAuthorizationToken(String authorizationToken) Set token
void	setRolePermissions(String uuid, String roleId, int permissions, boolean recursive) Set role permissions for a node.
void	setUserPermissions(String uuid, String userId, int permissions, boolean recursive) Set user permissions to a node
void	setUserProfile(String userId, long profileId) Set the user profile
void	setUserTenant(long tenantId) Update user tenant.
void	updateRole(String roleId, boolean active) Update role information
void	updateUser(String userId, String password, String email, String name, boolean active) Update user information
String	validate2FAAndSaveSecret(String secret, int code) Validate 2FA and save secret
String	verify2FACode(int code) Verify 2FA code

Method Detail

getSessionId

String getSessionId()

Get session

Returns:

String session id

setAuthorizationToken

void setAuthorizationToken(String authorizationToken)

Set token

Parameters:

authorizationToken - the authorization token

getGrantedUsersAndRoles

GrantedUsersAndRolesItem getGrantedUsersAndRoles(String uuid)
                                          throws AccessDeniedException,
                                                 RepositoryException,
                                                 DatabaseException,
                                                 PathNotFoundException,
                                                 UnknownException,
                                                 WebserviceException

Get granted users and roles

Parameters:

uuid - Node uuid.

Returns:

GrantedUsersAndRolesItem An object with list the users and roles

Throws:

AccessDeniedException - the access denied exception

RepositoryException - the repository exception

DatabaseException - the database exception

PathNotFoundException - the path not found exception

UnknownException - the unknown exception

WebserviceException - the webservice exception

getGrantedRoles

Map<String,Integer> getGrantedRoles(String uuid)
                             throws AccessDeniedException,
                                    RepositoryException,
                                    DatabaseException,
                                    PathNotFoundException,
                                    UnknownException,
                                    WebserviceException

Get roles permissions from am item (document or folder).

Parameters:

uuid - Node uuid.

Returns:

Map A hashmap with pairs of role / permissions.

Throws:

AccessDeniedException - the access denied exception

RepositoryException - the repository exception

DatabaseException - the database exception

PathNotFoundException - the path not found exception

UnknownException - the unknown exception

WebserviceException - the webservice exception

getGrantedUsers

Map<String,Integer> getGrantedUsers(String uuid)
                             throws AccessDeniedException,
                                    RepositoryException,
                                    DatabaseException,
                                    PathNotFoundException,
                                    UnknownException,
                                    WebserviceException

Get user permissions from am item (document or folder).

Parameters:

uuid - Node uuid.

Returns:

Map A hashmap with pairs of user / permissions.

Throws:

AccessDeniedException - the access denied exception

RepositoryException - the repository exception

DatabaseException - the database exception

PathNotFoundException - the path not found exception

UnknownException - the unknown exception

WebserviceException - the webservice exception

getRoles

List<String> getRoles(boolean showAll)
               throws AccessDeniedException,
                      RepositoryException,
                      DatabaseException,
                      PrincipalAdapterException,
                      UnknownException,
                      WebserviceException

Retrieves a list of repository roles.

Parameters:

showAll - If should only return active roles or all them

Returns:

List A collection of repository roles.

Throws:

AccessDeniedException - the access denied exception

RepositoryException - the repository exception

DatabaseException - the database exception

PrincipalAdapterException - the principal adapter exception

UnknownException - the unknown exception

WebserviceException - the webservice exception

getRolesByUser

List<String> getRolesByUser(String userId)
                     throws AccessDeniedException,
                            RepositoryException,
                            DatabaseException,
                            PrincipalAdapterException,
                            UnknownException,
                            WebserviceException

Retrieves a list of roles by user.

Parameters:

userId - A user id.

Returns:

List A repository roles.

Throws:

AccessDeniedException - the access denied exception

RepositoryException - the repository exception

DatabaseException - the database exception

PrincipalAdapterException - the principal adapter exception

UnknownException - the unknown exception

WebserviceException - the webservice exception

getUsers

List<CommonUser> getUsers(boolean showAll)
                   throws AccessDeniedException,
                          RepositoryException,
                          DatabaseException,
                          PrincipalAdapterException,
                          UnknownException,
                          WebserviceException

Retrieve information of a given user

Parameters:

showAll - If should only return active users or all them

Returns:

List A collection of repository users.

Throws:

AccessDeniedException - the access denied exception

RepositoryException - the repository exception

DatabaseException - the database exception

PrincipalAdapterException - the principal adapter exception

UnknownException - the unknown exception

WebserviceException - the webservice exception

getUser

CommonUser getUser(String userId)
            throws AccessDeniedException,
                   RepositoryException,
                   DatabaseException,
                   PrincipalAdapterException,
                   UnknownException,
                   WebserviceException

Retrieve information of a given user

Parameters:

userId - A user id.

Returns:

CommonUser The data user

Throws:

AccessDeniedException - the access denied exception

RepositoryException - the repository exception

DatabaseException - the database exception

PrincipalAdapterException - the principal adapter exception

UnknownException - the unknown exception

WebserviceException - the webservice exception

getUsersByRole

List<CommonUser> getUsersByRole(String roleId)
                         throws AccessDeniedException,
                                RepositoryException,
                                DatabaseException,
                                PrincipalAdapterException,
                                UnknownException,
                                WebserviceException

Retrieves a list of users by role.

Parameters:

roleId - A role id.

Returns:

List A repository users.

Throws:

AccessDeniedException - the access denied exception

RepositoryException - the repository exception

DatabaseException - the database exception

PrincipalAdapterException - the principal adapter exception

UnknownException - the unknown exception

WebserviceException - the webservice exception

revokeRole

void revokeRole(String uuid,
                String roleId,
                int permissions,
                boolean recursive)
         throws AccessDeniedException,
                RepositoryException,
                DatabaseException,
                PathNotFoundException,
                UnknownException,
                WebserviceException

Revoke role permissions from a node.

Parameters:

uuid - Node uuid.

roleId - Role name which permissions are changed.

permissions - A mask with the permissions to be removed.

recursive - If the nodePath indicates a folder, the permissions can be applied recursively.

Throws:

AccessDeniedException - the access denied exception

RepositoryException - the repository exception

DatabaseException - the database exception

PathNotFoundException - the path not found exception

UnknownException - the unknown exception

WebserviceException - the webservice exception

revokeUser

void revokeUser(String uuid,
                String userId,
                int permissions,
                boolean recursive)
         throws AccessDeniedException,
                RepositoryException,
                DatabaseException,
                PathNotFoundException,
                UnknownException,
                WebserviceException

Revoke user permissions from a node.

Parameters:

uuid - Node uuid.

userId - User name which permissions are changed.

permissions - A mask with the permissions to be removed.

recursive - If the nodePath indicates a folder, the permissions can be revoked recursively.

Throws:

AccessDeniedException - the access denied exception

RepositoryException - the repository exception

DatabaseException - the database exception

PathNotFoundException - the path not found exception

UnknownException - the unknown exception

WebserviceException - the webservice exception

grantRole

void grantRole(String uuid,
               String roleId,
               int permissions,
               boolean recursive)
        throws AccessDeniedException,
               RepositoryException,
               DatabaseException,
               PathNotFoundException,
               UnknownException,
               WebserviceException

Grant role permissions for a node.

Parameters:

uuid - Node uuid.

roleId - Role name which permissions are changed.

permissions - A mask with the permissions to be removed.

recursive - If the nodePath indicates a folder, the permissions can be applied recursively.

Throws:

AccessDeniedException - the access denied exception

RepositoryException - the repository exception

DatabaseException - the database exception

PathNotFoundException - the path not found exception

UnknownException - the unknown exception

WebserviceException - the webservice exception

grantUser

void grantUser(String uuid,
               String userId,
               int permissions,
               boolean recursive)
        throws AccessDeniedException,
               RepositoryException,
               DatabaseException,
               PathNotFoundException,
               UnknownException,
               WebserviceException

Add user permissions to a node.

Parameters:

uuid - Node uuid.

userId - User name which permissions are changed.

permissions - A mask with the permissions to be added.

recursive - If the nodePath indicated a folder, the permissions can be applied recursively.

Throws:

AccessDeniedException - the access denied exception

RepositoryException - the repository exception

DatabaseException - the database exception

PathNotFoundException - the path not found exception

UnknownException - the unknown exception

WebserviceException - the webservice exception

changeSecurity

void changeSecurity(String uuid,
                    ChangeSecurity changeSecurity)
             throws PathNotFoundException,
                    AccessDeniedException,
                    RepositoryException,
                    DatabaseException,
                    UnknownException,
                    WebserviceException

Change several security permissions in the same call.

Parameters:

uuid - Node uuid.

changeSecurity - the change security

Throws:

PathNotFoundException - the path not found exception

AccessDeniedException - the access denied exception

RepositoryException - the repository exception

DatabaseException - the database exception

UnknownException - the unknown exception

WebserviceException - the webservice exception

overwriteSecurity

void overwriteSecurity(String uuid,
                       ChangeSecurity changeSecurity)
                throws PathNotFoundException,
                       AccessDeniedException,
                       RepositoryException,
                       DatabaseException,
                       UnknownException,
                       WebserviceException

Change several security permissions in the same call.

Parameters:

uuid - Node uuid.

changeSecurity - the change security

Throws:

PathNotFoundException - the path not found exception

AccessDeniedException - the access denied exception

RepositoryException - the repository exception

DatabaseException - the database exception

UnknownException - the unknown exception

WebserviceException - the webservice exception

isAdmin

boolean isAdmin()
         throws PrincipalAdapterException,
                UnknownException,
                WebserviceException

Is admin

Returns:

boolean boolean

Throws:

PrincipalAdapterException - the principal adapter exception

UnknownException - the unknown exception

WebserviceException - the webservice exception

hasSecurityRecursive

boolean hasSecurityRecursive()
                      throws UnknownException,
                             WebserviceException

Has security recursive

Returns:

boolean boolean

Throws:

UnknownException - the unknown exception

WebserviceException - the webservice exception

isLoginLowercase

boolean isLoginLowercase()
                  throws UnknownException,
                         WebserviceException

Is login lowercase

Returns:

boolean boolean

Throws:

UnknownException - the unknown exception

WebserviceException - the webservice exception

isPasswordExpired

boolean isPasswordExpired()
                   throws UnknownException,
                          WebserviceException

Check the password of the user expiration

Returns:

true when password is expired

Throws:

UnknownException - the unknown exception

WebserviceException - the webservice exception

createUser

void createUser(String userId,
                String password,
                String email,
                String name,
                boolean active)
         throws PrincipalAdapterException,
                UnknownException,
                WebserviceException

Method to create a new user

Parameters:

userId - A user id.

password - the password

email - the email

name - the name

active - the active

Throws:

PrincipalAdapterException - the principal adapter exception

UnknownException - the unknown exception

WebserviceException - the webservice exception

deleteUser

void deleteUser(String userId)
         throws PrincipalAdapterException,
                UnknownException,
                WebserviceException

Method to delete a user

Parameters:

userId - A user id.

Throws:

PrincipalAdapterException - the principal adapter exception

UnknownException - the unknown exception

WebserviceException - the webservice exception

updateUser

void updateUser(String userId,
                String password,
                String email,
                String name,
                boolean active)
         throws PrincipalAdapterException,
                UnknownException,
                WebserviceException

Update user information

Parameters:

userId - A user id.

password - the password

email - the email

name - the name

active - the active

Throws:

PrincipalAdapterException - the principal adapter exception

UnknownException - the unknown exception

WebserviceException - the webservice exception

createRole

void createRole(String roleId,
                boolean active)
         throws PrincipalAdapterException,
                UnknownException,
                WebserviceException

Method to create a new role

Parameters:

roleId - A role id.

active - the active

Throws:

PrincipalAdapterException - the principal adapter exception

UnknownException - the unknown exception

WebserviceException - the webservice exception

deleteRole

void deleteRole(String roleId)
         throws PrincipalAdapterException,
                UnknownException,
                WebserviceException

Method to create a delete a role

Parameters:

roleId - A role id.

Throws:

PrincipalAdapterException - the principal adapter exception

UnknownException - the unknown exception

WebserviceException - the webservice exception

updateRole

void updateRole(String roleId,
                boolean active)
         throws PrincipalAdapterException,
                UnknownException,
                WebserviceException

Update role information

Parameters:

roleId - A role id

active - the active

Throws:

PrincipalAdapterException - the principal adapter exception

UnknownException - the unknown exception

WebserviceException - the webservice exception

assignRole

void assignRole(String userId,
                String roleId)
         throws PrincipalAdapterException,
                UnknownException,
                WebserviceException

Method to assign a role

Parameters:

userId - A user id.

roleId - A role id.

Throws:

PrincipalAdapterException - the principal adapter exception

UnknownException - the unknown exception

WebserviceException - the webservice exception

removeRole

void removeRole(String userId,
                String roleId)
         throws PrincipalAdapterException,
                UnknownException,
                WebserviceException

Method to remove a role

Parameters:

userId - A user id.

roleId - A role id.

Throws:

PrincipalAdapterException - the principal adapter exception

UnknownException - the unknown exception

WebserviceException - the webservice exception

getProfiles

List<Profile> getProfiles(boolean filterByActive)
                   throws PrincipalAdapterException,
                          WebserviceException,
                          UnknownException

Get all profiles

Parameters:

filterByActive - the filter by active

Returns:

List A list with all the registered profiles.

Throws:

PrincipalAdapterException - the principal adapter exception

WebserviceException - the webservice exception

UnknownException - the unknown exception

getUserProfile

Profile getUserProfile(String userId)
                throws PrincipalAdapterException,
                       WebserviceException,
                       UnknownException

Get user profile

Parameters:

userId - A user id.

Returns:

Profile Return the profile assigned to a user.

Throws:

PrincipalAdapterException - the principal adapter exception

WebserviceException - the webservice exception

UnknownException - the unknown exception

setUserProfile

void setUserProfile(String userId,
                    long profileId)
             throws PrincipalAdapterException,
                    WebserviceException,
                    UnknownException

Set the user profile

Parameters:

userId - The user id.

profileId - The profile to be assigned.

Throws:

PrincipalAdapterException - the principal adapter exception

WebserviceException - the webservice exception

UnknownException - the unknown exception

getUserToken

String getUserToken(String userId)
             throws PrincipalAdapterException,
                    WebserviceException,
                    UnknownException

Get user token

Parameters:

userId - A user id.

Returns:

String Return the token to a user.

Throws:

PrincipalAdapterException - the principal adapter exception

WebserviceException - the webservice exception

UnknownException - the unknown exception

setUserPermissions

void setUserPermissions(String uuid,
                        String userId,
                        int permissions,
                        boolean recursive)
                 throws PathNotFoundException,
                        AccessDeniedException,
                        RepositoryException,
                        DatabaseException,
                        WebserviceException,
                        UnknownException

Set user permissions to a node

Parameters:

uuid - Node uuid.

userId - User name which permissions are set.

permissions - User name which permissions are set.

recursive - recursive – If the nodePath indicated a folder, the permissions can be applied recursively.

Throws:

PathNotFoundException - the path not found exception

AccessDeniedException - the access denied exception

RepositoryException - the repository exception

DatabaseException - the database exception

WebserviceException - the webservice exception

UnknownException - the unknown exception

setRolePermissions

void setRolePermissions(String uuid,
                        String roleId,
                        int permissions,
                        boolean recursive)
                 throws PathNotFoundException,
                        AccessDeniedException,
                        RepositoryException,
                        DatabaseException,
                        WebserviceException,
                        UnknownException

Set role permissions for a node.

Parameters:

uuid - Node uuid.

roleId - Role name which permissions are set.

permissions - A mask with the permissions to be set.

recursive - If the nodePath indicates a folder, the permissions can be applied recursively.

Throws:

PathNotFoundException - the path not found exception

AccessDeniedException - the access denied exception

RepositoryException - the repository exception

DatabaseException - the database exception

WebserviceException - the webservice exception

UnknownException - the unknown exception

getUserTenants

List<Tenant> getUserTenants()
                     throws AccessDeniedException,
                            RepositoryException,
                            DatabaseException,
                            PathNotFoundException,
                            UnknownException,
                            WebserviceException

Get a list of available tenants for a user.

Returns:

List the list of tenants

Throws:

AccessDeniedException - the access denied exception

RepositoryException - the repository exception

DatabaseException - the database exception

PathNotFoundException - the path not found exception

UnknownException - the unknown exception

WebserviceException - the webservice exception

setUserTenant

void setUserTenant(long tenantId)
            throws AccessDeniedException,
                   RepositoryException,
                   DatabaseException,
                   PathNotFoundException,
                   UnknownException,
                   WebserviceException

Update user tenant.

Parameters:

tenantId - tenantId tenant id

Throws:

AccessDeniedException - the access denied exception

RepositoryException - the repository exception

DatabaseException - the database exception

PathNotFoundException - the path not found exception

UnknownException - the unknown exception

WebserviceException - the webservice exception

isTwoFactorAuthentication

boolean isTwoFactorAuthentication()
                           throws UnknownException,
                                  WebserviceException

Is two factor authentication

Returns:

true active two factor autentication

Throws:

UnknownException - the unknown exception

WebserviceException - the webservice exception

getTwoFactorQR

InputStream getTwoFactorQR(String secret)
                    throws PrincipalAdapterException,
                           UnknownException,
                           WebserviceException

Get 2FA

Parameters:

secret - the secret

Returns:

stream with 2FA qr image

Throws:

PrincipalAdapterException - the principal adapter exception

UnknownException - the unknown exception

WebserviceException - the webservice exception

generate2FASecret

String generate2FASecret()
                  throws PrincipalAdapterException,
                         UnknownException,
                         WebserviceException

Generate 2FA secret

Returns:

String with 2FA secret

Throws:

PrincipalAdapterException - the principal adapter exception

UnknownException - the unknown exception

WebserviceException - the webservice exception

validate2FAAndSaveSecret

String validate2FAAndSaveSecret(String secret,
                                int code)
                         throws PrincipalAdapterException,
                                UnknownException,
                                WebserviceException

Validate 2FA and save secret

Parameters:

secret - the secret

code - the code

Returns:

String string

Throws:

PrincipalAdapterException - the principal adapter exception

UnknownException - the unknown exception

WebserviceException - the webservice exception

disable2FA

String disable2FA()
           throws PrincipalAdapterException,
                  UnknownException,
                  WebserviceException

Disable 2FA

Returns:

String string

Throws:

PrincipalAdapterException - the principal adapter exception

UnknownException - the unknown exception

WebserviceException - the webservice exception

verify2FACode

String verify2FACode(int code)
              throws PrincipalAdapterException,
                     UnknownException,
                     WebserviceException

Verify 2FA code

Parameters:

code - the code

Returns:

int string

Throws:

PrincipalAdapterException - the principal adapter exception

UnknownException - the unknown exception

WebserviceException - the webservice exception