{"id":22700184,"url":"https://github.com/simp/pupmod-simp-dconf","last_synced_at":"2025-04-13T05:53:20.814Z","repository":{"id":32710645,"uuid":"135346814","full_name":"simp/pupmod-simp-dconf","owner":"simp","description":"Puppet module for managing Dconf settings","archived":false,"fork":false,"pushed_at":"2025-03-27T15:59:53.000Z","size":136,"stargazers_count":1,"open_issues_count":3,"forks_count":11,"subscribers_count":17,"default_branch":"master","last_synced_at":"2025-04-09T17:47:47.484Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/simp.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-05-29T20:01:12.000Z","updated_at":"2025-03-27T15:55:35.000Z","dependencies_parsed_at":"2022-07-16T04:46:14.087Z","dependency_job_id":"13e9f9c2-5c3f-4730-9d39-e5716025416a","html_url":"https://github.com/simp/pupmod-simp-dconf","commit_stats":null,"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simp%2Fpupmod-simp-dconf","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simp%2Fpupmod-simp-dconf/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simp%2Fpupmod-simp-dconf/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simp%2Fpupmod-simp-dconf/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/simp","download_url":"https://codeload.github.com/simp/pupmod-simp-dconf/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248610031,"owners_count":21132919,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-12-10T06:10:22.396Z","updated_at":"2025-04-13T05:53:20.783Z","avatar_url":"https://github.com/simp.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![License](https://img.shields.io/:license-apache-blue.svg)](http://www.apache.org/licenses/LICENSE-2.0.html)\n[![CII Best Practices](https://bestpractices.coreinfrastructure.org/projects/73/badge)](https://bestpractices.coreinfrastructure.org/projects/73)\n[![Puppet Forge](https://img.shields.io/puppetforge/v/simp/dconf.svg)](https://forge.puppetlabs.com/simp/dconf)\n[![Puppet Forge Downloads](https://img.shields.io/puppetforge/dt/simp/dconf.svg)](https://forge.puppetlabs.com/simp/dconf)\n[![Build Status](https://travis-ci.org/simp/pupmod-simp-dconf.svg)](https://travis-ci.org/simp/pupmod-simp-dconf)\n\n#### Table of Contents\n\n\u003c!-- vim-markdown-toc GFM --\u003e\n\n* [Description](#description)\n  * [This is a SIMP module](#this-is-a-simp-module)\n* [Setup](#setup)\n* [Usage](#usage)\n  * [Configuring custom rules](#configuring-custom-rules)\n* [\u003e to prevent users from modifying them!](#-to-prevent-users-from-modifying-them)\n    * [Using `puppet`](#using-puppet)\n    * [Using `hiera`](#using-hiera)\n  * [Configuring custom profiles](#configuring-custom-profiles)\n    * [Using `puppet`](#using-puppet-1)\n    * [Globally With `hiera`](#globally-with-hiera)\n* [Reference](#reference)\n* [Limitations](#limitations)\n* [Development](#development)\n\n\u003c!-- vim-markdown-toc --\u003e\n\n## Description\n\n`dconf` is a Puppet module that installs and manages `dconf` and associated system settings.\n\n### This is a SIMP module\n\nThis module is a component of the [System Integrity Management Platform](https://simp-project.com)\na compliance-management framework built on Puppet.\n\nIf you find any issues, they may be submitted to our [bug tracker](https://simp-project.atlassian.net/).\n\nThis module is optimally designed for use within a larger SIMP ecosystem, but\nit can be used independently:\n\n * When included within the SIMP ecosystem, security compliance settings will\n   be managed from the Puppet server.\n * If used independently, all SIMP-managed security subsystems are disabled by\n   default and must be explicitly opted into by administrators.  See\n   [simp_options](https://github.com/simp/pupmod-simp-simp_options) for more\n   detail.\n\n## Setup\n\nTo use the module with, just include the class:\n\n```ruby\ninclude 'dconf'\n```\n\n## Usage\n\n### Configuring custom rules\n\nYou can configure custom ``dconf`` settings using the ``dconf::settings``\ndefined type.\n\n---\n\u003e Any settings that are configured using this code will automatically be locked\n\u003e to prevent users from modifying them!\n---\n\n#### Using `puppet`\n\n```puppet\ndconf::settings { 'automount_lockdowns':\n  settings_hash =\u003e {\n    'org/gnome/desktop/media-handling' =\u003e {\n      'automount'      =\u003e { 'value' =\u003e false, 'lock' =\u003e false } # allow users to change this one\n      'automount-open' =\u003e { 'value' =\u003e false }\n    }\n  }\n}\n```\n\n#### Using `hiera`\n\n```yaml\n---\ndconf::user_settings:\n  settings_hash:\n    org/gnome/desktop/media-handling:\n      automount:\n        value: false\n        lock: false # allow users to change this one\n      automount-open:\n        value: false\n```\n\n### Configuring custom profiles\n\nYou can set up a custom [dconf profile](https://help.gnome.org/admin//system-admin-guide/3.8/dconf-profiles.html.en) as follows:\n\n#### Using `puppet`\n\n```puppet\ndconf::profile { 'my_profile':\n  entries =\u003e {\n    'user' =\u003e {\n      'type' =\u003e 'user',\n      'order' =\u003e 1\n    },\n    'system' =\u003e {\n      'type' =\u003e 'system',\n      'order' =\u003e 10\n    }\n  }\n```\n\n#### Globally With `hiera`\n\n```yaml\n---\ndconf::user_profile:\n  my_user:\n    type: user\n    order: 0\n  my_system:\n    type: system\n    order: 10\n```\n\n## Reference\n\nSee the [API documentation](./REFERENCE.md) or run `puppet strings` for full\ndetails.\n\n## Limitations\n\nSIMP Puppet modules are generally intended for use on Red Hat Enterprise Linux\nand compatible distributions, such as CentOS.\n\nPlease see the [`metadata.json` file](./metadata.json) for the most up-to-date\nlist of supported operating systems, Puppet versions, and module dependencies.\n\n## Development\n\nPlease read our [Contribution Guide](https://simp.readthedocs.io/en/stable/contributors_guide/index.html)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimp%2Fpupmod-simp-dconf","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsimp%2Fpupmod-simp-dconf","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimp%2Fpupmod-simp-dconf/lists"}