Skip to content

Commit db7f74f

Browse files
authored
Improving the README.md of 1.1 with screenshots and collapsable sections (#190)
* Trying to understand if pictures add value * Update README.md * Trying the expandable section for automation * layout pictures * Attempt to collapse the image * Fixing the details * Foldable image * fixing the expandable image * collapsable image * Pre-visible image
1 parent debe18b commit db7f74f

File tree

5 files changed

+40
-13
lines changed

5 files changed

+40
-13
lines changed

Diff for: 1-WebApp-OIDC/1-1-MyOrg/README.md

+40-13
Original file line numberDiff line numberDiff line change
@@ -32,26 +32,32 @@ To run this sample:
3232

3333
There is one project in this sample. To register it, you can:
3434

35-
- either use PowerShell scripts that **automatically** creates the Azure AD applications and related objects (passwords, permissions, dependencies) for you and modify the Visual Studio projects' configuration files. If you want to use this automation:
35+
- either use PowerShell scripts that **automatically** creates the Azure AD applications and related objects (passwords, permissions, dependencies) for you and modify the Visual Studio projects' configuration files.
3636

37-
1. On Windows run PowerShell and navigate to the solution's folder
38-
2. In PowerShell run:
37+
<details>
38+
<summary>Expand to see how to use this automation</summary>
3939

40-
```PowerShell
41-
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process -Force
42-
```
40+
1. On Windows run PowerShell and navigate to the solution's folder
4341

44-
3. Run the script to create your Azure AD application and configure the code of the sample application accordinly
42+
2. In PowerShell run:
4543

46-
```PowerShell
47-
.\AppCreationScripts\Configure.ps1
48-
```
44+
```PowerShell
45+
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process -Force
46+
```
47+
48+
3. Run the script to create your Azure AD application and configure the code of the sample application accordingly
49+
50+
```PowerShell
51+
.\AppCreationScripts\Configure.ps1
52+
```
4953
50-
> Other ways of running the scripts are described in [App Creation Scripts](./AppCreationScripts/AppCreationScripts.md)
54+
> Other ways of running the scripts are described in [App Creation Scripts](./AppCreationScripts/AppCreationScripts.md)
5155
52-
4. Open the Visual Studio solution and click start. That's it!
56+
4. Open the Visual Studio solution and click start. That's it!
5357
54-
- or, if you don't want to use automation, follow the steps below:
58+
</details>
59+
60+
- or, if you want to register your application with the Azure portal, follow the steps below:
5561
5662
#### Choose the Azure AD tenant where you want to create your applications
5763
@@ -68,9 +74,23 @@ As a first step you'll need to:
6874
1. When the **Register an application page** appears, enter your application's registration information:
6975
- In the **Name** section, enter a meaningful application name that will be displayed to users of the app, for example `WebApp`.
7076
- In the **Supported account types** section, select **Accounts in this organizational directory only ({tenant name})**.
77+
<details open=true>
78+
<summary>Expand/collapse screenshot</summary>
79+
80+
![Register app](../../ReadmeFiles/screenshot-register-app.png)
81+
82+
</details>
7183
> Note that there are more than one redirect URIs. You'll need to add them from the **Authentication** tab later after the app has been created succesfully.
84+
7285
1. Select **Register** to create the application.
7386
1. On the app **Overview** page, find the **Application (client) ID** value and record it for later. You'll need it to configure the Visual Studio configuration file for this project.
87+
<details open=true>
88+
<summary>Expand/collapse screenshot</summary>
89+
90+
![OVerview page](../../ReadmeFiles/screenshot-overview.png)
91+
92+
</details>
93+
7494
1. In the list of pages for the app, select **Authentication**..
7595
- In the Redirect URIs section, select **Web** in the combo-box and enter the following redirect URIs.
7696
- `https://localhost:44321/`
@@ -79,6 +99,13 @@ As a first step you'll need to:
7999
- In the **Advanced settings** | **Implicit grant** section, check **ID tokens** as this sample requires
80100
the [Implicit grant flow](https://docs.microsoft.com/azure/active-directory/develop/v2-oauth2-implicit-grant-flow) to be enabled to
81101
sign-in the user.
102+
<details open=true>
103+
<summary>Expand/collapse screenshot</summary>
104+
105+
![Authentication page](../../ReadmeFiles/screenshot-authentication.png)
106+
107+
</details>
108+
82109
1. Select **Save**.
83110
84111
> Note that unless the Web App calls a Web API, no certificate or secret is needed.

Diff for: ReadmeFiles/screenshot-authentication.png

152 KB
Loading

Diff for: ReadmeFiles/screenshot-new-registration.png

211 KB
Loading

Diff for: ReadmeFiles/screenshot-overview.png

146 KB
Loading

Diff for: ReadmeFiles/screenshot-register-app.png

104 KB
Loading

0 commit comments

Comments
 (0)