Merge pull request #111039 from curtand/sms0410

Azure AD user-help] SMS sign-in UX

Author: megvanhuygen

articles/active-directory/user-help/media/sms-sign-in-explainer/sms-sign-in-banner.png

@@ -0,0 +1,72 @@
+---
+title: SMS sign-in user experience for phone number (preview) - Azure AD
+description: Learn more about SMS sign-in user experience for new or existing phone numbers
+services: active-directory
+author: curtand
+manager: daveba
+ms.service: active-directory
+ms.subservice: user-help
+ms.workload: identity
+ms.topic: conceptual
+ms.date: 03/25/2020
+ms.author: curtand
+ms.reviewer: kasimpso
+ms.custom: "user-help, seo-update-azuread-jan"
+---
+
+# Use your phone number as a user name (preview)
+
+Registering your device gives your phone access to your organization's services and doesn't allow your organization access to your phone.
+
+## User registers a number
+
+If your organization hasn't made SMS sign-in available, you won't see an option for it when registering a phone with your account.  
+
+## User with new phone number
+
+If you get a new phone or new number and you register it with an organization for which SMS sign-in is available, you experience the normal phone registration process:
+
+1. Select **Add method**.
+1. Select **Phone**.
+1. Enter phone number and select **Text me a code**.
+1. After you enter the code, select **Next**.
+1. You will see a prompt that says "SMS verified. Your phone was registered successfully."
+
+> [!Important]
+> Due to a known issue in the preview, for a short time adding phone number will not register the number for SMS sign-in. You'll have to sign in with the added number and then follow the prompts to register the number for SMS sign-in.
+
+### The phone number is in use
+
+If you try to use a phone number that someone else in your organization is using, you'll see the following message:
+
+![Error message when your phone number is already used](media/sms-sign-in-explainer/sms-sign-in-error.png)
+
+Reach out to your admin to remediate the problem.
+
+## User with an existing number
+
+If you are already using a phone number with an organization, and using your phone number as a user name becomes available, the following steps can help you sign in.
+
+1. When SMS sign-in is available, a banner is displayed asking if you'd like to enable the phone number for SMS sign-in:
+
+    [![](media/sms-sign-in-explainer/sms-sign-in-banner.png "Banner to enable SMS sign-in for a phone number")](media/sms-sign-in-explainer/sms-sign-in-banner.png#lightbox)
+
+1. Also, an **Enable** button appears if you select the caret on the phone method tile:
+
+    [![](media/sms-sign-in-explainer/sms-sign-in-phone-method.png "Banner to enable SMS sign-in for a phone number")](media/sms-sign-in-explainer/sms-sign-in-phone-method.png#lightbox)
+
+1. To enable the method, select **Enable**. You are prompted to confirm the action:
+
+    ![Confirmation dialog to enable SMS sign-in for a phone number](media/sms-sign-in-explainer/sms-sign-in-confirmation.png)
+
+1. Select **Enable**.
+
+## Delete phone number
+
+1. To delete the phone number, select the delete button on the SMS sign-in phone method tile.
+
+    [![](media/sms-sign-in-explainer/sms-sign-in-delete-method.png "Banner to delete SMS sign-in for a phone number")](media/sms-sign-in-explainer/sms-sign-in-delete-method.png#lightbox)
+
+2. When prompted to confirm the action, select **OK**.
+
+You can't remove a phone number that is in use as the default sign-in method. To remove the number, you would have to change the default sign-in method, then remove the phone number again.

articles/active-directory/user-help/media/sms-sign-in-explainer/sms-sign-in-confirmation.png

@@ -74,6 +74,8 @@
       href: security-info-setup-text-msg.md
     - name: Set up phone calls
       href: security-info-setup-phone-number.md
+    - name: Set up SMS sign-in
+      href: sms-sign-in-explainer.md
     - name: Set up security key
       href: security-info-setup-security-key.md      
     - name: Set up email