Plesk Automation (PPA) Integration

Add-on integration

Plesk Automation (PPA) supports the APS 1.2 standard.

Before beginning, you must verify with your Parallels regional account manager that the APS license has been activated for your PPA setup.

  1. Login as PPA administrator
  2. Navigate to Services > External Applications
  3. Import the SpamExperts APS 1.2 package
  4. After the installation has completed, click the "SpamExperts Integration" package name and go to Resource types
  5. Create the following resources:
    1. Resource class: Application
      • Name: SE: SpamExperts
      • Spampanel URL: https://node1.demo-domain.invalid/

        Where node1.demo-domain.invalid is replaced with the custom Control Panel URL as set in Branding Management

        Ensure to use https and not http

      • Spampanel API hostname: node1.demo-domain.invalid

        Where node1.demo-domain.invalid is replaced with the custom Control Panel URL as set in Branding Management

      • Spampanel API super administrator name: admin
      • Spampanel API super administrator password: password
      • Enable SSL: no
      • Primary MX: node1.demo-domain.invalid

        Where node1.demo-domain.invalid is replaced with the custom Control Panel URL as set in Branding Management

      • Interface enabled: 1
      • Amount of domains allowed: 100
      • Amount of serviceusers allowed: 100
      • Enable incoming: 1
      • Enable outgoing: 0
      • Enable archiving: 0
      • Provision application on account's domain: yes
      • Provision application on vendor's domain: no
      • Auto host domain: yes
      • Bind domains to application instance: yes
      • Automatically provision application: yes
      • Prohibit service users with custom UPN: no
      • Prohibit application instance deinstallation: no
      • Mandatory for service user: yes
      • Show application in navigation menu: yes
      • Embed application user interface: Do not associate an attribute

      2. After this resource has been added, you need to:

      1. Edit the resource SE: SpamExperts
      2. Click Activation Parameters
      3. Navigate to the sub-heading Services
      4. Edit the Application service 'Email Level Account'
      5. Turn off Show in control panel and Show in instances list
    2. Resource class: Application service
      • Name: SE: Email account
      • Service: Email level account
    3. Resource class: Application counter (unit)
      • Name: SE: Interface Enabled (with corresponding resource on next page)
    4. Resource class: Application counter (unit)
      • Name: SE: # of domains (with corresponding resource on next page)
    5. Resource class: Application counter (unit)
      • Name: SE: # of users (with corresponding resource on next page)
    6. Resource class: Application counter (unit)
      • Name: SE: Incoming (with corresponding resource on next page)
    7. Resource class: Application counter (unit)
      • Name: SE: Outgoing (with corresponding resource on next page)
    8. Resource class: Application counter (unit)
      • Name: SE: Archiving (with corresponding resource on next page)
  6. Once all of the Resources are created as above, move to Products
  7. Then open Service Templates > Add Shared Hosting Template
  8. Create the template as follows:
    • Name: Mail + SE (default settings)

      • Add the newly created SE resources to this template:

      • SE: # of domains: unlimited
      • SE: # of users: unlimited
      • SE: Archiving: 0
      • SE: Email account: unlimited
      • SE: Incoming: 1
      • SE: Interface enabled: 1
      • SE: Outgoing: 0

For domain to be registered automatically in SpamExperts, you have to change its registrar status to Ready. A customer can add any of its domains from the customer panel, the registrar status is not important in this case.

If you get the error "License overuse for item 'Hosted APS applications' (hosted-aps-applications).", it means there is no APS license active on your PPA install. A Parallels regional sales manager can activate this for you.

Disclaimer: This documentation may contain references to third party software or websites. N-able has no control over third party software or content and is not responsible for the availability, security, or operation, of any third-party software. If you decide to utilize a release involving third-party software, you do so entirely at your own risk and subject to the applicable third party’s terms and conditions of the use of such software. No information obtained by you from N-able or this documentation shall create any warranty for such software.