search

infobloxopen / infoblox-swagger-wapi

Swagger documentation for Infoblox grid REST APIs
16 stars 6 forks source link

Missing "version" field on home.php #2

Open dotdiego opened 3 years ago

dotdiego commented 3 years ago

There a missing field on the default form we see in the home.php page.

It's missing the version field, creating an impossibility to start the documentation generation on a container that has no access to the grid master.

DerPhlipsi commented 3 years ago

Hey @DIDev1,

this is most likely intended by the Infoblox guys. See the pre-requisits:

Pre-requisites

  • [...]
  • Connectivity between Grid master and Host

Seems to be a measure to ensure that the tool only works in combination with a running Infoblox environment.

Greetings, Phil

dotdiego commented 3 years ago

Hello,

No. The home.php only connects to Grid Master to know which versions are available. Then it copies all the files from the dist/v2.XX folder

So if you know which version you have access to, you don't need to have GM/Host connectivity.

Regards,

DerPhlipsi commented 3 years ago

Heyo,

thanks for looking at the code, which I've done myself also, since I was facing the same problem as you did. However, even if the script is simply checking which WAPI versions are compatible with your Infoblox cluster, it still needs to establish a connection to a working Infoblox setup, which would still fall under my assumption I made.

Remember: This is not a repo that simply contains an OAS3 spec, this is a repo containing an application that provides you with an Swagger UI AFTER having verifed that you have connectivity to a Infoblox system (even if this verification is really simplistic and nowhere near to being a proof-safe way to check, since the logic can be tricked simply by running a mock server). If this would be no requirement, the version field would simply be accessible as one of the default fields. And btw, this connection-requirement plays hand in hand with your question in #1 where the OAS3 spec files are non-valid JSON files, which could be a kind of obfuscation.

But if you want an official answer, you'll have to wait for someone of the Infoblox Team to answer here.

Greetings, Phil