Skip to content

Commit 642a62f

Browse files
author
Emmanuel Girard
committed
Update OTP Code labels and related images, Fix few typos, Add the Optional Tasks Section
1 parent 1407a42 commit 642a62f

20 files changed

+136
-14
lines changed

docs/class3/module2/lab01.rst

Lines changed: 105 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,17 @@
11
Lab 1: Deploy PUA with Client Certificate Authentication
22
===============================================================
33

4+
Overview
5+
---------------------------------------------------------------
6+
7+
In this lab, we will focus on configuring and testing MFA (Multifactor Authentication) with F5 APM (Access Policy Manager).
8+
9+
We will be leveraging a client certificate for authentication to the webtop (HTML webpage) and creating ephemeral authentication (one-time password) to the endpoint (router, switch, management UI).
10+
11+
Users will begin the lab by starting the PUA containers and it’s dependencies. We will then access the PUA UI and deploy PUA Smartcard.
12+
13+
The lab will commence with testing and validating user access.
14+
415
Solution Design
516
---------------------------------------------------------------
617

@@ -78,7 +89,7 @@ Task 1 - Start PUA
7889

7990
|image_udf_dep_pua_access|
8091

81-
#. In the new browser Tab, execute the flowing shell commands to launch the PUA containers and it dependencies :
92+
#. In the new browser Tab, execute the following shell commands to launch the PUA containers and it dependencies :
8293

8394
.. code-block:: console
8495
@@ -265,7 +276,7 @@ Task 3 - Review Deployment details and Deploy
265276
Task 4 - Track Deployment progress
266277
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
267278

268-
If you go back to the **PUA Deploy Agent WebSSH** tab in your local browser, you should see the logs generated by the the deployment of the PUA (SmartCard) Playbook.
279+
If you go back to the **PUA Deploy Agent WebSSH** tab in your local browser, you should see the logs generated by the deployment of the PUA (SmartCard) Playbook.
269280

270281
#. Confirm that the deployment is successful by looking for **Playbook deployed successfully** log.
271282

@@ -305,11 +316,11 @@ Task 2 - Validate user1 Access
305316

306317
#. In the **Applications and Links** section of the Webtop
307318

308-
* Click on **bigip1** and observe the the username at the bottom left corner
319+
* Click on **bigip1** and observe the username at the bottom left corner
309320

310321
|image_chrome_incognito_pua_webtop_user1_bigip1|
311322

312-
* Click on **bigip5** and observe the the username at the bottom left corner
323+
* Click on **bigip5** and observe the username at the bottom left corner
313324

314325
|image_chrome_incognito_pua_webtop_user1_bigip5|
315326

@@ -349,11 +360,11 @@ Task 4 - Validate user2 Access
349360

350361
#. In the **Applications and Links** section of the Webtop
351362

352-
* Click on **bigip1** and observe the the username at the bottom left corner
363+
* Click on **bigip1** and observe the username at the bottom left corner
353364

354365
|image_chrome_incognito_pua_webtop_user2_bigip1|
355366

356-
* Click on **bigip5** and observe the the username at the bottom left corner
367+
* Click on **bigip5** and observe the username at the bottom left corner
357368

358369
|image_chrome_incognito_pua_webtop_user2_bigip5|
359370

@@ -387,6 +398,77 @@ Task 5 - Acces PUA Webtop using an invalid certificate
387398

388399
|image_chrome_incognito_pua_webtop_denied|
389400

401+
.. warning:: Close the Incognito window before going to the next task
402+
403+
404+
405+
406+
407+
408+
Optional Tasks
409+
---------------------------------------------------------------
410+
411+
Task 1 - Access PUA Webtop as user1
412+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
413+
414+
#. Right click on the **PUA Webtop** Bookmark and click on **Open in Incognito window**
415+
416+
|image_chrome_incognito_pua_webtop|
417+
418+
#. Select certificate associated with **User1** in the **Select a certificate** dialog box and Click **Ok**.
419+
420+
|image_chrome_incognito_pua_webtop_user1_cert|
421+
422+
#. Click **Click here to continue**
423+
424+
|image_chrome_incognito_pua_webtop_banner|
425+
426+
#. Webtop should now be available
427+
428+
|image_chrome_incognito_pua_webtop_links|
429+
430+
Task 2 - Validate user1 Access to BIG-IP 5 TMUI
431+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
432+
433+
#. In the **Applications and Links** section of the Webtop
434+
435+
* Click on **bigip5-tmui** and observe at the top of the newly open browser tab that your are connected to the **bigip5.f5lab.local** as **user1** with the **Administrator** role.
436+
437+
|image_chrome_incognito_pua_webtop_user1_bigip5_tmui|
438+
439+
440+
Task 3 - Validate user1 Access to a Linux Host
441+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
442+
443+
#. In the **Applications and Links** section of the Webtop
444+
445+
* Click on **linux-host** and observe the username at the bottom left corner
446+
447+
|image_chrome_incognito_pua_webtop_user1_linuxhost|
448+
449+
450+
451+
452+
#. In the **linux-host** tab, elevate access to root by typing the following command:
453+
454+
.. code-block:: console
455+
456+
sudo -i
457+
458+
|image_chrome_incognito_pua_webtop_user1_linuxhost_sudo|
459+
460+
#. Click on **Menu** at the bottom left of the screen and select **Credentials** when prompted with **[sudo] password for user1:**
461+
462+
|image_chrome_incognito_pua_webtop_user1_linuxhost_menu_credentials|
463+
464+
#. This will automatically type the ephemeral password for **user1** and the linux prompt should now display **root**
465+
466+
|image_chrome_incognito_pua_webtop_user1_linuxhost_sudo_success|
467+
468+
.. warning:: You successfully completed this lab Close the Incognito window before going to the next lab.
469+
470+
471+
390472
|image_end_of_lab|
391473

392474
.. |image_pua_sol_design| image:: media/lab01/pua_smartcard_solution.png
@@ -450,4 +532,21 @@ Task 5 - Acces PUA Webtop using an invalid certificate
450532
:width: 480
451533

452534

535+
536+
.. |image_chrome_incognito_pua_webtop_user1_bigip5_tmui| image:: media/lab01/chrome_incognito_pua_webtop_user1_bigip5_tmui.png
537+
:width: 480
538+
.. |image_chrome_incognito_pua_webtop_user1_linuxhost| image:: media/lab01/chrome_incognito_pua_webtop_user1_linuxhost.png
539+
:width: 480
540+
.. |image_chrome_incognito_pua_webtop_user1_linuxhost_sudo| image:: media/lab01/chrome_incognito_pua_webtop_user1_linuxhost_sudo.png
541+
:width: 480
542+
543+
544+
545+
.. |image_chrome_incognito_pua_webtop_user1_linuxhost_menu_credentials| image:: media/lab01/chrome_incognito_pua_webtop_user1_linuxhost_menu_credentials.png
546+
:width: 480
547+
.. |image_chrome_incognito_pua_webtop_user1_linuxhost_sudo_success| image:: media/lab01/chrome_incognito_pua_webtop_user1_linuxhost_sudo_success.png
548+
:width: 480
549+
550+
551+
453552
.. |image_end_of_lab| image:: media/lab01/end_of_lab.png

docs/class3/module2/lab02.rst

Lines changed: 18 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,20 @@
11
Lab 2: Deploy PUA Alternate Webtop
22
=====================================================
33

4+
Overview
5+
---------------------------------------------------------------
6+
7+
In this lab, we will focus on configuring and testing an ALT webtop with F5 APM (Access Policy Manager).
8+
9+
The ALT webtop creates a single tile (webtop link), that launches a portal containing more endpoints specified from a .csv configuration file.
10+
This will allow us to configure multiple endpoints faster and more efficiently.
11+
12+
We will also leverage the Smartcard Client Authentication (created in Lab 1) for authentication to the webtop.
13+
14+
We will begin the lab by adding the .csv file as a resource and deploying the ALT webtop. Next, we will need to update the Access Policy to include the new ALT webtop tile (webtop link) to the webtop.
15+
16+
This lab will commence with testing and validating user access.
17+
418
Expected time to complete: **15 minutes**
519

620
.. note:: This is an add-on playbook that works with an existing PUA deployment (such as :doc:`/class3/module2/lab01`)
@@ -108,7 +122,7 @@ Task 3 - Review Deployment details and Deploy
108122
Task 4 - Track Deployment progress
109123
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
110124

111-
If you go back to the **PUA Deploy Agent WebSSH** tab in your local browser, you should see the logs generated by the the deployment of the PUA ALT WEBTOP Playbook.
125+
If you go back to the **PUA Deploy Agent WebSSH** tab in your local browser, you should see the logs generated by the deployment of the PUA ALT WEBTOP Playbook.
112126

113127

114128
#. Confirm that the deployment is successful by looking for **Playbook deployed successfully** log.
@@ -172,7 +186,7 @@ Task 3 - Add Alternate Webtop to the Webtop Links
172186

173187
|image_bigip1_tmui_access_profiles_pua_smartcard_ressources|
174188

175-
#. Click the **Webtop Links 3/5** tab.
189+
#. Click the **Webtop Links 4/5** tab.
176190

177191
|image_bigip1_tmui_access_profiles_pua_smartcard_ressources_acls|
178192

@@ -228,13 +242,13 @@ Task 2 - Validate user1 Access
228242

229243
|image_chrome_incognito_pua_webtop_user1_altwebtop|
230244

231-
* Click on the **>_** icon of **bigip15** and observe the the username at the bottom left corner
245+
* Click on the **>_** icon of **bigip15** and observe the username at the bottom left corner
232246

233247
|image_chrome_incognito_pua_webtop_user1_altwebtop_bigip15_arrow|
234248

235249
|image_chrome_incognito_pua_webtop_user1_altwebtop_bigip15|
236250

237-
* Click on the **>_** icon of **bigip17** and observe the the username at the bottom left corner
251+
* Click on the **>_** icon of **bigip17** and observe the username at the bottom left corner
238252

239253
|image_chrome_incognito_pua_webtop_user1_altwebtop_bigip17_arrow|
240254

docs/class3/module2/lab03.rst

Lines changed: 13 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,15 @@
11
Lab 3: Deploy PUA with Multifactor Authentication
22
===========================================================
33

4+
Overview
5+
---------------------------------------------------------------
6+
7+
In the final lab of this lab series, we will focus on deploying F5’s Privileged User Access solution incorporating multi-factor authentication (MFA) using a one-time-password (OTP) with F5's Access Policy Manager (APM).
8+
9+
This lab is similar to Lab 1. However, it will demonstrate the use of token-based MFA rather than smartcard/client certificate. We will begin the lab by accessing the PUA UI, then deploying PUA MFA.
10+
11+
The lab will conclude with testing and validating user access.
12+
413
Expected time to complete: **15 minutes**
514

615
.. _Access PUA:
@@ -126,7 +135,7 @@ Task 3 - Review Deployment details and Deploy
126135
Task 4 - Track Deployment progress
127136
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
128137

129-
If you go back to the **PUA Deploy Agent WebSSH** tab in your local browser, you should see the logs generated by the the deployment of the PUA MFA Playbook.
138+
If you go back to the **PUA Deploy Agent WebSSH** tab in your local browser, you should see the logs generated by the deployment of the PUA MFA Playbook.
130139

131140
#. Confirm that the deployment is successful by looking for **Playbook deployed successfully** log.
132141

@@ -199,15 +208,15 @@ Task 2 - Validate user2 Access
199208

200209
#. In the **Applications and Links** section of the Webtop
201210

202-
* Click on **bigip1** and observe the the username at the bottom left corner
211+
* Click on **bigip1** and observe the username at the bottom left corner
203212

204213
|image_chrome_incognito_pua_webtop_user2_bigip1|
205214

206-
* Click on **bigip5** and observe the the username at the bottom left corner
215+
* Click on **bigip5** and observe the username at the bottom left corner
207216

208217
|image_chrome_incognito_pua_webtop_user2_bigip5|
209218

210-
.. warning:: Close the Incognito window before going to the next task
219+
.. warning:: You successfully completed this lab, Close the Incognito window.
211220

212221
|image_end_of_lab|
213222

118 KB
Loading
512 KB
Loading
140 KB
Loading
152 KB
Loading
155 KB
Loading
139 KB
Loading
148 KB
Loading

0 commit comments

Comments
 (0)