IBM Cloud Docs
About Private Path services

About Private Path services

The beta release of IBM Cloud Private Path services is only available to allowlisted users. Contact your IBM Support representative if you are interested in getting early access to this beta offering.

Private Path services provide private connectivity for IBM Cloud and third-party services. A Private Path service requires a Private Path network load balancer to deploy a service on IBM Cloud and a Virtual Private Endpoint (VPE) gateway for consumers to connect to the service. Traffic stays on the IBM backbone without traversing the internet.

The typical process for creating private connectivity between Providers and Consumers is as follows:

  1. The provider creates a Private Path service.
  2. The provider associates their Private Path service with a Private Path NLB.
  3. The provider shares pertinent information with service consumers, including a unique Private Path service Cloud Resource Name (CRN).
  4. The consumer creates a VPE gateway that configures the Private Path service's CRN. In turn, a connection request is sent to the service Provider.
  5. The provider permits or denies the consumer's request and sets up an account policy, if need be (alternatively, the provider can set up an account policy to automatically permit or deny consumer requests).
  6. The consumer is notified of the status of the connection request. If permitted, the consumer can access the service; if denied, the consumer can contact the provider for further details.

For more information, see the Private Path solution guide.

Your ability to complete the following actions depends on the level of IAM permissions that are associated with your IBM Cloud account. For more information, see Required permissions.

Getting started with Private Path service

As a service provider, follow these steps to get started:

  1. Make sure that you have a Virtual Private Cloud (VPC) and at least one subnet in the selected VPC.

  2. Create a Private Path NLB.

    • You can create a Private Path NLB when you create your Private Path service, or you can use the Load balancer for VPC provisioning page to create one. To create a Private Path load balancer separate from the Private Path service, see Creating a Private Path network load balancer.
    • You must use the same account within the same VPC region for your Private Path NLB and Private Path service.
  3. Create a Private Path service.

    • Set the default policy for when an account doesn’t have a specific policy that is assigned to it. The default policy (Review) allows you to permit or deny each request, whereas Permit and Deny automate the process for connection requests without specific account policies.
    • Create account policies for specific account IDs now or later. These policies determine what action to take when the provider receives a request from a specific account, and take precedence over the default policy.

Private Path IAM roles and actions

It is important to understand how to effectively assign access for users to work with products and take specific account management actions within your account to follow the principle of least privilege and minimize the number of policies that you have to manage. The following tables provide information about the access roles and the actions mapped to each by the IBM Cloud® services.

Review the available platform and service roles and the actions mapped to each to help you assign access. If you're using the CLI or API to assign access, use is.private-path-service-gateway for the service name.

Platform roles - Private Path Service for VPC
Use the tab buttons to change the context of the table. This table has row and column headers. The row headers provide the platform role name and the column headers identify the specific information available about each role.
Role Description
Administrator As an administrator you can create, delete, update and view private path service gateway service instances, and assign access policies to other users.
Editor As an editor you can create, delete, update and view private path service gateway service instance.
Operator As an operator you can view the properties of private path service gateways but you cannot modify them.
Viewer As a viewer you can view the properties of private path service gateway service instances, but you cannot modify them.
Service actions - Private Path Service for VPC
Use the tab buttons to change the context of the table. This table provides the available actions for the service, descriptions of each, and the roles that each action are mapped to.
Action Description Roles
is.private-path-service-gateway.private-path-service-gateway.read [BETA] View Private Path services Administrator, Editor, Operator, Viewer
is.private-path-service-gateway.private-path-service-gateway.list [BETA] List Private Path services Administrator, Editor, Operator, Viewer
is.private-path-service-gateway.private-path-service-gateway.create [BETA] Create Private Path service Administrator, Editor
is.private-path-service-gateway.private-path-service-gateway.delete [BETA] Delete Private Path service Administrator, Editor
is.private-path-service-gateway.private-path-service-gateway.update [BETA] Update Private Path service Administrator, Editor
is.private-path-service-gateway.private-path-service-gateway.operate [BETA] Operate Private Path service Administrator, Editor, Operator
is.private-path-service-gateway.account-policy.read Get Private Path Service Gateway Account Policy Viewer
is.private-path-service-gateway.account-policy.list List Account Policies Viewer
is.private-path-service-gateway.account-policy.manage Manage Account Policy Administrator, Editor, Operator
is.private-path-service-gateway.endpoint-gateway-binding.list List Endpoint Gateway Bindings Administrator, Editor, Operator, Viewer
is.private-path-service-gateway.endpoint-gateway-binding.read View Endpoint Gateway Binding Administrator, Editor, Operator, Viewer
is.private-path-service-gateway.endpoint-gateway-binding.manage Manage Endpoint Gateway Binding Administrator, Editor, Operator
is.private-path-service-gateway.private-path-service-gateway.publish Publish Private Path service Administrator, Editor
is.private-path-service-gateway.private-path-service-gateway.unpublish Unpublish Private Path service Administrator, Editor

Private Path service use cases

The following use cases show you the various ways you can use Private Path services.

Use case 1: Connecting a service to a single consumer

As a Provider, you want to connect your service to a Consumer without traffic traversing the internet and without giving access to your entire VPC. Your Consumer can be a customer, other division in your company, or something else.

Figure 1 illustrates how to establish a Private Path service. Establishing a Private Path service enables you to expose a service to a customer privately.

First, a Consumer's application connects to a VPE gateway in the Consumer's VPC. Then, the VPE gateway connects to the Private Path NLB in the Provider's VPC. In turn, the Private Path NLB connects to the Provider's service. The Provider's service then responds to the Consumer's request through Direct Server Return (DSR). This Private Path service activity is completely contained in a single region (US South) in an IBM Cloud private network.

A Private Path exposing a service to a customer
A Private Path exposing a service to a customer without using public internet

Use case 2: Connecting a service to multiple consumers

Figure 2 illustrates how to establish a Private Path service with connections to multiple Consumers VPE gateways.

First, a Consumer's application connects to a VPE gateway in the Consumer's VPCs. Then, the VPE gateway connects to the Private Path NLB in the Provider's VPC. In turn, the Private Path NLB connects to the Provider's service. The Provider's service then responds to the Consumer's request through DSR. This Private Path service activity is completely contained in a single region (US South) in an IBM Cloud private network.

A Private Path exposing a service to multiple customers
A Private Path exposing a service to multiple customers without using public internet

Use case 3: Connecting a service to a customer within your VPC

Figure 3 illustrates how to establish a Private Path service with connections to the VPE gateway of a Consumer within your VPC.

First, a Consumer's application connects to the Consumer's VPE gateway within the Provider's VPC. Then, the VPE gateway connects to the Private Path NLB in the Provider's VPC. In turn, the Private Path NLB connects to the Provider's service. The Provider's service then responds to the Consumer's request through DSR. This Private Path service activity is completely contained in a single region (US South) in an IBM Cloud private network.

A Private Path exposing a service to a customer within the same VPC
A Private Path exposing a service to a customer within the same VPC without using public internet

Use case 4: Enabling an IBM Cloud service to connect to a customer's VPC

Private Path allows connection between an IBM Cloud service like IBM Cloud Code Engine and your VPC without compromising security or putting your VPC at risk. Code Engine is a multi-tenant compute service that runs source-code or containerized workloads. Its dynamic scaling capabilities allow your apps to automatically scale up and down, even to zero, based on incoming requests. With it’s pay-per-use model, Code Engine only charges for the compute capacity you actually use. For more information, see IBM Cloud Code Engine.

Figure 4 illustrates how to establish a Private Path service with connections to the VPE gateway of a Code Engine application and your VPC. First, the Code Engine application connects to the VPE gateway within the Code Engine's VPC. Then, the VPE gateway connects to the Private Path NLB in the Consumer's VPC. In turn, the Private Path NLB connects to the Consumer's application. The Consumer's application then responds to the request. This Private Path service activity is completely contained in a single region (US South) in an IBM Cloud private network.

Use Code Engine and Private Path to deploy complex architecture with dynamic and static scaling needs
Use Code Engine and Private Path to deploy complex architecture with dynamic and static scaling needs