NAME

Net::FreeIPA is a perl FreeIPA JSON API client class

SYNOPSIS

'ipa user-find' equivalent using API call and basic result postprocessing. The connection in this example will (try to) use kerberos authentication. See Net::FreeIPA::RPC::new_client for authentication details.

    my $fi = Net::FreeIPA->new("host.example.com");

    die("Failed to initialise the rest client") if ! $fi->{rc};

    if($fi->api_user_find("")) {
        print "Found ", scalar @{$fi->{result}}, " users\n";
    } else {
        print "Something went wrong\n";
    }

Private methods

_initialize

Handle the actual initializtion of new. Return 1 on success, undef otherwise.

log

An instance that can be used for logging (with error/warn/info/debug methods) (e.g. LOG::Log4perl).

debugapi

When true, log the JSON POST and JSON reply data with debug.

All other arguments and options are passed to Net::FreeIPA::RPC::new_client during initialisation. (Check the presence of an rc attribute for succesfull initialisation of the underlying rest client. An error is logged in case of failure.)