Strata Cloud Manager
Manage: Snippets
Table of Contents
Manage: Snippets
Use snippets to group configurations that you can quickly push to your firewalls or
deployments.
Where Can I Use This? | What Do I Need? |
---|---|
|
|
Use snippets to group configurations that you can quickly push to
your firewalls or deployments.
A snippet is a configuration object, which can't fit into
a hierarchy, or grouping of configuration objects, that you can associate with a folder,
deployment, or device. Snippets are used to standardize a common base configuration for
a set of firewalls or deployments allowing you to quickly onboard new devices with a
known good configuration and reducing the time required to onboard a new device. For
example, you can onboard a new firewall in a remote branch office. You can associate a
set of snippets that contain all of the required network and policy rule configurations
with the folder the new firewall belongs to. This reduces the time required to set up
the firewall to protect the remote branch office.
Snippet associations have a top-down priority in the
event of conflicting object values. Rules with duplicate names are not allowed, and
validation fails during the creation of a snippet with the same name in any folder or
while associating a snippet to a folder if the snippet with the same name is already
associated.
This means that if the first and the last associated snippets have different
values for the same object, the value from the first snippet is inherited by the device
or deployment. Additionally, all configurations inherited from a snippet can be
overridden at the child folder, deployment, or device level.
Within a folder hierarchy, a snippet might
only be associated one time within any folder hierarchy. This means that a snippet can’t
be associated with both a folder and the folder nested under it. However, you can
associate the same snippet with different folders or folders nested under different
folders. Snippets that are already associated with a folder in the folder hierarchy are
grayed out so they can’t be used more than once where
applicable.
![](/content/dam/techdocs/en_US/dita/_graphics/cloud-management/associate-snippet-example.png)
Cross-Scope Configuration Referenceability in Snippets
This feature allows you to reference any common configurations or objects attached to
a global scope and push it to Prisma Access and NGFW firewalls. These shared objects
and configurations within the global scope are available to all the snippets. A
snippet associated with the global scope is considered as a global snippet. Objects
defined within these snippets attached to the global scope, can be referenced across
any snippets in the configuration.
For example, you can create a snippet named Global Variable to consolidate variables
and attach it to a Global scope. This ensures easy referencing and availability
across all other snippets in the configuration. Similarly, you can effectively
manage custom URL categories for access policy rules, threat prevention profiles,
zones, addresses, and other objects representing standard network segments.
Create a Snippet
Create and associate a snippet with a folder, deployment, or device to apply a
common base configuration to a group of devices. You can associate as many
snippets with a folder, deployment, or device as needed.
Snippets can be modified and reassociated with any folder, deployment, or device
at any time after creation.
Custom snippets that are no longer in use can be deleted.
- Log in toStrata Cloud Manager.
- Selectand expand the Configuration Scope to view theManageConfigurationNGFW and Prisma AccessOverviewSnippets.
- Add Snippet.
- Create the snippet.
- Give the snippet a descriptiveName.
- (Optional) Enter aDescriptionfor the snippet.
- (Optional) Assign one or moreLabels.You can select an existing label or create a new label by typing the label you wanted to create.
- Create.Newly created snippets are listed categorized underLocalsnippets. After the snippets are published, they are moved under Published snippets.
- Create your snippet configuration.You’re now in the Configuration Scope for the snippet. All configurations you create while in the snippet scope occurs only for the snippet.While in the snippet scope, you can review the snippetOverviewto see detailed information about the snippet. This includes information such as the number of variables, information about the snippet was created and last updated, and the list of all folders, deployments, and devices the snippet is associated with.
- Associate a snippet.
- Selectand expand the Configuration Scope to view theManageConfigurationNGFW and Prisma AccessOverviewConfig Tree.
- Select the folder, deployment, or device you want to associate the snippet with.
- Edit theConfig Snippet.
- Add the snippets that you want to associate and order them as needed.If you are associating snippet to the global scope, it becomes referenceable and available to all the other snippets in the configuration. All the snippets will be able to reference the objects you have in the snippet attached to the global folder.
- Close.
- Push Configto push your configuration changes to your network.
Modify a Snippet
Modify your snippet configurations, details, and associations.
Custom snippets no longer associated with a folder,
deployment, or device can be deleted.
- Log in toStrata Cloud Manager.
- Selectand expand the Configuration Scope to view theManageConfigurationNGFW and Prisma AccessOverviewSnippets.
- Select the snippet you want to modify.After you select a snippet, you’re redirected to the snippetOverview.
- (Optional) Edit the snippet to modify theName,Description, or to change or assign additionalLabels. Enable or disablePause Updateto see the configuration diffs and decide to accept the change.
- Edit theSnippet Associationsto reassociate the snippet with a different folder, deployment, or device or to associate the snippet with additional folders, deployments, or devices.Exit the snippet reassociation screen to apply the changes.
- Make any changes to the snippet configuration as needed.
- Push Config.
Delete a Snippet
Delete your custom snippets to keep your configurations organized. Snippets must
be unassociated with any firewalls, folders, or deployments before they are able
to be deleted. Deleting predefined snippets is not supported.
- Log in toStrata Cloud Manager.
- Selectand expand theManageConfigurationNGFW and Prisma AccessOverviewConfiguration Scopeto view the Snippets.
- Click the three vertical dots of the custom snippet you want to delete.
- Deletethe snippet.Snippets currently associated with folders, deployments, or devices can't be deleted. First edit theSnippet Associationsto remove all existing associations before it can be deleted.
Clone a Snippet
If you want to use an existing snippet as a template for a new snippet, you can
easily clone it so you do not have to configure a new object.
Cloned snippets are not associated with any devices, folders, or deployments,
allowing you to customize them freely without having to disassociate them before
you begin your configurations.
- Log in toStrata Cloud Manager.
- Selectand expand theManageConfigurationNGFW and Prisma AccessOverviewConfiguration Scopeto view the Snippets.
- Click the three vertical dots of the custom snippet you want to clone.
- Clonethe snippet.
- (Optional) Give the cloned snippet a new name.
Share a Snippet Configuration
This feature provides a unique and flexible method for sharing common
configurations across any tenants including in a multitenant environment. You
can save and manage various configurations as snippets, easily sharing them
across tenants under a customer account. This capability provides considerable
flexibility and control in managing shared configurations across different
tenant environments.
Additionally, this feature supports centralizing configuration management for
common scenarios among tenants and overseeing global configurations within a
multibusiness unit setup.
In this framework, the publisher tenant shares snippets with the subscriber
tenant, while the subscriber tenant receives snippets from the publisher
tenant.
- Log in toStrata Cloud Manager.
- On the publisher tenant, select, select theManageConfigurationNGFW and Prisma AccessOverviewGlobalconfiguration scope.
- Establish Trust Between the Tenants: Establish a connection between the subscriber and publisher tenants to enable the sharing of snippets.
- ClickSubscriber TenantunderTrusted Tenants for Snippet Sharing.
- Add Subscriber Tenant.
- Enter theTSG IDto add as a subscriber tenant, andCheck TSG ID. This ensures prevention of randomly generated TSG or serialized TSG-based attacks.Upon successful validation, a confirmation message indicates that the TSD ID has been verified.
- Next: Generate Pre Shared Key.Copy the generated PSK. You will enter this PSK when validating the publisher tenant in step 4.
- Go to subscriber tenant, selectand set the configuration scope toManageConfigurationNGFW and Prisma AccessOverviewGlobal.
- ThePublisher Tenantsstatus underTrusted Tenants for Snippet Sharingshows asPending.
- ClickPublisher TenantsandEnter Pre Shared Keygenerated in the previous step, andValidatethe subscriber tenant.After successful validation, a message confirms the tenant as trusted, establishing trust between the subscriber and publisher tenants.
- Publish a Snippet to a subscriber tenant.
- Create and associate the snippet with a folder.Newly created snippets are available underLocalsnippets.
- TheOverviewtab shows snippet details such as name, description, creation time (when the snippet was loaded on the subscriber side), last updated time, and labels details.
- TheSubscriber Tenantstab shows the tenant name, published version on the tenant, last published date, and publish status.
- ClickPublished Versionto review configuration changes.
- Before publishing a snippet to a tenant,Add SubscriberandSaveit.
- TheVersion Snapshotsgives a history of your snippet configuration. In this screen, you can compare configuration snapshots with your candidate configuration, andSave Version SnapshotorLoadan earlier configuration snapshot as your candidate. Click theVersionnumber to view the configuration differences.
- TheAudit Historyprovides an audit trail of all actions initiated by the administrator. It logs details such as the published version number, changes made, the owner of the change, the date and time of the change, and specifics of the change.
- On theSubscriber Tenanttab, select the tenant name andPublish.This sends the publish request to the subscriber tenant. In theStatuscolumn indicates that Snippet Successfully published to subscriber and the snippet will be available under Published snippets.
- Verify on the subscriber tenant.
- Go to, and select the snippet underOverviewConfiguration ScopeSnippetsSubscribedsnippets.You're redirected to the snippetOverviewwhich shows details such as the publisher tenant's name, description, TSG ID, snippet creation time, last updated time, labels, and pause update details.
- Delete the trust.Subscribed snippets associated with folders or firewalls can only be cloned and can't be deleted.
- Go to subscriber or publisher tenant.
- ClickSubscriber TenantunderTrusted Tenants for Snippet Sharing.
- Select theTenant Name, andDelete Trust.
After deleting the trust, the snippet will no longer be associated with the firewall, or folder and becomes a local snippet.
Snippet Classification
- Predefined: All Strata Cloud Manager users can access these snippets to quickly set up new firewalls and deployments with best practice configurations.
- Local: These editable snippets are created within the tenant and can't share them with other subscriber tenants.
- Published: Trusted subscriber tenants have access to these shared snippets, which can't be cloned or edited.
- Subscribed: These snippets, shared by the publisher tenant, can be cloned by users but can't be edited.