Editing Test Day:2013-05-09 SSSD Improvements and AD Integration

{{Infobox_group
| name = Fedora 19 Test Days
| image = [[File:Echo-testing-48px.png|link=QA/Fedora_19_test_days]]
| caption =  Enterprise accounts
| date = 2013-05-09
| time = all day
| website = [http://www.freedesktop.org/software/realmd/ realmd] [http://fedorahosted.org/sssd/ SSSD project], [http://fedoraproject.org/wiki/Features/SSSDImproveADIntegration Feature page]
| irc = [irc://irc.freenode.net/#sssd #sssd] ([http://webchat.freenode.net/?channels=sssd webirc], [irc://irc.freenode.net/#fedora-test-day #fedora-test-day] ([http://webchat.freenode.net/?channels=fedora-test-day webirc]))
}}

{{admon/note | Can't make the date? | If you come to this page before or after the test day is completed, your testing is still valuable, and you can use the information on this page to test, file any bugs you find, and add your results to the results section.}}

== What to test? ==
Today's Test Day will be focused on new features related to using enterprise accounts (coming from either Active Directory or FreeIPA), in particular '''realmd''' and '''adcli''' to join a machine to a domain and '''sssd''' to handle authentication and other related tasks.

== Who's available ==
* Development: [[User:stefw|Stef Walter]] (stefw, realmd/adcli dev), [[User:jhrozek|Jakub Hrozek]] (jhrozek, sssd dev)
* Quality Assurance: [[User:pkis|Patrik Kis]] (pkis), [[User:dspurek|Davis Spurek]] (dspurek), [[User:kaushik|Kaushik Banerjee]] (kaushik)

== Prerequisite for Test Day ==

* You may download a non-destructive Fedora 19 live image for your architecture. Tips on using a live image are available at [[FedoraLiveCD]].
{|
! Architecture !! SHA256SUM 
|- 
| [http://fedorapeople.org/groups/qa/testday-20130509-2-x86_64.iso x86_64] || 720f0cb153aac8ae2e55629ec4a50e1c3f53a5fbe4b2ce65f1d6792b15af94b0
|-
| [http://fedorapeople.org/groups/qa/testday-20130509-2-i686.iso i686] || 29d7de49bd77760299924f90e9f732d60892766ff32318f5fac5dcbb4089073e
|}

* If you don't want to use the LiveCD, you can use an updated [http://fedoraproject.org/get-prerelease Fedora 19 pre-release]
** Make sure that the following components are installed:
*** '''adcli-0.7-1.fc19'''
*** '''realmd-0.14.0-1.fc19'''
*** '''sssd-1.10.0-4.fc19.beta1'''
*** '''selinux-policy-3.12.1-42.fc19'''
* A server to test against. Most test cases require an [https://fedoraproject.org/wiki/QA:Testcase_Active_Directory_Setup Active Directory domain], other tests require a [https://fedoraproject.org/wiki/QA:Testcase_freeipav3_installation FreeIPA server]. Don't worry if you don't have both, any involvement in the test day is much appreciated!
* Domain user account or administrator account on the given Active Directory domain. See table below for which test cases require which privileges.
* If you are on Red Hat internal network you can test against our internal '''Test Bed''': [[Test Day:2013-05-09 Red Hat Test Bed]]. Please note that the Test Bad doesn't have all capabilities which are required to run all test cases. While all test cases which requires administrator privileges and posix users are supported, the test cases with privileges listed below can't be run against the Test Bad (please skip them). In some cases you might need to contact the Test Bed admins to perform some special configuration; please contact pkis or dspurek.

== How to test ==
At a high level the following are being tested:

* realmd used together with Active Directory or FreeIPA
* adcli used together with Active Directory
* latest Kerberos improvements
* sssd used together with Active Directory or FreeIPA

You can explore these, and their documentation. Or you can follow the test cases below.

There are many test cases, if you don't have a particular area of special interest, '''start from the top'''. The most common and simpler scenarios are generally in the earlier test cases.

All tests should pass with '''SELinux in enforcing mode''' unless otherwise specified.

== Tests: Kerberos ==

These are tests that test basic kerberos functionality, including fixes that have been worked on to make using kerberos less brittle. Perform [[QA:Testcase_kerberos_setup|prerequisite setup]] before you run these tests.

{| class="wikitable" style="width:100%" border="1"
!style="width:20%"|Testcase
!style="width:58%"|Description
!style="width:12%"|Privileges
!style="width:10%"|Duration
|-  
| [[QA:Testcase_kerberos_without_krb5_conf|noconf]] 
| Using Active Directory without krb5.conf
| Any
| 5 minutes
|-
|-
| [[QA:Testcase_kerberos_unsynced_clocks|clocks]] 
| Kerberos client with unsynced clocks
| Any
| 5 minutes
|-
|-
| [[QA:Testcase_kerberos_reverse_dns|rdns]] 
| Kerberos client without reverse DNS
| Any
| 5 minutes
|-
|}

File bugs for these test cases in the 
[https://bugzilla.redhat.com/enter_bug.cgi?product=Fedora&component=krb5 Red Hat bugzilla], and record results below.

{|
! User
| [[QA:Testcase_kerberos_without_krb5_conf|noconf]] 
| [[QA:Testcase_kerberos_unsynced_clocks|clocks]] 
| [[QA:Testcase_kerberos_reverse_dns|rdns]] 
! References
|-
| [[User:SampleUser|Sample User]]
| {{result|pass}}
| {{result|none}}
| {{result|fail}} <ref>{{bz|12345}}</ref>
| <references/>
|-
|-
| [[User:stefw|stefw]]
| {{result|pass}}
| {{result|pass}}
| {{result|pass}}
| <references/>
|-
| [[User:dspurek|dspurek]]
| {{result|pass}}
| {{result|fail}} <ref>{{bz|961221}}</ref>
| {{result|}} 
| <references/>
|-
| [[User:kaushikub|kaushik]]
| {{result|pass}}
| {{result|fail}} 
| {{result|pass}} 
| <references/>
|-
| [[User:okos|okos]]
| {{result|pass}}
| {{result|pass}}
| {{result|pass}}
| <references/>
|-
| [[User:Omoris|omoris]]
| {{result|pass}}
| {{result|pass}}
| {{result|none}}
| <references/>
|-
| [[User:pkis|pkis]]
| {{result|fail}} <ref>{{bz|961235}}</ref>
| {{result|none}}
| {{result|none}}
| <references/>
|-
| [[User:alich|alich]]
| {{result|fail}} <ref>{{bz|961235}}</ref>
| {{result|none}}
| {{result|none}}
| <references/>
|-
|}


<p>&nbsp;</p>
<p>&nbsp;</p>
<p>&nbsp;</p>
<p>&nbsp;</p>

== Tests: Basics of sssd and realmd ==

These tests cover the basics of realmd being used for configuring domain authentication, and sssd providing that authentication.

{| class="wikitable" style="width:100%" border="1"
!style="width:20%"|Testcase
!style="width:58%"|Description
!style="width:12%"|Privileges
!style="width:10%"|Duration
|-
| [[QA:Testcase_realmd_discovery|discover domain]]
| Using realmd to discover information about an Active Directory domain
| Any
| 5 minutes
|-
|-
| [[QA:Testcase_realmd_discover_single|discover server]]
| Using realmd to discover information about an Active Directory server
| Any
| 5 minutes
|-
|-
| [[QA:Testcase_realmd_join_sssd|join domain]]
| Using realmd to join a domain using standard options and configure sssd
| Admin account
| 15 minutes
|-
|-
| [[QA:Testcase_realmd_leave|leave domain]]
| Using realmd to leave a domain and deconfigure sssd
| Any
| 10 minutes
|-
|-
| [[QA:Testcase_realmd_join_otp|join otp]]
| Using realmd to join a domain using a one time password
| Admin account
| 15 minutes
|-
|-
| [[QA:Testcase_realmd_leave_remove|leave remove]]
| Using realmd to leave a domain, removing the computer account, and deconfigure sssd
| Any
| 10 minutes
|-
|-
| [[QA:Testcase_realmd_login|login domain]]
| After joining a domain, log in using domain credentials
| User and admin account
| 10 minutes
|-
|-
| [[QA:Testcase_sssd_ad_dns_update|dns update]]
| Verifies an AD client is able to update its DNS record. 
| Joined to a domain
| 20 minutes
|-
|}

Please file bugs in the [https://bugzilla.redhat.com/enter_bug.cgi?product=Fedora&component=realmd Red Hat bugzilla], and create a table line below for your test results.

{|
! User
| [[QA:Testcase_realmd_discovery|discover domain]]
| [[QA:Testcase_realmd_discover_single|discover server]]
| [[QA:Testcase_realmd_join_sssd|join domain]]
| [[QA:Testcase_realmd_leave|leave domain]]
| [[QA:Testcase_realmd_join_otp|join otp]]
| [[QA:Testcase_realmd_leave_remove|leave remove]]
| [[QA:Testcase_realmd_login|login domain]]
| [[QA:Testcase_sssd_ad_dns_update|dns update]]
! References
|-
| [[User:SampleUser|Sample User]]
| {{result|none}}
| {{result|pass}}
| {{result|warn}} <ref>Test pass, {{bz|54321}}</ref>
| {{result|fail}} <ref>{{bz|12345}}</ref>
| {{result|none}}
| {{result|none}}
| {{result|none}}
| {{result|none}}
| <references/>
|-
|-
| [[User:stefw|stefw]]
| {{result|warn}} <ref>{{bz|961230}}</ref>
| {{result|pass}}
| {{result|warn}} <ref>{{bz|961235}}</ref>
| {{result|pass}}
| {{result|warn}} <ref>{{bz|961230}}</ref>
| {{result|warn}} <ref>{{bz|961244}}</ref>
| {{result|fail}} <ref>{{bz|961246}}</ref> <ref>{{bz|961251}}</ref>
| {{result|warn}} <ref>{{bz|961264}}</ref>
| <references/>
|-
| [[User:dspurek|dspurek]]
| {{result|pass}}
| {{result|pass}}
| {{result|pass}}
| {{result|pass}}
| {{result|pass}}
| {{result|pass}}
| {{result|fail}} <ref>{{bz|961246}}</ref> <ref>{{bz|961251}}</ref>
| {{result|none}}
| <references/>
|-
| [[User:okos|okos]]
| {{result|warn}} <ref>{{bz|961230}}</ref>
| {{result|pass}}
| {{result|warn}} <ref>{{bz|961235}}</ref>
| {{result|pass}}
| {{result|warn}} <ref>{{bz|961230}}</ref>
| {{result|warn}} <ref>{{bz|961244}}</ref>
| {{result|none}}
| {{result|none}}
| <references/>
|-
| [[User:kaushikub|Kaushik]]
| {{result|warn}} <ref>{{bz|961254}}</ref>
| {{result|none}}
| {{result|none}} 
| {{result|none}}
| {{result|none}}
| {{result|none}}
| {{result|none}}
| {{result|none}}
| <references/>
|-
|}

<p>&nbsp;</p>
<p>&nbsp;</p>
<p>&nbsp;</p>
<p>&nbsp;</p>

== Tests: Integration of realmd ==

These tests test integration of realmd with several of its clients and callers. Each test has a few extra or differing requirements, which you should be on the lookout for in the setup section of the test.

{| class="wikitable" style="width:100%" border="1"
!style="width:20%"|Testcase
!style="width:58%"|Description
!style="width:12%"|Privileges
!style="width:10%"|Duration
|-
|-
| [[QA:Testcase_realmd_join_kickstart|kickstart]]  
| Use anaconda and kickstart to join a domain during installation.
| Admin account
| 45 minutes
|-
|-
| [[QA:Testcase_realmd_control_center|control center]]  
| Use control center to add an Enterprise Login from a domain.
| User or admin account
| 20 minutes
|-
|-
| [[QA:Testcase_realmd_gdm_screen|gdm screen]]  
| Check the GDM login screen domain hints
| Joined to a domain
| 10 minutes
|-
|-
| [[QA:Testcase_realmd_join_openlmi|openlmi]]  
| Use the OpenLMI realmd CIM provider to join a domain
| Admin account
| 30 minutes
|-
|}

Please file bugs in the [https://bugzilla.redhat.com/enter_bug.cgi?product=Fedora&component=realmd Red Hat bugzilla], and create a table line below for your test results. Bugs will be reassigned when appropriate to other components.

{|
! User
| [[QA:Testcase_realmd_join_kickstart|kickstart]]
| [[QA:Testcase_realmd_control_center|control center]]
| [[QA:Testcase_realmd_gdm_screen|gdm screen]]
| [[QA:Testcase_realmd_join_openlmi|openlmi]]
! References
|-
| [[User:SampleUser|Sample User]]
| {{result|none}}
| {{result|pass}}
| {{result|warn}} <ref>Test pass, {{bz|54321}}</ref>
| {{result|fail}} <ref>{{bz|12345}}</ref>
| <references/>
|-
|-
| [[User:stefw|stefw]]
| {{result|none}}
| {{result|none}}
| {{result|none}}
| {{result|fail}} <ref>{{bz|961225}}</ref> <ref>{{bz|961228}}</ref>
| <references/>
|-
|}

<p>&nbsp;</p>
<p>&nbsp;</p>
<p>&nbsp;</p>
<p>&nbsp;</p>

== Advanced Tests: sssd and realmd ==

These are additional advanced tests which could be completed after the above, these go into further detail about various aspects of sssd and realmd usage. As each test requires that you have access to Active Directory, you can through that [[QA:Testcase_Active_Directory_Setup|prerequisite setup]] before you start.

{| class="wikitable" style="width:100%" border="1"
!style="width:20%"|Testcase
!style="width:58%"|Description
!style="width:12%"|Privileges
!style="width:10%"|Duration
|-
|-
| [[QA:Testcase_sssd_ad_dns_sites|site disco]]
| Verifies an AD client is able to connect to a particular DNS site as defined on the AD server 
| Requires a joined client
| 20 minutes
|-
|-
| [[QA:Testcase_sssd_ad_discover_netbios_name|netbios disco]]
| This test case verifies an Active Directory client is able to discover the NetBIOS name automatically
| Requires a joined client
| 15 minutes
|-
|-
| [[QA:Testcase_realmd_login_any|login any]]
| Allow any domain user to log into local machine
| User and admin account
| 15 minutes
|-
|-
| [[QA:Testcase_realmd_login_withdraw|login withdraw]]  
| Withdraw access to a user to log into the machine
| User and admin account
| 15 minutes
|-
|-
| [[QA:Testcase_realmd_login_deny_any|deny any]]  
| Deny any domain logins to the machine
| User and admin account
| 15 minutes
|-
|-
| [[QA:Testcase_realmd_join_ccache|join ccache]]  
| Join the current machine to an Active Directory domain using kerberos credentials already acquired before the join.
| Administrator
| 10 minutes
|-
|-
| [[QA:Testcase_realmd_join_os|join osinfo]]  
| Join the current machine to an Active Directory, and set the operating system name and version of the account. 
| Administrator
| 10 minutes
|-
|-
| [[QA:Testcase_realmd_join_packages|join packages]]  
| Join the current machine to an Active Directory, and prevent automatic installation of packages. 
| Administrator
| 10 minutes
|-
|-
| [[QA:Testcase_realmd_join_qualify|join names]]  
| Join the current machine to an Active Directory, without using fully qualified user names.
| Administrator
| 10 minutes
|-
|-
| [[QA:Testcase_realmd_join_rfc2307|join posix]]
| Join the current machine to an Active Directory, but use the POSIX attributes in the directory.
| Administrator or user with posix attributes
| 10 minutes
|-
|-
| [[QA:Testcase_realmd_join_server|join server]]
| Join the current machine to an Active Directory, manually specifying the domain server you want to join against.
| Administrator
| 10 minutes
|-
|-
| [[QA:Testcase_realmd_join_upn|join upn]]
| Join the current machine to an Active Directory, while creating a userPrincipalName.
| Administrator
| 10 minutes
|-
|}

Bugs can be filed in the Red Hat bugzilla for [https://bugzilla.redhat.com/enter_bug.cgi?product=Fedora&component=realmd sssd] or  [https://bugzilla.redhat.com/enter_bug.cgi?product=Fedora&component=realmd realmd] components. Please create a row in the table below for your testing.
 
{|
! User
| [[QA:Testcase_sssd_ad_dns_sites|site disco]]
| [[QA:Testcase_sssd_ad_discover_netbios_name|netbios disco]]
| [[QA:Testcase_realmd_login_any|login any]]
| [[QA:Testcase_realmd_login_withdraw|login withdraw]]  
| [[QA:Testcase_realmd_login_deny_any|deny any]]  
| [[QA:Testcase_realmd_join_ccache|join ccache]]  
| [[QA:Testcase_realmd_join_os|join osinfo]]  
| [[QA:Testcase_realmd_join_packages|join packages]]  
| [[QA:Testcase_realmd_join_qualify|join names]]  
| [[QA:Testcase_realmd_join_rfc2307|join posix]]  
| [[QA:Testcase_realmd_join_server|join server]]
| [[QA:Testcase_realmd_join_upn|join upn]]
! References
|-
| [[User:SampleUser|Sample User]]
| {{result|none}} 
| {{result|pass}}
| {{result|warn}} <ref>Test pass, {{bz|54321}}</ref>
| {{result|fail}} <ref>{{bz|12345}}</ref>
| {{result|none}}
| {{result|none}}
| {{result|none}}
| {{result|none}} 
| {{result|none}} 
| {{result|none}} 
| {{result|none}} 
| {{result|none}} 
| <references/>
|-
|}

<p>&nbsp;</p>
<p>&nbsp;</p>
<p>&nbsp;</p>
<p>&nbsp;</p>

== Advanced Tests: adcli ==

adcli is a component that realmd uses to talk to Active Directory.

To run these test cases you need to [[QA:Testcase_adcli_setup|fulfill these prerequisites]]. In addition, further [[Category:Adcli_Test_Cases|test cases are available]] for using adcli with complex domains.


{| class="wikitable sortable" style="width:100%" border="1"
!style="width:20%"|Testcase
!style="width:58%"|Description
!style="width:12%"|Privileges
!style="width:10%"|Approx. time required
|-  
| [[QA:Testcase_adcli_info|info domain]] 
| This test case retrieves basic information about a domain. 
| Any
| 5 minutes
|-
|-  
| [[QA:Testcase_adcli_info_server|info server]] 
| This test case retrieves basic information about a domain controller and the domain it is a part of.
| Any
| 5 minutes
|-
|-  
| [[QA:Testcase_adcli_join_simple|join simple]] 
| This test case verifies that adcli join works with basic options.
| Administrator
| 5 minutes
|-
|-  
| [[QA:Testcase_adcli_join_nodns|join nodns]] 
| his test case verifies that adcli join can work without DNS.
| Administrator
| 5 minutes
|-
|-  
| [[QA:Testcase_adcli_preset_auto|preset auto]] 
| This test case precreates accounts in the domain using adcli join, using the default automatic 'reset' computer account password.
| Administrator
| 5 minutes
|-
|-  
| [[QA:Testcase_adcli_preset_otp|preset otp]] 
| This test case precreates accounts in the domain using adcli join.
| Administrator
| 5 minutes
|-
|}


Please file bugs in the [https://bugzilla.redhat.com/enter_bug.cgi?product=Fedora&component=adcli Red Hat bugzilla], and create a table line below for your test results.

{|
! User
| [[QA:Testcase_adcli_info|info domain]] 
| [[QA:Testcase_adcli_info_server|info server]] 
| [[QA:Testcase_adcli_join_simple|join simple]] 
| [[QA:Testcase_adcli_join_nodns|join nodns]] 
| [[QA:Testcase_adcli_preset_auto|preset auto]] 
| [[QA:Testcase_adcli_preset_otp|preset otp]] 
! References
|-
| [[User:SampleUser|Sample User]]
| {{result|none}}
| {{result|pass}}
| {{result|warn}} <ref>Test pass, {{bz|54321}}</ref>
| {{result|fail}} <ref>{{bz|12345}}</ref>
| {{result|none}}
| {{result|none}}
| <references/>
|-
|}

<p>&nbsp;</p>
<p>&nbsp;</p>
<p>&nbsp;</p>
<p>&nbsp;</p>

== Advanced Tests: With FreeIPA ==

{| class="wikitable sortable" style="width:100%" border="1"
!style="width:20%"|Testcase
!style="width:58%"|Description
!style="width:12%"|Privileges
!style="width:10%"|Approx. time required
|-  
| [[QA:Testcase_FreeIPA_realmd_join|join]] 
| Join a client machine to a domain
| admin
| 10 minutes
|-
| [[QA:Testcase_FreeIPA_realmd_login|login]] 
| Log in using FreeIPA credentials, both online and offline
| admin
| 15 minutes
|-
|-
| [[QA:Testcase_FreeIPA_realmd_sudo|sudo]] 
| Test FreeIPA's sudo management capabilities
| admin
| 10 minutes
|-
|-
| [[QA:Testcase_FreeIPA_realmd_ssh|ssh]] 
| Verify FreeIPA's SSH public key management
| admin
| 20 minutes
|-
|-
| [[QA:Testcase_FreeIPA_realmd_automount|automount]] 
| Test FreeIPA's automounter maps management
| admin
| 20 minutes
|-
|-
| [[QA:Testcase_FreeIPA_realmd_leave|leave]] 
| Leave a FreeIPA domain by deconfiguring it locally. 
| Any
| 5 minutes
|-
|}

* [https://bugs.freedesktop.org/enter_bug.cgi?product=realmd realmd bugzilla]  
* [https://bugzilla.redhat.com Red Hat bugzilla]
* [https://fedorahosted.org/sssd SSSD Trac]

{|
! User
| [[QA:Testcase_FreeIPA_realmd_join|FreeIPA join]] 
| [[QA:Testcase_FreeIPA_realmd_login|FreeIPA login]] 
| [[QA:Testcase_FreeIPA_realmd_ssh|FreeIPA SSH]] 
| [[QA:Testcase_FreeIPA_realmd_automount|FreeIPA automount]] 
| [[QA:Testcase_FreeIPA_control_center|FreeIPA control center]] 
| [[QA:Testcase_FreeIPA_realmd_leave|FreeIPA leave]] 
! References
|-
| [[User:SampleUser|Sample User]]
| {{result|none}} 
| {{result|pass}}
| {{result|warn}} <ref>Test pass, {{bz|54321}}</ref>
| {{result|fail}} <ref>{{bz|12345}}</ref>
| {{result|none}}
| {{result|none}}
| <references/>
|-
| [[User:steeve|Steeve]]
| {{result|pass}} 
| {{result|none}}
| {{result|none}}
| {{result|none}}
| {{result|none}}
| {{result|none}}
| <references/>
|-
|}

[[Category:Test Days]]
[[Category:QA Templates]]