paloaltonetworks / panos.pan.dev

PAN-OS® for Developers site

This repository has been migrated to pan.dev

Please direct any future commits to the pan.dev Repository.

panos.pan.dev's Issues

[Community Health Assessment] Changes needed

This issue was opened by a bot called Community Health (PANW) because this repo has failed too many community health checks.

Repo maintainers: Please take the time to fix the issues in the table to reach the target score. These improvements will help others find your work and contribute to it. This issue will update as your score improves until it hits the target score.

Click More info for instructions to fix each item.

Health Check	Pass	Score	More Info
Contains a meaningful README.md file	✅	20 / 20	More info
SUPPORT.md file exists	❌	0 / 20	More info
Repo has a description	✅	15 / 15	More info
Has a recognized open source license	✅	15 / 15	More info
Has a descriptive repo name	✅	15 / 15	More info
Required topics attached to repo	✅	15 / 15	More info
CONTRIBUTING.md file with contribution guidelines	✅	5 / 5	More info
Has custom issue and pull request templates	❌	0 / 5	More info

Current score: 85
Target threshold: 100
Total possible: 110

Issue with "Expedition 2.0 Installation" in @site/docs/expedition/expedition_qs.md

Thank you for taking the time to help us improve our documentation! Please describe the problem and a suggested fix below and we'll get back to you as soon as we can. --DevRel

Describe the problem

The installation script check for expedition being already installed utilizes the wrong command to list applications and therefore never recognizes expedition as installed.

Suggested fix

Utilize "apt list --installed" instead of "apt-get list --installed"

Check if some packages has already been installed

expeditionAlreadyInstalled=$(apt list --installed | grep -c expedition)
if [ "$expeditionAlreadyInstalled" -ne 0 ]; then
    printTitleFailed "This script has been prepared to install Expedition from scratch"
    printTitleFailed "Expedition package is already present"
    exit 1
else
    printTitle "This machine does not have Expedition installed"
fi;

Incorrect Python Example for Expedition Zip Preparation

Thank you for taking the time to help us improve our documentation! Please describe the problem and a suggested fix below and we'll get back to you as soon as we can. --DevRel

Describe the problem

The python example for STEP 1: Initiate a Zip preparation for migration at the URL below is incorrect. In the response from the Expedition API the key under expedition is resources, not resource as listed in the documentation.

https://panos.pan.dev/docs/expedition/creating_migration_zip_2/

Relevant response data from the API.

      "data": {
        "total-objects": null,
        "fields": null,
        "columns": null,
        "content": {
          "expedition": {
            "resources": {
              "zipId": 860292
            }
          }
        }

Suggested fix

--- a/docs/expedition/creating_migration_zip_2.mdx
+++ b/docs/expedition/creating_migration_zip_2.mdx
@@ -126,7 +126,7 @@ values={[
 print('PREPARE MIGRATION ZIP')
 r = requests.get('https://'+ip+'/api/v1/prepare/zip', data=data, verify=False, headers=hed)
 response=r.json()
-zipID = json.dumps(response['Contents']['response']['data']['content']['expedition']['resource']['zipId'])
+zipID = json.dumps(response['Contents']['response']['data']['content']['expedition']['resources']['zipId'])
 print(zipID+'\n')

Issue with "Export security rule hitcount to CSV" in @site/docs/apis/panos_tutorials_rule_hit_count.md

Thank you for taking the time to help us improve our documentation! Please describe the problem and a suggested fix below and we'll get back to you as soon as we can. --DevRel

Describe the problem

Broken pan-python and pango links following doc dir restructure.

Suggested fix

Update links.

Docbar hides heading on scroll

The new docbar hides the heading on scroll when following a doc TOC link.

[Website] Article TOC showing up at the bottom of the content

Describe the problem

The Table of Contents for an article on some articles shows up at the bottom of the article instead of being on the right side.
Example: https://panos.pan.dev/docs/panos_tutorials_address_group

Suggested fix

Move it back to the right of the page :-)

Issue with "Quickstart" in @site/docs/panpython_qs.md

Thank you for taking the time to help us improve our documentation! Please describe the problem and a suggested fix below and we'll get back to you as soon as we can. --DevRel

Describe the problem

Testing

Suggested fix

Testing

Issue with "PAN Device Framework Quickstart" in @site/docs/apis/pandevice_qs.md

Thank you for taking the time to help us improve our documentation! Please describe the problem and a suggested fix below and we'll get back to you as soon as we can. --DevRel

Describe the problem

Broken "Usage guide" link.

Suggested fix

Change to correct link URL.

Issue with "Terraform ELB Integration" in @site/docs/cloud/terraform_elb.md

Thank you for taking the time to help us improve our documentation! Please describe the problem and a suggested fix below and we'll get back to you as soon as we can. --DevRel

Describe the problem

when I run the script prep_tf.py it gives the error.

Traceback (most recent call last):
File "C:\Users\Chiranjeev Sinha\Desktop\terraform\palo alto autoscale\aws_modules_version\prep_tf.py", line 70, in
main()
File "C:\Users\Chiranjeev Sinha\Desktop\terraform\palo alto autoscale\aws_modules_version\prep_tf.py", line 48, in main
key, value = line.split("=")
ValueError: need more than 1 value to unpack

I'm new to python so I don't understand what is this error. I tried to google it but no luck.
I am using it to generate terraform.tfvars from output.tfvars.
Could you please help me on this.

2nd. when I make terraform.tfvars manually and run terraform apply: it gives me below error:
terraform.exe plan

Error: resource 'aws_cloudformation_stack.LambdaCustomResource' config: unknown variable referenced: 'LambdaENIQueue'; define it with a 'variable' block

Error: resource 'aws_cloudformation_stack.LambdaCustomResource' config: unknown variable referenced: 'UntrustSecurityGroup'; define it with a 'variable' block

Error: resource 'aws_cloudformation_stack.LambdaCustomResource' config: unknown variable referenced: 'TrustSecurityGroup'; define it with a 'variable' block

Error: resource 'aws_cloudformation_stack.LambdaCustomResource' config: unknown variable referenced: 'MgmtSecurityGroup'; define it with a 'variable' block

---

i have verified the variables are declared already.

Issue with "Automating IP Blocking" in @site/docs/panos_dag_qs.md

Describe the problem

I want more PURPLE!

Suggested fix

IDK, Add more purple

Issue with "PAN-OS® APIs and SDKs" in @site/docs/apis.md

Thank you for taking the time to help us improve our documentation! Please describe the problem and a suggested fix below and we'll get back to you as soon as we can. --DevRel

Describe the problem

Broken links due to dir structure change

Suggested fix

Fix links to other docs

Issue with "Automating IP Blocking" in @site/docs/apis/panos_dag_qs.md

Thank you for taking the time to help us improve our documentation! Please describe the problem and a suggested fix below and we'll get back to you as soon as we can. --DevRel

Describe the problem

Broken links to other docs.

Suggested fix

Update links.

Issue with "Expedition 2.0" in @site/docs/expedition.md

Thank you for taking the time to help us improve our documentation! Please describe the problem and a suggested fix below and we'll get back to you as soon as we can. --DevRel

Describe the problem

Supported vendor matrix table illegible in dark mode

Suggested fix

Perhaps use a different emoji?

Instead of ✔️ use ☑️ or ✅

Issue with "Quickstart" in @site/docs/panpython_qs.md

Thank you for taking the time to help us improve our documentation! Please describe the problem and a suggested fix below and we'll get back to you as soon as we can. --DevRel

Describe the problem

Testing

Suggested fix

Testing

"Products" position in the topbars

The Products menu in the topbar is in different positions in cortex.pan.dev, panos.pan.dev and xsoar.pan.dev. Position should be consistent across the websites.