Skip to content

Commit

Permalink
Fix HowTo/vsphere5_integration page migration
Browse files Browse the repository at this point in the history
This page was incorrectly migrated and contained a user report about the
topic instead. Recover the original article.

Signed-off-by: Antonio Torres <antorres@redhat.com>
  • Loading branch information
antoniotorresm committed Aug 30, 2023
1 parent bf86808 commit e0fb4b8
Show file tree
Hide file tree
Showing 3 changed files with 217 additions and 95 deletions.
File renamed without changes
312 changes: 217 additions & 95 deletions src/page/HowTo/vsphere5_integration.rst
Original file line number Diff line number Diff line change
@@ -1,97 +1,219 @@
vsphere5_integration
vShpere5 integration
====================

I'm running vSphere 6.0 (hot off presses last month) and these
instructions against a vSphere 6 installation and FreeIPA 4.1 (on CentOS
7.1) do not appear to work anymore. I'm troubleshooting now, but it's
not obvious what's going on and I'm pretty new to troubleshooting this
sort of problem.

What I've seen thus far is that the ldap access logs on my FreeIPA
server show signs that vCenter is logging in just fine to my FreeIPA
LDAP server:

::

[17/Apr/2015:13:27:29 +0100] conn=2438 op=0 BIND dn="uid=#removed#,cn=users,cn=compat,dc=#removed#,dc=uk" method=128 version=3
[17/Apr/2015:13:27:29 +0100] conn=2438 op=0 RESULT err=0 tag=97 nentries=0 etime=0 dn="uid=#removed#,cn=users,cn=accounts,dc=#removed#,dc=uk"
[17/Apr/2015:13:27:29 +0100] conn=2438 op=1 SRCH base="cn=users,cn=compat,dc=#removed#,dc=uk" scope=2 filter="(objectClass=inetOrgPerson)" attrs="uid description givenName sn mail useraccountcontrol pwdaccountlockedtime entryuuid"
[17/Apr/2015:13:27:29 +0100] conn=2438 op=1 RESULT err=0 tag=101 nentries=4 etime=0 notes=P
[17/Apr/2015:13:27:29 +0100] conn=2438 op=2 UNBIND

And on the VCSA 6.0 appliance is the vmware-sts-idmd.log I see this
corresponding exception:

::

[2015-04-17T19:17:42.252Z #removed#.local f4468c9c-220c-43d1-99af-cf8fd6a7d926 WARN ] [LdapErrorChecker] Error received by LDAP client: com.vmware.identity.interop.ldap.LinuxLdapClientLibrary, error code: -13
[2015-04-17T19:17:42.252Z #removed#.local f4468c9c-220c-43d1-99af-cf8fd6a7d926 ERROR] [LinuxLdapClientLibrary] Exception when calling ldap_one_paged_search: base=cn=users,cn=compat,dc=#removed#,dc=uk, scope=2, filter=(objectClass=inetOrgPerson), attrs=[Ljava.lang.String;@94e9177, attrsonly=0, sizelimit=0
com.vmware.identity.interop.ldap.ControlNotFoundLdapException: Control not found
LDAP error [code: -13]
at com.vmware.identity.interop.ldap.LdapErrorChecker$56.RaiseLdapError(LdapErrorChecker.java:768)
at com.vmware.identity.interop.ldap.LdapErrorChecker.CheckError(LdapErrorChecker.java:826)
at com.vmware.identity.interop.ldap.LinuxLdapClientLibrary.CheckError(LinuxLdapClientLibrary.java:1066)
at com.vmware.identity.interop.ldap.LinuxLdapClientLibrary.ldap_one_paged_search(LinuxLdapClientLibrary.java:859)
at com.vmware.identity.interop.ldap.LdapConnection$5.call(LdapConnection.java:651)
at com.vmware.identity.interop.ldap.LdapConnection$5.call(LdapConnection.java:648)
at com.vmware.identity.interop.ldap.LdapConnection.execute(LdapConnection.java:73)
at com.vmware.identity.interop.ldap.LdapConnection.search_one_page_internal(LdapConnection.java:647)
at com.vmware.identity.interop.ldap.LdapConnection.paged_search(LdapConnection.java:597)
at com.vmware.identity.idm.server.provider.ldap.LdapProvider.ldap_search(LdapProvider.java:2236)
at com.vmware.identity.idm.server.provider.ldap.LdapProvider.findUsersInternal(LdapProvider.java:782)
at com.vmware.identity.idm.server.provider.ldap.LdapProvider.findUsers(LdapProvider.java:725)
at com.vmware.identity.idm.server.provider.ldap.LdapProvider.find(LdapProvider.java:1407)
at com.vmware.identity.idm.server.IdentityManager.find(IdentityManager.java:4443)
at com.vmware.identity.idm.server.IdentityManager.find(IdentityManager.java:8963)
at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
at sun.reflect.NativeMethodAccessorImpl.invoke(Unknown Source)
at sun.reflect.DelegatingMethodAccessorImpl.invoke(Unknown Source)
at java.lang.reflect.Method.invoke(Unknown Source)
at sun.rmi.server.UnicastServerRef.dispatch(Unknown Source)
at sun.rmi.transport.Transport$1.run(Unknown Source)
at sun.rmi.transport.Transport$1.run(Unknown Source)
at java.security.AccessController.doPrivileged(Native Method)
at sun.rmi.transport.Transport.serviceCall(Unknown Source)
at sun.rmi.transport.tcp.TCPTransport.handleMessages(Unknown Source)
at sun.rmi.transport.tcp.TCPTransport$ConnectionHandler.run0(Unknown Source)
at sun.rmi.transport.tcp.TCPTransport$ConnectionHandler.run(Unknown Source)
at java.util.concurrent.ThreadPoolExecutor.runWorker(Unknown Source)
at java.util.concurrent.ThreadPoolExecutor$Worker.run(Unknown Source)
at java.lang.Thread.run(Unknown Source)
[2015-04-17T19:17:42.253Z #removed#.local f4468c9c-220c-43d1-99af-cf8fd6a7d926 ERROR] [IdentityManager] Failed to find objects [Criteria : search String=, domain=#removed#.uk] in tenant [#removed#.local]
[2015-04-17T19:17:42.253Z #removed#.local f4468c9c-220c-43d1-99af-cf8fd6a7d926 ERROR] [ServerUtils] Exception 'com.vmware.identity.interop.ldap.ControlNotFoundLdapException: Control not found
LDAP error [code: -13]'
com.vmware.identity.interop.ldap.ControlNotFoundLdapException: Control not found
LDAP error [code: -13]
at com.vmware.identity.interop.ldap.LdapErrorChecker$56.RaiseLdapError(LdapErrorChecker.java:768)
at com.vmware.identity.interop.ldap.LdapErrorChecker.CheckError(LdapErrorChecker.java:826)
at com.vmware.identity.interop.ldap.LinuxLdapClientLibrary.CheckError(LinuxLdapClientLibrary.java:1066)
at com.vmware.identity.interop.ldap.LinuxLdapClientLibrary.ldap_one_paged_search(LinuxLdapClientLibrary.java:859)
at com.vmware.identity.interop.ldap.LdapConnection$5.call(LdapConnection.java:651)
at com.vmware.identity.interop.ldap.LdapConnection$5.call(LdapConnection.java:648)
at com.vmware.identity.interop.ldap.LdapConnection.execute(LdapConnection.java:73)
at com.vmware.identity.interop.ldap.LdapConnection.search_one_page_internal(LdapConnection.java:647)
at com.vmware.identity.interop.ldap.LdapConnection.paged_search(LdapConnection.java:597)
at com.vmware.identity.idm.server.provider.ldap.LdapProvider.ldap_search(LdapProvider.java:2236)
at com.vmware.identity.idm.server.provider.ldap.LdapProvider.findUsersInternal(LdapProvider.java:782)
at com.vmware.identity.idm.server.provider.ldap.LdapProvider.findUsers(LdapProvider.java:725)
at com.vmware.identity.idm.server.provider.ldap.LdapProvider.find(LdapProvider.java:1407)
at com.vmware.identity.idm.server.IdentityManager.find(IdentityManager.java:4443)
at com.vmware.identity.idm.server.IdentityManager.find(IdentityManager.java:8963)
at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
at sun.reflect.NativeMethodAccessorImpl.invoke(Unknown Source)
at sun.reflect.DelegatingMethodAccessorImpl.invoke(Unknown Source)
at java.lang.reflect.Method.invoke(Unknown Source)
at sun.rmi.server.UnicastServerRef.dispatch(Unknown Source)
at sun.rmi.transport.Transport$1.run(Unknown Source)
at sun.rmi.transport.Transport$1.run(Unknown Source)
at java.security.AccessController.doPrivileged(Native Method)
at sun.rmi.transport.Transport.serviceCall(Unknown Source)
at sun.rmi.transport.tcp.TCPTransport.handleMessages(Unknown Source)
at sun.rmi.transport.tcp.TCPTransport$ConnectionHandler.run0(Unknown Source)
at sun.rmi.transport.tcp.TCPTransport$ConnectionHandler.run(Unknown Source)
at java.util.concurrent.ThreadPoolExecutor.runWorker(Unknown Source)
at java.util.concurrent.ThreadPoolExecutor$Worker.run(Unknown Source)
at java.lang.Thread.run(Unknown Source)

Any ideas?
Preface
-------

The environment used to write this document is based on pure vSphere 5.1, used in trial mode with vCenter server configured as a virtual appliance.

NOTE: there is a bug in this version of vSphere regarding configuration of OpenLDAP integration in vSphere WebClient, so that you are unable to change Base DN for groups after its initial configuration. In case you need to modify that field, you have to delete and recreate the whole LDAP definition. The bug is solved in vsphere 5.1 update 1a. If anyone wants to test further integration scenarios and also test with vSPhere 5.5, he/she then can report here and I will crosscheck eventually.

IPA components
--------------

To gain interaction of IPA with VMware authentication and authorization system I used the slapi-nis (schema compat) plugin. Initially I tested it on CentOS 6.6 with IPA 3.0.0-42 and slapi-nis-0.40-4 pakages. I was able to get both users and groups enumeration in vSphere client (using _cn=accounts_ for bind definition), but then no authentication of defined users due to inability of IPA 3.0 to do bind on compat tree.

To get the bind on compat tree support I had to use IPA 3.3 and slapi-nis >= 0.47.5. They are provided for example by CentOS 7 with: ipa-server-3.3.3-28.0.1.el7.centos.3.x86\_64 and slapi-nis-0.52-4.el7.x86\_64

So I migrated my IPA test server from CentOS 6.6 to another server in CentOS 7.0, following chapter 6 of this [guide](https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/7/html/Linux_Domain_Identity_Authentication_and_Policy_Guide/upgrading.html)

LDAP tree modification
----------------------

I used two ldif files to adapt schema compat entries for vSphere

### 1) vsphere\_usermod.ldif

dn: cn=users,cn=Schema Compatibility,cn=plugins,cn=config
changetype: modify
add: schema-compat-entry-attribute
schema-compat-entry-attribute: objectclass=inetOrgPerson
-
add: schema-compat-entry-attribute
schema-compat-entry-attribute: sn=%{sn}
-



### 2) vsphere\_groupmod.ldif

dn: cn=groups,cn=Schema Compatibility,cn=plugins,cn=config
changetype: modify
add: schema-compat-entry-attribute
schema-compat-entry-attribute: objectclass=groupOfUniqueNames
-
add: schema-compat-entry-attribute
schema-compat-entry-attribute: uniqueMember=%mregsub("%{member}","^(.\*)accounts(.\*)","%1compat%2")
-

Applied with the following commands:

ldapmodify -x -D "cn=Directory Manager" -f vsphere\_usermod.ldif -W

and

ldapmodify -x -D "cn=Directory Manager" -f vsphere\_groupmod.ldif -W

Permission Update
-----------------

With [FreeIPA 4.0](https://www.freeipa.org/page/Releases/4.0.0 "Releases/4.0.0") and later, system permissions need to be updated to allow the new attributes. Run following commands as admin to allow the new sn attribute for compat users and uniqueMember for compat groups:

\# ipa permission-mod "System: Read User Compat Tree" --includedattrs sn
# ipa permission-mod "System: Read Group Compat Tree" --includedattrs uniquemember

vSphere Configuration
---------------------

The VMware configuration part has to be managed from within vSphere Web Client under Identity Sources row of

Administration -->
Sign-On and Discovery -->
Configuration

My setup is:

Primary server URL: ldaps://c7server.localdomain.local:636
Base DN for users: cn=users,cn=compat,dc=localdomain,dc=local
Domain name: localdomain.local
Base DN for groups: cn=groups,cn=compat,dc=localdomain,dc=local
Authentication type: Password
Username: uid=vadmin,cn=users,cn=compat,dc=localdomain,dc=local

resembled in the image below


.. figure:: Ipa_3.3_with_centos_7_and_vsphere.png
:alt: Ipa_3.3_with_centos_7_and_vsphere.png


Click on _Test Connection_ button to verify parameters are correct.

The _vadmin_ is a normal IPA user I created only for bind with no ESX permissions at all (it is only part of the default ipausers IPA group)

I used the secure protocol with **ldaps://** connection string. I used the file **/etc/ipa/ca.crt** on the IPA server as the certificate to give to vSphere in input; I only needed to copy it to the client where the browser for vSphere Web Client was running and rename it to **ca.cer** without any modification at all. vSphere accepted it without any problem.

Test cases
----------

I successfully executed this set of tests at the moment using both vSphere fat client (5.1 1471691) and vSphere Web Client (Version 5.1.0 Build 869765):

* add gcecchi IPA user at top vcenter server permissions level as a virtual machine user (sample) default role
* verify gcecchi is able to connect both in fat and web clients
* edit settings of the vm VC1 and verify that the "add..." button in hardware tab is greyed out
* add the defined esxpower IPA group at VC1 permissions level granting it the virtual machine power user (sample) role
* logout/login gcecchi and verify nothing changed in his permissions
* add gcecchi to the IPA group esxpower
* logout/login gcecchi and verify the user now can select the "add..." button in hardware tab of VC1
* logout gcecchi and remove gcecchi from IPA group esxpower
* login as gcecchi in vSphere and verify that now the "add..." button is disabled again
* create an IPA group named esxnestedpower and insert it in esxpower group
* login as gcecchi in vSphere and verify he is still unable to add devices
* modify IPA user gcecchi adding him to esxnestedpower group
* logout/login gcecchi from vSphere and verify that now gcecchi is able to add device to VC1


Here below a screenshot with the permissions applied on the virtual machine VC1


.. figure:: Ipa_and_vsphere.png
:alt: Ipa_and_vsphere.png


Further notes due to upgrade from IPA 3.0 to 3.3
------------------------------------------------

My tests began in CentOS 6.6. I noticed that the IPA groups created when in IPA 3.0 and CentOS 6.6 didn't get the uniqueMember property for their group members... I didn't investigate more, but I noticed that instead for the system group "admins" and for newly created groups it was ok. So I recreated the three groups already existing in IPA 3.0. As an alternative, one can think of creating a new group and but inside the old group as a nested group. After my migration from IPA 3.0 to 3.3 it seems I lost dna settings and group addition in IPA failed without explicitly specifying its GID. I solved as described here adding the missing entry **dnaNextRange: 1639600001-1639799999**: [\[1\]](https://www.redhat.com/archives/freeipa-users/2014-December/msg00090.html)

Example outputs from ldapsearch command
---------------------------------------

\[root@c7server \]# ldapsearch -x -b "cn=groups,cn=compat,dc=localdomain,dc=local" cn=esxpower
# extended LDIF
#
# LDAPv3
# base <cn=groups,cn=compat,dc=localdomain,dc=local> with scope subtree
# filter: cn=esxpower
# requesting: ALL
#

# esxpower, groups, compat, localdomain.local
dn: cn=esxpower,cn=groups,cn=compat,dc=localdomain,dc=local
objectClass: posixGroup
objectClass: groupOfUniqueNames
objectClass: top
gidNumber: 1639600010
memberUid: gcecchi
uniqueMember: cn=esxnestedpower,cn=groups,cn=compat,dc=localdomain,dc=local
cn: esxpower

# search result
search: 2
result: 0 Success

# numResponses: 2
# numEntries: 1

\[root@c7server slapd-LOCALDOMAIN-LOCAL\]# ldapsearch -x -b "cn=groups,cn=compat,dc=localdomain,dc=local" cn=esxnestedpower
# extended LDIF
#
# LDAPv3
# base <cn=groups,cn=compat,dc=localdomain,dc=local> with scope subtree
# filter: cn=esxnestedpower
# requesting: ALL
#

# esxnestedpower, groups, compat, localdomain.local
dn: cn=esxnestedpower,cn=groups,cn=compat,dc=localdomain,dc=local
objectClass: posixGroup
objectClass: groupOfUniqueNames
objectClass: top
gidNumber: 1639600012
memberUid: gcecchi
uniqueMember: uid=gcecchi,cn=users,cn=compat,dc=localdomain,dc=local
cn: esxnestedpower

# search result
search: 2
result: 0 Success

# numResponses: 2
# numEntries: 1

\[root@c7server slapd-LOCALDOMAIN-LOCAL\]# ldapsearch -x -b "cn=users,cn=compat,dc=localdomain,dc=local" uid=gcecchi
# extended LDIF
#
# LDAPv3
# base <cn=users,cn=compat,dc=localdomain,dc=local> with scope subtree
# filter: uid=gcecchi
# requesting: ALL
#

# gcecchi, users, compat, localdomain.local
dn: uid=gcecchi,cn=users,cn=compat,dc=localdomain,dc=local
objectClass: posixAccount
objectClass: uniqueMember
objectClass: inetOrgPerson
objectClass: extensibleObject
objectClass: top
objectClass: organizationalPerson
objectClass: person
gecos: Gianluca Cecchi
cn: Gianluca Cecchi
uidNumber: 1639600001
gidNumber: 1639600001
loginShell: /bin/sh
homeDirectory: /home/gcecchi
uid: gcecchi

# search result
search: 2
result: 0 Success

# numResponses: 2
# numEntries: 1

Author
------

Provided by: Gianluca Cecchi

0 comments on commit e0fb4b8

Please sign in to comment.