See the Javadocs in <EPM_ORACLE_HOME>/common/docs/ReportingAnalysis/SDK/javadoc.
The system automatically creates this interface including default access control when EPM Workspace creates an artifact.
The default access control grants full control to the artifact owner. This interface is equivalent to the Permissions class in Brio Portal and is deprecated in EPM Workspace. The interface is obtained by invoking the getInstancePermission() method on an artifact. After retrieval, it can be modified to enforce new access control on it. It provides necessary methods to grant different levels of access control for different users, groups, and business roles.
Two other interfaces, RoleAccessor and Role, are very closely related to this interface. For example, here are the steps to grant the MODIFY role to User1 on an artifact doc1:
Retrieve the instance permission associated with the artifact by invoking the doc1.getInstancePermission() method.
Create a RoleAccessor artifact using the createRoleAccessor() method in the Authorization interface by sending User1 as a parameter.
Retrieve the role artifact for MODIFY role using the getRoleByName() method of the Authorization interface and passing MODIFY as the parameter.
Add this role to the roles accessor created previously by invoking the addSystemRole() method on the role accessor artifact.
Add the role accessor to the instance permission artifact using the addRoleAccessor() method on the instance permission artifact.
Use the update() method on the instance permission artifact.