HENNGE
How to configure Keeper SSO Connect Cloud with HENNGE for seamless and secure SAML 2.0 authentication.
Please complete the steps in the Admin Console Configuration section first.
![](https://docs.keeper.io/~gitbook/image?url=https%3A%2F%2F2503956294-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MB_i6vKdtG6Z2n6zWgJ%252Fuploads%252F31RScPLbu4jBWDd3Gl9b%252FHENNGE.jpg%3Falt%3Dmedia%26token%3D7a559035-fd20-4f57-9163-11c4f374ea5b&width=768&dpr=4&quality=100&sign=791252e&sv=1)
HENNGE SSO Configuration
(1) Log into the HENNGE Administrator console.
![](https://docs.keeper.io/~gitbook/image?url=https%3A%2F%2F2503956294-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MB_i6vKdtG6Z2n6zWgJ%252Fuploads%252FBcIUHCFbsoor112lcmpj%252FLogin_HENNGE.png%3Falt%3Dmedia%26token%3D22d4a9e6-d52e-4161-861d-6c2ec903b08d&width=768&dpr=4&quality=100&sign=423f7ebd&sv=1)
Click the Administration tile on the menu.
![](https://docs.keeper.io/~gitbook/image?url=https%3A%2F%2F2503956294-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MB_i6vKdtG6Z2n6zWgJ%252Fuploads%252F0X5aZvDqtqfQ28dXXFeT%252FScreenshot%25202024-01-26%2520142959.png%3Falt%3Dmedia%26token%3D485def2d-de31-4b2a-8480-6b6bc13d9e96&width=768&dpr=4&quality=100&sign=8ce2577&sv=1)
(2) Next, Select the Connected Services menu item and click Add Service.
![](https://docs.keeper.io/~gitbook/image?url=https%3A%2F%2F2503956294-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MB_i6vKdtG6Z2n6zWgJ%252Fuploads%252FEehPQFs0xMZInG59a1hx%252FApp_Creation_at_HENGGE.png%3Falt%3Dmedia%26token%3D25b20a82-f5f1-4d38-9b60-1cd0863965f1&width=768&dpr=4&quality=100&sign=149126ff&sv=1)
On the "Add New Service" page, Click the Add Service Manually at "Add Service for SSO" menu.
![](https://docs.keeper.io/~gitbook/image?url=https%3A%2F%2F2503956294-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MB_i6vKdtG6Z2n6zWgJ%252Fuploads%252FRlYNMRM5zW4Tx4ubzkRL%252FApp_Creation_at_HENGGE2.png%3Falt%3Dmedia%26token%3D94e66d1a-59bc-4f2f-a2b1-3ce6e5d0755c&width=768&dpr=4&quality=100&sign=d23a0191&sv=1)
(3) Set the Service name to “Keeper Password Manager and Digital Vault” or whatever you prefer, and Add the Attributes Email claim with the value "UsePrincipleName (UPN)", then Click the Submit button.
![](https://docs.keeper.io/~gitbook/image?url=https%3A%2F%2F2503956294-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MB_i6vKdtG6Z2n6zWgJ%252Fuploads%252F0aiRGrs7n0g3W44Av9V8%252FApp_Creation_at_HENGGE3.png%3Falt%3Dmedia%26token%3D4cbef1a6-4302-4b48-a53c-c5fc5fbd0845&width=768&dpr=4&quality=100&sign=327baa3d&sv=1)
![](https://docs.keeper.io/~gitbook/image?url=https%3A%2F%2F2503956294-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MB_i6vKdtG6Z2n6zWgJ%252Fuploads%252FycIm32MELIbUhbTcoKN5%252FAttribute.png%3Falt%3Dmedia%26token%3D03be6056-b03b-4876-9100-97aaf98fb6bd&width=768&dpr=4&quality=100&sign=82b0f91b&sv=1)
In your environment, if your user.userprincipalname (UPN) is not the same as the users actual email address, you can edit the Email claim and change it to user.mail as the value for the Email attribute.
Now you can see all values required for Keeper side configuration at Step (5). Click X at the right up and Leave this page for now.
![](https://docs.keeper.io/~gitbook/image?url=https%3A%2F%2F2503956294-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MB_i6vKdtG6Z2n6zWgJ%252Fuploads%252FJwu1NBm1XKEs1lrYp9Mz%252FMetaData_Export_HENNGE.png%3Falt%3Dmedia%26token%3Db86240d6-1f16-4148-babf-d02833eaf97d&width=768&dpr=4&quality=100&sign=c340b34&sv=1)
On the Connected Services menu area, Click the Service Name you created and then click the "Upload Using Metadata" button.
![](https://docs.keeper.io/~gitbook/image?url=https%3A%2F%2F2503956294-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MB_i6vKdtG6Z2n6zWgJ%252Fuploads%252FblGvfTy5i4YoEqpu1aaZ%252FScreenshot%25202024-01-26%2520152438.png%3Falt%3Dmedia%26token%3Dc1c41c6a-41b9-483a-b2cb-bbb0c73705df&width=768&dpr=4&quality=100&sign=14abef5e&sv=1)
![](https://docs.keeper.io/~gitbook/image?url=https%3A%2F%2F2503956294-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MB_i6vKdtG6Z2n6zWgJ%252Fuploads%252F2s1mhnQeZb8quTlR0KjH%252FMetaData_Upload_HENNGE.png%3Falt%3Dmedia%26token%3D54b2dc12-dbd9-469b-bfd6-4a0d894cc640&width=768&dpr=4&quality=100&sign=52f040dc&sv=1)
The Keeper metadata is available on the admin console. Go to the provisioning instance -> View -> Export Metadata
![](https://docs.keeper.io/~gitbook/image?url=https%3A%2F%2F2503956294-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MB_i6vKdtG6Z2n6zWgJ%252Fuploads%252FrZQj322WRJexLu4k1miK%252FSSO_Cloud_Connect2.png%3Falt%3Dmedia%26token%3Dc3a2514b-b9d2-4889-95f0-88ae8f5d9dfd&width=768&dpr=4&quality=100&sign=25e1b1a9&sv=1)
(4) After the metadata has been uploaded, head back to the HENNGE Connected Service configuration page and input the Login URL as such https://keepersecurity.com/api/rest/sso/ext_login/<YourSSOIdHere>.
Your SSO ID can be found at the end of your SP Entity ID. Ex: https://keepersecurity.com/api/rest/sso/saml/3534758084794
![](https://docs.keeper.io/~gitbook/image?url=https%3A%2F%2F2503956294-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MB_i6vKdtG6Z2n6zWgJ%252Fuploads%252Fn21zwL4JQ9XFnZu8NJyp%252FLogin_URL_HENNGE.png%3Falt%3Dmedia%26token%3D366030af-d4be-4670-be82-3e26ac574b6d&width=768&dpr=4&quality=100&sign=23093f75&sv=1)
Complete the configuration by scrolling to the bottom of the page and select the Save Changes button.
![](https://docs.keeper.io/~gitbook/image?url=https%3A%2F%2F2503956294-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MB_i6vKdtG6Z2n6zWgJ%252Fuploads%252FpHpOe7lRcQSBKC9AN46R%252FSave_Changes_HENNGE.png%3Falt%3Dmedia%26token%3D905ff5f2-0a8b-4dff-87b4-effdad22278f&width=768&dpr=4&quality=100&sign=1781fdb3&sv=1)
(5) Last step is to export the metadata from this connector to import it into the Keeper SSO Connect Cloud™.
![](https://docs.keeper.io/~gitbook/image?url=https%3A%2F%2F2503956294-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MB_i6vKdtG6Z2n6zWgJ%252Fuploads%252FHIgpUpwXx9JL2r8RN1jb%252FMetaData_Export_HENNGE.png%3Falt%3Dmedia%26token%3D1cac2571-db95-46f4-bfbb-35fe59f23ed9&width=768&dpr=4&quality=100&sign=74226759&sv=1)
Set the IDP Type to GENERIC and upload this file into the Keeper SSO Connect Cloud™ provisioning interface by dragging and dropping the file into the edit screen:
![](https://docs.keeper.io/~gitbook/image?url=https%3A%2F%2F2503956294-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MB_i6vKdtG6Z2n6zWgJ%252Fuploads%252FExmD3s7IhYg6FKPLujPL%252FSSO_Cloud_Connect4.png%3Falt%3Dmedia%26token%3Db75b6dad-29bf-4b6c-8038-96086ef4a602&width=768&dpr=4&quality=100&sign=e47ee77f&sv=1)
![](https://docs.keeper.io/~gitbook/image?url=https%3A%2F%2F2503956294-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MB_i6vKdtG6Z2n6zWgJ%252Fuploads%252FeFyN5cOTl83uCdNZWJHj%252FSSO_Cloud_Connect5.png%3Falt%3Dmedia%26token%3Db7c5c83c-0b45-4612-a4f2-7cd54520a5d7&width=768&dpr=4&quality=100&sign=300bbbae&sv=1)
Assign Users
From HENNGE, you can now add users at Access Policy section on the User list page, or groups at Allowed services section on Access Policy Groups page.
![](https://docs.keeper.io/~gitbook/image?url=https%3A%2F%2F2503956294-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MB_i6vKdtG6Z2n6zWgJ%252Fuploads%252FViH9uHEsK51CpN9Xchvu%252FAsign_User_Hennge.png%3Falt%3Dmedia%26token%3D42d24abe-002b-4faa-aa08-abb3ea46a9a9&width=768&dpr=4&quality=100&sign=454ff0e4&sv=1)
![](https://docs.keeper.io/~gitbook/image?url=https%3A%2F%2F2503956294-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MB_i6vKdtG6Z2n6zWgJ%252Fuploads%252FH3mKVbOck5wj2UPZUgjK%252FAsign_Group_Hennge.png%3Falt%3Dmedia%26token%3Db94e0f45-c37b-4618-9431-71d3214aed86&width=768&dpr=4&quality=100&sign=3dcaad9c&sv=1)
Your Keeper SSO Connect setup is now complete!
Move existing users/initial admin to SSO authentication
Users created in the root node (top level) will need to be migrated to the sub node that the SSO integration was configured on. If users remain in the root node, they will be prompted for the master password when accessing the vault and/or admin console.
An admin can not move themselves to the SSO enabled node. It requires another admin to perform this action.
After the user is moved to the SSO enabled node, they need to log into the Keeper vault initially by selecting the "Enterprise SSO" pull down and inputting in the Enterprise Domain configured on the SSO integration. The user may get prompted to confirm by entering in the master password.
![](https://docs.keeper.io/~gitbook/image?url=https%3A%2F%2F2503956294-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MB_i6vKdtG6Z2n6zWgJ%252Fuploads%252FfFPNzWDvSwH48ebLJOeY%252FSSO_Login.png%3Falt%3Dmedia%26token%3Df7bc0249-986d-427d-9746-0e7873ff7840&width=768&dpr=4&quality=100&sign=be6b680a&sv=1)
Once the user has authenticated with SSO, they only need to use their email address moving forward to initiate SSO authentication.
They won't have to enter the Enterprise Domain. If typing in the email address and clicking Next does not route the user to the desired SSO, ensure that just-in-time provisioning is enabled in the Keeper SSO configuration and ensure that your email domain is reserved by Keeper. More information regarding routing and domain reservation can be found here.
Last updated