Amplify Integration Axway Marketplace Product Subscription Notifier

An Amplify Integration project for notifying Axway Marketplace Product subscribers/Resource Access Requestors and approvers via Microsoft Teams and via email as shown below:

There are two integrations in the project, MPSRN:

• Amplify MPSR Approver Notifier - Amplify Marketplace Product Subscription Request Approver Notifier
• Amplify MPRAR Approver Notifier - Amplify Marketplace Product Resource Access Request Approver Notifier

Once setup and configured properly, the Product Subscription Request Notifier integration performs the following actions:

• Sends a message to MS Teams via an HTTP/S POST when a marketplace product subscription requested is created, approved or rejected. This is useful for a subscription approval team so they can be aware of requests

  

  

• Sends an email via SMTP to a team member with subscription approval role from the team that owns the product when a marketplace product subscription requested is created, approved or rejected.

  

  

• Sends an email to the subscriber via SMTP when their request is approved or rejected

  

A demo video is below:

Once setup and configured properly, the Product Access Request Notifier integration performs the following actions:

• Sends a message to MS Teams via an HTTP/S POST when a marketplace product resource access requested is created, approved or rejected. This is useful for a subscription approval team so they can be aware of requests

  

  

• Sends an email via SMTP to a team member with subscription approval role from the team that owns the product when a marketplace product subscription requested is created, approved or rejected.

  

  

• Sends an email to the subscriber via SMTP when their request is approved or rejected

  

A demo video is below:

Amplify Integration Setup

Follow these steps to setup the integration:

• Import the project, MPSRN.zip, from this repo from the Manager->Environment using the Import feature

  

• Update the Amplify Central API HTTPS Client connection with an Amplify Service Account Client Id and Secret. The Service Account should have Amplify Central Admin rights.

  

• Do the same for the Amplify Platform API HTTPS Client connection with the same Client Id and Secret

  

• Update the MS Team - Product Subscription Approvals HTTP/S Client connection and provide an Incoming Webhook Connector URL for the MS Teams channel you want to receive notifications on

  

• Update the Send In Blue LBG Email connection and provide your SMTP parameters for sending emails

  

• Update the Webhook Trigger HTTPS Server Basic connection and provide any credentials you'd like for Basic authentication or set the Authentication to None

  

  • You will need the Basic Authentication credentials for when you configure the Marketplace webhook in the next section. For example, if you set the username/password to abcd/1234, then your Authorization header value will be Basic YWJjZDoxMjM0

• Open the Integration Amplify MPSR Subscription Approver Notifier and click on the second component in the integration. It is a Map component with label Declare Vars and Parse webhook payload and expand the bottom panel and expand the Vars variable in the Pipe-out

  

• Right click on the following variables and make sure that they are set properly for your environment:

  • AmplifyCentralBaseAddress - base address of your Amplify Central environment (e.g. https://apicentral.axway.com)
  • EmailMessageSubject - the email subject for the emails sent to the Subscription Approver (e.g. Marketplace product subscription status update)
  • EmailMessageFromEmailAddress - the email reply to email address for the emails sent to the Subscription Approver (e.g. no-reply@axway.com)

• Enable the integration and get the URL as you will need this in the next section

  

• Do the same for the Amplify MPRAR Approver Notifier integration and enable it.

Marketplace Setup

Follow these steps to setup the Marketplace webhook that will trigger the integrations above whenever a subscription and/or resource access request is made and whenever the request is approved or rejected:

• Download the mpsrapprovalworflowintegration.yaml YAML file from the repo and edit it:

  • Enter the URL of the Integration above in the Webhook section
  • Enter the Authorization header value in the Secrets section
  • Do the same for mprarapprovalworflowintegration.yaml

• Use the CLI to create the resource using the Axway CLI commands:

  axway central create -f mpsrapprovalworflowintegration.yaml
  axway central create -f mprarapprovalworflowintegration.yaml