PaloAltoNetworks / PaloAltoNetworks/pan.dev

Issue with "Create IKE gateways"

Open
#266 3 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

documentation
Dominant language
MDX
Stars
78
Forks
88
Avg merge
5d 17h
Merged PRs (30d)
18

Description

Documentation link

https://pan.dev/access/api/prisma-access-config/post-sse-config-v-1-ike-gateways/

Describe the problem

Your old documentation used to give me specifications of what was acceptable local and remote peer type. The new format just does a reg expression based on the type that is specified. It makes it difficult to "guess" what values you accept as a test as you have different GUI requirements from what the API takes. For instance you have:

  • IP Address
  • FQDN
  • Email
  • KexID
    As possible type values, but I can't tell what values you will accept nor do you explain the proper values that you will accept.

Suggested fix

Update your document as it was previously where it specified the type that you accept instead of having to guess and create an IKE tunnel with each type to figure out what the correct values are.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the linked Prisma Access API documentation for POST SSE Config v1 IKE gateways and compare it with the earlier documentation referenced in the issue. Document the accepted local and remote peer values for each peer type, then verify that the page clearly distinguishes API values from GUI requirements.

Written by the indexing model from the issue text.

Assessment

Domain
api, documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.