necouchman commented on code in PR #286:
URL: https://github.com/apache/guacamole-manual/pull/286#discussion_r2869770419
##########
src/json-auth.md.j2:
##########
@@ -282,26 +282,34 @@ Guacamole, will authenticate a user and grant them access
to the connections
described in the JSON (at least until the expires timestamp is reached, at
which point the JSON will no longer be accepted).
-In summary, after obtaining the `base64` data of your encrypted, signed JSON,
you can authenticate using one of the following methods:
+In summary, after obtaining the `base64` data of your encrypted, signed JSON,
+you can authenticate using one of the following methods:
-1. **URL Encoding Method**: Pass the URL-encoded base64 data directly in the
URL, like so:
- `{DOMAIN}/guacamole/?data={your_url_encoded_data}`
- You can obtain the URL-encoded data using the following Python command:
- `python3 -c "import urllib.parse; print(urllib.parse.quote('XXXX',
safe=''))"`
- replace `XXXX` with your base64.
+1. **GET Request Method**: URL-encode the base64 data and pass it in the
+ `data` URL parameter to the Guacamole web application:
+ `http://localhost:8080/guacamole/?data={your_url_encoded_data}`
+
+ There are several ways to URL-encode the data - for example, the following
+ one-line Python command works well:
+ `python3 -c "import urllib.parse; print(urllib.parse.quote('{your
base64_encoded_data}', safe=''))"`
- Alternatively, you can use an online tool to encode it.
-2. **POST Request Method**: As shown in the `curl` example above, you can also
make a POST request to `/api/tokens` with the `data` parameter in the request
body,
- where the value is the raw base64-encoded encrypted JSON:
+ Many programming languages include tools for URL-encoding data, and there
+ are online tools that can provide it for you, as well.
+
+2. **POST Request Method**: As shown in the `curl` example above, you can also
+ make a POST request to the `api/tokens` endpoint of your Guacamole Client
+ install with the `data` parameter in the request body, where the value is
+ the raw base64-encoded encrypted JSON:
Review Comment:
Got it - how's it look, now? Or is there a more proper way to represent
`application/x-www-form-urlencoded` data?
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
