- \n
- See Configure a Conditional Access Policy<\/a>.<\/li>\n\n\n\n
- Conditional Access is a Platform Prime feature. See JumpCloud pricing<\/a> for more information about Platform Prime. <\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n
Considerations<\/strong>:<\/p>\n\n\n\n
- \n
- Device Trust certificates covered in this article apply only to desktop devices using the JumpCloud Agent and supported web browsers.<\/li>\n\n\n\n
- Certificates are distributed only to JumpCloud managed users on devices.<\/li>\n<\/ul>\n\n\n\n
![](\"\/wp-content\/themes\/jumpcloud\/assets\/images\/gutenberg-blocks\/important-icon.png\")
<\/p><\/div>Important:<\/strong> \nThe managed device condition using Device Trust certificates doesn’t apply to mobile devices managed by MDM. To enforce Device Trust on mobile devices, see Get Started: Mobile Device Trust<\/a>.<\/p>\n <\/div><\/div><\/div><\/div>\n\n\n\n
Understanding the Device Trust Certificate Bundle<\/h2>\n\n\n\n
The JumpCloud Device Trust certificate bundle contains four parts:<\/p>\n\n\n\n
- \n
- Root Certificate<\/strong> – The JumpCloud Production Device Identification Root CA<\/em> certificate is a self-signed certificate and displays as untrusted<\/em> in some certificate managers, but this is not an issue.<\/li>\n\n\n\n
- Intermediate Certificate<\/strong> – The device-trust.intermediate<\/em> certificate.<\/li>\n\n\n\n
- Leaf Certificate<\/strong> – The JumpCloud Device Trust Certificate – \u2026\u2026..<\/em> certificate.<\/em> The browser presents this certificate in response to the challenge from the agent server. The \u2018……..\u2019<\/em> contains an eight-digit hexadecimal identifier. The identifier is only used to ensure that two different leaf certs will have unique names.<\/li>\n\n\n\n
- Private key<\/strong> – The Imported Private Key was created by the agent on the user\u2019s behalf to generate the certificate signing request, as part of requesting the Device Trust certificate. It\u2019s packaged along with the certificates so it can be used to sign requests to the agent server.<\/li>\n<\/ul>\n\n\n\n
![](\"\/wp-content\/themes\/jumpcloud\/assets\/images\/gutenberg-blocks\/note-icon.png\")
<\/p><\/div>Note:<\/strong> \nIn addition to requesting and installing the Device Trust certificate, the Agent or the user-agent must also create certificate selection filters so that the user\u2019s browser can locate the correct certificate when challenged. <\/p>\n <\/div><\/div><\/div><\/div>\n\n\n\n
Finding the Storage Location of Global Device Certificates<\/h2>\n\n\n\n
On macOS<\/strong>:<\/p>\n\n\n\n
- \n
- The certificates are stored in a new jumpcloud-device-trust-keychain in the user\u2019s Library\/Keychains folder.<\/li>\n\n\n\n
- The generated password for the new keychain is stored in the user\u2019s login keychain, in a generic password item named JumpCloud Device Trust Keychain Password<\/em>. This allows the user agent to unlock the Device Trust keychain when it needs access to install or renew certificates.<\/li>\n\n\n\n
- The Device Trust keychain password will be rotated every time a certificate is installed or renewed.<\/li>\n<\/ul>\n\n\n\n
On Windows:<\/strong><\/p>\n\n\n\n
- \n
- The agent installs the root (CA) certificate in the system cert store<\/li>\n\n\n\n
- The user-agent installs the intermediate certificate in the user\u2019s Intermediate Certification Authorities store, and the Device Trust certificate in the user\u2019s Personal store.<\/li>\n<\/ul>\n\n\n\n
On Linux:<\/strong><\/p>\n\n\n\n
- \n
- Certificates are stored in the user\u2019s NSS database (~\/.pki\/nssdb\/cert9.db, ~\/.pki\/nssdb\/key4.db).<\/li>\n\n\n\n
- If the database does not exist, the agent will create a new one<\/li>\n\n\n\n
- Certificate auto-select filters are found in \/etc\/opt\/chrome\/policies\/managed\/JumpCloudCertificateAutoselect.json<\/li>\n<\/ul>\n\n\n\n
Distributing Global Device Certificates <\/h2>\n\n\n\n
Distribute device certificates from the Conditional Policies Settings page or when you create your first policy that uses a device condition. See Configure a Conditional Access Policy<\/a> to learn how to distribute certificates when you create your first device-based policy. <\/p>\n\n\n\n
- \n
- Log in to the JumpCloud Admin Portal<\/a>. <\/li>\n\n\n\n
- Go to SECURITY MANAGEMENT > Conditional Policies<\/strong>. <\/li>\n\n\n\n
- Click Settings<\/strong> to the right of the policies. You can also click Edit in Settings<\/strong> under Global Policies<\/strong>.
![\"\"](\"https:\/\/jumpcloud.com\/\/wp-content\/uploads\/2023\/05\/DeviceTrustSettingsIcon.png\")
<\/li>\n\n\n\n - In Device Certificates<\/strong>, set Global Certificate Distribution<\/strong> to ON<\/strong>.<\/li>\n\n\n\n
- Click save<\/strong> changes<\/strong>. <\/li>\n<\/ol>\n\n\n\n<\/p><\/div>Note:<\/strong> \n
Global device certificates have a time-to-live of 30 days, but are renewed every two weeks by the user agent.<\/p>\n <\/div><\/div><\/div><\/div>\n\n\n\n
Using Commands to Confirm Presence<\/h2>\n\n\n\n
To check the presence and validity of device trust certificates, you can use the follow commands (from JumpCloud Commands or locally on the device).
From JumpCloud Commands:<\/strong><\/p>\n\n\n\n!\/bin\/bashlocaluser=$(scutil <<< “show State:\/Users\/ConsoleUser” | awk ‘\/Name :\/ && ! \/loginwindow\/ { print $3 }’)sudo -u $localuser security find-certificate -c “JumpCloud Device Trust Certificate” -p | openssl x509 -text | grep “Not Before|Not After”<\/code><\/p>\n\n\n\nFrom Local Device:<\/strong><\/p>\n\n\n\nsecurity find-certificate -c “JumpCloud Device Trust Certificate” -p | openssl x509 -text | grep “Not Before|Not After”<\/code><\/p>\n\n\n\n<\/p><\/div>Note:<\/strong> \nIn both cases, you can omit the last grep<\/em> section of the command to return the full output of the certificate.<\/p>\n <\/div><\/div><\/div><\/div>\n\n\n\n
Removing Global Device Certificates<\/h2>\n\n\n\n
You can remove global device certificates after you\u2019ve distributed them. When you disable global device certificates, existing policies aren\u2019t updated, and any custom macOS Keychain Application Access<\/a> configurations are removed. To make sure users have uninterrupted access to their resources, disable policies with a device condition before you remove global device certificates. Learn how to disable a policy in Configure a Conditional Access Policy<\/a>. <\/p>\n\n\n\n
To remove global device certificates<\/strong>:<\/p>\n\n\n\n
- \n
- Log in to the JumpCloud Admin Portal<\/a>. <\/li>\n\n\n\n
- Go to SECURITY MANAGEMENT > Conditional Policies<\/strong>. <\/li>\n\n\n\n
- Click Settings<\/strong> to the right of the policies. You can also click Edit in Settings<\/strong> under Global Policies<\/strong>.<\/li>\n\n\n\n
- In Device Certificates<\/strong>, set Global Certificate Distribution<\/strong> to OFF<\/strong>. <\/li>\n\n\n\n
- Click save changes<\/strong>.
![\"\"](\"https:\/\/jumpcloud.com\/\/wp-content\/uploads\/2023\/05\/DeviceTrustSelectCert.png\")
<\/li>\n<\/ol>\n\n\n\n<\/p><\/div>Note:<\/strong> \nDisabling Global Certificate Distribution removes certificates from every device and every user on a device. Any existing managed device policies treat users as unmanaged, and this takes effect immediately. <\/p>\n <\/div><\/div><\/div><\/div>\n\n\n\n
Users: Selecting a Device Trust Certificate<\/h2>\n\n\n\n
As part of Device Trust, users may see prompts to select Device Trust certificates when browsing to the JumpCloud User Portal or using some SSO-enabled applications after certificate distribution is enabled. You should inform users that these types of prompts are legitimate and expected, and to select the JumpCloud Device Trust Certificate and let the application or browser proceed.
![\"\"](\"https:\/\/jumpcloud.com\/\/wp-content\/uploads\/2023\/05\/DeviceTrustSelectCert2.png\")
<\/p>\n\n\n\nThe prompt may present multiple JumpCloud Device Trust Certificat<\/em>e options, but they are all the same certificate, and the user can select any one.<\/p>\n\n\n\n
Addressing Persistent Certificate Prompts on macOS<\/h2>\n\n\n\n
In some applications on macOS (Google Chrome, for example), the certificate selection prompt may persistently appear, even when the user has previously selected the certificate. To resolve this issue, restart the device. <\/p>\n\n\n\n
If a restart does not resolve the issue, you can gather the Device Trust Password from the macOS Keychain and input it when prompted.<\/p>\n\n\n\n
To gather the Device Trust Password on a macOS device<\/strong>:<\/p>\n\n\n\n
- \n
- On the macOS device, open the Keychain<\/strong> app.<\/li>\n\n\n\n
- In the list of keychains, locate the JumpCloud Device Trust Keychain Password <\/strong>item under the Login<\/strong> keychain and double-click.<\/li>\n\n\n\n
- The keychain entry opens in a new window. Click Show password<\/strong> and a password prompt appears.\n
- \n
- Enter the user’s local device account password (the same password used for device login) and click Allow<\/strong>.<\/li>\n\n\n\n
- A second password prompt appears, enter the device account password again and click Allow<\/strong>.
![\"\"](\"https:\/\/jumpcloud.com\/\/wp-content\/uploads\/2023\/10\/macos_keychain_device_trust_password_always_allow.jpg\")
<\/li>\n<\/ol>\n<\/li>\n\n\n\n - In the keychain window, the Device Trust password will now appear. Select the password and Copy<\/strong> it.<\/li>\n\n\n\n
- When prompted for the JumpCloud Device Trust Key<\/strong>, Paste<\/strong> this password into the field. <\/li>\n\n\n\n
- Important<\/strong>! Click Always Allow<\/strong>. Clicking Allow may not prevent the popup from reappearing later. <\/li>\n<\/ol>\n","protected":false},"excerpt":{"rendered":"
JumpCloud\u2019s Device Trust Certificates let you allow or deny access to the User Portal and SSO applications based on the […]<\/p>\n","protected":false},"author":202,"featured_media":0,"template":"","meta":{"_acf_changed":false,"_oasis_is_in_workflow":0,"_oasis_original":0,"_oasis_task_priority":"","inline_featured_image":false,"footnotes":""},"support_category":[2929,2852],"support_tag":[],"coauthors":[2836,3011],"acf":[],"yoast_head":"\n
Manage Device Trust Certificates for Desktop - JumpCloud<\/title>\n<meta name=\"description\" content=\"Discover how to use Device Trust to allow or deny access to resources like the User Portal and applications, based on the device the user utilizes to authenticate.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/jumpcloud.com\/support\/manage-device-trust-certificates\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Manage Device Trust Certificates for Desktop\" \/>\n<meta property=\"og:description\" content=\"Browse the JumpCloud Help Center by category, search for a specific topic, or check out our featured articles.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/jumpcloud.com\/support\/manage-device-trust-certificates\" \/>\n<meta property=\"og:site_name\" content=\"JumpCloud\" \/>\n<meta property=\"article:modified_time\" content=\"2025-02-10T21:12:12+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/jumpcloud.com\/\/wp-content\/uploads\/2023\/05\/DeviceTrustSettingsIcon.png\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"6 minutes\" \/>\n\t<meta name=\"twitter:label2\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data2\" content=\"denasteward, nickconrad\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/jumpcloud.com\/support\/manage-device-trust-certificates\",\"url\":\"https:\/\/jumpcloud.com\/support\/manage-device-trust-certificates\",\"name\":\"Manage Device Trust Certificates for Desktop - JumpCloud\",\"isPartOf\":{\"@id\":\"https:\/\/jumpcloud.com\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/jumpcloud.com\/support\/manage-device-trust-certificates#primaryimage\"},\"image\":{\"@id\":\"https:\/\/jumpcloud.com\/support\/manage-device-trust-certificates#primaryimage\"},\"thumbnailUrl\":\"https:\/\/jumpcloud.com\/\/wp-content\/uploads\/2023\/05\/DeviceTrustSettingsIcon.png\",\"datePublished\":\"2023-05-15T20:40:23+00:00\",\"dateModified\":\"2025-02-10T21:12:12+00:00\",\"description\":\"Discover how to use Device Trust to allow or deny access to resources like the User Portal and applications, based on the device the user utilizes to authenticate.\",\"breadcrumb\":{\"@id\":\"https:\/\/jumpcloud.com\/support\/manage-device-trust-certificates#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/jumpcloud.com\/support\/manage-device-trust-certificates\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/jumpcloud.com\/support\/manage-device-trust-certificates#primaryimage\",\"url\":\"https:\/\/jumpcloud.com\/\/wp-content\/uploads\/2023\/05\/DeviceTrustSettingsIcon.png\",\"contentUrl\":\"https:\/\/jumpcloud.com\/\/wp-content\/uploads\/2023\/05\/DeviceTrustSettingsIcon.png\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/jumpcloud.com\/support\/manage-device-trust-certificates#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/jumpcloud.com\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Support\",\"item\":\"https:\/\/jumpcloud.com\/support\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Manage Device Trust Certificates for Desktop\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/jumpcloud.com\/#website\",\"url\":\"https:\/\/jumpcloud.com\/\",\"name\":\"JumpCloud\",\"description\":\"Daily insights on directory services, IAM, LDAP, identity security, SSO, system management (Mac, Windows, Linux), networking, and the cloud.\",\"publisher\":{\"@id\":\"https:\/\/jumpcloud.com\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/jumpcloud.com\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/jumpcloud.com\/#organization\",\"name\":\"JumpCloud\",\"url\":\"https:\/\/jumpcloud.com\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/jumpcloud.com\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/jumpcloud.com\/wp-content\/uploads\/2021\/01\/jc-logo-brand-2021.png\",\"contentUrl\":\"https:\/\/jumpcloud.com\/wp-content\/uploads\/2021\/01\/jc-logo-brand-2021.png\",\"width\":598,\"height\":101,\"caption\":\"JumpCloud\"},\"image\":{\"@id\":\"https:\/\/jumpcloud.com\/#\/schema\/logo\/image\/\"}}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"Manage Device Trust Certificates for Desktop - JumpCloud","description":"Discover how to use Device Trust to allow or deny access to resources like the User Portal and applications, based on the device the user utilizes to authenticate.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/jumpcloud.com\/support\/manage-device-trust-certificates","og_locale":"en_US","og_type":"article","og_title":"Manage Device Trust Certificates for Desktop","og_description":"Browse the JumpCloud Help Center by category, search for a specific topic, or check out our featured articles.","og_url":"https:\/\/jumpcloud.com\/support\/manage-device-trust-certificates","og_site_name":"JumpCloud","article_modified_time":"2025-02-10T21:12:12+00:00","og_image":[{"url":"https:\/\/jumpcloud.com\/\/wp-content\/uploads\/2023\/05\/DeviceTrustSettingsIcon.png"}],"twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"6 minutes","Written by":"denasteward, nickconrad"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/jumpcloud.com\/support\/manage-device-trust-certificates","url":"https:\/\/jumpcloud.com\/support\/manage-device-trust-certificates","name":"Manage Device Trust Certificates for Desktop - JumpCloud","isPartOf":{"@id":"https:\/\/jumpcloud.com\/#website"},"primaryImageOfPage":{"@id":"https:\/\/jumpcloud.com\/support\/manage-device-trust-certificates#primaryimage"},"image":{"@id":"https:\/\/jumpcloud.com\/support\/manage-device-trust-certificates#primaryimage"},"thumbnailUrl":"https:\/\/jumpcloud.com\/\/wp-content\/uploads\/2023\/05\/DeviceTrustSettingsIcon.png","datePublished":"2023-05-15T20:40:23+00:00","dateModified":"2025-02-10T21:12:12+00:00","description":"Discover how to use Device Trust to allow or deny access to resources like the User Portal and applications, based on the device the user utilizes to authenticate.","breadcrumb":{"@id":"https:\/\/jumpcloud.com\/support\/manage-device-trust-certificates#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/jumpcloud.com\/support\/manage-device-trust-certificates"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/jumpcloud.com\/support\/manage-device-trust-certificates#primaryimage","url":"https:\/\/jumpcloud.com\/\/wp-content\/uploads\/2023\/05\/DeviceTrustSettingsIcon.png","contentUrl":"https:\/\/jumpcloud.com\/\/wp-content\/uploads\/2023\/05\/DeviceTrustSettingsIcon.png"},{"@type":"BreadcrumbList","@id":"https:\/\/jumpcloud.com\/support\/manage-device-trust-certificates#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/jumpcloud.com\/"},{"@type":"ListItem","position":2,"name":"Support","item":"https:\/\/jumpcloud.com\/support"},{"@type":"ListItem","position":3,"name":"Manage Device Trust Certificates for Desktop"}]},{"@type":"WebSite","@id":"https:\/\/jumpcloud.com\/#website","url":"https:\/\/jumpcloud.com\/","name":"JumpCloud","description":"Daily insights on directory services, IAM, LDAP, identity security, SSO, system management (Mac, Windows, Linux), networking, and the cloud.","publisher":{"@id":"https:\/\/jumpcloud.com\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/jumpcloud.com\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/jumpcloud.com\/#organization","name":"JumpCloud","url":"https:\/\/jumpcloud.com\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/jumpcloud.com\/#\/schema\/logo\/image\/","url":"https:\/\/jumpcloud.com\/wp-content\/uploads\/2021\/01\/jc-logo-brand-2021.png","contentUrl":"https:\/\/jumpcloud.com\/wp-content\/uploads\/2021\/01\/jc-logo-brand-2021.png","width":598,"height":101,"caption":"JumpCloud"},"image":{"@id":"https:\/\/jumpcloud.com\/#\/schema\/logo\/image\/"}}]}},"_links":{"self":[{"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/support\/75905"}],"collection":[{"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/support"}],"about":[{"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/types\/support"}],"author":[{"embeddable":true,"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/users\/202"}],"version-history":[{"count":2,"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/support\/75905\/revisions"}],"predecessor-version":[{"id":120890,"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/support\/75905\/revisions\/120890"}],"wp:attachment":[{"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/media?parent=75905"}],"wp:term":[{"taxonomy":"support_category","embeddable":true,"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/support_category?post=75905"},{"taxonomy":"support_tag","embeddable":true,"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/support_tag?post=75905"},{"taxonomy":"author","embeddable":true,"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/coauthors?post=75905"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}