{"id":5604,"date":"2013-09-27T10:06:44","date_gmt":"2013-09-27T08:06:44","guid":{"rendered":"https:\/\/ingmarverheij.com\/?p=5604"},"modified":"2013-09-27T10:22:09","modified_gmt":"2013-09-27T08:22:09","slug":"vmware-recover-vcenter-single-sign-on-sso-master-password","status":"publish","type":"post","link":"https:\/\/ingmarverheij.com\/en\/vmware-recover-vcenter-single-sign-on-sso-master-password\/","title":{"rendered":"VMware: Recover vCenter Single Sign On (SSO) master password"},"content":{"rendered":"<p><a href=\"https:\/\/ingmarverheij.com\/wp-content\/uploads\/2013\/09\/VMware-vSphere-Web-Client-vCenter-Single-Sign-On-Information.png\"><img loading=\"lazy\" decoding=\"async\" title=\"VMware vSphere Web Client - vCenter Single Sign On Information\" style=\"border-left-width: 0px; border-right-width: 0px; background-image: none; border-bottom-width: 0px; float: right; padding-top: 0px; padding-left: 0px; margin: 0px 0px 0px 5px; display: inline; padding-right: 0px; border-top-width: 0px\" border=\"0\" alt=\"VMware vSphere Web Client - vCenter Single Sign On Information\" align=\"right\" src=\"https:\/\/ingmarverheij.com\/wp-content\/uploads\/2013\/09\/VMware-vSphere-Web-Client-vCenter-Single-Sign-On-Information_thumb.png\" width=\"154\" height=\"116\" \/><\/a>During the installation of the VMware vSphere Web Client I had to provide vCenter Single Sign On Information. Since no additional accounts \/ groups where granted SSO admin privileges (see <a href=\"https:\/\/pubs.vmware.com\/vsphere-51\/index.jsp?topic=%2Fcom.vmware.vsphere.security.doc%2FGUID-1F21D2D9-0BE1-4FB1-B9D4-790BCB62E726.html\" target=\"_blank\">VMware vSphere 5.1 Documentation Center<\/a>)&#160; the only account that had sufficient privileges was the default SSO admin user <strong>admin@System-Domain<\/strong>. The credentials of this account are provided during installation of the vCenter Single Sign On Service.<\/p>\n<p>Unfortunately the password of the default SSO admin account was unknown. In this article I\u2019ll explain how to change the password of the default SSO admin account.<\/p>\n<p><!--more--><\/p>\n<h2>Master password<\/h2>\n<p>VMware provides us with a solution to reset the password of the default SSO admin account (<a href=\"https:\/\/kb.vmware.com\/selfservice\/microsites\/search.do?language=en_US&amp;cmd=displayKC&amp;externalId=2034608\" target=\"_blank\">KB2034608<\/a>) but it requires the <strong>master password. <\/strong>The master password is set during installation, the password provided for the default SSO admin account is used as master password, but it is not the same password as the default SSO admin account. <\/p>\n<p>Although we can change the password of the default SSO admin account (<a href=\"mailto:admin@System-Domain\">admin@System-Domain<\/a>), changing the master password is not possible (or supported). After the password of the default SSO admin account is changed the master password is still unusable.    <br clear=\"all\" \/><a href=\"https:\/\/ingmarverheij.com\/wp-content\/uploads\/2013\/09\/Invalid-password-failed-to-decrypt-system-key.png\"><img loading=\"lazy\" decoding=\"async\" title=\"Error: Invalid password, failed to decrypt system key  Root cause: javax.crypto.BadPaddingException: Given final block not properly padded\" style=\"border-top: 0px; border-right: 0px; background-image: none; border-bottom: 0px; padding-top: 0px; padding-left: 0px; margin: 0px 5px 0px 0px; border-left: 0px; display: inline; padding-right: 0px\" border=\"0\" alt=\"\" src=\"https:\/\/ingmarverheij.com\/wp-content\/uploads\/2013\/09\/Invalid-password-failed-to-decrypt-system-key_thumb.png\" width=\"354\" height=\"56\" \/><\/a>    <br clear=\"all\" \/>    <br clear=\"all\" \/><\/p>\n<h2>Default SSO admin account<\/h2>\n<p>The vCenter Single Sign On Service stores all data in a databases, including the principals. The credentials of the default SSO admin account are stored in the <strong>IMS_PRINCIPAL <\/strong>table. One of the stored properties is a <a href=\"https:\/\/en.wikipedia.org\/wiki\/SHA-2\" target=\"_blank\">SSHA-256<\/a> (<a href=\"https:\/\/en.wikipedia.org\/wiki\/Salt_(cryptography)\" target=\"_blank\">salted<\/a>) hashed password. Changing the password is as easy as replacing the hash (also known as <a href=\"https:\/\/en.wikipedia.org\/wiki\/Pass_the_hash\" target=\"_blank\">pass the hash<\/a>) from a clean vCenter SSO service installation.<\/p>\n<p><a href=\"https:\/\/www.die-schubis.de\/doku.php?id=vmware:vsphere&amp;&amp;_sm_au_=iVVqjkrsQ0sLqFW6\" target=\"_blank\">Schubis<\/a> wrote a (german) article how to generate a new hash and how to replace it in your existing vCenter SSO setup. Unfortunately this requires you to built a lab environment with a SQL server and vCenter Single Sign On service, which is time consuming.&#160; Since you can change the password afterwards, I might as well provide you with some pre-created hashes:<\/p>\n<pre>Passw0rd!\n{SSHA256}B6HO7UNHVi5fglh1RpJXX4z1maGJ9lcicTVcy94ztsmzAekseg==\n\nVMware1234!\n{SSHA256}KGOnPYya2qwhF9w4xK157EZZ\/RqIxParohltZWU7h2T\/VGjNRA==<\/pre>\n<p>&#160;<\/p>\n<h3>Recover access<\/h3>\n<p>If you need to recover access of the default SSO admin account please follow the following three steps:<br \/>\n  <br clear=\"all\" \/><\/p>\n<h6>1. Reset password to temporary password<\/h6>\n<p>Connect to the SQL database (default is RSA) and execute the statement below to reset the password of the default SSO admin account to <strong>Password!<\/strong><\/p>\n<pre lang=\"sql\"> UPDATE\n\t [Dbo]. [IMS_PRINCIPAL]\n SET\n\t [PASSWORD] = '{SSHA256}B6HO7UNHVi5fglh1RpJXX4z1maGJ9lcicTVcy94ztsmzAekseg=='\n WHERE\n\t LOGINUID = 'admin'\n AND\n\t PRINCIPAL_IS_DESCRIPTION = 'admin'<\/pre>\n<p><font color=\"#4bacc6\"><\/p>\n<p>&#160;<\/p>\n<h6>2. Restart vCenter SSO service<\/h6>\n<p><font color=\"#666666\">Restart the service \u201cvCenter Single Sign On\u201d to apply the changes.<\/font><font color=\"#666666\"><br \/>\n      <br clear=\"all\" \/><a href=\"https:\/\/ingmarverheij.com\/wp-content\/uploads\/2013\/09\/vCenter-Single-Sign-On-Properties.png\"><img loading=\"lazy\" decoding=\"async\" title=\"vCenter Single Sign On - Properties\" style=\"border-top: 0px; border-right: 0px; background-image: none; border-bottom: 0px; padding-top: 0px; padding-left: 0px; margin: 0px 5px 0px 0px; border-left: 0px; display: inline; padding-right: 0px\" border=\"0\" alt=\"vCenter Single Sign On - Properties\" src=\"https:\/\/ingmarverheij.com\/wp-content\/uploads\/2013\/09\/vCenter-Single-Sign-On-Properties_thumb.png\" width=\"154\" height=\"173\" \/><\/a><\/font><\/p>\n<p>&#160;<\/p>\n<h6>3. Change the password the default SSO Admin account<\/h6>\n<p><font color=\"#666666\">Connect to the VMware vSphere Web Client and authenticate with the new default SSO credentials (<strong>username <\/strong>: <\/font><a href=\"mailto:admin@System-DomainPassword\"><font color=\"#666666\">admin@System-Domain and <strong>password<\/strong><\/font><strong> <\/strong>: Passw0rd! ).<\/a><\/p>\n<p><\/font><\/p>\n<p><a href=\"https:\/\/ingmarverheij.com\/wp-content\/uploads\/2013\/09\/VMware-vSphere-Web-Client-Authentication10.png\"><em><a href=\"https:\/\/ingmarverheij.com\/wp-content\/uploads\/2013\/09\/VMware-vSphere-Web-Client-Authentication11.png\"><img loading=\"lazy\" decoding=\"async\" title=\"VMware vSphere Web Client - Authentication\" style=\"border-top: 0px; border-right: 0px; background-image: none; border-bottom: 0px; padding-top: 0px; padding-left: 0px; margin: 0px 5px 0px 0px; border-left: 0px; display: inline; padding-right: 0px\" border=\"0\" alt=\"VMware vSphere Web Client - Authentication\" src=\"https:\/\/ingmarverheij.com\/wp-content\/uploads\/2013\/09\/VMware-vSphere-Web-Client-Authentication_thumb.png\" width=\"354\" height=\"120\" \/><\/a><\/em><\/a><\/p>\n<p>  <br clear=\"all\" \/><\/p>\n<p>Navigate to Home &gt; Administration &gt; SSO Users and Groups<a href=\"https:\/\/ingmarverheij.com\/wp-content\/uploads\/2013\/09\/Home-Administration-SSO-Users-and-Groups.png\"><img loading=\"lazy\" decoding=\"async\" title=\"Home - Administration - SSO Users and Groups\" style=\"border-top: 0px; border-right: 0px; background-image: none; border-bottom: 0px; padding-top: 0px; padding-left: 0px; margin: 0px 5px 0px 0px; border-left: 0px; display: inline; padding-right: 0px\" border=\"0\" alt=\"Home - Administration - SSO Users and Groups\" src=\"https:\/\/ingmarverheij.com\/wp-content\/uploads\/2013\/09\/Home-Administration-SSO-Users-and-Groups_thumb.png\" width=\"354\" height=\"74\" \/><\/a><\/p>\n<p>  <br clear=\"all\" \/><\/p>\n<p>Select the default SSO admin account &gt; Action &gt; Edit User<a href=\"https:\/\/ingmarverheij.com\/wp-content\/uploads\/2013\/09\/vCenter-Single-Sign-On-Users-and-Groups-admin.png\"><img loading=\"lazy\" decoding=\"async\" title=\"vCenter Single Sign On Users and Groups - admin\" style=\"border-top: 0px; border-right: 0px; background-image: none; border-bottom: 0px; padding-top: 0px; padding-left: 0px; margin: 0px 5px 0px 0px; border-left: 0px; display: inline; padding-right: 0px\" border=\"0\" alt=\"vCenter Single Sign On Users and Groups - admin\" src=\"https:\/\/ingmarverheij.com\/wp-content\/uploads\/2013\/09\/vCenter-Single-Sign-On-Users-and-Groups-admin_thumb.png\" width=\"354\" height=\"126\" \/><\/a><\/p>\n<p>  <br clear=\"all\" \/><\/p>\n<p>Change the password of the default SSO admin account to your preferred password<br \/>\n  <br clear=\"all\" \/><a href=\"https:\/\/ingmarverheij.com\/wp-content\/uploads\/2013\/09\/admin-Edit.png\"><img loading=\"lazy\" decoding=\"async\" title=\"admin - Edit\" style=\"border-top: 0px; border-right: 0px; background-image: none; border-bottom: 0px; padding-top: 0px; padding-left: 0px; margin: 0px 5px 0px 0px; border-left: 0px; display: inline; padding-right: 0px\" border=\"0\" alt=\"admin - Edit\" src=\"https:\/\/ingmarverheij.com\/wp-content\/uploads\/2013\/09\/admin-Edit_thumb.png\" width=\"154\" height=\"198\" \/><\/a><\/p>\n<p>  <br clear=\"all\" \/><em>Please avoid the use of special characters in your SSO administrator password like (^ * $ ; \u201d \u2019 ) &lt; &gt; &amp; | \\ _\u201d), non-ASCII characters and trailing \u201c \u201c space as the vCenter SSO service cant\u2019 handle it (<a href=\"https:\/\/kb.vmware.com\/selfservice\/microsites\/search.do?language=en_US&amp;cmd=displayKC&amp;externalId=2035820\" target=\"_blank\">KB2035820<\/a>)!<\/em><\/p>\n<p>&#160;<\/p>\n<h2>Lessons learned<\/h2>\n<p>To avoid this situation in the future I wrote down some lessons I learned. Although their very obvious, it\u2019s good to keep them in mind.<\/p>\n<ul>\n<li>Always store the master password in a safe location<\/li>\n<li>Grant additional users \/ groups administrative SSO admin privileges<\/li>\n<li><em>Preferably add an Active Directory integrated group in __Administrators__<\/em><\/li>\n<li>Database administrators (DBA) can get access to your VMware vCenter by replacing a simple hash<\/li>\n<\/ul>\n<p>&#160;<\/p>\n<p>.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>During the installation of the VMware vSphere Web Client I had to provide vCenter Single Sign On Information. Since no additional accounts \/ groups where granted SSO admin privileges (see VMware vSphere 5.1 Documentation Center)&#160; the only account that had sufficient privileges was the default SSO admin user admin@System-Domain. The credentials of this account are [&hellip;]<\/p>\n","protected":false},"author":3,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"site-container-style":"default","site-container-layout":"default","site-sidebar-layout":"default","disable-article-header":"default","disable-site-header":"default","disable-site-footer":"default","disable-content-area-spacing":"default","footnotes":""},"categories":[592],"tags":[595,594,593,76],"class_list":["post-5604","post","type-post","status-publish","format-standard","hentry","category-vmware-2","tag-password","tag-sso","tag-vcenter","tag-vmware"],"_links":{"self":[{"href":"https:\/\/ingmarverheij.com\/en\/wp-json\/wp\/v2\/posts\/5604","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ingmarverheij.com\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/ingmarverheij.com\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/ingmarverheij.com\/en\/wp-json\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/ingmarverheij.com\/en\/wp-json\/wp\/v2\/comments?post=5604"}],"version-history":[{"count":7,"href":"https:\/\/ingmarverheij.com\/en\/wp-json\/wp\/v2\/posts\/5604\/revisions"}],"predecessor-version":[{"id":5621,"href":"https:\/\/ingmarverheij.com\/en\/wp-json\/wp\/v2\/posts\/5604\/revisions\/5621"}],"wp:attachment":[{"href":"https:\/\/ingmarverheij.com\/en\/wp-json\/wp\/v2\/media?parent=5604"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/ingmarverheij.com\/en\/wp-json\/wp\/v2\/categories?post=5604"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/ingmarverheij.com\/en\/wp-json\/wp\/v2\/tags?post=5604"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}