From 2e882dba6e43d0402749ae656fc0d5e752fd7451 Mon Sep 17 00:00:00 2001 From: Kamesh-PaloAlto <166385805+Kamesh-PaloAlto@users.noreply.github.com> Date: Mon, 7 Oct 2024 11:51:04 +0530 Subject: [PATCH] rewrote content for compute version topics as well --- .../welcome/utilities-and-plugins.adoc | 77 +++++++++++++++++-- .../welcome/utilities-and-plugins.adoc | 77 +++++++++++++++++-- 2 files changed, 142 insertions(+), 12 deletions(-) diff --git a/docs/en/compute-edition/32/admin-guide/welcome/utilities-and-plugins.adoc b/docs/en/compute-edition/32/admin-guide/welcome/utilities-and-plugins.adoc index d2f41bfe72..d1da88d54b 100644 --- a/docs/en/compute-edition/32/admin-guide/welcome/utilities-and-plugins.adoc +++ b/docs/en/compute-edition/32/admin-guide/welcome/utilities-and-plugins.adoc @@ -1,13 +1,78 @@ == Utilities and plugins -All Prisma Cloud utilities and plugins can be downloaded directly from the Console UI +All Prisma Cloud utilities and plugins can be downloaded directly from the Console UI. ifdef::compute_edition[] They are also bundled with the release tarball you download from the xref:../welcome/releases.adoc[Customer Support Portal] endif::compute_edition[] -To download the utilities from Prisma Cloud Console, go to *Manage > System > Utilities*. -From there, you can download: +All Prisma Cloud utilities and plugins can be downloaded directly from the Console UI. -* Jenkins plugin. -* Linux Container Defender image. -* twistcli for Linux, macOS, and Windows. +=== Downloading Utilities from the Prisma Cloud Console +. Navigate to *Manage* > *System* > *Utilities*. ++ +You will find a list of downloadable utilities and plugins available for various platforms. +. For each utility, you can: +- Click the *Download* button to download the utility directly to your system. +- Click the *Copy* button to copy a curl command to run anywhere. + +=== General Utilities + +. *Jenkins plugin*: The Jenkins plugin enables integration with Prisma Cloud for seamless security scanning in your CI/CD pipeline. ++ +To download the plugin for Prisma Cloud integration, use any of the following methods: + +* Use the *Download* button to download the plugin directly. +* Use the *Copy* button to retrieve a curl command for remote download. + +. *VMware Tanzu tile*: The VMware Tanzu Tile allows you to integrate Prisma Cloud with VMware Tanzu, enabling security across your Tanzu-managed workloads. + ++ +To download the plugin for Prisma Cloud integration, perform any of the following actions: + +* Use the *Download* button to download the Tanzu integration tile for direct deployment into your VMware Tanzu environment. +* Use the *Copy* button to get a curl command for remote download. + +. OpenAPI Spec (Beta): The OpenAPI Spec provides a schema definition for the Prisma Cloud API. ++ +To download the plugin for Prisma Cloud integration, use any of the following methods: + +* Use the *Download* button to download the current OpenAPI specification in Beta. +* Use the *Copy* button to download the OpenAPI spec using curl. + +. Defender Image: Download the Defender image to install in your container environments. + ++ +To download the image, perform any of the following actions: + +* Use the *Download* button to download the Defender image. +* Use the *Copy* button for a curl command. + +=== Twistcli Tool + +The twistcli tool is a command-line utility for interacting with Prisma Cloud to scan containers, images, serverless functions, and IaC (Infrastructure-as-Code) templates. + +Different versions are available for various platforms: + +* Linux x86_64 platform: Download the twistcli for standard Linux x86_64 architectures. +* Linux ARM64 platform: Download for ARM64-based systems. +* macOS x86_64 platform: Download for macOS on Intel-based systems. +* macOS ARM64 platform: Download for Apple Silicon (M1/M2) systems. +* Windows platform: Download the twistcli for Windows environments. + +For each platform, you have the option to either: +* Download: Download the utility directly. +* Copy: Copy a curl command to retrieve the tool remotely. + +=== Path to Console + +When using the Jenkins plugin or the twistcli tool, you need to configure them with the correct Console address. + +Use the Copy icon to copy the console path from the *Path to Console* section. + +=== API Token + +For access to Prisma Cloud APIs, you will require an API token. + +Use the Copy icon to copy the token details from the *API Token* section. This token is used for authentication when making API requests to the Prisma Cloud Console. + +The Console UI also shows the token validity. Ensure that the token is stored securely and is rotated before expiration to avoid disruptions in API access. diff --git a/docs/en/compute-edition/33/admin-guide/welcome/utilities-and-plugins.adoc b/docs/en/compute-edition/33/admin-guide/welcome/utilities-and-plugins.adoc index d2f41bfe72..35ec74c66e 100644 --- a/docs/en/compute-edition/33/admin-guide/welcome/utilities-and-plugins.adoc +++ b/docs/en/compute-edition/33/admin-guide/welcome/utilities-and-plugins.adoc @@ -1,13 +1,78 @@ == Utilities and plugins -All Prisma Cloud utilities and plugins can be downloaded directly from the Console UI +All Prisma Cloud utilities and plugins can be downloaded directly from the Console UI. ifdef::compute_edition[] They are also bundled with the release tarball you download from the xref:../welcome/releases.adoc[Customer Support Portal] endif::compute_edition[] -To download the utilities from Prisma Cloud Console, go to *Manage > System > Utilities*. -From there, you can download: +=== Downloading Utilities from the Prisma Cloud Console +. Navigate to *Manage* > *System* > *Utilities*. ++ +You will find a list of downloadable utilities and plugins available for various platforms. +. For each utility, you can: +- Click the *Download* button to download the utility directly to your system. +- Click the *Copy* button to copy a curl command to run anywhere. -* Jenkins plugin. -* Linux Container Defender image. -* twistcli for Linux, macOS, and Windows. +=== General Utilities + +. *Jenkins plugin*: The Jenkins plugin enables integration with Prisma Cloud for seamless security scanning in your CI/CD pipeline. ++ +To download the plugin for Prisma Cloud integration, use any of the following methods: + +* Use the *Download* button to download the plugin directly. +* Use the *Copy* button to retrieve a curl command for remote download. + +. *VMware Tanzu tile*: The VMware Tanzu Tile allows you to integrate Prisma Cloud with VMware Tanzu, enabling security across your Tanzu-managed workloads. + ++ +To download the plugin for Prisma Cloud integration, perform any of the following actions: + +* Use the *Download* button to download the Tanzu integration tile for direct deployment into your VMware Tanzu environment. +* Use the *Copy* button to get a curl command for remote download. + +. OpenAPI Spec (Beta): The OpenAPI Spec provides a schema definition for the Prisma Cloud API. ++ +To download the plugin for Prisma Cloud integration, use any of the following methods: + +* Use the *Download* button to download the current OpenAPI specification in Beta. +* Use the *Copy* button to download the OpenAPI spec using curl. + +. Defender Image: Download the Defender image to install in your container environments. + ++ +To download the image, perform any of the following actions: + +* Use the *Download* button to download the Defender image. +* Use the *Copy* button for a curl command. + +In addition, you can use the checksum to ensure the security of Defender images and protect them from tampering. Click the *Show Checksum* button to display the checksum and verify the downloaded image. Click *Hide Checksum* to hide the checksum after you have copied it. + +=== Twistcli Tool + +The twistcli tool is a command-line utility for interacting with Prisma Cloud to scan containers, images, serverless functions, and IaC (Infrastructure-as-Code) templates. + +Different versions are available for various platforms: + +* Linux x86_64 platform: Download the twistcli for standard Linux x86_64 architectures. +* Linux ARM64 platform: Download for ARM64-based systems. +* macOS x86_64 platform: Download for macOS on Intel-based systems. +* macOS ARM64 platform: Download for Apple Silicon (M1/M2) systems. +* Windows platform: Download the twistcli for Windows environments. + +For each platform, you have the option to either: +* Download: Download the utility directly. +* Copy: Copy a curl command to retrieve the tool remotely. + +=== Path to Console + +When using the Jenkins plugin or the twistcli tool, you need to configure them with the correct Console address. + +Use the Copy icon to copy the console path from the *Path to Console* section. + +=== API Token + +For access to Prisma Cloud APIs, you will require an API token. + +Use the Copy icon to copy the token details from the *API Token* section. This token is used for authentication when making API requests to the Prisma Cloud Console. + +The Console UI also shows the token validity. Ensure that the token is stored securely and is rotated before expiration to avoid disruptions in API access.