Skip to content

Latest commit

 

History

History
99 lines (84 loc) · 9.33 KB

README.md

File metadata and controls

99 lines (84 loc) · 9.33 KB
Raw

Ansible Role: firefox-autoconfig

Installs and configures firefox with mozilla autoconfig

Role Variables

Variable name Type Default Description
firefox_user string {{ ansible_user }} The user to configure firefox for.
firefox_build string Allows to set a specific firefox version to be installed (must be available through apt).
firefox_autoconfig file path mozilla.cfg.j2 Can be used to replace the default autoconfig script
firefox_syspref file path syspref.js Can be used to replace the default syspref config
firefox_installs_ini file path installs.ini Can be used to replace the default installs.ini template
firefox_profiles_ini file path profiles.ini Can be used to replace the default profiles.ini template
firefox_xulstore file path xulstore.json Can be used to replace the default xulstore.json
firefox_config_dir file path /home/{{ firefox_user }}/.mozilla/firefox The path for the firefox user config directory
firefox_profile string profile.default The directory for the default profile
firefox_profile_name string default The name for the default profile
firefox_profiles_version string 4F96D1932A9F858E The hex identifier for the firefox install. Needed to configure profiles.
firefox_distribution_template file path templates/distribution.ini.j2 The template to use for the distribution.ini file
firefox_distribution_append bool True If True the distribution.ini template will be appended to the existing file installed by the apt package. Otherwise the file will be completely replaced.*
firefox_homepage URL Sets the firefox startpage. (is overridden if firefox_json contains homepage setting)
firefox_json dict Configures firefox using the supplied dictionary.
    ∟.homepage string Firefox startpage
    ∟.accounts list[dict] List of dictionaries containing user login information. See below for details on dict content.** format
    ∟.certs list[string] A list of certificates to add to firefox. List items must be certificate content without line breaks.
    ∟.certfiles list[file path] A list of CA certificate file locations to be installed in firefox.
firefox_cert_files list[file path] A list of CA certificate file locations to be installed in firefox.
firefox_distribution dict Accepts a distribution.ini configuration in dictionary format i.e. a map where top level keys are sections and top level values are dictionaries containing the configuration. See https://wiki.mozilla.org/Distribution_INI_File

*Note when completely replacing the distribution.ini file a Global section with the following entries is required:

  • id
  • version
  • about

*firefox_json.acounts:

  • ∟.hostname: The URL to save the user login for
  • ∟.httpRealm: The HTTP Realm in case of HTTP Auth or null otherwise
  • ∟.formSubmitURL: The URL to POST the login form. Usually the same as hostname
  • ∟.username: The username to save
  • ∟.password: The password to save
  • ∟.usernameField: The id of the username input HTML field
  • ∟.passwordField: The id of the password input HTML field

Examples

Simple config only change start page

- hosts: "{{ test_host | default('localhost') }}"
  roles:
    - role: firefox-autoconfig
      vars: 
        firefox_homepage: test.at

Add login credentials to pre configure

- hosts: "{{ test_host | default('localhost') }}"
  roles:
    - role: firefox-autoconfig
      vars: 
        firefox_json: 
          homepage: test.at
          accounts:
          - hostname: http://test.at
            httpRealm: null
            formSubmitURL: http://test.at
            username: test
            password: test
            usernameField: user_name
            passwordField: password

Add a few bookmarks

- hosts: "{{ test_host | default('localhost') }}"
  roles:
    - role: firefox-autoconfig
      vars: 
        firefox_json: 
          BookmarksToolbar:
            item.1.title: OWASP TOP 10 2013
            item.1.link: https://www.owasp.org/index.php/Top_10_2013-Top_10
            item.1.description: OWASP Top 10 vulnarbilities year 2013
            item.2.title: Test
            item.2.link: https://test.at/
            item.2.description: This is test

Licence

GPL-3.0

Author information

This role was created in 2019 by Maximilian Frank