https://github.com/simp/pupmod-simp-dconf
Puppet module for managing Dconf settings
https://github.com/simp/pupmod-simp-dconf
Last synced: about 1 year ago
JSON representation
Puppet module for managing Dconf settings
- Host: GitHub
- URL: https://github.com/simp/pupmod-simp-dconf
- Owner: simp
- License: other
- Created: 2018-05-29T20:01:12.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2025-03-27T15:59:53.000Z (about 1 year ago)
- Last Synced: 2025-04-09T17:47:47.484Z (about 1 year ago)
- Language: Ruby
- Size: 133 KB
- Stars: 1
- Watchers: 17
- Forks: 11
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG
- License: LICENSE
Awesome Lists containing this project
README
[](http://www.apache.org/licenses/LICENSE-2.0.html)
[](https://bestpractices.coreinfrastructure.org/projects/73)
[](https://forge.puppetlabs.com/simp/dconf)
[](https://forge.puppetlabs.com/simp/dconf)
[](https://travis-ci.org/simp/pupmod-simp-dconf)
#### Table of Contents
* [Description](#description)
* [This is a SIMP module](#this-is-a-simp-module)
* [Setup](#setup)
* [Usage](#usage)
* [Configuring custom rules](#configuring-custom-rules)
* [> to prevent users from modifying them!](#-to-prevent-users-from-modifying-them)
* [Using `puppet`](#using-puppet)
* [Using `hiera`](#using-hiera)
* [Configuring custom profiles](#configuring-custom-profiles)
* [Using `puppet`](#using-puppet-1)
* [Globally With `hiera`](#globally-with-hiera)
* [Reference](#reference)
* [Limitations](#limitations)
* [Development](#development)
## Description
`dconf` is a Puppet module that installs and manages `dconf` and associated system settings.
### This is a SIMP module
This module is a component of the [System Integrity Management Platform](https://simp-project.com)
a compliance-management framework built on Puppet.
If you find any issues, they may be submitted to our [bug tracker](https://simp-project.atlassian.net/).
This module is optimally designed for use within a larger SIMP ecosystem, but
it can be used independently:
* When included within the SIMP ecosystem, security compliance settings will
be managed from the Puppet server.
* If used independently, all SIMP-managed security subsystems are disabled by
default and must be explicitly opted into by administrators. See
[simp_options](https://github.com/simp/pupmod-simp-simp_options) for more
detail.
## Setup
To use the module with, just include the class:
```ruby
include 'dconf'
```
## Usage
### Configuring custom rules
You can configure custom ``dconf`` settings using the ``dconf::settings``
defined type.
---
> Any settings that are configured using this code will automatically be locked
> to prevent users from modifying them!
---
#### Using `puppet`
```puppet
dconf::settings { 'automount_lockdowns':
settings_hash => {
'org/gnome/desktop/media-handling' => {
'automount' => { 'value' => false, 'lock' => false } # allow users to change this one
'automount-open' => { 'value' => false }
}
}
}
```
#### Using `hiera`
```yaml
---
dconf::user_settings:
settings_hash:
org/gnome/desktop/media-handling:
automount:
value: false
lock: false # allow users to change this one
automount-open:
value: false
```
### Configuring custom profiles
You can set up a custom [dconf profile](https://help.gnome.org/admin//system-admin-guide/3.8/dconf-profiles.html.en) as follows:
#### Using `puppet`
```puppet
dconf::profile { 'my_profile':
entries => {
'user' => {
'type' => 'user',
'order' => 1
},
'system' => {
'type' => 'system',
'order' => 10
}
}
```
#### Globally With `hiera`
```yaml
---
dconf::user_profile:
my_user:
type: user
order: 0
my_system:
type: system
order: 10
```
## Reference
See the [API documentation](./REFERENCE.md) or run `puppet strings` for full
details.
## Limitations
SIMP Puppet modules are generally intended for use on Red Hat Enterprise Linux
and compatible distributions, such as CentOS.
Please see the [`metadata.json` file](./metadata.json) for the most up-to-date
list of supported operating systems, Puppet versions, and module dependencies.
## Development
Please read our [Contribution Guide](https://simp.readthedocs.io/en/stable/contributors_guide/index.html)