AuthorizationProfile - applyAclTemplate

AuthorizationProfile - applyAclTemplate

Description :

This command applies an access control list (ACL) template to the ACL controlling access to an authorization profile.

When an ACL template is applied to an object, all permission entries from the ACL template that are relevant to that target object are retrieved from the ACL template. Then, any entries with the role "Current Role" are replaced with the role that is executing the command. These entries are then either appended to the existing ACL entries, or they replace the existing ACL entries, depending on the value of the 'replace' argument. Returns the DBKey of the modified object.

Return type : DBKey

Command Input :

Variable Name

Variable Type

Description

name

String

The name of the authorization profile to be modified.

templateName

String

The name of the ACL template to use.

replace

Boolean

A flag indicating whether you want to to replace all the existing ACL entries with the entries in the template. Set this flag to true if you want to replace the existing entries with the entries in the template. Set this flag to false if you want to append the entries in the template to the existing entries.

Example

The following example shows how to apply an ACL template called "Test Template" to the authorization profile "Profile".

Assuming "Test Template" has the following entries in its template:

  • RoleA Server.Read
  • RoleA AuthProfile.*

And that "Profile" has the following entries in its ACL:

  • Everyone AuthProfile.Read
  • RoleA AuthProfile.ModifyACL

Script





AuthorizationProfile applyAclTemplate "Profile" "Test Template" true 

#would result in the ACL for "Profile" having only the entry: RoleA AuthProfile.* 

AuthorizationProfile applyAclTemplate "Profile" "Test Template" false 

#would result in the ACL for "Profile" having the entries: RoleA AuthProfile.* Everyone AuthProfile.Read RoleA AuthProfile.ModifyACL 



Was this page helpful? Yes No Submitting... Thank you

Comments