{"id":3984,"date":"2018-10-25T16:51:36","date_gmt":"2018-10-25T21:51:36","guid":{"rendered":"http:\/\/www.jasemccarty.com\/blog\/?p=3984"},"modified":"2020-02-16T16:52:08","modified_gmt":"2020-02-16T22:52:08","slug":"ve-client-cert-update","status":"publish","type":"post","link":"https:\/\/www.jasemccarty.com\/blog\/ve-client-cert-update\/","title":{"rendered":"Understanding vSAN Encryption \u2013 Updating a KMS Client Certificate"},"content":{"rendered":"<p>A question came up the other day where a customer had the KMS client certificate was about to expire.<\/p>\n<p>The initial client certificate was created with an expiration roughly a year after their encrypted vSAN Cluster installation.<\/p>\n<h2>vSAN Health Check<\/h2>\n<p>The vSAN Health Check will report on the status of the client certificate each time the health check is run.<\/p>\n<p>Alerts will show up in vCenter, but like any other, can be tied to other actions like an email, SNMP trap, etc.<\/p>\n<p><a href=\"http:\/\/blogs.vmware.com\/virtualblocks\/files\/2018\/10\/KMSTRUSTREPLACE01.png\"><br \/>\n<\/a><a href=\"http:\/\/blogs.vmware.com\/virtualblocks\/files\/2018\/10\/KMSTRUSTREPLACE01.png\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter wp-image-14134\" src=\"http:\/\/blogs.vmware.com\/virtualblocks\/files\/2018\/10\/KMSTRUSTREPLACE01-1024x353.png\" alt=\"KMS client\" width=\"800\" height=\"276\" srcset=\"https:\/\/blogs.vmware.com\/virtualblocks\/files\/2018\/10\/KMSTRUSTREPLACE01-1024x353.png 1024w, https:\/\/blogs.vmware.com\/virtualblocks\/files\/2018\/10\/KMSTRUSTREPLACE01-220x76.png 220w, https:\/\/blogs.vmware.com\/virtualblocks\/files\/2018\/10\/KMSTRUSTREPLACE01-768x265.png 768w, https:\/\/blogs.vmware.com\/virtualblocks\/files\/2018\/10\/KMSTRUSTREPLACE01-290x100.png 290w\" sizes=\"auto, (max-width: 800px) 100vw, 800px\" \/><\/a><\/p>\n<p>Notice that the client certificate will expire in a few days.<\/p>\n<p>There is no mechanism to correct this in the vSAN UI, this is because the vCenter to KMS trust, is a vCenter setting, not an individual cluster setting.<\/p>\n<h2>Updating the Client Certificate in vCenter<\/h2>\n<p>The process of updating the KMS client certificate in very simple.<\/p>\n<p>Select the vCenter server, and then look for Key Management Servers in the Configure tab for vCenter.<\/p>\n<p>The process up updating the client certificate is the same as the initial process of &#8220;Make KMS trust vCenter&#8221;<\/p>\n<p><a href=\"http:\/\/blogs.vmware.com\/virtualblocks\/files\/2018\/10\/KMSTRUSTREPLACE02.png\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter wp-image-14137 size-large\" src=\"http:\/\/blogs.vmware.com\/virtualblocks\/files\/2018\/10\/KMSTRUSTREPLACE02-1024x586.png\" alt=\"KMS client\" width=\"580\" height=\"332\" srcset=\"https:\/\/blogs.vmware.com\/virtualblocks\/files\/2018\/10\/KMSTRUSTREPLACE02-1024x586.png 1024w, https:\/\/blogs.vmware.com\/virtualblocks\/files\/2018\/10\/KMSTRUSTREPLACE02-220x126.png 220w, https:\/\/blogs.vmware.com\/virtualblocks\/files\/2018\/10\/KMSTRUSTREPLACE02-768x439.png 768w, https:\/\/blogs.vmware.com\/virtualblocks\/files\/2018\/10\/KMSTRUSTREPLACE02-290x166.png 290w, https:\/\/blogs.vmware.com\/virtualblocks\/files\/2018\/10\/KMSTRUSTREPLACE02.png 1360w\" sizes=\"auto, (max-width: 580px) 100vw, 580px\" \/><\/a><\/p>\n<p>The process of making a KMS trust vCenter will be dependent on the KMS vendor solution that is being used. Using the <a href=\"https:\/\/www.hytrust.com\/\" target=\"_blank\" rel=\"noopener noreferrer\">HyTrust<\/a> KeyControl appliance, the <strong>KMS certificate and private key<\/strong><\/p>\n<p><a href=\"http:\/\/blogs.vmware.com\/virtualblocks\/files\/2018\/10\/KMSTRUSTREPLACE03.png\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter wp-image-14138 size-large\" src=\"http:\/\/blogs.vmware.com\/virtualblocks\/files\/2018\/10\/KMSTRUSTREPLACE03-1024x858.png\" alt=\"KMS client\" width=\"580\" height=\"486\" srcset=\"https:\/\/blogs.vmware.com\/virtualblocks\/files\/2018\/10\/KMSTRUSTREPLACE03-1024x858.png 1024w, https:\/\/blogs.vmware.com\/virtualblocks\/files\/2018\/10\/KMSTRUSTREPLACE03-203x170.png 203w, https:\/\/blogs.vmware.com\/virtualblocks\/files\/2018\/10\/KMSTRUSTREPLACE03-768x643.png 768w, https:\/\/blogs.vmware.com\/virtualblocks\/files\/2018\/10\/KMSTRUSTREPLACE03-227x190.png 227w, https:\/\/blogs.vmware.com\/virtualblocks\/files\/2018\/10\/KMSTRUSTREPLACE03.png 1323w\" sizes=\"auto, (max-width: 580px) 100vw, 580px\" \/><\/a><\/p>\n<p>Establishing the trust is simple after uploading the new KMS certificate &amp; private key.<\/p>\n<p><a href=\"http:\/\/blogs.vmware.com\/virtualblocks\/files\/2018\/10\/KMSTRUSTREPLACE04.png\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter wp-image-14139 size-large\" src=\"http:\/\/blogs.vmware.com\/virtualblocks\/files\/2018\/10\/KMSTRUSTREPLACE04-1024x858.png\" alt=\"KMS client\" width=\"580\" height=\"486\" srcset=\"https:\/\/blogs.vmware.com\/virtualblocks\/files\/2018\/10\/KMSTRUSTREPLACE04-1024x858.png 1024w, https:\/\/blogs.vmware.com\/virtualblocks\/files\/2018\/10\/KMSTRUSTREPLACE04-203x170.png 203w, https:\/\/blogs.vmware.com\/virtualblocks\/files\/2018\/10\/KMSTRUSTREPLACE04-768x644.png 768w, https:\/\/blogs.vmware.com\/virtualblocks\/files\/2018\/10\/KMSTRUSTREPLACE04-227x190.png 227w, https:\/\/blogs.vmware.com\/virtualblocks\/files\/2018\/10\/KMSTRUSTREPLACE04.png 1315w\" sizes=\"auto, (max-width: 580px) 100vw, 580px\" \/><\/a><\/p>\n<p>With the new trust established, rerun the vSAN Health Check.<\/p>\n<p><a href=\"http:\/\/blogs.vmware.com\/virtualblocks\/files\/2018\/10\/KMSTRUSTREPLACE05.png\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter wp-image-14140 size-large\" src=\"http:\/\/blogs.vmware.com\/virtualblocks\/files\/2018\/10\/KMSTRUSTREPLACE05-1024x628.png\" alt=\"KMS client\" width=\"580\" height=\"356\" srcset=\"https:\/\/blogs.vmware.com\/virtualblocks\/files\/2018\/10\/KMSTRUSTREPLACE05-1024x628.png 1024w, https:\/\/blogs.vmware.com\/virtualblocks\/files\/2018\/10\/KMSTRUSTREPLACE05-220x135.png 220w, https:\/\/blogs.vmware.com\/virtualblocks\/files\/2018\/10\/KMSTRUSTREPLACE05-768x471.png 768w, https:\/\/blogs.vmware.com\/virtualblocks\/files\/2018\/10\/KMSTRUSTREPLACE05-290x178.png 290w, https:\/\/blogs.vmware.com\/virtualblocks\/files\/2018\/10\/KMSTRUSTREPLACE05.png 1430w\" sizes=\"auto, (max-width: 580px) 100vw, 580px\" \/><\/a><\/p>\n<p>In the green, all good. Five by five.<\/p>\n<p><a href=\"http:\/\/blogs.vmware.com\/virtualblocks\/files\/2018\/10\/KMSTRUSTREPLACE06.png\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter wp-image-14142 size-large\" src=\"http:\/\/blogs.vmware.com\/virtualblocks\/files\/2018\/10\/KMSTRUSTREPLACE06-1024x349.png\" alt=\"KMS client\" width=\"580\" height=\"198\" srcset=\"https:\/\/blogs.vmware.com\/virtualblocks\/files\/2018\/10\/KMSTRUSTREPLACE06-1024x349.png 1024w, https:\/\/blogs.vmware.com\/virtualblocks\/files\/2018\/10\/KMSTRUSTREPLACE06-220x75.png 220w, https:\/\/blogs.vmware.com\/virtualblocks\/files\/2018\/10\/KMSTRUSTREPLACE06-768x262.png 768w, https:\/\/blogs.vmware.com\/virtualblocks\/files\/2018\/10\/KMSTRUSTREPLACE06-290x99.png 290w\" sizes=\"auto, (max-width: 580px) 100vw, 580px\" \/><\/a>For good measure, perform a shallow rekey.<\/p>\n<p><a href=\"http:\/\/blogs.vmware.com\/virtualblocks\/files\/2018\/10\/KMSTRUSTREPLACE07.png\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter wp-image-14144 size-large\" src=\"http:\/\/blogs.vmware.com\/virtualblocks\/files\/2018\/10\/KMSTRUSTREPLACE07-1024x592.png\" alt=\"KMS client\" width=\"580\" height=\"335\" srcset=\"https:\/\/blogs.vmware.com\/virtualblocks\/files\/2018\/10\/KMSTRUSTREPLACE07-1024x592.png 1024w, https:\/\/blogs.vmware.com\/virtualblocks\/files\/2018\/10\/KMSTRUSTREPLACE07-220x127.png 220w, https:\/\/blogs.vmware.com\/virtualblocks\/files\/2018\/10\/KMSTRUSTREPLACE07-768x444.png 768w, https:\/\/blogs.vmware.com\/virtualblocks\/files\/2018\/10\/KMSTRUSTREPLACE07-290x168.png 290w, https:\/\/blogs.vmware.com\/virtualblocks\/files\/2018\/10\/KMSTRUSTREPLACE07.png 1141w\" sizes=\"auto, (max-width: 580px) 100vw, 580px\" \/><\/a><\/p>\n<p>A shallow rekey is non-disruptive, is relatively quick, and can be accomplished quickly and easily.<\/p>\n<h2>Summary<\/h2>\n<p>Even though the process to update the client certificate is relatively simple, it isn&#8217;t something that should be taken lightly.<\/p>\n<p>Encrypted vSAN clusters will continue to run once the Host Key and Key Encryption Key (KEK) are loaded. A client certificate could expire, and hosts would still have encrypted disks mounted. Should one of those hosts reboot, with an expired client certificate, they would not be able to mount the encrypted vSAN disks.<\/p>\n<p>Make certain the KMS client certificate is valid and hasn&#8217;t expired to keep your encrypted vSAN cluster healthy and happy.<\/p>\n<p>This was originally posted on the VMware Virtual Blocks site: https:\/\/blogs.vmware.com\/virtualblocks\/2018\/10\/25\/ve-client-cert-update\/<\/p>\n","protected":false},"excerpt":{"rendered":"<p>A question came up the other day where a customer had the KMS client certificate was about to expire. The initial client certificate was created &hellip; <\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[],"class_list":["post-3984","post","type-post","status-publish","format-standard","hentry","category-uncategorized"],"_links":{"self":[{"href":"https:\/\/www.jasemccarty.com\/blog\/wp-json\/wp\/v2\/posts\/3984","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.jasemccarty.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.jasemccarty.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.jasemccarty.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.jasemccarty.com\/blog\/wp-json\/wp\/v2\/comments?post=3984"}],"version-history":[{"count":2,"href":"https:\/\/www.jasemccarty.com\/blog\/wp-json\/wp\/v2\/posts\/3984\/revisions"}],"predecessor-version":[{"id":3986,"href":"https:\/\/www.jasemccarty.com\/blog\/wp-json\/wp\/v2\/posts\/3984\/revisions\/3986"}],"wp:attachment":[{"href":"https:\/\/www.jasemccarty.com\/blog\/wp-json\/wp\/v2\/media?parent=3984"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.jasemccarty.com\/blog\/wp-json\/wp\/v2\/categories?post=3984"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.jasemccarty.com\/blog\/wp-json\/wp\/v2\/tags?post=3984"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}