Get authentication credentials from the client.

Effective smtp stage

authenticate only.

Return

• Credentials - the credentials of the client.

Example

#{
    authenticate: [
       action "log auth" || log("info", `${auth::credentials()}`),
    ]
}

Get the anonymous_token property of the connection. Can only be use on ‘AnonymousToken’ authentication typed credentials.

Effective smtp stage

authenticate only.

Return

• String - the token.

Examples

#{
    authenticate: [
       action "log auth token" || {
            let credentials = auth::credentials();
            log("info", `credentials token: ${credentials.anonymous_token}`);
        },
    ]
}

Get the authid property of the connection. Can only be use on ‘Verify’ authentication typed credentials.

Effective smtp stage

authenticate only.

Return

• String - the authentication id.

Examples

#{
    authenticate: [
       action "log auth id" || {
            let credentials = auth::credentials();
            log("info", `credentials id: ${credentials.authid}`);
        },
    ]
}

Get the authpass property of the connection. Can only be use on ‘Verify’ authentication typed credentials.

Effective smtp stage

authenticate only.

Return

• String - the authentication password.

Examples

#{
    authenticate: [
       action "log auth pass" || {
            let credentials = auth::credentials();
            log("info", `credentials pass: ${credentials.authpass}`);
        },
    ]
}

Get the type of the auth property of the connection.

Effective smtp stage

authenticate only.

Return

• String - the credentials type.

Examples

#{
    authenticate: [
       action "log auth type" || {
            let credentials = auth::credentials();

            // Logs here will output 'Verify' or 'AnonymousToken'.
            // depending on the authentication type.
            log("info", `credentials type: ${credentials.type}`);
        },
    ]
}

Check if the client is authenticated.

Effective smtp stage

authenticate stage only.

Return

• bool - true if the client succeeded to authenticate itself, false otherwise.

Example

#{
    authenticate: [
       action "log info" || log("info", `client authenticated: ${auth::is_authenticated()}`),
    ]
}

Process the SASL authentication mechanism.

The current implementation support “PLAIN” mechanism, and will call the testsaslauthd program to check the credentials.

The credentials will be verified depending on the mode of saslauthd.

A native implementation will be provided in the future.