Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.
Red Hat Satellite engineering is moving the tracking of its product development work on Satellite to Red Hat Jira (issues.redhat.com). If you're a Red Hat customer, please continue to file support cases via the Red Hat customer portal. If you're not, please head to the "Satellite project" in Red Hat Jira and file new tickets here. Individual Bugzilla bugs will be migrated starting at the end of May. If you cannot log in to RH Jira, please consult article #7032570. That failing, please send an e-mail to the RH Jira admins at rh-issues@redhat.com to troubleshoot your issue as a user management inquiry. The email creates a ServiceNow ticket with Red Hat. Individual Bugzilla bugs that are migrated will be moved to status "CLOSED", resolution "MIGRATED", and set with "MigratedToJIRA" in "Keywords". The link to the successor Jira issue will be found under "Links", have a little "two-footprint" icon next to it, and direct you to the "Satellite project" in Red Hat Jira (issue links are of type "https://issues.redhat.com/browse/SAT-XXXX", where "X" is a digit). This same link will be available in a blue banner at the top of the page informing you that that bug has been migrated.

Bug 1206138

Summary: [doc] Documentation needed for sat61 AD Direct Integration with GSS-Proxy
Product: Red Hat Satellite Reporter: Kedar Bidarkar <kbidarka>
Component: DocumentationAssignee: Peter Ondrejka <pondrejk>
Status: CLOSED CURRENTRELEASE QA Contact: Tahlia Richardson <trichard>
Severity: medium Docs Contact:
Priority: unspecified    
Version: 6.1.0CC: greartes, hhudgeon, jpazdziora, kbidarka
Target Milestone: UnspecifiedKeywords: Reopened
Target Release: Unused   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2015-08-12 11:49:30 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:
Attachments:
Description Flags
Satellite61 AD Integration with GSS-Proxy
none
[Updated] Satellite61 AD Integration with GSS-Proxy none

Description Kedar Bidarkar 2015-03-26 12:28:35 UTC
Created attachment 1006779 [details]
Satellite61 AD Integration with GSS-Proxy

Document URL: 

I have attached the documentation "Satellite61_Active_Directory_Integration_with_gss_proxy.txt'

This documentation is being updated here, after collecting the relevant information from various sources.



Section Number and Name: 

Describe the issue: 
Currently there is no document to help with the integration process.

Suggestions for improvement: 

Additional information: 

This document should help people integrate the Satellite6.1 with Active Directory.
This will allow the ActiveDirectory users, to login to Satellite6.1 WebUI (without the need to fill the login form) via SSO, using realmd, kerberos, SSSD.

Comment 1 Kedar Bidarkar 2015-03-26 12:34:55 UTC
Created attachment 1006786 [details]
[Updated] Satellite61 AD Integration with GSS-Proxy

Please use this latest doc, which is now updated after corrections.

Comment 2 Athene Chan 2015-03-27 04:55:55 UTC
Hi Kedar,

Thank you! Possible 6.1 if it ties in to the active directory requirements we might have. I am assigning this to Megan.

Cheers,
Athene

Comment 3 Jan Pazdziora (Red Hat) 2015-03-30 09:42:24 UTC
Ad step 2 b) -- please note that you need to have krb5-workstation to be able to run that klist command.

Comment 4 Jan Pazdziora (Red Hat) 2015-04-02 13:01:03 UTC
Ad KrbLocalUserMapping -- it is possible to keep it on the On value that --foreman-ipa-authentication=true puts there, no change to Off is needed.

What you need to do instead is to add to the beginning of /etc/krb5.conf directive

  includedir /var/lib/sss/pubconf/krb5.include.d/

We track that in bug 1207552.

So the net result is that no modification to auth_kerb.conf is needed, neither for the setup without GSS-Proxy, nor the setup with GSS-Proxy, because KrbLocalUserMapping can stay at On and the Krb5KeyTab line can stay there as well -- the most important is to remove the actual /etc/httpd/conf/http.keytab when setting up the GSS-Proxy. And if you remove the keytab using

  rm -f /etc/httpd/conf/http.keytab && touch /etc/httpd/conf/http.keytab

even subsequent katello-install runs will pass and keep things sane, without attempting to run ipa-getkeytab to re-retrieve it again, which would obviously fail for the direct AD integration scenario when there is no IPA there.

Comment 5 Jan Pazdziora (Red Hat) 2015-04-03 10:36:12 UTC
Please note that this bugzilla is likely blocked by bug 1132527 -- we really want the --foreman-ipa-authentication=true option documented for its primary use before describing this setup without IdM/IPA.

Comment 7 RHEL Program Management 2015-04-21 16:05:03 UTC
Since this issue was entered in Red Hat Bugzilla, the release flag has been
set to ? to ensure that it is properly evaluated for this release.

Comment 10 Kedar Bidarkar 2015-07-01 16:08:48 UTC
We can only find the file /etc/httpd/conf.d/05-foreman-ssl.d/auth_kerb.conf , after running the "katello-installer" command.

But we do not want the users to edit the above file, So no need to remove the Krb5KeyTab line. Reasons given above as per comment 4 of this bug. An alternate method of getting things to work without editing the file, have already been suggested in comment4 and have been properly updated in the Draft.

Looks like we have missed this step:

From the attached file by me above,
------------------------
7) Place the keytab file created in step 5) at /etc/httpd/conf/http.keytab , with permissions for apache.

'chown apache /etc/httpd/conf/http.keytab'

NOTE: we need to copy /etc/gssproxy/http.keytab and place at /etc/httpd/conf/http.keytab
------------------------

Above step should have been added between Step 4) and step 5) of "procedure 20.4"To Configure Direct AD Integration:, without which step 5) is bound to fail with missing /etc/httpd/conf/http.keytab.


I need to go through the draft in more detail, but these are things which can think of currently.

Comment 11 Kedar Bidarkar 2015-07-01 16:11:04 UTC
I see little changes in the draft, but I will test it out once as it is as per draft and update my findings here soon. I believe that should help.

Comment 12 Kedar Bidarkar 2015-07-02 12:07:59 UTC
Corrections for "proecedure 20.5" To Configure GSS Proxy for Direct AD Integration:

a) The below step 5)  needs to be removed from the docs Draft.

Remove the Krb5KeyTab line from the /etc/httpd/conf.d/05-foreman-ssl.d/auth_kerb.conf. 


b) We need to add the below statement for step 2), as to where the entry needs to be updated to  /etc/gssproxy/gssproxy.conf.


This section has to be before any section which might have allow_any_uid = yes, namely gssproxy-0.3.0 in its service/nfs-client:

c) Another correction required, my attached doc too had this entry, but now this needs to be removed from step 7)

# systemctl enable httpd.service