Installing and configuring apoctl

Download the executable appropriate to your platform.
macOS
sudo curl -o /usr/local/bin/apoctl \
  https://download.aporeto.com/releases/release-5.0.12/apoctl/darwin/apoctl && \
sudo chmod 755 /usr/local/bin/apoctl
Linux
sudo curl -o /usr/local/bin/apoctl \
  https://download.aporeto.com/releases/release-5.0.12/apoctl/linux/apoctl && \
sudo chmod 755 /usr/local/bin/apoctl
Windows
curl https://download.aporeto.com/releases/release-5.0.12/apoctl/windows/apoctl.msi -o apoctl.msi; `
if ($?) {. .\apoctl.msi /quiet}
if ($?) {$env:PATH+="C:\Program Files\Apoctl;"}
Open the Microsegmentation Console web interface.
Navigate to the top-level namespace that you have access to. In the following example, we have access to the top-level namespace /acme.

Click the lock icon in the bottom left corner, then click
Copy to clipboard
, as shown below.

Paste the configuration command into your terminal and press ENTER.
An example command follows, using https://api.microsegmentation.acme.com:4443 as the URL of the Microsegmentation Console API and a Microsegmentation account.
apoctl configure --api https://api.microsegmentation.acme.com:4443 \
                 --namespace /acme \
                 --token $(apoctl auth aporeto --account acme --api https://api.microsegmentation.acme.com:4443)
Authenticate at the prompt.
It should return the following.
apoctl profile 'default' successfully configured
Issue the following commands to extract the URL of your Microsegmentation Console API, set it in a MICROSEG_API environment variable, and ensure that the environment variable persists across sessions.
macOS/Linux
export MICROSEG_API=$(apoctl auth verify | jq -r '.iss')
echo "export MICROSEG_API=$MICROSEG_API" | tee -a ~/.bash_profile
Windows
$env:MICROSEG_API = (apoctl auth verify | jq -r '.iss')
$env:MICROSEG_API = [System.Environment]::SetEnvironmentVariable('MICROSEG_API','User')
Confirm that you can connect to the Microsegmentation Console API and that you trust its certificate.
curl
curl $MICROSEG_API
wget
wget $MICROSEG_API
Issue the following command to confirm that you’re authenticated.
 apoctl auth verify
It should return something like the following.
 {
   "data": {
     "commonName": "app:credential:6022d9eeeb15c100010d9290:acme-apoctl-default-credentials",
     "organization": "/acme",
     "realm": "certificate",
     "serialNumber": "96242056717083374710660459658200369221",
     "subject": "96242056717083374710660459658200369221"
   },
   "exp": 1612903956,
   "iat": 1612896755,
   "iss": "api.microsegmentation.acme.co",
   "realm": "Certificate",
   "restrictions": {},
   "sub": "96242056717083374710660459658200369221"
 }
Great job! You’ve installed and configured apoctl.