IBM Cloud Docs
Managing IPSec VPN tunnels (ibmcloud sl ipsec)

Managing IPSec VPN tunnels (ibmcloud sl ipsec)

IBM Cloud® VPN access allows users to manage all servers remotely and securely over the IBM Cloud private network. A VPN connection from your location to the private network gives you the capability for out-of-band management and server rescue through an encrypted VPN tunnel.

Use the following commands from the IBM Cloud Command Line Interface to manage IPSec VPN tunnels in the IBM Cloud classic infrastructure IPSec VPN service.

ibmcloud sl ipsec cancel

Cancel a IPSec VPN tunnel context

ibmcloud sl ipsec cancel CONTEXT_ID [flags]

Command options:

--f, force
Force operation without confirmation
--immediate
Cancel the IPSec immediately instead of on the billing anniversary
--reason
An optional reason for cancellation

ibmcloud sl ipsec config

Request configuration of a tunnel context

ibmcloud sl ipsec config CONTEXT_ID [OPTIONS]

Request configuration of a tunnel context.

This action will update the advancedConfigurationFlag on the context
instance and further modifications against the context will be prevented
until all changes can be propagated to network devices.
ibmcloud sl ipsec config CONTEXT_ID

ibmcloud sl ipsec detail

List IPSec VPN tunnel context details

ibmcloud sl ipsec detail CONTEXT_ID [OPTIONS]

List IPSEC VPN tunnel context details.

Additional resources can be joined using multiple instances of the include
option, for which the following choices are available.

at: address translations
is: internal subnets
rs: remote subnets
sr: statically routed subnets
ss: service subnets
ibmcloud sl ipsec detail CONTEXT_ID [flags]

Command options:

--i, include
Include extra resources. Options are: at,is,rs,sr,ss

ibmcloud sl ipsec list

List IPSec VPN tunnel contexts

ibmcloud sl ipsec list [flags]

Command options:

--order
Filter by ID of the order that purchased the IPSec

ibmcloud sl ipsec order

Order a IPSec VPN tunnel

ibmcloud sl ipsec order [flags]

Command options:

--d, datacenter
Short name of the datacenter for the IPSec. For example, dal09[required]

ibmcloud sl ipsec subnet-add

Add a subnet to an IPSec tunnel context

ibmcloud sl ipsec subnet-add CONTEXT_ID [OPTIONS]

Add a subnet to an IPSEC tunnel context.

A subnet id may be specified to link to the existing tunnel context.

Otherwise, a network identifier in CIDR notation should be specified,
indicating that a subnet resource should first be created before
associating it with the tunnel context. Note that this is only supported
for remote subnets, which are also deleted upon failure to attach to a
context.

A separate configuration request should be made to realize changes on
network devices.
ibmcloud sl ipsec subnet-add CONTEXT_ID [flags]

Command options:

--n, network
Subnet network identifier to create
--s, subnet-id
Subnet identifier to add, required
--t, subnet-type
Subnet type to add. Options are: internal,remote,service[required]

ibmcloud sl ipsec subnet-remove

Remove a subnet from an IPSEC tunnel context

ibmcloud sl ipsec subnet-remove CONTEXT_ID SUBNET_ID SUBNET_TYPE

Remove a subnet from an IPSEC tunnel context.

The subnet id to remove must be specified.

Remote subnets are deleted upon removal from a tunnel context.

A separate configuration request should be made to realize changes on
network devices.
ibmcloud sl ipsec subnet-remove CONTEXT_ID SUBNET_ID SUBNET_TYPE

ibmcloud sl ipsec translation-add

Add an address translation to an IPSec tunnel

ibmcloud sl ipsec translation-add CONTEXT_ID [OPTIONS]

Add an address translation to an IPSEC tunnel context.

A separate configuration request should be made to realize changes on
network devices.
ibmcloud sl ipsec translation-add CONTEXT_ID [flags]

Command options:

--n, note
Note value
--r, remote-ip
Remote IP address[required]
--s, static-ip
Static IP address[required]

ibmcloud sl ipsec translation-remove

Remove a translation entry from an IPSec

ibmcloud sl ipsec translation-remove CONTEXT_ID TRANSLATION_ID

Remove a translation entry from an IPSEC tunnel context.

A separate configuration request should be made to realize changes on
network devices.
ibmcloud sl ipsec translation-remove CONTEXT_ID TRANSLATION_ID

ibmcloud sl ipsec translation-update

Update an address translation for an IPSec

ibmcloud sl ipsec translation-update CONTEXT_ID TRANSLATION_ID [OPTIONS]

Update an address translation for an IPSEC tunnel context.

A separate configuration request should be made to realize changes on
network devices.
ibmcloud sl ipsec translation-update CONTEXT_ID TRANSLATION_ID [flags]

Command options:

--n, note
Note
--r, remote-ip
Remote IP address[required]
--s, static-ip
Static IP address[required]

ibmcloud sl ipsec update

Update tunnel context properties

ibmcloud sl ipsec update CONTEXT_ID [OPTIONS]

Update tunnel context properties.

Updates are made atomically, so either all are accepted or none are.

Key life values must be in the range 120-172800.

Phase 2 perfect forward secrecy must be in the range 0-1.

A separate configuration request should be made to realize changes on
network devices.
ibmcloud sl ipsec update CONTEXT_ID [flags]

Command options:

--n, name
Friendly name
--a, phase1-auth
Phase 1 authentication. Options are: MD5,SHA1,SHA256
--c, phase1-crypto
Phase 1 encryption. Options are: DES,3DES,AES128,AES192,AES256
--d, phase1-dh
Phase 1 Diffie-Hellman group. Options are: 0,1,2,5
--t, phase1-key-ttl
Phase 1 key life. Range is 120-172800
--u, phase2-auth
Phase 2 authentication. Options are: MD5,SHA1,SHA256
--y, phase2-crypto
Phase 2 encryption. Options are: DES,3DES,AES128,AES192,AES256
--e, phase2-dh
Phase 2 Diffie-Hellman group. Options are: 0,1,2,5
--f, phase2-forward-secrecy
Phase 2 perfect forward secrecy. Range is 0-1
--l, phase2-key-ttl
Phase 2 key life. Range is 120-172800
--k, preshared-key
Preshared key
--r, remote-peer
Remote peer IP address