You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Browse filesBrowse the repository at this point in the historyBrowse files
Jose Garcia
committed
Document the Superadministrator role and restricted settings (Track D)
Explains, in the administrator guide, that the Catalog Server, Intranet
parameters and Proxy server settings can only be edited by a
Superadministrator (Administrator retains view access), that a direct API
attempt to change them is rejected with 403 and nothing saved, and adds a
Superadministrator entry to the profile list and role matrix notes.
Copy file name to clipboardExpand all lines: docs/manual/docs/administrator-guide/configuring-the-catalog/system-configuration.md
+13Lines changed: 13 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,6 +6,10 @@ Most of the system configuration parameters can be changed by administrator user
6
6
7
7
Configuration of these parameters is critically important for the catalog in an operational context. Misunderstanding some settings may result in a system that does not function as expected. For example, downloads may fail to be correctly processed, or metadata harvesting from other servers may not work.
8
8
9
+
!!! note "Superadministrator-only settings"
10
+
11
+
The **Catalog Server**, **Intranet parameters** and **Proxy server** settings below (host/port/protocol/log level, the intranet network/netmask, and the outbound proxy configuration) can only be *edited* by a user with the [Superadministrator profile](../managing-users-and-groups/index.md#user_profiles). A regular `Administrator` can still view these settings — they are shown, not hidden — but the form fields are disabled, with a lock icon and tooltip explaining why. Attempting to change one of these settings directly through the API without the Superadministrator profile is rejected outright (`403 Forbidden`), and no part of that request is saved, including any other, unrelated settings submitted in the same request.
12
+
9
13
10
14

11
15
@@ -25,6 +29,9 @@ Since the settings form is a long form, the `save` button is repeated between th
25
29
26
30
## Catalog Server {#system-config-server}
27
31
32
+
!!! note
33
+
These settings can only be edited by a Superadministrator. See [Superadministrator-only settings](#system-configuration) above.
34
+
28
35
-**Host** The node's name or IP number (without `http://`). For example, they are used during metadata editing to create resource links and when returning the server's capabilities during a CSW request.
29
36
- If your node is publicly accessible from the Internet, you have to use the domain name.
30
37
- If your node is hidden inside your private network and you have a firewall or web server that redirects incoming requests to the node, you have to enter the public address of the firewall or web server. A typical configuration is to have an Apache web server on address A that is publicly accessible and redirects the requests to a Tomcat server on a private address B. In this case you have to enter A in the host parameter.
@@ -36,6 +43,9 @@ Since the settings form is a long form, the `save` button is repeated between th
36
43
37
44
## Intranet parameters
38
45
46
+
!!! note
47
+
These settings can only be edited by a Superadministrator. See [Superadministrator-only settings](#system-configuration) above.
48
+
39
49
A common need for an organisation is to automatically discriminate between anonymous internal users that access the node from within an organisation (Intranet) and anonymous external users from the Internet. The catalog defines anonymous users from inside the organisation as belonging to the group *Intranet*, while anonymous users from outside the organisation are defined by the group *All*. To automatically distinguish users that belong to the Intranet group you need to tell the catalog the intranet IP address and netmask.
40
50
41
51
-**Network** The intranet address in IP form (eg. 147.109.100.0). It can be a comma separated list of IP addresses.
@@ -45,6 +55,9 @@ If intranet parameters are empty, the group *Intranet* will not be displayed in
45
55
46
56
## Proxy server
47
57
58
+
!!! note
59
+
These settings can only be edited by a Superadministrator. See [Superadministrator-only settings](#system-configuration) above.
60
+
48
61
The settings page offers to set the configuration of a proxy server. This configuration is used by the application to access the internet to get online resources, for example as part of a harvest process.
49
62
50
63
-**Use proxy** Enable the proxy in case the catalog is behind a proxy and need to use it to access remote resources.
Copy file name to clipboardExpand all lines: docs/manual/docs/administrator-guide/managing-users-and-groups/index.md
+16-6Lines changed: 16 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -32,7 +32,7 @@ The catalog uses the concept of Users, Groups and User Profiles.
32
32
33
33
- A User can be part of one or more Groups.
34
34
- A User has a Role in a Group.
35
-
- The Administrator Role is not related to a Group.
35
+
- The Administrator and Superadministrator Roles are not related to a Group.
36
36
37
37
The combination of Role and Group defines what tasks the User can perform on the system or on specific metadata records.
38
38
@@ -42,7 +42,14 @@ Roles are hierarchical and based on inheritance. This means that a user with an
42
42
43
43
Rights associated with the roles are illustrated in detail in the list below:
44
44
45
-
1.**Administrator Profile**
45
+
1.**Superadministrator Profile**
46
+
47
+
The Superadministrator has every privilege of the Administrator Profile described below, plus exclusive rights over a small set of server-level settings:
48
+
49
+
- Everything the Administrator Profile can do (see below) - all Administrator privileges are inherited.
50
+
- Exclusive right to *edit* the **Catalog Server**, **Intranet parameters** and **Proxy server** settings (see [System configuration](../configuring-the-catalog/system-configuration.md)). An Administrator can still view these settings but cannot change them.
51
+
52
+
2.**Administrator Profile**
46
53
47
54
The Administrator has special privileges that give access to all available functions.
48
55
@@ -53,26 +60,26 @@ Rights associated with the roles are illustrated in detail in the list below:
53
60
- Full rights for creating/editing/deleting new/old metadata.
54
61
- Perform system administration and configuration tasks.
55
62
56
-
2.**User Administrator Profile**
63
+
3.**User Administrator Profile**
57
64
58
65
The user administrator is the administrator of their own group(s) with the following privileges:
59
66
60
67
- Full rights on creating new users within their own groups.
61
68
- Rights to change users profiles within their own groups.
62
69
63
-
3.**Content Reviewer Profile**
70
+
4.**Content Reviewer Profile**
64
71
65
72
The content reviewer is the only person allowed to give final clearance on the metadata publication on the intranet and/or on the internet:
66
73
67
74
- Rights on reviewing metadata content within their own groups and authorising its approval and publication.
68
75
69
-
4.**Editor Profile**
76
+
5.**Editor Profile**
70
77
71
78
The editor works on metadata with the following privileges:
72
79
73
80
- Full rights on creating/editing/deleting new/old data within their own groups.
74
81
75
-
5.**Registered User Profile**
82
+
6.**Registered User Profile**
76
83
77
84
The Registered User has more access privileges than non-authenticated Guest users:
78
85
@@ -82,6 +89,9 @@ Rights associated with the roles are illustrated in detail in the list below:
82
89
83
90
The tables below show a comprehensive overview of Roles and Features. It explains in detail what each role can do in GeoNetwork.
84
91
92
+
!!! note
93
+
The tables below do not include a separate Superadministrator column. Superadministrator is a strict superset of the Administrator profile for every feature shown here: anywhere a table shows :material-check-circle: (or any other mark) for Administrator, a Superadministrator has the same access. The only difference between the two profiles is the exclusive right to edit the settings described under [Superadministrator Profile](#user_profiles) above, which are not part of these feature tables.
0 commit comments