From Fedora Project Wiki

(Update requirements)
(revise somewhat for use as a release validation test case)
Line 1: Line 1:
{{Template:Associated_release_criterion|Beta|domain-access-control}}
{{QA/Test_Case
{{QA/Test_Case
|description=Check that FreeIPA's HBAC rules are respected after using realmd to join the current machine to a FreeIPA domain.  
|description=This test case checks that a system enrolled in a FreeIPA domain honors the domain controller's host-based access control (HBAC) rules.
|setup=
|setup=
# If you haven't already, run through the [[QA:Testcase_FreeIPA_realmd_join|test case to join the domain]].
{{FreeIPA server client setup}}
 
|actions=
# The intent here is to set up an HBAC rule which specifies that all access is prohibited, unless it is initiated by a specific user ("testuser")
# The intent here is to set up an HBAC rule which specifies that all access is prohibited, unless it is initiated by a specific user ("testuser")
# Make sure you have freeipa-admintools installed
# Make sure you have freeipa-admintools installed
Line 20: Line 20:
#: You will be prompted to enter a new password here
#: You will be prompted to enter a new password here


|results=
|actions=
# On the system that joined the domain, switch to another VT (press <code>Ctrl-Alt-F4</code>).
# On the system that joined the domain, switch to another VT (press <code>Ctrl-Alt-F4</code>).
# Log in as the admin should fail.
# Try to log in as the admin user.
#: <pre>host login: admin@ipa.example.org</pre>
#: <pre>host login: admin@ipa.example.org</pre>
#: You should see 'Permission Denied' appear for a second or two
# Now try to log in as test user.
#: Login should not be possible
# Now log in as test user, this should succeed.
#: <pre>host login: testuser@ipa.example.org</pre>
#: <pre>host login: testuser@ipa.example.org</pre>
#: The login should complete, and you should get to a standard unix shell prompt.
 
|results=
# Log in as the admin user must fail, and log in as the test user must succeed.
}}
}}


Line 43: Line 43:


== Clean-up after the test ==
== Clean-up after the test ==
Enable the ''allow_all'' rule again to avoid interference with other Test cases:
Enable the ''allow_all'' rule again to avoid interference with other tests:


  $ kinit admin
  $ kinit admin
  $ ipa hbacrule-enable allow_all
  $ ipa hbacrule-enable allow_all


== Troubleshooting ==
[[Category:FreeIPA_Test_Cases]] [[Category:Realmd_Test_Cases]] [[Category:Server Acceptance Test Cases]]
 
 
[[Category:FreeIPA_Test_Cases]] [[Category:Realmd_Test_Cases]]

Revision as of 22:53, 21 November 2014

Associated release criterion
This test case is associated with the Fedora_42_Beta_Release_Criteria#domain-access-control release criterion. If you are doing release validation testing, a failure of this test case may be a breach of that release criterion. If so, please file a bug and nominate it as blocking the appropriate milestone, using the blocker bug nomination page.


Description

This test case checks that a system enrolled in a FreeIPA domain honors the domain controller's host-based access control (HBAC) rules.

Setup

  1. Deploy a correctly-configured FreeIPA domain controller (you can follow QA:Testcase_Server_role_deploy with the Domain Controller role to do this on Fedora 28 or earlier, or QA:Testcase_freeipa_trust_server_installation to do this on Fedora 29 or later)
  2. Enrol a test system in the FreeIPA domain (several of the other Category:Server Acceptance Test Cases cover different mechanisms for doing this, you can follow any of those)
  3. The intent here is to set up an HBAC rule which specifies that all access is prohibited, unless it is initiated by a specific user ("testuser")
  4. Make sure you have freeipa-admintools installed 
    # yum install freeipa-admintools
  5. Create a FreeIPA user (after acquiring admin credentials) 
    $ kinit admin
    $ ipa user-add testuser --first test --last user --password
  6. Create an HBAC rule that allows access to the user you just created 
    $ ipa hbacrule-add testrule --servicecat=all --hostcat=all
    $ ipa hbacrule-add-user testrule --users=testuser
  7. Disable the default rule that allows access to everyone 
    $ ipa hbacrule-disable allow_all
  8. On the system that joined the domain, change the testuser password for the first time. 
    $ kinit testuser@IPA.EXAMPLE.ORG
    You will be prompted to enter a new password here

How to test

  1. On the system that joined the domain, switch to another VT (press Ctrl-Alt-F4).
  2. Try to log in as the admin user. 
    host login: admin@ipa.example.org
  3. Now try to log in as test user. 
    host login: testuser@ipa.example.org

Expected Results

  1. Log in as the admin user must fail, and log in as the test user must succeed.



More testing - offline logins

  1. Before the test, make sure that credential caching is enabled on the client
    open /etc/sssd/sssd.conf in your editor of choice
    Make sure that cache_credentials=True is present in the [domain] section of sssd.conf
    Restart the SSSD if you modified the config file: service sssd restart
  2. Perform one more login online to cache the credentials
    Disconnect the client from the network. As root, shut down the NM service:
    # service NetworkManager stop
    Log in as the test user again. The login should succeed.
    Don't forget to start the networking again to make sure you're able to run the cleanup

Clean-up after the test

Enable the allow_all rule again to avoid interference with other tests: 

$ kinit admin
$ ipa hbacrule-enable allow_all
Retrieved from "https://fedoraproject.org/w/index.php?title=QA:Testcase_FreeIPA_realmd_login&oldid=395414"