Subscribe to EMG

You can subscribe to Equinix Messaging Gateway (EMG) in a self-serviceable way and integrate with Platform Equinix over event-based channels.

Integration with Apps

An integral part of the EMG subscription process is the integration with your apps.

For more details, see how to register app.

Pre-requisites

You have valid user credentials to access the Equinix Customer Portal (see Sign Into the Equinix Portal)
You must have the required permissions to order and receive EMG notifications

If you are unaware of your user permissions or need access to some Equinix products and services, contact your Primary Administrator.

To create and manage your Equinix Messaging Gateway subscriptions, follow the steps below:

Access Messaging Gateway

Log in to the Equinix Portal.
From the global navigation menu, select Developer Settings > Messaging Gateway to display subscription details.

API License Agreement
Before using the platform and APIs for the first time, you must read and accept the displayed API license agreement. Once you have accepted the agreement, you can find it in the Additional Information section.

Create Subscription

Step 1 - Initiate New Subscription

One subscription per environment.
You are limited to one active subscription per environment.

Click Create New Subscription.

In the displayed form, provide the subscription details:

Enter subscription name.
Choose an integration environment for your subscription:
- Sandbox — select if you are conducting integration testing with EMG. It is a global mock test environment to simulate Equinix production behavior.
- Production — select if you want to integrate your subscription into a live, production setting.

Step 2 - Specify Equinix Products and Services

Select Equinix products and services for which you want to receive EMG notifications.
Click Next to proceed.

Based on your preferences, you can choose one or multiple features and sub-features to integrate with your app.

Details: Features and sub-features

# Permission Required

You may also have products or services you need access to due to the lack of permissions.

If you are unaware of your user permissions or need access to some Equinix products and services, contact your Primary Administrator.

# Non-EMG Order Notifications

Order Management and Managed Services allow you to receive notifications for orders placed outside of EMG.
After choosing the specific features of Order Management or Managed Services, you can:

Decide if you want notifications for non-EMG orders:
- Choose Yes if you want to get these notifications.
The Authentication section is enabled as a second step.

Step 3 - Choose Authentication Method

Specify Authentication type.
Click Next to proceed.

EMG offers two types of authentication:

Access Token
Signed Certificate

For detailed information, refer to the Access and Authentication resource.

# Access Token Authentication

If you opt for access token authentication, you can use an existing app or create a new one.

# Certificate-based Authentication

If you opt for certificate-based authentication, you can provide certificate details (primary and secondary public keys).

Step 4 - Verify Subscription Summary

# Before Creating Subscription

Check the subscription summary.
Before you create a subscription, you can edit subscription details and authentication. You can also go back to the previous steps.

Step 5 - Activate Subscription

Once you verify all data, click Create to create a new subscription.

Step 6 - Congratulations on subscribing to EMG!

Congratulations on successfully subscribing to Equinix Messaging Gateway! To get started with EMG, check out our video tutorials and explore the available SDKs.

Now you can access your subscription details, check the configuration, and follow the next steps.