.. _tasks-onboard-offboard-ms-users:

.. rst-class:: chapter-with-expand


Onboard and Offboard Microsoft Users
--------------------------------------

.. _21.1|VOSS-847:

Onboarding a Microsoft user involves importing users and related data to the customer level
from the Microsoft Cloud service, and then moving users to the correct sites as fully provisioned
subscribers.

Automated workflows configure imported objects once changes are synced in, and apply the required
configuration, policies, and licenses. This means administrators won't need to
continually monitor the sync, or to perform additional steps to complete the process.

Once synced in (at the customer or site level), administrators can manage Microsoft users and
subscribers via a single interface and login, from within the VOSS-4-UC Admin Portal. To maintain data
integrity, to manage licenses, and to automate number auditing for synced in users, regular, targeted backend
syncs poll for changes made at the device model layer.


Onboard Microsoft Users
........................


VOSS-4-UC provides two onboarding options for Microsoft users:

================================================ ==============================================================================
Sync users to customer level, and then to sites  :ref:`VOSS-4-UC-configuration-and-sync-for-microsoft`
     
                                                 This option starts with an initial import of dial plans, policies, licenses,
                                                 and Microsoft users, to the customer level (sync all to the tenant).

                                                 Then you will need to set up the configuration and user
                                                 move criteria before moving users to the sites (set up model filter criteria,
                                                 site defaults, quick add groups, subscriber profiles, and number inventory).

                                                 Finally, you have two options to move users to the sites as fully
                                                 provisioned subscribers:

                                                 * Run the overbuild to move multiple users to your sites at once.
                                                 * Add single users via Quick Add Subscriber (QAS)

                                                 When moving users to site, the VOSS-4-UC automated workflow applies the
                                                 required configuration, services, lines, policies, and licenses.

Sync users directly to sites                     :ref:`sync-with-flow-through-for-microsoft`

                                                 In this option, you run the initial sync together with flow through 
                                                 provisioning. In this case, you start by setting up the configuration and 
                                                 user move criteria before running the initial sync. That is, to set up
                                                 the model filter criteria, site defaults, quick add groups,
                                                 and subscriber profiles.

                                                 In addition, you will need to:

                                                 * Configure flow through provisioning criteria
                                                 * Enable flow through in the Global Settings

                                                 Once changes are synced in from the Microsoft Cloud, VOSS-4-UC automated
                                                 workflows move the tenant dial plan, policies, and licenses to the customer
                                                 level, and moves users directly to the appropriate sites as fully
                                                 provisioned subscribers.
================================================ ==============================================================================



.. .. include:: microsoft-user-management.uml


Offboard a User
.................

This procedure offboards a user.

1. Log in to the Admin Portal.
#. Go to **MS Subscriber Management > Subscribers**.
#. Click on the relevant subscriber.
#. On the **MS Licenses** tab, delete the licenses.



Related Topics
...............

*
  .. raw:: latex

     Microsoft Overview in the Core Feature Guide

  .. raw:: html

     <a href="concepts-microsoft-overview.html">Microsoft Overview</a>
*
  .. raw:: latex

     VOSS-4-UC Configuration and Sync in the Core Feature Guide

  .. raw:: html

     <a href="concepts-VOSS-4-UC-configuration-and-sync-for-microsoft.html">VOSS-4-UC Configuration and Sync</a>

*
  .. raw:: latex

     Sync with Flow Through in the Core Feature Guide

  .. raw:: html

     <a href="concepts-sync-with-flow-through-for-microsoft.html">Sync with Flow Through</a>