> ## Documentation Index
> Fetch the complete documentation index at: https://docs.megaport.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Creating MCR Connections to Salesforce Express Connect

> This help topic describes how to create connections between a Megaport Cloud Router and Salesforce Express Connect.

export const Image = ({src, alt = '', caption, width, height, shadow}) => {
  const errorPrefix = '\x1b[31;1;4mERROR\x1b[0m: Image -';
  if (typeof src !== 'string') {
    src = String(src);
  }
  if (!src || src === 'undefined') {
    console.error(`${errorPrefix} \`src\` is required — rendering an empty string instead`);
    return <></>;
  }
  const img = <img className={['mega-image-style', shadow ? 'shadow' : ''].join(' ')} src={src} alt={alt} width={width} height={height} style={{
    display: 'block'
  }} />;
  return caption ? <figure>
      {img}
      <figcaption style={{
    textAlign: 'center',
    width
  }}>{caption}</figcaption>
    </figure> : img;
};

export const Link = ({href, children}) => {
  const errorPrefix = '\x1b[31;1;4mERROR\x1b[0m: Link -';
  if (typeof href !== 'string') {
    href = String(href);
  }
  if (!href || href === 'undefined') {
    console.error(`${errorPrefix} the \`href\` property is required — rendering an empty string instead`);
    return <></>;
  }
  if (href.includes('{') || href.toUpperCase().includes('%7B')) {
    console.error(`${errorPrefix} could not resolve a variable in href "${href}" — rendering an empty string instead`);
    return <></>;
  }
  const isExternal = (/^https?:\/\//).test(href);
  return <a href={href} className="link" target={isExternal ? '_blank' : undefined} rel={isExternal ? 'noreferrer' : undefined}>
      {children ?? href}
      {isExternal && <span className="sr-only"> (opens in a new tab)</span>}
    </a>;
};

Salesforce Express Connect lets you access Salesforce applications and services directly with a private, dedicated connection. When you create a Salesforce Express Connect through the <Link href="https://portal.megaport.com">Megaport Portal</Link>:

* Express Connect is delivered as a Layer 3 routed service.
* You access Salesforce services using public IPs and are required to
  run BGP to receive Salesforce routes.
* Megaport allocates a /31 public IP range for each Salesforce
  peering.
* You can advertise your own public IP address space to Salesforce.
  (Salesforce will not accept [RFC 1918](https://tools.ietf.org/html/rfc1918) routes.)

Deployment considerations:

* **Provisioning** -- One Virtual Cross Connect (VXC) provisions two logical connections to Salesforce using a Megaport Cloud Router (MCR). Salesforce has redundant routers that provide guaranteed uptime for both service locations.
* **Timeframe** -- Salesforce can take up to 2 business days for approval once a VXC is deployed from the Portal.
* **Internet Backup** -- Although Megaport always recommends two Ports for redundancy, an Express Connect over Megaport can be used for the primary connection to Salesforce and if you use publicly routed IP space and the single Megaport fails, routing to Salesforce can revert to the public internet.

This image shows a common Express Connect deployment:

<Image src="/images/cloud/mcr/common-deployment.png" alt="Salesforce deployment" width={900} />

**To create a connection to Salesforce Express Connect**

1. Log in to the <Link href="https://portal.megaport.com">Megaport Portal</Link>, choose **Services**, and select the MCR you want to configure.\
   If you haven't already created an MCR, see
   [Creating an MCR](/mcr/creating-mcr).

2. Add a VXC connection.\
   If this is the first connection for the MCR, click the Salesforce
   tile. The tile is a shortcut to the configuration page.
   Alternatively, click **+Connection**, click **Cloud**, then click **Salesforce**.
   <Image src="/images/cloud/mcr/select-salesforce.png" alt="Salesforce tile" shadow={true} width={700} />

3. Select Salesforce as the provider.
   <Image src="/images/cloud/mcr/sfdc-dest-port.png" alt="Select destination" shadow={true} width={700} />

4. Select your destination Port and click **Next**.

5. Specify the connection details:

   * **Connection Name** -- The name of your VXC to be shown in the <Link href="https://portal.megaport.com">Megaport Portal</Link>.

   * **Service Level Reference** (optional) -- Specify a unique identifying number for your Megaport service to be used for billing purposes, such as a cost center number, unique customer ID, or purchase order number. The service level reference number appears for each service under the Product section of the invoice. You can also edit this field for an existing service.

   * **Rate Limit** -- The speed of your connection in Mbps. Accepted values start at 1 Mbps and scale up to several Gbps, depending on location and service availability.

   * **VXC State** -- Select **Enabled** or **Shut Down** to define the initial state of the connection. For more information, see [Shutting Down a VXC for Failover Testing](/connections/shut-down-vxc).

     <Note>
       If you select **Shut Down**, traffic will not flow through this service and it will behave as if it was down on the Megaport network. Billing for this service will remain active and you will still be charged for this connection.
     </Note>

   * **Minimum Term** -- Select No Minimum Term, 12 Months, 24 Months, 36 Months, 48 Months, or 60 Months. Longer terms result in a lower monthly rate. *12 Months* is selected by default. Take note of the information on the screen to avoid early termination fees (ETF).

     Enable the [Minimum Term Renewal](/portal-admin/auto-renew/#auto-renew) option for services with a 12, 24, 36, 48 or 60-month term to automatically renew the contract at the same discounted price and term length at the end of the contract. If you don't renew the contract, at the end of the term,  the contract will automatically roll over to month-to-month contract for the following billing period, at the same price, without term discounts.

     For more information, see [VXC Pricing and Contract Terms](/finance/vxc-pricing) and [VXC, Megaport Internet, and IX Billing](/finance/billing-details).

   * **Resource Tags** -- You can use resource tags to add your own reference metadata to a Megaport service.\
     To add a tag:

     1. Click **Add Tags**.
     2. Click  **Add New Tag**.
     3. Enter details into the fields:
        * **Key** -- string maximum length 128. Valid values are a-z 0-9 \_ : . / \ -
        * **Value** -- string maximum length 256. Valid values are a-z A-Z 0-9 \_ : . @ / + \ - (space)
     4. Click **Save**.

     If you already have resource tags for that service, you can manage them by clicking **Manage Tags**.

     <Warning>
       Never include sensitive information in a resource tag. Sensitive information includes commands that return existing tag definitions and information that will identify a person or company.
     </Warning>

     <Image src="/images/cloud/mcr/mcr-cloud-create-details.png" alt="Connection details" shadow={true} width={600} />

6. Click **Next**.

7. On the pop-up window called **MCR A-End Connection Details**, click **Next**.

8. Provide these connection details:

   * **ASN** -- Enter a private or public ASN. By default, the MCR ASN is 133937.

   * **BGP Password** -- Leave this blank, as Salesforce doesn't support a BGP password.

   * **Prefixes** -- Enter prefixes to announce to Salesforce -- RIR
     assigned IPv4 address ranges only. If you do not have public
     IP ranges, you can source NAT to the /31s IP provided by
     Megaport. If you are going to use the /31s IP provided by
     Megaport, you can leave this field blank. Once configured, you cannot add new prefixes to the VXC.

   <Note>
     [RFC 1918](https://tools.ietf.org/html/rfc1918) space is not permitted.
   </Note>

9. Click **Next**.

   <Image src="/images/cloud/mcr/summary.png" alt="Salesforce summary" shadow={true} width={400} />

   A summary page appears that includes the monthly cost.

10. Click **Back** to make changes or click **Add VXC**.

    Once you have finished this configuration, you can configure additional VXCs or proceed with the order.

11. Click **Review Order** to proceed through the checkout process, or click **Save** to save the configured services before placing the order.

12. Review the Important Information section and confirm agreement with the Service Agreements.

    If you do not have a promotion code, skip to the **Order Now** step. If you do have a promotion code, enter it into the **Enter discount code** field then click **Apply**. Alternatively, if a code already appears in the **Discounts** field, verify it is correct and click **Apply**.

    The promotional discount appears below the Standard Term discount.  This discount is not reflected in the Monthly Rate shown here, it is applied at the time of billing.  If an invalid or expired code causes an error with your order, contact your Megaport Account Manager for a replacement code.

    <Image src="/images/snippets/add-promo-code.png" alt="Add Promo Code" shadow={true} width={750} />

    If you entered an incorrect promotion code, you can remove it by clicking **Remove**.

13. Click **Order Now**.

    After submitting the order, Salesforce can take up to 2 business days to approve the connection request. The VXC status will be *Deployable* until Salesforce accepts the connection.

<Image src="/images/cloud/mcr/deployable-status.png" alt="Select destination port" shadow={true} width={700} />

When Salesforce accepts the request, two logical and redundant connections are created from Salesforce.

You can view and edit the details of your connection in the <Link href="https://portal.megaport.com">Megaport Portal</Link> by selecting the VXC and selecting Details.

## Using a service key

You can create a service key that allows you to share your service with another Megaport account holder.
For more information, see [Setting up Service Keys](/marketplace/service-keys/).

## Helpful references

* [Salesforce Express Connect Product Page](https://www.salesforce.com/campaign/salesforce-express-connect/)
