sssd_test_framework.utils.realmd

Manage realm operations.

Classes

RealmUtils(*args, **kwargs)

Interface to the realm utility.
class sssd_test_framework.utils.realmd.RealmUtils(*args, **kwargs)

Bases: MultihostUtility[MultihostHost]

Interface to the realm utility.

Example usage
@pytest.mark.topology(KnownTopology.AD)
def test_realm_discover(client: Client, provider: ADProvider):
    r = client.realm.discover(provider.host.domain, args=["--use-ldaps"])
    assert provider.host.domain in r.stdout, "realm failed to discover domain info!"

Initialize the RealmUtils.

Parameters:

host (MultihostHost) – The multihost host instance.

cli: CLIBuilder

Command line builder.

discover(domain: str | None = None, *, args: list[str] | None = None) → ProcessResult

Discover a realm and it’s capabilities.

Parameters:

  • domain (str, optional) – domain, defaults to None

  • args (list[str] | None, optional) – Additional arguments, defaults to None

Returns:

Result of called command.

Return type:

ProcessResult

leave(domain: str | None = None, *, args: list[str] | None = None, password: str, user: str, krb: bool = False) → ProcessResult

Deconfigure and remove a client from realm.

Parameters:

  • domain (str) – domain.

  • args (list[str] | None, optional) – Additional arguments, defaults to None.

  • password (str) – Password to run the operation.

  • user (str) – Authenticating user.

  • krb (bool) – kerberos authentication, defaults to False.

Returns:

Result of called command.

Return type:

ProcessResult

join(domain: str, *, args: list[str] | None = None, password: str, user: str, krb: bool = False) → ProcessResult

Join and configure a client to realm.

Parameters:

  • domain (str) – Domain.

  • args (list[str] | None, optional) – Additional arguments, defaults to None

  • password (str) – Password.

  • user (str) – Authenticating user.

  • krb (bool) – Kerberos authentication, defaults to False

Returns:

Result of called command.

Return type:

ProcessResult

renew(domain: str, *, args: list[str] | None = None) → ProcessResult

Renew host keytab.

Parameters:

  • domain (str) – domain.

  • args (list[str] | None, optional) – Additional arguments, defaults to None

Returns:

Result of called command.

Return type:

ProcessResult

permit(*, args: list[str] | None = None) → ProcessResult

Permit and deny users, groups local log in.

Parameters:

args (list[str] | None, optional) – Additional arguments, defaults to None

Returns:

Result of called command.

Return type:

ProcessResult

deny(*, args: list[str] | None = None) → ProcessResult

Deny local log in.

Parameters:

args (list[str] | None, optional) – Additional arguments, defaults to None

Returns:

Result of called command.

Return type:

ProcessResult

list(*, args: list[str] | None = None) → ProcessResult

List discovered, and configured realms.

Parameters:

args (list[str] | None, optional) – Additional arguments, defaults to None

Returns:

Result of called command.

Return type:

ProcessResult