Skip to content

Commit ad49e58

Browse files
author
Melony QIN
authored
Add token URL
Add information about how to get JWT token in case users would consume the app with Fiddler or Postman.
1 parent 1c9c998 commit ad49e58

1 file changed

Lines changed: 16 additions & 2 deletions

File tree

docs/big-data-cluster/big-data-cluster-consume-apps.md

Lines changed: 16 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -93,6 +93,12 @@ In order to access the RESTful web service for the app you have deployed you fir
9393
|GDR1| `https://[IP]:[PORT]/docs/swagger.json`|
9494
|CU1 and later| `https://[IP]:[PORT]/api/v1/swagger.json`|
9595

96+
From the output of previous example, CU4 release and the IP address of controller (10.1.1.3 in the example) and the port number (30080), the URL would look like the following :
97+
98+
```bash
99+
https://10.1.1.3 :30080/api/v1/swagger.json
100+
```
101+
96102
> For version information, see [Release history](release-notes-big-data-cluster.md#release-history).
97103
98104
Open the appropriate URL in your browser using the IP address and port you retrieved running the [`describe`](#retrieve-the-endpoint) command above. Sign in with the same credentials you used for `azdata login`.
@@ -101,11 +107,19 @@ Paste the contents of the `swagger.json` into the [Swagger Editor](https://edito
101107

102108
![API Swagger](media/big-data-cluster-consume-apps/api_swagger.png)
103109

104-
Notice the `app` GET method as well as the `token` POST method. Since the authentication for apps uses JWT tokens, you will need to get a token my using your favorite tool to make a POST call to the `token` method. Here is an example of how to do just that in [Postman](https://www.getpostman.com/):
110+
Notice the `app` is GET method and to get the `token` would use POST method. Since the authentication for apps uses JWT tokens, you will need to get a token my using your favorite tool to make a POST call to the `token` method. With the same example, the URL to get JWT token would look like the follows :
111+
112+
```bash
113+
https://10.1.1.3 :30080/api/v1/token
114+
```
115+
116+
117+
Here is an example of how to do just that in [Postman](https://www.getpostman.com/):
105118

106119
![Postman Token](media/big-data-cluster-consume-apps/postman_token.png)
107120

108-
The result of this request will give you a JWT `access_token`, which you will need to call the URL to run the app.
121+
122+
The output of this request will give you a JWT `access_token`, which you will need to call the URL to run the app.
109123

110124
## Execute the app using the RESTful web service
111125

0 commit comments

Comments
 (0)