auth::authentication::authenticate (public)

 auth::authentication::authenticate -authority_id authority_id \
    -username username -password password

Defined in packages/acs-authentication/tcl/authentication-procs.tcl

Invoke the Authenticate service contract operation for the given authority.

Switches:

-authority_id (required)

The ID of the authority to ask to verify the user.

-username (required)

Username of the user.

-password (required)

The password as the user entered it.

Testcases:

auth_password_reset

Source code:

    set impl_id [auth::authority::get_element -authority_id $authority_id -element "auth_impl_id"]

    if { $impl_id eq "" } {
        # No implementation of authentication
        set authority_pretty_name [auth::authority::get_element -authority_id $authority_id -element "pretty_name"]
        error "The authority '$authority_pretty_name' doesn't support authentication"
    }

    set parameters [auth::driver::get_parameter_values  -authority_id $authority_id  -impl_id $impl_id]

    return [acs_sc::invoke  -error  -impl_id $impl_id  -operation Authenticate  -call_args [list $username $password $parameters $authority_id]]

Generic XQL file:

packages/acs-authentication/tcl/authentication-procs.xql

PostgreSQL XQL file:

packages/acs-authentication/tcl/authentication-procs-postgresql.xql

Oracle XQL file:

packages/acs-authentication/tcl/authentication-procs-oracle.xql