cfme.fixtures.rbac module¶
RBAC Role based parametrization and checking
The purpose of this fixture is to allow tests to be run within the context of multiple different users, without the hastle or modifying the test. To this end, the RBAC module and fixture do not require any modifications to the test body.
The RBAC fixture starts by receiving a list of roles and associated errors from the test metadata. This data is in YAML format and an example can be seen below.
Metadata:
test_flag: provision
suite: infra_provisioning
rbac:
roles:
default:
evmgroup-super_administrator:
evmgroup-administrator:
evmgroup-operator: NoSuchElementException
evmgroup-auditor: NoSuchElementException
Let’s assume also we have a test that looks like the following:
def test_rbac(rbac_role):
if rbac_role != 'evmgroup-superadministrator' or rbac_role != 'evmgroup-operator':
1 / 0
This metadata defines the roles to be tested, and associates with them the exceptions that are expected for that particular test, or blank if no Exception is expected. In this way we can have 5 states of test result.
- Test Passed - This was expected - We do nothing to this and exit early. In the example above evmgroup-super_administrator fulfills this, as it expects no Exception.
- Test Failed - This was expected - We consume the Exception and change the result of the test to be a pass. In the example, this is fulfilled by evmgroup-auditor as it was expected to fail with the ZeroDivisionError.
- Test Failed - This was unexpected - We consume the Exception and raise another informing that the test should have passed. In the example above, evmgroup-administrator satisfies this condition as it didn’t expect a failure, but got one.
- Test Failed - This was expected, but the wrong Exception appeared - We consume the Exception throw another stating that the Exception wasn’t of the expected type. In the example above, the default user satifies this as it receives the ZeroDivisionError, but expects MonkeyError.
- Test Passed - This was unexpected - We have Exception to consume, but we raise an Exception of our own as the test should have failed. In the example above, evmgroup-operator satisfies this as it should have received the ZeroDivisionError, but actually passes with no error.
When a test is configured to run against the RBAC suite, it will first parametrize the test with
the associated roles from the metadata. The test will then be wrapped and before it begins
we login as the new user. This process is also two fold. The pytest_store
holds the current
user, and logging in is performed with whatever this user value is set to. So we first replace this
value with our new user. This ensures that if the browser fails during a navigation, we get
the opportunity to log in again with the right user. Once the user is set, we attempt to login.
When the test finishes, we set the user back to default
before moving on to handling the outcome
of the test with the wrapped hook handler. This ensures that the next test will have the correct
user at login, even if the test fails horribly, and even if the inspection of the outcome should
fail.
To configure a test to use RBAC is simple. We simply need to add rbac_role
to the list of
fixtures and the addition and the ldap configuration fixture also. Below is a complete
example of adding RBAC to a test.
import pytest
def test_rbac(rbac_role):
""" Tests provisioning from a template
Metadata:
rbac:
roles:
default:
evmgroup-super_administrator:
evmgroup-administrator:
evmgroup-operator: NoSuchElementException
evmgroup-auditor: NoSuchElementException
"""
if rbac_role != 'evmgroup-superadministrator' or rbac_role != 'evmgroup-operator':
1 / 0
Exception matching is done with a simple string startswith match.
Currently there is no provision for skipping a role for a certain test, though this is easy to implement. There is also no provision, for tests that have multiple parameters, to change the expectation of the test, with relation to a parameter. For example, if there was a parameter called rhos and one called ec2 we could not change the expected exception to be different depending on if the test was run against rhos or ec2.
-
cfme.fixtures.rbac.
pytest_configure
(config)[source]¶ Filters the list of providers as part of pytest configuration.
-
cfme.fixtures.rbac.
pytest_pyfunc_call
(pyfuncitem)[source]¶ Inspects and consumes certain exceptions
The guts of this function are explained above in the module documentation.
Parameters: pyfuncitem – A pytest test item.
-
cfme.fixtures.rbac.
really_logout
()[source]¶ A convenience function logging out
This function simply ensures that we are logged out and that a new browser is loaded ready for use.
-
cfme.fixtures.rbac.
save_traceback_file
(node, contents)[source]¶ A convenience function for artifactor file sending
This function simply takes the nodes id and the contents of the file and processes them and sends them to artifactor
Parameters: - node – A pytest node
- contents – The contents of the traceback file