Mercury:Manual - Revision history

Desheng Fu: /* Password Management */

2026-05-02T07:16:04Z

Password Management

← Older revision		Revision as of 07:16, 2 May 2026
Line 96:		Line 96:
	You may change the password of any account without giving the current password, however it's recommended that each administrator manages it's own account including the password.		You may change the password of any account without giving the current password, however it's recommended that each administrator manages it's own account including the password.

	Sometimes, you may want to give the ~~right~~ "password never expires" to an account, especially the accounts used to access [[Mercury:API \| API]]. You should limit the permission of such accounts to avoid any risk that the password is stolen.		Sometimes, you may want to give the permission "password never expires" to an account, especially the accounts used to access [[Mercury:API \| API]]. You should limit the permission of such accounts to avoid any risk that the password is stolen.

	==== API ====		==== API ====

Desheng Fu: /* Permission */

2026-05-02T07:15:10Z

Permission

← Older revision		Revision as of 07:15, 2 May 2026
Line 89:		Line 89:

	You can also grant permission directly to an administrator without using group. However, it's not recommended since it significantly increases the complexity managing the accounts.		You can also grant permission directly to an administrator without using group. However, it's not recommended since it significantly increases the complexity managing the accounts.

			The “system management” permission can only be assigned to accounts but not to groups.

	==== Password Management ====		==== Password Management ====

Desheng Fu: /* Permission */

2026-05-02T07:13:15Z

Permission

← Older revision		Revision as of 07:13, 2 May 2026
Line 82:		Line 82:
	==== Permission ====		==== Permission ====

	A group is a non-exclusive collection of of accounts. It means an account may belong to from 0 to any groups.		A group is a non-exclusive collection of of accounts. It means an account may belong to from zero to any groups.

	In general, the permission to view specific data / perform specific jobs can be granted to each group. The administrator is allowed when its account is in any group with the related permission. Please take care that we only have a so-called white-list-algorithm. You can't ban / black-list an administrator. The only way to disallow an administrator from view specific data / perform specific jobs is to make sure that its account is not in any group allowing this.		In general, the permission to view specific data / perform specific jobs can be granted to each group. The administrator is allowed when its account is in any group with the related permission. Please take care that we only have a so-called white-list-algorithm. You can't ban / black-list an administrator. The only way to disallow an administrator from view specific data / perform specific jobs is to make sure that its account is not in any group allowing this.

Desheng Fu: /* Identifiers */

2026-05-02T07:09:47Z

Identifiers

← Older revision		Revision as of 07:09, 2 May 2026
Line 64:		Line 64:
	=== Identifiers ===		=== Identifiers ===

	By default, the ID of many types of data ~~is starting~~ from 1 (e.g. administrator ID, article ID, user ID) and ~~increase~~ by 1 when a new data is generated. Sometimes, it's easier to maintain IDs with fixed length. You may manually adjust the next ID of many types of data via '''Information & System / Identifiers'''. For example if you set the next ID of administrator to 1001, the next created administrator will have the ID 1001, and the one after next will have the ID 1002, etc.		By default, the ID of many types of data starts from 1 (e.g. administrator ID, article ID, user ID) and increases by 1 when a new data is generated. Sometimes, it's easier to maintain IDs with fixed length. You may manually adjust the next ID of many types of data via '''Information & System / Identifiers'''. For example if you set the next ID of administrator to 1001, the next created administrator will have the ID 1001, and the one after next will have the ID 1002, etc.

	The specified ID must be larger than the ID of any existing data of the same type.		The specified ID must be larger than the ID of any existing data of the same type.

Desheng Fu: /* Login / Logout / Access to the Management Panel */

2026-05-02T06:52:04Z

← Older revision		Revision as of 06:52, 2 May 2026
Line 34:		Line 34:
	Your password expires every 90 days unless the ''password never expires'' permission is granted. You can still login with expired password. However, most of the features are disabled in this case. You need to modify your password to reactivate these features.		Your password expires every 90 days unless the ''password never expires'' permission is granted. You can still login with expired password. However, most of the features are disabled in this case. You need to modify your password to reactivate these features.

	The number of failed logins are limited. If you login with wrong password for too many times, your IP is banned for ~~10 minutes~~. You can either change your IP or try later.		The number of failed logins are limited. If you login with wrong password for too many times, your IP is banned for some hours. You can either change your IP or try later.

	=== Warning in Browser Caches ===		=== Warning in Browser Caches ===

Desheng Fu: /* Advanced Features */

2026-05-02T06:39:06Z

Advanced Features

← Older revision		Revision as of 06:39, 2 May 2026
Line 319:		Line 319:
	=== Prometheus Entry Point ===		=== Prometheus Entry Point ===

	We provide a Prometheus (https://prometheus.io/) entry point to monitor the status of your shop. It's available at: ''https://<your-server-address>/feature/mercury.mercury.mercury/metrics''. Please note that it works via ~~https~~ on port 443 instead of regular http protocol on port 9090.		We provide a Prometheus (https://prometheus.io/) entry point to monitor the status of your shop. It's available at: ''https://<your-server-address>/feature/mercury.mercury.mercury/metrics''. Please note that it works via HTTPS on port 443 instead of regular http protocol on port 9090.
	A typical Prometheus configuration should look like this:		A typical Prometheus configuration should look like this:

Line 334:		Line 334:
	</pre>		</pre>

	It’s notable that the fetch frequency is limited to 10s per IP.		It’s notable that the fetch frequency is limited to one access per 10s per IP.

	== Get Support ==		== Get Support ==

Desheng Fu: /* Prometheus Entry Point */

2026-05-02T06:37:22Z

Prometheus Entry Point

← Older revision		Revision as of 06:37, 2 May 2026
Line 333:		Line 333:
	...		...
	</pre>		</pre>

			It’s notable that the fetch frequency is limited to 10s per IP.

	== Get Support ==		== Get Support ==

Desheng Fu: /* Prometheus Entry Point */

2026-05-02T06:33:54Z

Prometheus Entry Point

← Older revision		Revision as of 06:33, 2 May 2026
Line 329:		Line 329:
	metrics_path: "/feature/mercury.mercury.mercury/metrics"		metrics_path: "/feature/mercury.mercury.mercury/metrics"
	static_configs:		static_configs:
	- targets: ["your-server-address"]		- targets: ["your-server-address:443"]

	...		...

Desheng Fu: /* Get Support */

2026-05-02T06:30:22Z

Get Support

← Older revision		Revision as of 06:30, 2 May 2026
Line 351:		Line 351:
	=== Email ===		=== Email ===

	You can ~~also~~ reach us via email: info[at]esoul.online. Although it's not the recommended way and it may take longer than other ~~channel~~ to get feedback.		You can reach us via email as well: info[at]esoul.online. Although it's not the recommended way and it may take longer than other channels to get feedback.

	By default, you'll receive impotent announcements periodically from us per email. You may unsubscribe / re-subscribe the news letter whenever you want.		By default, you'll receive impotent announcements periodically from us per email. You may unsubscribe / re-subscribe the news letter whenever you want.

Desheng Fu: /* Login / Logout / Access to the Management Panel */

2025-10-27T08:07:07Z

← Older revision		Revision as of 08:07, 27 October 2025
Line 33:		Line 33:

	Your password expires every 90 days unless the ''password never expires'' permission is granted. You can still login with expired password. However, most of the features are disabled in this case. You need to modify your password to reactivate these features.		Your password expires every 90 days unless the ''password never expires'' permission is granted. You can still login with expired password. However, most of the features are disabled in this case. You need to modify your password to reactivate these features.

			The number of failed logins are limited. If you login with wrong password for too many times, your IP is banned for 10 minutes. You can either change your IP or try later.

	=== Warning in Browser Caches ===		=== Warning in Browser Caches ===