Skip to content

Commit 7511e18

Browse files
pstack2021MarcialRosales
authored andcommitted
Update oauth2-examples.md
Some updates as a result of my review @MarcialRosales, can you have a quick look through them to ensure they are correct, thank you.
1 parent 908e8e6 commit 7511e18

File tree

1 file changed

+8
-9
lines changed

1 file changed

+8
-9
lines changed

site/oauth2-examples.md

Lines changed: 8 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -126,7 +126,7 @@ It was signed with the symmetric key.
126126

127127
![JWT token](./img/oauth2/admin-token-signed-sym-key.png)
128128

129-
To configure RabbitMQ Management UI with OAuth 2.0 we need the following configuration entries:
129+
To configure the RabbitMQ Management UI with OAuth 2.0, the following configuration entries are required:
130130
<pre class="lang-erlang">
131131
...
132132
{rabbitmq_management, [
@@ -140,8 +140,8 @@ To configure RabbitMQ Management UI with OAuth 2.0 we need the following configu
140140

141141
### <a id="identity-provider-initiated-logon" class="anchor" href="#identity-provider-initiated-logon">Identity-Provider initiated logon</a>
142142

143-
When RabbitMQ is offered as a service from a web portal, it is more convenient to navigate to RabbitMQ Management UI
144-
with a single click. The web portal is responsible for getting a token before taking the user to the RabbitMQ Management UI web page.
143+
When RabbitMQ is provided as a service from a web portal, it is easy to navigate to the RabbitMQ Management UI
144+
with a single click. The web portal retrieves a token before taking the user to the RabbitMQ Management UI web page.
145145

146146
<pre class="lang-plain">
147147
[ Idp | WebPortal ] ----&gt; 2. /#/login?access_token=&lt;TOKEN&gt;---- [ RabbitMQ Cluster ]
@@ -150,12 +150,11 @@ with a single click. The web portal is responsible for getting a token before ta
150150
1. rabbit_admin from a browser 3. validate token
151151
</pre>
152152

153-
At step 1, `rabbit_admin` user navigates to the web portal and clicks on the hyperlink associated to a RabbitMQ
154-
cluster. At step2, the web portal obtains a token and redirects the user to RabbitMQ. And at step 3,
153+
How it works, firstly, the `rabbit_admin` user navigates to the web portal and clicks on the hyperlink associated with a RabbitMQ
154+
cluster. Next, the web portal obtains a token and redirects the user to RabbitMQ. Finally,
155155
RabbitMQ validates the token in the http request and if it is valid, it redirects the user to the overview page.
156156

157-
By default, RabbitMQ Management UI is configured with **service-provider initiated logon**. We have to configure
158-
the Management plugin by adding just one entry to the configuration as shown below:
157+
By default, the RabbitMQ Management UI is configured with **service-provider initiated logon**, to configure **Identity-Provider initiated logon**, add one entry to the configuration. An example is provided here:
159158

160159
<pre class="lang-erlang">
161160
...
@@ -170,8 +169,8 @@ the Management plugin by adding just one entry to the configuration as shown bel
170169
</pre>
171170

172171
**NOTE**: When the user logs out, or its RabbitMQ session expired, or the token expired, the user is directed to the
173-
Management landing page which presents the user with a button labeled **Click here to login**. The user is
174-
never automatically redirected back to the url configured in `oauth_provider_url`. Only when the user clicks on the button, it is redirected to the configured in `oauth_provider_url`.
172+
RabbitMQ Management landing page which has a **Click here to login** button. The user is
173+
never automatically redirected back to the url configured in the `oauth_provider_url`. It is only when the user clicks **Click here to login** , the user is redirected to the configured url in `oauth_provider_url`.
175174

176175
## <a id="access-other-protocols" class="anchor" href="#access-other-protocols">Access other protocols using OAuth 2.0 tokens</a>
177176

0 commit comments

Comments
 (0)