Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- content:serverbasics:docker-freeipa [2025/03/26 09:07] – [Security: Disable non encrypted access] Daniel
+++ content:serverbasics:docker-freeipa [2025/04/09 15:24] (aktuell) – [Setup your Browser to trust your IPA-Server] Daniel
@@ Zeile 7: / Zeile 7: @@
 This chapter will describe, how to install FreeIPA in a rootless Docker- Environement, use letsencrypt Cretificates for SSL and TLS and how to setup central User- Management with it.
-===== Prerequiusite =====
+===== Prerequisites =====
 You will need a Docker- Host, that is rechable from the Internet with its fully qualifierd Domain- Name (FQDN) as described in the chapters before. The given Ports must be reachable from the clients.
@@ Zeile 244: / Zeile 244: @@
 </file>
-===== What if... =====
+==== What if... ====
 you did not setup that cron or there was an error and now everything is not working any more?
@@ Zeile 256: / Zeile 257: @@
 </code>
-Well, you're in trouble. The only wa, i found out to fix this is to adjust the Hosts time to some time before that expiration- date, start the Container with "DEBUG_NO_EXIT: 1" and run the script manally.
+Well, you're in trouble. The only way, i found to fix this, is to adjust the Hosts time to some time before that expiration- date, start the Container with "DEBUG_NO_EXIT: 1" and run the script manally.
 ===== Web- Gui / Logon =====
-Now, you should be able to login to your instance using User admin and the Password of your docker-compose file at https://ipa.domain.tld
+Now, you should be able to login to your instance using User admin and the Password of your docker-compose file at [[https://ipa.domain.tld|https://ipa.domain.tld]]
 ===== LDAP - Zentrales AD =====
@@ Zeile 269: / Zeile 268: @@
 As of now, you should be able to query the LDAP already with your certificates in Place using your Admin- Password:
 <code>
-docker@servername:~> ldapsearch -xv -W -H ldaps://ipa.domain.tld -b "dc=hosts,dc=domain,dc=tld" -D "cn=Directory Manager" "objectclass=account"
+docker@servername:~> ldapsearch -xv -W -H ldaps://ipa.domain.tld -b "dc=clients,dc=domain,dc=tld" -D "cn=Directory Manager" "objectclass=account"
 ldap_initialize( ldaps://ipa.domain.tld:636/??base )
 Enter LDAP Password:
@@ Zeile 279: / Zeile 278: @@
 #
 # LDAPv3
-# base <dc=hosts,dc=domain,dc=tld> with scope subtree
+# base <dc=clients,dc=domain,dc=tld> with scope subtree
 # filter: objectclass=account
 # requesting: ALL
@@ Zeile 332: / Zeile 331: @@
 <code>
-docker@servername:~> ldapsearch -xv -H ldaps://ipa.domain.tld:636 -b "dc=hosts,dc=domain,dc=tld"
+docker@servername:~> ldapsearch -xv -H ldaps://ipa.domain.tld:636 -b "dc=clients,dc=domain,dc=tld"
 ldap_initialize( ldaps://ipa.domain.tld:636/??base )
 filter: (objectclass=*)
@@ Zeile 339: / Zeile 338: @@
 #
 # LDAPv3
-# base <dc=hosts,dc=domain,dc=tld> with scope subtree
+# base <dc=clients,dc=domain,dc=tld> with scope subtree
 # filter: (objectclass=*)
 # requesting: ALL
@@ Zeile 365: / Zeile 364: @@
 <code>
-docker@servername:~> ldapsearch -xv -H ldaps://ipa.domain.tld:636 -b "dc=hosts,dc=domain,dc=tld"
+docker@servername:~> ldapsearch -xv -H ldaps://ipa.domain.tld:636 -b "dc=clients,dc=domain,dc=tld"
 ldap_initialize( ldaps://ipa.domain.tld:636/??base )
 filter: (objectclass=*)
@@ Zeile 372: / Zeile 371: @@
 #
 # LDAPv3
-# base <dc=hosts,dc=domain,dc=tld> with scope subtree
+# base <dc=clients,dc=domain,dc=tld> with scope subtree
 # filter: (objectclass=*)
 # requesting: ALL
@@ Zeile 385: / Zeile 384: @@
 </code>
 ==== Security: Disable non encrypted access ====
@@ Zeile 392: / Zeile 392: @@
 <code>
-docker@servername:~> ldapsearch -xv -w '123' -H ldap://ipa.domain.tld -b "dc=hosts,dc=domain,dc=tld" -D "cn=Directory Manager"
+docker@servername:~> ldapsearch -xv -w '123' -H ldap://ipa.domain.tld -b "dc=clients,dc=domain,dc=tld" -D "cn=Directory Manager"
 ldap_initialize( ldap://ipa.domain.tld:389/??base )
 ldap_bind: Invalid credentials (49)
@@ Zeile 414: / Zeile 414: @@
 <code>
-docker@pcserver2023:~> ldapsearch -xv -w '123' -H ldap://ipa.domain.tld -b "dc=hosts,dc=domain,dc=tld" -D "cn=Directory Manager"
+docker@pcserver2023:~> ldapsearch -xv -w '123' -H ldap://ipa.domain.tld -b "dc=clients,dc=domain,dc=tld" -D "cn=Directory Manager"
 ldap_initialize( ldap://ipa.domain.tld:389/??base )
 ldap_bind: Confidentiality required (13)
@@ Zeile 424: / Zeile 424: @@
 <code>
-docker@servername:~> ldapsearch -xv -Z -W -H ldap://ipa.domain.tld -b "dc=hosts,dc=domain,dc=de" -D "cn=Directory Manager"
+docker@servername:~> ldapsearch -xv -Z -W -H ldap://ipa.domain.tld -b "dc=clients,dc=domain,dc=de" -D "cn=Directory Manager"
 ldap_initialize( ldap://ipa.domain.tld:389/??base )
 Enter LDAP Password:
@@ Zeile 432: / Zeile 432: @@
 #
 # LDAPv3
-# base <dc=hosts,dc=domain,dc=tld> with scope subtree
+# base <dc=clients,dc=domain,dc=tld> with scope subtree
 # filter: (objectclass=*)
 # requesting: ALL
@@ Zeile 445: / Zeile 445: @@
 </code>
+==== Usage: CN=Config ====
+To see your full config:
+<code>
+docker@servername:~> ldapsearch -xv -H ldaps://ipa.domain.tld:636 -W -b "cn=config" -D "cn=Directory Manager"> cn_config.txt
+</code>
+or only the root-dse with anonymous access:
+<code>
+docker@servername:~> ldapsearch -H ldaps://ipa.domain.tld -x -b "" -s base "objectclass=*"
+# extended LDIF
+#
+# LDAPv3
+# base <> with scope baseObject
+# filter: objectclass=*
+# requesting: ALL
+#
+#
+dn:
+objectClass: top
+...
+</code>
+You will find many docs like [[https://docs.redhat.com/en/documentation/red_hat_directory_server/11/html/administration_guide/examples-of-common-ldapsearches|https://docs.redhat.com/en/documentation/red_hat_directory_server/11/html/administration_guide/examples-of-common-ldapsearches]] in the internet how to use ldap.
+==== Test User- Access ====
+Now you can add an User in the FreeIPA- Web-GUI and test the connection.
+To do this, logon to FreeIPA- Gui as Admin, than create a new user with some stupid password (not the real one!). You may change the e-Mail instantly after creation and don't forget to save after changes at the user.
+Than, logout from FreeIPA and login as your new User. You now need to change the password to the real password you want.
+After that, the LDAP- Query should work. Test it:
+<code>
+docker@servername:~> ldapsearch -xv -W -H ldaps://ipa.domain.tld -b "cn=users,cn=accounts,dc=domain,dc=tld" -D "uid=USERID,cn=users,cn=accounts,dc=domain,dc=tld"
+ldap_initialize( ldaps://ipa.domain.tld:636/??base )
+Enter LDAP Password:
+filter: (objectclass=*)
+requesting: All userApplication attributes
+# extended LDIF
+#
+# LDAPv3
+# base <cn=users,cn=accounts,dc=domain,dc=tld> with scope subtree
+# filter: (objectclass=*)
+# requesting: ALL
+#
+# users, accounts, domain.tld
+dn: cn=users,cn=accounts,dc=domain,dc=tld
+objectClass: top
+objectClass: nsContainer
+cn: users
+...
+# search result
+search: 2
+result: 0 Success
+# numResponses: 4
+# numEntries: 3
+</code>
+==== Jxplorer - GUI for LDAP ====
+A very nice tool for exploring your LDAP- Tree is: [[http://jxplorer.org/index.html|http://jxplorer.org/index.html]]
+===== Port opening =====
+Now, the Server should be secured enough - you can open the firewall at the external ports in docker-compose and test the access from somewhere not in your network.
+===== Central DNS for the Domain =====
+Finally, the Hosts in the Domain will be managed by FreeIPA- DNS- Service, meaning every host that is integrated in the Domain will get a name (can be chosen freely) and will get an host-entry where the secure key for that host is attached to. To get this working, FreeIPAs DNS needs to manage the Sub-Domain you created in dokcer-compose.
+In our Example, the subdamin would be: clients.domain.tld
+Every Host will then get somename.clients.domain.tld as hostname.
+That means, you have to tell your internet DNS- Provider, that clients.domain.tld will be managed by DNS- Server ipa.domain.tld
+This is done by adding an NS- Entry to you Internet-DNS. Please check yout ISP- Docs for how to add that NS entry for your domain:
+<code>
+clients.domain.tld  42363 IN NS ipa.domain.tld.
+</code>
+Check out, if this works by:
+<code>
+dig +noall +answer +multiline clients.domain.tld NS
+</code>
+And at last:
+<code>
+nslookup ipa-ca.clients.domain.tld
+</code>
+This should return the IP of yout IPA- Server. If this works, you are done with the basic setup.
+===== Client Setup =====
+to fully use Single Sign On on your Client, you will need to
+  - Setup your Browser to trust your IPA-Server
+  - Install a working Kerberos-Client and enroll your PC to the Domain
+  - Logon to your Linux- PC using SSSD/Kerberos
+==== Install Kerberos-Client and enroll your PC to the Domain ====
+Currently unfortunatelly i was not able to get Leap 15.6 working with freeipa-client (which worked for 15.5). So i switched to fedora (the KDE- Spin is very nice)
+On Fedora, you can archive the Installation like this (Docs at [[https://www.freeipa.org/page/ConfiguringFedoraClients|https://www.freeipa.org/page/ConfiguringFedoraClients]]
+<code>
+#:> sudo yum install ipa-client
+</code>
+After that, go on with the next chapter https://obel1x.de/dokuwiki/doku.php?id=content:serverbasics:docker-freeipa#integrate_to_the_domain
+----
+Using Ferdora, skip this!
+After a fresh Install of OpenSUSE, you frist need to get the Package freeipa-client.
+I personally made it working that way:
+  * Open Yast
+  * Choose User and Group- Management
+  * Go to Authentication Settings
+  * Select SSSD and Add a new FreeIPA-Domain.
+      * Enable Domain Logons
+      * Create Home-Directory = yes
+      * Sync Users and Groups
+      * SSH + Sudo = yes
+As IPA- Server use ''ipa.domain.tld'', no hostname set. The Network- Domain is ''clients.domain.tld''
+After those settings, exit from Yast. Do not care about Errors, that SSSD is not working: Your Client is missing important Domain Integration, so the service will fail.
+As the time beeing, there is no official Package for Leap 15.6. So you may use mine:
+<code>
+zypper addrepo https://download.opensuse.org/repositories/home:obel1x/15.6/home:obel1x.repo
+zypper refresh
+zypper install freeipa-client
+#Add Additional Packages / setup some needed files
+pip3 install ifaddr
+ln /usr/lib/mit/bin/kdestroy /usr/bin/kdestroy
+</code>
+=== Integrate to the Domain ===
+After that, you need to setup your Client maybe with this small script, called ipa_register_host.sh which you can put to /root:
+<file>
+#!/bin/bash
+TLDOMAIN=domain.tld
+DOMAIN=clients.${TLDOMAIN}
+SERVERFQDN=ipa.${TLDOMAIN}
+#Serialnr of this device
+HOSTNM=pc$(dmidecode -t system|grep -i "serial"|sed 's/Serial Number: //'|xargs|cut -c1-60|tr '[:upper:]' '[:lower:]'|sed 's/[^0-9a-z]*//g')
+FQDN=${HOSTNM}.${DOMAIN}
+echo "${FQDN} wird der Domain ${DOMAIN} hinzugefügt"
+hostnamectl set-hostname ${HOSTNM}
+#Check, if hostname is resolvable to this host - if not, add entry to /etc/hosts
+if ! grep -q ${FQDN} "/etc/hosts"; then
+  echo "Adding Host ${FQDN} to /etc/hosts"
+  echo "">>"/etc/hosts"
+  echo "127.0.0.1   ${FQDN} ${HOSTNM}">>"/etc/hosts"
+fi
+INSTCMD="ipa-client-install --mkhomedir --force-join --no-ntp --principal=admin --domain=${DOMAIN} --server=${SERVERFQDN} --hostname=${FQDN}"
+echo ${INSTCMD}
+${INSTCMD}
+echo "Ende Installation, sie können das Fenster schließen"
+</file>
+This script will integrate your PC into your IPA- Domain. Have the Password of your IPA- Admin ready.
+After that, the SSSD should start, you may start, check and enable the Service.
+ <font 18px/inherit;;#e74c3c;;inherit>ATTENTION: When you now restart your PC and you have only WLAN enabled, the login WILL FAIL, because WLAN is activated AFTER logon. So SSSD cannot check your Domain and your Account and thus user logon will fail.</font>
+To prevent this, use a network- cable and configure Networking at system start, OR configure your wireless lan to be setup first. Or first logon as root, then as User.
+You should frist check on non-graphical terminal if this will work, because errors will be shown there. Good Luck.
+==== Setup your Browser to trust your IPA-Server ====
+This one is on Firefox, as it works.
+Go to your IPAs ipa.domain.tld/ipa/config/ssbrowser.html website. You can also find the LInk at the initial Logon-Page.
+For me, the Button ''Import Certificate'' did not install automagically - use right- click and save to a file named ipa.crt.
+Than open Firefox settings, Privacy and Security, Authorities- Tab and select Import. Use the downloaded file and select all Checkboxes. This installs your IPA- Authority to your Browser as trusted CA.
+Do Steps 2 - 5 as described.
+After that, and after loggon to your pc with your FreeIPA-User, the User should automagically be logged on when you open ipa.domain.tld.
+If not, check if your klist shows some vaild Tickets. Otherwise inspect if this works:
+<code>
+HOSTNAME:~ # kinit admin
+Password for admin@DOMAIN.TLD:
+HOSTNAME:~ # klist
+Ticket cache: KEYRING:persistent:0:0
+Default principal: admin@DOMAIN.TLD
+Valid starting     Expires            Service principal
+/07/25 12:58:27  04/08/25 12:40:12  krbtgt/DOMAIN.TLD@DOMAIN.TLD
+</code>
+This should be all needed to work for Firefox.
+==== Setup Sudoers with FreeIPA/SSSD ====
+This is quite a cool feature to have client admin- users managed by putting them in an IPA- group. When Loggin in with SSSD they will get added to the sudoers, making them admin on the given machines. Check this out: [[https://www.howtoforge.de/anleitung/wie-integriere-ich-sudoers-in-den-freeipa-server/|https://www.howtoforge.de/anleitung/wie-integriere-ich-sudoers-in-den-freeipa-server/]]
+===== Next Steps =====
+Next, you can integrate a Middleware for Authentication. You could, but you should NOT use FreeIPAs LDAP- Service directly as Authentication- Source for anything, as LDAP is very costy and would not deliver all needed APIs e.g. for SSO. This is part of your Middleware, so checkout [[.:docker-authentik|]] to read further.