Added documentation for Introspection API

[divyaac]

No description provided.

[mladlow]

The RFC mentions that because this would expose information at a similar sensitivity to sys/raw, there would be more required to enable the endpoint. We should document somewhere how to enable and disable the feature. sys/raw config is documented here https://developer.hashicorp.com/vault/docs/configuration#parameters and the API docs (https://developer.hashicorp.com/vault/api-docs/system/raw) link to that page.

[divyaac]

Ah yes - added this as well.

[mladlow]

Thanks for adding the link, but I think we also should document what they need to change in the configuration to enable this?

[divyaac]

Spoke to Josh about this - it seems that sys/raw is off by default because it's a dangerous endpoint that if used incorrectly has the capacity to change storage.

Since this endpoint is a read only endpoint, we think it's probably not necessary to have it off by default.
The way it's currently implemented also configured this way.

I removed this portion form the docs.

[mladlow]

In the vercel preview, this link is broken - I think because the path in the api-docs-nav json doesn't have the internal part of the link. Edit (sorry missed this on the first pass)

[divyaac]

Fixed this in the current commit

[raskchanky]

Suggested change

	The `/sys/internal/inspect/router` is intended for Vault admin to inspect a specific internal subsystem for debugging purposes.
	The `/sys/internal/inspect/router` is intended for a Vault admin to inspect a specific internal subsystem of the router for debugging purposes.

[raskchanky]

Suggested change

	This token can be accessed with a root token or sudo privileges.
	This endpoint can be accessed with a root token or sudo privileges.

[divyaac]

Done!

[raskchanky]

Looks great! Just a few minor nits.