forked from pivotal-cf/docs-twistlock
-
Notifications
You must be signed in to change notification settings - Fork 4
/
installing.html.md.erb
112 lines (75 loc) · 5.98 KB
/
installing.html.md.erb
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
---
title: Installing Prisma Cloud for VMware Tanzu
owner: Partners
---
Install and configure Prisma Cloud for VMware Tanzu.
After the install is complete, Prisma Cloud Defender will be running in your environment.
<p class='note'><strong>Note:</strong>
If you're upgrading from a previous release, you must first uninstall any previous versions of PCF Defender.
The new 20-09 tile has been rearchitected.
The old tile created a dedicated VM in the TAS environment with a Defender installed, and supported blobstore scanning only.
The new tile installs Defender on every Diego cell in the TAS environment, with expanded support for app scanning, host scanning, and runtime defense.
</p>
**Prerequisites**: Prisma Cloud Console is already installed and running in your environment.
If you're using Prisma Cloud Enterprise Edition, Console is delivered as SaaS service, so you're all set.
If you're using Prisma Cloud Compute Edition, you've got a number of options.
You could install Console on a stand-alone virtual machine with Onebox or as a pod in Tanzu Kubernetes Grid.
##<a id='install'></a> Import Prisma Cloud for VMware Tanzu
1. In Prisma Cloud Console, go to **Manage > System > Downloads**, and download the tile.
1. In the Ops Manager Installation Dashboard, click **Import a Product**, and select the tile you just downloaded.
1. Retrieve the install command from Prisma Cloud Console.
It's used to configure the tile.
1. Go to **Manage > Defenders > Deploy > Single Defender**.<br><br>
1. Choose the DNS name or IP address the PCF Defender will use to connect to Console.
If a suitable option is not available, go to **Manage > Defenders > Names**, and add a DNS name or IP address to the SAN table.<br><br>
1. Set the Defender type to **PCF Defender**.<br><br>
1. Copy the install command and set it aside.
1. Go to the PCF Ops Manager Installation Dashboard.
1. Add the Prisma Cloud tile to your staging area.
Click the **+** button next to the version of the tile you want to install.
##<a id='configure'></a> Install and Configure the Tile
By default Prisma Cloud performs strict validation of your Cloud Controller's (CC) TLS certificate.
Strict validation verifies the name, signer, and validity date of the CC's certificate.
If you're using self-signed certificates, this check will fail.
To add your custom certificates to trusted cert list, you need to add the custom CA's cert on the VM where the Prisma Cloud tile runs.
For more details about how to do this, see [Tanzu trusted certificates](https://docs.pivotal.io/ops-manager/2-9/trusted-certificates.html).
You can optionally disable strict validation.
Even with strict validation disabled, the sesssion is still encrypted.
Skip strict validation when:
* You're using self-signed certificates.
* You're using certificates signed by a CA that isn't in your cert store.
* When there's a mismatch between the address you're using to connect to the CC and the common name (CN) or subject alternative name (SAN) in the CC's certificate.
1. Click the newly added **Prisma Cloud for PCF** tile.
1. In **Prisma Cloud Component Configuration**, paste the install command you copied from Prisma Cloud Console, then click **Save**.
1. To skip strict validation of your Cloud Controller's (CC) TLS certificate, enable **Skip Cloud Controller TLS validation**.
1. If you have Prisma Cloud Compute Edition (self-hosted Console):
1. In **Credentials**, select your preferred authentication method: Basic Authentication or Certificate-based Authentication.
Your role must be [Defender Manager](https://docs.paloaltonetworks.com/prisma/prisma-cloud/prisma-cloud-admin-compute/authentication/user_roles.html) or higher.<br><br>
1. For Basic Authentication, enter your Prisma Cloud Console credentials, then click **Save**.<br><br>
1. For certificate-based authentication, paste the certificate and private key used for authentication in PEM format, then click **Save**.
For certificate-based authentication, the root CA used to sign the certificate used for authentication must be entered under **Manage > Authentication > System Certificates > Advanced Certificate Configuration**.
1. If you have Prisma Cloud Enterprise Edition (SaaS Console):
1. In **Credentials**, enter your Prisma Cloud Console credentials, then click **Save**.
Your role must be [Defender Manager](https://docs.paloaltonetworks.com/prisma/prisma-cloud/prisma-cloud-admin-compute/authentication/user_roles.html) or higher.
Certificate-based authentication is not supported with Prisma Cloud Enterprise Edition.
1. Install the Prisma Cloud tile.
Return to the Ops Manager Installation Dashboard, click **Review Pending Changes**, select both **Prisma Cloud for PCF** and **Pivotal Application Service**, then click **Apply changes**.
<p class='note'><strong>Note:</strong>
Pivotal Application Service must be staged when installing the Prisma Cloud tile.
</p>
##<a id='validate'></a> Validate your Installation
After the changes are applied, validate that Prisma Cloud Defenders are running in your environment.
1. Log into Prisma Cloud Console.
1. Go to **Manage > Defenders > Manage**.
1. In the table of deployed Defenders, you should see a Defender of type **PCF**, one per Diego cell.
<%= image_tag("tas_defenders_deployed.png", :width => "600") %>
<p class='note'><strong>Note:</strong>
Prisma Cloud reports the agentID in the Host field.
To correlate an agentID to a Diego cell IP address, and determine exactly which host runs a Defender, login to an Diego cell, and inspect */var/vcap/instance/dns/records.json*.
This file shows how the agentID maps to a host IP address.
</p>
<p class='note'><strong>Note:</strong>
If a PCF Defender disconnects from Console for more than one day, all data it collected is purged from Console.
The Defender is also removed from the table in **Manage > Defenders > Manage**.
The period of time that data from a disconneted Defender is retained (by default, one day) can be configured in **Manage > Defenders > Manage > Defenders > Advanced Settings**.
</p>