ACL Groups¶

Overview¶

Object name: ACLGROUP

Show¶

In order to list available ACL Groups, use the SHOW action::

[root@centreon ~]# ./centreon -u admin -p centreon -o ACLGROUP -a show
id;name;alias;activate
1;ALL;ALL;1
[...]

Columns are the following :

Column	Description
ID	ID
Name	Name
Alias	Alias
Activate	1 when ACL Group is enabled, 0 otherwise

Add¶

In order to add an ACL Group, use the ADD action::

[root@centreon ~]# ./centreon -u admin -p centreon -o ACLGROUP -a add -v "ACL Group test;my alias"

Required fields are:

Column	Description
Name	Name
Alias	Alias

Del¶

If you want to remove an ACL Group, use the DEL action. The Name is used for identifying the ACL Group to delete::

[root@centreon ~]# ./centreon -u admin -p centreon -o ACLGROUP -a del -v "ACL Group test"

Setparam¶

If you want to change a specific parameter of an ACL Group, use the SETPARAM action. The Name is used for identifying the ACL Group to update::

[root@centreon ~]# ./centreon -u admin -p centreon -o ACLGROUP -a setparam -v "ACL Group test;alias;my new alias"

Arguments are composed of the following columns:

Order	Column description
1	Name of ACL Group
2	Parameter name
3	Parameter value

Parameters that you may change are:

Column	Description
name
alias
activate	1 when ACL Group is enabled, 0 otherwise

Getmenu¶

If you want to retrieve the Menu Rules that are linked to a specific ACL Group, use the GETMENU action::

[root@centreon ~]# ./centreon -u admin -p centreon -o ACLGROUP -a getmenu -v "ACL Group test"
id;name
1;Configuration
3;Reporting
4;Graphs
2;Monitoring + Home

Arguments are composed of the following columns:

Order	Column description
1	Name of ACL group

Getaction¶

If you want to retrieve the Action Rules that are linked to a specific ACL Group, use the GETACTION action::

[root@centreon ~]# ./centreon -u admin -p centreon -o ACLGROUP -a getaction -v "ACL Group test"
id;name
1;Simple action rule

Arguments are composed of the following columns:

Order	Column description
1	Name of ACL group

Getresource¶

If you want to retrieve the Resource Rules that are linked to a specific ACL Group, use the GETRESOURCE action::

[root@centreon ~]# ./centreon -u admin -p centreon -o ACLGROUP -a getresource -v "ACL Group test"
id;name
1;All Resources

Arguments are composed of the following columns:

Order	Column description
1	Name of ACL group

Getcontact and Getcontactgroup¶

If you want to retrieve the Contacts that are linked to a specific ACL Group, use the GETCONTACT action::

[root@centreon ~]# ./centreon -u admin -p centreon -o ACLGROUP -a getcontact -v "ACL Group test"
id;name
1;user1

If you want to retrieve the Contact Groups that are linked to a specific ACL Group, use the GETCONTACTGROUP action::

[root@centreon ~]# ./centreon -u admin -p centreon -o ACLGROUP -a getcontactgroup -v "ACL Group test"
id;name
1;usergroup1

Arguments are composed of the following columns:

Order	Column description
1	Name of ACL group

Setmenu, Setaction, Setresource, Addmenu, Addaction, Addresource¶

If you want to link rules to a specific ACL Group, use the following actions: SETMENU, SETACTION, SETRESOURCE, ADDMENU, ADDACTION, ADDRESOURCE:

[root@centreon ~]# ./centreon -u admin -p centreon -o ACLGROUP -a setmenu -v "ACL Group test;Menu rule 1|Menu rule 2"

[root@centreon ~]# ./centreon -u admin -p centreon -o ACLGROUP -a addresource -v "ACL Group test;All Routers"

Command type	Description
set*	Overwrites previous definitions. Use the delimiter \| to set multiple rules
add*	Appends new rules to the previous definitions. Use the delimiter \| to add multiple rules

Arguments are composed of the following columns:

Order	Column description
1	Name of ACL group
2	Name of the ACL rule to link

Delmenu, Delaction, Delresource¶

If you want to remove rules from a specific ACL Group, use the following actions: DELMENU, DELACTION, DELRESOURCE:

[root@centreon ~]# ./centreon -u admin -p centreon -o ACLGROUP -a delaction -v "ACL Group test;Ack rule|Downtime rule"

Arguments are composed of the following columns:

Order	Column description
1	Name of ACL group
2	Name of the ACL rule to remove

Setcontact, Setcontactgroup, Addcontact, Addcontactgroup¶

If you want to link contacts or contact groups to a specific ACL Group, use the following actions: SETCONTACT, SETCONTACTGROUP, ADDCONTACT, ADDCONTACTGROUP:

[root@centreon ~]# ./centreon -u admin -p centreon -o ACLGROUP -a setcontact -v "ACL Group test;user1"

[root@centreon ~]# ./centreon -u admin -p centreon -o ACLGROUP -a addcontactgroup -v "ACL Group test;usergroup1"

Arguments are composed of the following columns:

Order	Column description
1	Name of ACL group
2	Contact/Contact group to add/set

Command type	Description
set*	Overwrites previous definitions. Use the delimiter \| to set multiple contacts/contact groups
add*	Appends new contacts/contact groups to the previous definitions. Use the delimiter \| to add multiple rules

Delcontact, Delcontactgroup¶

If you want to remove rules from a specific ACL Group, use the following actions: DELCONTACT, DELCONTACTGROUP:

[root@centreon ~]# ./centreon -u admin -p centreon -o ACLGROUP -a delcontact -v "ACL Group test;user1"

Arguments are composed of the following columns:

Order	Column description
1	Name of ACL group
2	Contact/Contact group to remove from ACL group