author | goetz |
Thu, 21 Nov 2013 18:29:34 -0800 | |
changeset 22852 | 1063026e8cee |
parent 2621 | 78567495e352 |
permissions | -rw-r--r-- |
2 | 1 |
###################################################################### |
2 |
# Default Access Control File for Remote JMX(TM) Monitoring |
|
3 |
###################################################################### |
|
4 |
# |
|
5 |
# Access control file for Remote JMX API access to monitoring. |
|
6 |
# This file defines the allowed access for different roles. The |
|
7 |
# password file (jmxremote.password by default) defines the roles and their |
|
8 |
# passwords. To be functional, a role must have an entry in |
|
9 |
# both the password and the access files. |
|
10 |
# |
|
2621
78567495e352
6721651: Security problem with out-of-the-box management
dfuchs
parents:
2
diff
changeset
|
11 |
# The default location of this file is $JRE/lib/management/jmxremote.access |
2 | 12 |
# You can specify an alternate location by specifying a property in |
13 |
# the management config file $JRE/lib/management/management.properties |
|
14 |
# (See that file for details) |
|
15 |
# |
|
16 |
# The file format for password and access files is syntactically the same |
|
17 |
# as the Properties file format. The syntax is described in the Javadoc |
|
18 |
# for java.util.Properties.load. |
|
2621
78567495e352
6721651: Security problem with out-of-the-box management
dfuchs
parents:
2
diff
changeset
|
19 |
# A typical access file has multiple lines, where each line is blank, |
2 | 20 |
# a comment (like this one), or an access control entry. |
21 |
# |
|
22 |
# An access control entry consists of a role name, and an |
|
23 |
# associated access level. The role name is any string that does not |
|
24 |
# itself contain spaces or tabs. It corresponds to an entry in the |
|
25 |
# password file (jmxremote.password). The access level is one of the |
|
26 |
# following: |
|
27 |
# "readonly" grants access to read attributes of MBeans. |
|
28 |
# For monitoring, this means that a remote client in this |
|
29 |
# role can read measurements but cannot perform any action |
|
30 |
# that changes the environment of the running program. |
|
31 |
# "readwrite" grants access to read and write attributes of MBeans, |
|
2621
78567495e352
6721651: Security problem with out-of-the-box management
dfuchs
parents:
2
diff
changeset
|
32 |
# to invoke operations on them, and optionally |
78567495e352
6721651: Security problem with out-of-the-box management
dfuchs
parents:
2
diff
changeset
|
33 |
# to create or remove them. This access should be granted |
78567495e352
6721651: Security problem with out-of-the-box management
dfuchs
parents:
2
diff
changeset
|
34 |
# only to trusted clients, since they can potentially |
78567495e352
6721651: Security problem with out-of-the-box management
dfuchs
parents:
2
diff
changeset
|
35 |
# interfere with the smooth operation of a running program. |
78567495e352
6721651: Security problem with out-of-the-box management
dfuchs
parents:
2
diff
changeset
|
36 |
# |
78567495e352
6721651: Security problem with out-of-the-box management
dfuchs
parents:
2
diff
changeset
|
37 |
# The "readwrite" access level can optionally be followed by the "create" and/or |
78567495e352
6721651: Security problem with out-of-the-box management
dfuchs
parents:
2
diff
changeset
|
38 |
# "unregister" keywords. The "unregister" keyword grants access to unregister |
78567495e352
6721651: Security problem with out-of-the-box management
dfuchs
parents:
2
diff
changeset
|
39 |
# (delete) MBeans. The "create" keyword grants access to create MBeans of a |
78567495e352
6721651: Security problem with out-of-the-box management
dfuchs
parents:
2
diff
changeset
|
40 |
# particular class or of any class matching a particular pattern. Access |
78567495e352
6721651: Security problem with out-of-the-box management
dfuchs
parents:
2
diff
changeset
|
41 |
# should only be granted to create MBeans of known and trusted classes. |
78567495e352
6721651: Security problem with out-of-the-box management
dfuchs
parents:
2
diff
changeset
|
42 |
# |
78567495e352
6721651: Security problem with out-of-the-box management
dfuchs
parents:
2
diff
changeset
|
43 |
# For example, the following entry would grant readwrite access |
78567495e352
6721651: Security problem with out-of-the-box management
dfuchs
parents:
2
diff
changeset
|
44 |
# to "controlRole", as well as access to create MBeans of the class |
78567495e352
6721651: Security problem with out-of-the-box management
dfuchs
parents:
2
diff
changeset
|
45 |
# javax.management.monitor.CounterMonitor and to unregister any MBean: |
78567495e352
6721651: Security problem with out-of-the-box management
dfuchs
parents:
2
diff
changeset
|
46 |
# controlRole readwrite \ |
78567495e352
6721651: Security problem with out-of-the-box management
dfuchs
parents:
2
diff
changeset
|
47 |
# create javax.management.monitor.CounterMonitorMBean \ |
78567495e352
6721651: Security problem with out-of-the-box management
dfuchs
parents:
2
diff
changeset
|
48 |
# unregister |
78567495e352
6721651: Security problem with out-of-the-box management
dfuchs
parents:
2
diff
changeset
|
49 |
# or equivalently: |
78567495e352
6721651: Security problem with out-of-the-box management
dfuchs
parents:
2
diff
changeset
|
50 |
# controlRole readwrite unregister create javax.management.monitor.CounterMBean |
78567495e352
6721651: Security problem with out-of-the-box management
dfuchs
parents:
2
diff
changeset
|
51 |
# |
78567495e352
6721651: Security problem with out-of-the-box management
dfuchs
parents:
2
diff
changeset
|
52 |
# The following entry would grant readwrite access as well as access to create |
78567495e352
6721651: Security problem with out-of-the-box management
dfuchs
parents:
2
diff
changeset
|
53 |
# MBeans of any class in the packages javax.management.monitor and |
78567495e352
6721651: Security problem with out-of-the-box management
dfuchs
parents:
2
diff
changeset
|
54 |
# javax.management.timer: |
78567495e352
6721651: Security problem with out-of-the-box management
dfuchs
parents:
2
diff
changeset
|
55 |
# controlRole readwrite \ |
78567495e352
6721651: Security problem with out-of-the-box management
dfuchs
parents:
2
diff
changeset
|
56 |
# create javax.management.monitor.*,javax.management.timer.* \ |
78567495e352
6721651: Security problem with out-of-the-box management
dfuchs
parents:
2
diff
changeset
|
57 |
# unregister |
78567495e352
6721651: Security problem with out-of-the-box management
dfuchs
parents:
2
diff
changeset
|
58 |
# |
78567495e352
6721651: Security problem with out-of-the-box management
dfuchs
parents:
2
diff
changeset
|
59 |
# The \ character is defined in the Properties file syntax to allow continuation |
78567495e352
6721651: Security problem with out-of-the-box management
dfuchs
parents:
2
diff
changeset
|
60 |
# lines as shown here. A * in a class pattern matches a sequence of characters |
78567495e352
6721651: Security problem with out-of-the-box management
dfuchs
parents:
2
diff
changeset
|
61 |
# other than dot (.), so javax.management.monitor.* matches |
78567495e352
6721651: Security problem with out-of-the-box management
dfuchs
parents:
2
diff
changeset
|
62 |
# javax.management.monitor.CounterMonitor but not |
78567495e352
6721651: Security problem with out-of-the-box management
dfuchs
parents:
2
diff
changeset
|
63 |
# javax.management.monitor.foo.Bar. |
2 | 64 |
# |
65 |
# A given role should have at most one entry in this file. If a role |
|
66 |
# has no entry, it has no access. |
|
67 |
# If multiple entries are found for the same role name, then the last |
|
68 |
# access entry is used. |
|
69 |
# |
|
70 |
# |
|
71 |
# Default access control entries: |
|
72 |
# o The "monitorRole" role has readonly access. |
|
2621
78567495e352
6721651: Security problem with out-of-the-box management
dfuchs
parents:
2
diff
changeset
|
73 |
# o The "controlRole" role has readwrite access and can create the standard |
78567495e352
6721651: Security problem with out-of-the-box management
dfuchs
parents:
2
diff
changeset
|
74 |
# Timer and Monitor MBeans defined by the JMX API. |
2 | 75 |
|
76 |
monitorRole readonly |
|
2621
78567495e352
6721651: Security problem with out-of-the-box management
dfuchs
parents:
2
diff
changeset
|
77 |
controlRole readwrite \ |
78567495e352
6721651: Security problem with out-of-the-box management
dfuchs
parents:
2
diff
changeset
|
78 |
create javax.management.monitor.*,javax.management.timer.* \ |
78567495e352
6721651: Security problem with out-of-the-box management
dfuchs
parents:
2
diff
changeset
|
79 |
unregister |