Skip to content

Commit 8c3ff97

Browse files
authored
Merge pull request #1064 from Icinga/doc-07-operations-restic-acl
doc/07-Operations.md: Redis ACL
2 parents 88c801b + 33b760d commit 8c3ff97

File tree

1 file changed

+24
-0
lines changed

1 file changed

+24
-0
lines changed

doc/07-Operations.md

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -125,3 +125,27 @@ save 3600 1 900 100000
125125
can be used.
126126
In this example, a dump is performed every hour (3600s) if at least on changes occurred in that time frame
127127
and every fifteen minutes (900s) if at least 100,000 changes occurred.
128+
129+
#### Redis® Access Control List
130+
131+
When using a shared Redis® server between Icinga DB and other applications, configuring the
132+
[Redis® Access Control List (ACL)](https://redis.io/docs/latest/operate/oss_and_stack/management/security/acl/)
133+
should be considered.
134+
Creating dedicated Redis® users and ACL entries ensure that each application can only access its data.
135+
136+
Icinga DB only needs to access Redis® keys in the `icinga` and `icingadb` namespaces.
137+
138+
Using the [`ACL SETUSER`](https://redis.io/docs/latest/commands/acl-setuser/) command,
139+
a new `icingadb` user only permitted to access its keys can be created.
140+
Please change the password behind `>` in the following example.
141+
142+
```
143+
> ACL SETUSER icingadb on >PASSWORD_CHANGE_ME ~icinga:* ~icingadb:* +@all
144+
OK
145+
```
146+
147+
Afterward, Icinga DB needs to connect using this username and password.
148+
This requires a change to
149+
[Icinga 2's `IcingaDB` object](https://icinga.com/docs/icinga-2/latest/doc/09-object-types/#icingadb),
150+
[Icinga DB's Redis® configuration](03-Configuration.md#redis-configuration) and
151+
[Icinga DB Web's Redis® configuration](https://icinga.com/docs/icinga-db-web/latest/doc/03-Configuration/#redis-configuration).

0 commit comments

Comments
 (0)