Merge pull request #215738 from henrymbuguakiarie/msid-update-tutorial-v2-shared-device-mode

[msid][pm-update] tutorial-v2-shared-device-mode(ADO-2132925)

Author: ttorble

articles/active-directory/develop/tutorial-v2-shared-device-mode.md

@@ -9,7 +9,7 @@ ms.service: active-directory
 ms.subservice: develop
 ms.topic: tutorial
 ms.workload: identity
-ms.date: 1/15/2020
+ms.date: 11/03/2022
 ms.author: henrymbugua
 ms.reviewer: brandwe
 ms.custom: aaddev, identityplatformtop40
@@ -22,13 +22,14 @@ In this tutorial, Android developers and Azure Active Directory (Azure AD) tenan
 In this tutorial:
 
 > [!div class="checklist"]
-> * Download a code sample
-> * Enable and detect shared-device mode
-> * Detect single or multiple account mode
-> * Detect a user switch, and enable global sign-in and sign-out
-> * Set up tenant and register the application in the Azure portal
-> * Set up an Android device in shared-device mode
-> * Run the sample app
+>
+> - Download a code sample
+> - Enable and detect shared-device mode
+> - Detect single or multiple account mode
+> - Detect a user switch, and enable global sign-in and sign-out
+> - Set up tenant and register the application in the Azure portal
+> - Set up an Android device in shared-device mode
+> - Run the sample app
 
 ## Prerequisites
 
@@ -64,21 +65,21 @@ Here's an example of the auth_config.json file included in the **app**>**main**>
 
 ```json
 {
- "client_id":"Client ID after app registration at https://aka.ms/MobileAppReg",
- "authorization_user_agent":"DEFAULT",
- "redirect_uri":"Redirect URI after app registration at https://aka.ms/MobileAppReg",
- "account_mode":"SINGLE",
- "broker_redirect_uri_registered": true,
- "shared_device_mode_supported": true,
- "authorities":[
-  {
-   "type":"AAD",
-   "audience":{
-     "type": "AzureADandPersonalMicrosoftAccount",
-     "tenant_id":"common"
-   }
-  }
- ]
+  "client_id": "Client ID after app registration at https://aka.ms/MobileAppReg",
+  "authorization_user_agent": "DEFAULT",
+  "redirect_uri": "Redirect URI after app registration at https://aka.ms/MobileAppReg",
+  "account_mode": "SINGLE",
+  "broker_redirect_uri_registered": true,
+  "shared_device_mode_supported": true,
+  "authorities": [
+    {
+      "type": "AAD",
+      "audience": {
+        "type": "AzureADandPersonalMicrosoftAccount",
+        "tenant_id": "common"
+      }
+    }
+  ]
 }
 ```
 
@@ -88,7 +89,7 @@ Shared-device mode allows you to configure Android devices to be shared by multi
 
 Use `isSharedDevice()` to determine if an app is running on a device that is in shared-device mode. Your app could use this flag to determine if it should modify UX accordingly.
 
-Here's a code snippet that shows how you could use `isSharedDevice()`.  It's from the `SingleAccountModeFragment` class in the sample app:
+Here's a code snippet that shows how you could use `isSharedDevice()`. It's from the `SingleAccountModeFragment` class in the sample app:
 
 ```Java
 deviceModeTextView.setText(mSingleAccountApp.isSharedDevice() ? "Shared" : "Non-Shared");
@@ -204,6 +205,31 @@ private void onSignOutClicked()
 }
 ```
 
+### Receive broadcast to detect global sign out initiated from other applications
+
+To receive the account change broadcast, you'll need to register a broadcast receiver.  It’s recommended to register your broadcast receiver via the [Context-registered receivers](https://developer.android.com/guide/components/broadcasts#context-registered-receivers).
+
+When an account change broadcast is received, immediately [get the signed in user and determine if a user has changed on the device](#get-the-signed-in-user-and-determine-if-a-user-has-changed-on-the-device). If a change is detected, initiate data cleanup for previously signed-in account. It is recommended to properly stop any operations and do data cleanup.
+
+The following code snippet shows how you could register a broadcast receiver.
+
+```java
+private static final String CURRENT_ACCOUNT_CHANGED_BROADCAST_IDENTIFIER = "com.microsoft.identity.client.sharedmode.CURRENT_ACCOUNT_CHANGED";
+private BroadcastReceiver mAccountChangedBroadcastReceiver;
+private void registerAccountChangeBroadcastReceiver(){
+    mAccountChangedBroadcastReceiver = new BroadcastReceiver() {
+        @Override
+        public void onReceive(Context context, Intent intent) {
+            //INVOKE YOUR PRIOR ACCOUNT CLEAN UP LOGIC HERE      
+        }
+    };
+    IntentFilter filter = new
+
+    IntentFilter(CURRENT_ACCOUNT_CHANGED_BROADCAST_IDENTIFIER);
+    this.registerReceiver(mAccountChangedBroadcastReceiver, filter);
+}
+```
+
 ## Administrator guide
 
 The following steps describe setting up your application in the Azure portal and putting your device into shared-device mode.
@@ -257,7 +283,7 @@ The device is now in shared mode.
 
 :::image type="content" source="media/tutorial-v2-shared-device-mode/shared-device-mode-screen.png" alt-text="App screen showing shared device mode enabled":::
 
- Any sign-ins and sign-outs on the device will be global, meaning they apply to all apps that are integrated with MSAL and Microsoft Authenticator on the device. You can now deploy applications to the device that use shared-device mode features.
+Any sign-ins and sign-outs on the device will be global, meaning they apply to all apps that are integrated with MSAL and Microsoft Authenticator on the device. You can now deploy applications to the device that use shared-device mode features.
 
 ## View the shared device in the Azure portal