Remote Authentication Module
Overview
The ActiveMember360 Remote Authentication module provides a remote authentication method for non WordPress sites/applications.
It is designed to allow an external application to remotely interact with ActiveMember360 and your ActiveCampaign application for the purposes of authenticating a user.
Upon a successful autentication either all or the chosen ActiveCampaign contact fields will be returned.
Activation
- In WordPress administrator main navigation click ActiveMember360, Modules.
- In ActiveMember360 Modules tabs click Remote Authentication.
- Set Enable Remote Authentication module to Yes/On.
- Click Save Settings.
Usage
Remote authentication can be carried out through either a POST or a GET. The plugin checks against $_REQUEST parameters and values.
The URL used for for the POST or GET should match that of the site URL as defined in WordPress, Settings, General, Site URL.
Required Parameters
| Parameters | Value & Description |
|---|---|
| mbr_auth | The value passed should be one of the security codes as defined in ActiveMember360, Settings, Security, Security Codes. Default: none. Required: yes. |
| user | The value passed should be the contact’s primary email address, as stored in ActiveCampaign. Default: none. Required: yes. |
| pass | The value passed should be the contact’s password as stored in the field password in ActiveCampaign. Default: none Required: yes. |
Optional Parameters
| Parameters | Value & Description |
|---|---|
| retfields | This value, if passed, is used to define which ActiveCampaign fields should be returned in the result array. If more than one contact field is provided, please separate with commas. If not specified, all contact fields will be returned. Default: All contact fields. Required: no. |
| required_tags | This value, if passed, defines one or more tag ID’s defined within ActiveCampaign which a user must have, in addition to a matching password, in order to successfully authenticate. If more than one tag ID is provided, please separate with commas. In order to authenticate, the user must have all tag IDs specified. Default: none. Required: no. |
| json | This value, if passed, is used to direct the module to return any data in JSON format. If not specified, the default method used is PHP’s serialize(). Default: PHP serialize(). Required: no. |
| base64 | This value, if passed, is used to direct the module to return the JSON or serialized return values in Base64 encoded format. Default: none. Required: no. |
When using the user parameter for a GET an email address can only contain the plus character + if it is URL encoded i.e. replaced by %2B.
Otherwise it will be decoded by the PHP $_GET into a space and the authentication will fail.