Skip to content

Managed schema

Sami Vänttinen edited this page Oct 25, 2024 · 3 revisions

Managed schema

It's possible to distribute global settings to the extension by using 3rdparty policy. Examples on how to distribute the policy can be found from here.

Link to the schema file:

https://github.com/keepassxreboot/keepassxc-browser/blob/develop/keepassxc-browser/managed_storage.json

Properties

The following properties have certain specified values to be used:

afterFillSorting (How to sort credentials after fill)

  • sortByMatchingCredentials (default)
  • sortByRelevantEntry

afterFillSortingTotp ()

  • sortByMatchingCredentials
  • sortByRelevantEntry (default)

bannerPosition (Where to position the Credential Banner)

  • 0 Bottom
  • 1 Top (default)

checkUpdateKeePassXC (When to check updates for KeePassXC)

  • 0 Never (default)
  • 3 Every three days
  • 7 Weekly
  • 30 Monthly

colorTheme (Extension color scheme)

  • dark
  • light
  • system (default)

credentialSorting (How to sort matching credentials)

  • sortByTitle
  • sortByUsername
  • sortByGroupAndTitle (default)
  • sortByGroupAndUsername

Example policy file

An example policy file in JSON format:

{
  "policies": {
    "3rdparty": {
      "Extensions": {
        "[email protected]": {
          "settings": {
            "defined-custom-fields": {
              "https://example.com": {
                "fields": [
                  [
                    "/html/body/table/tbody/tr[10]/td[4]/table/tbody/tr/td/table/tbody/tr[2]/td[4]/form/table/tbody/tr[2]/td[2]/input",
                    "INPUT password form_password "
                  ]
                ],
                "password": [
                  "/html/body/table/tbody/tr[10]/td[4]/table/tbody/tr/td/table/tbody/tr[2]/td[4]/form/table/tbody/tr/td[2]/input",
                  "INPUT text form_username "
                ],
                "username": [
                  "/html/body/table/tbody/tr[10]/td[4]/table/tbody/tr/td/table/tbody/tr[2]/td[4]/form/table/tbody/tr[2]/td[2]/input",
                  "INPUT password form_password "
                ]
              }
            },
            "passkeys": true,
            "sitePreferences": [
              {
                "allowIframes": false,
                "ignore": "ignoreNothing",
                "improvedFieldDetection": false,
                "url": "https://example.com",
                "usernameOnly": true
              }
            ]
          }
        }
      }
    }
  }
}