Merge pull request #18 from Azure-Samples/https-readme-update

https readme update

Author: idg-sam

README.md

@@ -153,21 +153,27 @@ Open `application.properties` in the msal-web-sample/src/main/resources folder.
 - Replace *Enter_the_Client_Secret_Here* with the **key value** noted earlier.
 - Replace *OboApi* with the API exposed in the `Web Api app` **(api://{clientId})**.
 
-If you want to use https with localhost, you must have a certificate.
-Use the `keytool` utility (included in JRE) if you want to generate self-signed certificate.
+#### HTTPS on localhost
 
-```Bash
-keytool -genkeypair -alias testCert -keyalg RSA -storetype PKCS12 -keystore keystore.p12 -storepass password
-```
+If you are only testing locally, you may skip this step. If you deploy your app to Azure App Service (for production or for testing), https is handled by Azure and you may skip this step. Note that https is essential for providing critical security and data integrity to your applications, and http should not be used outside of testing scenarios. If you need to configure your application to handle https, complete the instructions in this section.
 
-You may then put the following key-value pairs into your `application.properties` file.
+1. Use the `keytool` utility (included in JRE) if you want to generate self-signed certificate.
 
-```ini
-server.ssl.key-store-type=PKCS12
-server.ssl.key-store=classpath:keystore.p12
-server.ssl.key-store-password=password
-server.ssl.key-alias=testCert
-```
+    ```Bash
+    keytool -genkeypair -alias testCert -keyalg RSA -storetype PKCS12 -keystore keystore.p12 -storepass password
+    ```
+
+2. Put the following key-value pairs into your [application.properties](msal-web-sample/src/main/resources/application.properties) file.
+
+    ```ini
+    server.ssl.key-store-type=PKCS12
+    server.ssl.key-store=classpath:keystore.p12
+    server.ssl.key-store-password=password
+    server.ssl.key-alias=testCert
+    ```
+
+3. Change both occurrences of `8080` to `8443` in the msal-web-sample's [application.properties](msal-web-sample/src/main/resources/application.properties) file.
+4. Update your java_webapp Azure AD application registration redirects (e.g., `https://localhost:8443/msal4jsample/secure/aad` and `https://localhost:8443/msal4jsample/graph/me`) on the [Azure Portal](https://portal.azure.com).
 
 #### Configure known client applications for service (Java-webapi)
 

msal-web-sample/src/main/resources/application.properties

@@ -1,8 +1,11 @@
 aad.authority=https://login.microsoftonline.com/common/
 aad.clientId=Enter_the_Application_Id_Here
 aad.secretKey=Enter_the_Client_Secret_Here
+
+# change the port to 8443 if running HTTPS on localhost
 aad.redirectUri=http://localhost:8080/msal4jsample/secure/aad
 aad.oboApi=api://Enter_the_Obo_Api_Application_Id_Here/access_as_user
 aad.webapp.defaultScope=api://Enter_the_Obo_Api_Application_Id_Here/.default
 
+# change the port to 8443 if running HTTPS on localhost
 server.port=8080