About mobile device management

Learn how to use mobile device management to manage how your organization uses 1Password on their devices.

If you’re an administrator in 1Password Teams or 1Password Business, you can use mobile device management (MDM) to enforce stricter controls for employees who use 1Password on their devices. You can use these settings to configure 1Password using your MDM solution.

Important

Installations of 1Password 7 or earlier won’t be affected by these settings.

Instructions for

The preference domain for 1Password 8 for Mac is com.1password.1password. These settings must be applied using MDM and cannot be set manually using the defaults command.

Download a sample .mobileconfig profile.

General

These settings allow you to control basic options for the 1Password app.

SettingKeyType
Start at loginapp.startAtLoginBoolean
Save new items in [vault]*app.defaultVaultForSavingString
Submit automatically with Universal Autofillsecurity.autofill.autosubmitBoolean

* Learn how to set the default vault for saving new items. If this string is left empty, 1Password will suggest a vault.

Security

Help

If you also enforce unlock or auto-lock settings with policies on 1Password.com, those selections will take precedence over any enforced MDM settings.

These settings affect how a team member unlocks 1Password and uses data in it.

SettingKeyType
Enforce unlock using Touch IDsecurity.authenticatedUnlock.appleTouchIdBoolean
Enforce unlock using Apple Watchsecurity.authenticatedUnlock.appleWatchUnlockBoolean
Allow 1Password to unlock when the device is unlockedsecurity.authenticatedUnlock.deviceBasedUnlockBoolean
Set the account password requirement timeframe*security.authenticatedUnlock.requireAccountPasswordAfterString
Set auto-lock timeout†
(in minutes)
security.autolock.minutesInteger
Lock when device locks or sleepssecurity.autolock.onDeviceLockBoolean
Lock when main window is closedsecurity.autolock.onWindowCloseBoolean
Remove copied information and one-time passwords after 90 secondssecurity.clipboard.clearAfterBoolean
Use Universal Clipboard to copy to other devicessecurity.deviceClipboardSharingBoolean
Keep device active for Large Typesecurity.blockSleepEnabledBoolean
Always show passwords and full credit card numberssecurity.revealPasswordsBoolean
Always show Wi-Fi QR codessecurity.revealWifiQrCodesBoolean

* The allowed values are "one-day", "two-weeks", "thirty-days", and "never". Each value must be enclosed in quotation marks, as shown here.

† You can choose a number from 1 to 1440 (1 day).

Privacy

These settings allow you to manage settings related to privacy and Watchtower.

SettingKeyType
Show app and website iconsprivacy.downloadRichIconsBoolean
Check for compromised websitesprivacy.checkCompromisedWebsitesBoolean
Check for vulnerable passwordsprivacy.checkHibpBoolean
Check for two-factor authenticationprivacy.checkMfaBoolean
Check for passkeysprivacy.checkPasskeysBoolean

Trusted browsers

The following setting allows you to control how 1Password connects with trusted browsers. Browsers you add this way are combined with any a team member adds themselves in Settings > Browser > Add Browser. MDM can’t remove a browser a team member added on their own or a browser that 1Password trusts by default.

SettingKeyType
Add trusted browsersbrowsers.admin-trusted-appsString

This setting doesn’t use a fixed value. Generate it on a Mac with 1Password installed:

  1. If 1Password is open, quit it completely.

  2. Open Terminal, then copy and paste the following command. Replace the browser path with the browser you want to use. For example, to generate values for Waterfox:

    /Applications/1Password.app/Contents/MacOS/1Password --generate-trusted-browser-config /Applications/Waterfox.app
    
  3. Copy the <key> and <string> XML that 1Password prints to the terminal and paste them in the fields for this setting.

Updates

Important

These settings can only be controlled if you deploy or install 1Password with the 1Password.app installer. If you use the PKG installer, you can monitor updates and deploy them with your MDM solution.

These settings allow you to manage 1Password updates.

SettingKeyType
Automatically check for updatesupdates.autoUpdateBoolean
Set release channel*updates.updateChannelString

* The allowed values are PRODUCTION, BETA, and NIGHTLY.

If your organization manages the release channel with a 1Password.com policy, that policy overrides these MDM settings for automatic updates and the release channel.

Authentication

These settings allow you to control the process of signing into the 1Password app.

SettingKeyType
Set a default sign-in address*authentication.defaultDomainString
Enforce the default sign-in address†authentication.enforceDomainBoolean

* Use the following structure for the sign-in address: domain.1password.com. The scheme (https://) shouldn't be included.

† To use this setting, you must set a sign-in address for the authentication.defaultDomain setting.

You can use an administrative template (ADMX) to control settings in 1Password through Group Policy. You can import templates directly into Active Directory or Intune.

To get the template for 1Password, download this ZIP file, then extract its contents. If you need the template for a specific version of 1Password, replace latest at the end of the URL with the version of 1Password you need (8.12.36, for example).

To learn how to set up and use the template in your organization, review the README.md file in the template folder for further instructions.

Important

If you’re using the HKEY_LOCAL_MACHINE\SOFTWARE\Agilebits Inc.\1Password\Policy registry key to control settings in your organization, you should migrate to administrative templates.

This registry key is deprecated, and we’ll be removing support for it in a future update. You can find steps to migrate in the README.md file after you create a template.

General

These settings allow you to control basic options for the 1Password app.

SettingKeyType
Show the main app window at login*app.openAppOnStartupBoolean
Save new items in [vault]†app.defaultVaultForSavingString
Allow the use of Auto-Typeapp.autoTypeEnabledBoolean
Allow proxy detection‡proxy.autoDetectNetworkSettingsString
Submit automatically with Auto-Typesecurity.autofill.autosubmitBoolean

* To control this setting, 1Password must be turned on in Windows Settings > Apps > Startup.

† Learn how to set the default vault for saving new items. If this string is left empty, 1Password will suggest a vault.

‡ Turn this off to force a direct network connection.

Security

Help

If you also enforce unlock or auto-lock settings with policies on 1Password.com, those selections will take precedence over any enforced MDM settings.

These settings affect how a team member unlocks 1Password and uses data in it.

SettingKeyType
Set the account password requirement timeframe*security.authenticatedUnlock.requireAccountPasswordAfterString
Allow 1Password to unlock when the device is unlockedsecurity.authenticatedUnlock.deviceBasedUnlockBoolean
Set auto-lock timeout†
(in minutes)
security.autolock.minutesInteger
Lock when device locks or sleepssecurity.autolock.onDeviceLockBoolean
Lock when main window is closedsecurity.autolock.onWindowCloseBoolean
Remove copied information and one-time passwords after 90 secondssecurity.clipboard.clearAfterBoolean
Keep device active for Large Typesecurity.blockSleepEnabledBoolean
Always show passwords and full credit card numberssecurity.revealPasswordsBoolean
Always show Wi-Fi QR codessecurity.revealWifiQrCodesBoolean

* The allowed values are "one-day", "two-weeks", "thirty-days", and "never". Each value must be enclosed in quotation marks, as shown here.

† You can choose a number from 1 to 1440 (1 day).

Privacy

These settings allow you to manage settings related to privacy and Watchtower.

SettingKeyType
Show app and website iconsprivacy.downloadRichIconsBoolean
Check for compromised websitesprivacy.checkCompromisedWebsitesBoolean
Check for vulnerable passwordsprivacy.checkHibpBoolean
Check for two-factor authenticationprivacy.checkMfaBoolean
Check for passkeysprivacy.checkPasskeysBoolean

Updates

These settings allow you to manage 1Password updates.

SettingKeyType
Automatically check for updates*updates.autoUpdateBoolean
Set release channel†updates.updateChannelString

* This setting only applies if 1Password is installed with the MSIX, MSI, or App Installer. Learn how to control updates if you deploy 1Password through the Microsoft Store.

† The allowed values are PRODUCTION, BETA, and NIGHTLY. This setting only applies if 1Password is installed with the MSIX or MSI, not with App Installer or through the Microsoft Store.

If your organization manages the release channel with a 1Password.com policy, that policy overrides these MDM settings for automatic updates and the release channel.

Authentication

These settings allow you to control the process of signing into the 1Password app.

SettingKeyType
Set a default sign-in address*authentication.defaultDomainString
Enforce the default sign-in address†authentication.enforceDomainBoolean

* Use the following structure for the sign-in address: domain.1password.com. The scheme (https://) shouldn't be included.

† To use this setting, you must set a sign-in address for the authentication.defaultDomain setting.

The preference domain for 1Password 8 for iOS is com.1password.1password.

General

These settings allow you to control basic options for the 1Password app.

SettingKeyType
Save new items in [vault]*app.defaultVaultForSavingString

* Learn how to set the default vault for saving new items. If this string is left empty, 1Password will suggest a vault.

Security

Help

If you also enforce unlock or auto-lock settings with policies on 1Password.com, those selections will take precedence over any enforced MDM settings.

These settings affect how a team member unlocks 1Password and uses data in it.

SettingKeyType
Enforce unlock using Touch IDsecurity.authenticatedUnlock.appleTouchIdBoolean
Enforce unlock using Face IDsecurity.authenticatedUnlock.appleFaceIdBoolean
Allow unlock with device passcodesecurity.authenticatedUnlock.appleDevicePinUnlockBoolean
Allow 1Password to unlock when the device is unlockedsecurity.authenticatedUnlock.deviceBasedUnlockBoolean
Set the account password requirement timeframe*security.authenticatedUnlock.requireAccountPasswordAfterString
Set auto-lock timeout†
(in minutes)
security.autolock.minutesInteger
Clear clipboard after timeoutsecurity.clipboard.clearAfterBoolean
Use Universal Clipboard to copy to other devicessecurity.deviceClipboardSharingBoolean
Keep device active for Large Typesecurity.blockSleepEnabledBoolean
Always show passwords and full credit card numberssecurity.revealPasswordsBoolean
Always show Wi-Fi QR codessecurity.revealWifiQrCodesBoolean

* The allowed values are "one-day", "two-weeks", "thirty-days", and "never". Each value must be enclosed in quotation marks, as shown here.

† You can choose a number from 0 to 480. If you choose 0, the app will lock immediately when no longer in focus.

Privacy

These settings allow you to manage preferences related to privacy and Watchtower.

SettingKeyType
Show app and website iconsprivacy.downloadRichIconsBoolean
Use Apple Mapsprivacy.mapsEnabledBoolean
Check for compromised websitesprivacy.checkCompromisedWebsitesBoolean
Check for vulnerable passwordsprivacy.checkHibpBoolean
Check for two-factor authenticationprivacy.checkMfaBoolean
Check for passkeysprivacy.checkPasskeysBoolean

Autofill

These settings allow you to manage preferences related to Autofill.

SettingKeyType
Show passkey suggestionsapp.autoFillPasskeyShowFillingSuggestionsBoolean

Notifications

These settings allow you to manage the notifications that team members receive from 1Password.

Notification typeKeyType
One-Time Passwordsapp.notifyCopyTotpToClipboardBoolean

Authentication

These settings allow you to control the process of signing into the 1Password app.

SettingKeyType
Set a default sign-in address*authentication.defaultDomainString
Enforce the default sign-in address†authentication.enforceDomainBoolean

* Use the following structure for the sign-in address: domain.1password.com. The scheme (https://) shouldn't be included.

† To use this setting, you must set a sign-in address for the authentication.defaultDomain setting.

Appendix: Set the default vault for saving new items

To specify a vault and account to save new items, use the following structure:

{"VaultReference":{"vault_uuid":"UUID","account_uuid":"UUID"}}

Replace both UUID values with the appropriate ones for the vault and account you want to use.

To enforce the default behavior and prevent users from changing this setting, enter the following string instead:

CurrentVaultOrFallback

Learn more



Published: