Skip to content

Using ADS Enterprise Features

PhonicUK edited this page Mar 31, 2020 · 14 revisions

Prerequisites

When running in Enterprise Mode, the following requirements apply:

  • AMP must be served over HTTPS, either using the internal implementation or using a reverse proxy.
  • On Linux systems, hidepid must be configured. Without it AMP will not create instances.

Activating ADS

By default ADS can't be activated, and won't accept a key. To enable AMPs Enterprise features you need to set it up to allow activation, then activate it with your key.

At time of writing, an AMP Patreon Edition licence can be used to unlock the Enterprise features for testing - but this does not entitle you to use AMP commercially.

Run the following commands (Applies on any platform):

ampinstmgr reconfigure ADS01 +Core.AMP.RequireActivation True
ampinstmgr reactivate ADS01 *yourlicencekeygoeshere*

This will need doing on all of your controllers and targets.

Template Deployment Callbacks

ADS Controllers can be configured to invoke a HTTPS POST callback once a template has been deployed. This callback informs you as to whether the request was successful, and to which target it was deployed. The URL can be configured under the 'ADS' category in settings.

The callback data is JSON formatted, containing the following:

{
    "Success": true,
    "Secret": "MySecretString",
    "TargetId": "60008d3c-cf4b-401a-9383-25694115781f",
}

You can then query the specified target for the instance containing the Tag specified during the DeployTemplate API call.

Clone this wiki locally