@@ -31,36 +31,40 @@ given user. When combined with Sync subscription queries, these features
3131determine what data a user can :ref:`read and write from a synced database
3232<sdks-write-synced-database>`.
3333
34- You can also associate :ref:`metadata <sdks- user-metadata>` or
35- :ref:`custom data <sdks-custom-user-data>` with user accounts.
34+ The SDK also provides functionality to extend a user object, and manage
35+ multiple users or identities:
3636
37- Users can have multiple identities. For more information, refer to
38- :ref:`sdks-link-user-identities`.
39-
40- Your app can manage multiple users on a device. For more information, refer
41- to :ref:`sdks-multi-user-applications`.
37+ - You can associate :ref:`metadata <sdks-user-metadata>` or
38+ :ref:`custom data <sdks-custom-user-data>` with user accounts.
39+ - Users can have multiple identities. For more information, refer to
40+ :ref:`sdks-link-user-identities`.
41+ - Your app can manage multiple users on a device. For more information, refer
42+ to :ref:`sdks-multi-user-applications`.
4243
4344For more information about authentication providers, identities, and user
4445sessions, refer to :ref:`Authenticate & Manage Users <users-and-authentication>`
4546in the App Services documentation.
4647
47- .. tip:: Atlas Device SDK Users Differ from Other Types of Atlas Users
48+ .. _sdks-device-sdk-users-vs-other-users:
49+
50+ Atlas Device SDK Users vs. Other User Types
51+ -------------------------------------------
4852
49- Atlas Device SDK users are distinct from :ref:`database users <mongodb-users>`
50- or :ref:`Atlas account users <atlas_users>`. SDK users are bounded by the
51- App Services App where they are registered, and only have access to
52- resources you provide through the App. Your application can let SDK users:
53+ Atlas Device SDK users are distinct from :ref:`database users <mongodb-users>`
54+ or :ref:`Atlas account users <atlas_users>`. SDK users are bounded by the
55+ App Services App where they are registered, and only have access to
56+ resources you provide through the App. Your application can let SDK users:
5357
54- - :ref:`Read and write from a synced database <sdks-write-synced-database>`
55- - :ref:`Call an Atlas Function <sdks-call-function>`
56- - Call :ref:`Data API <data-api>` or :ref:`custom HTTPS endpoints <custom-endpoints>`
57- - Read and write from specified collections and databases in MongoDB Atlas
58- through :ref:`the MongoClient API <sdks-access-mongodb>`
58+ - :ref:`Read and write from a synced database <sdks-write-synced-database>`
59+ - :ref:`Call an Atlas Function <sdks-call-function>`
60+ - Call :ref:`Data API <data-api>` or :ref:`custom HTTPS endpoints <custom-endpoints>`
61+ - Read and write from specified collections and databases in MongoDB Atlas
62+ through :ref:`the MongoClient API <sdks-access-mongodb>`
5963
60- SDK users do not have direct Atlas database access, or direct Atlas account
61- access. It is your responsibility to manage these application users,
62- including complying with data retention or deletion policies and regulatory
63- requirements where you publish your applications.
64+ SDK users do not have direct Atlas database access, or direct Atlas account
65+ access. It is your responsibility to manage these application users,
66+ including complying with data retention or deletion policies and regulatory
67+ requirements where you publish your applications.
6468
6569.. _sdks-create-users:
6670
@@ -98,8 +102,9 @@ more details about how to link these identities, refer to
98102Manually Create Users
99103~~~~~~~~~~~~~~~~~~~~~
100104
101- If your app uses email/password authentication, you must manually register a
102- user to create a user object. For more information about registering
105+ If your app uses email/password authentication, your app must explicitly
106+ register a user to create the user object in App Services. This method is
107+ independent of authenticating a user. For more information about registering
103108email/password users, refer to :ref:`sdks-email-password-user-register`.
104109
105110You can also manually create email/password users through App Services. For
@@ -173,7 +178,7 @@ server.
173178Calling the user delete method performs the following:
174179
175180- Deletes synced databases associated with the user from the device.
176- - deletes the ``User`` object from the Atlas App Services server
181+ - Deletes the ``User`` object from the Atlas App Services server.
177182- Sets the user state on the device to removed.
178183
179184Because this method deletes any synced databases owned by the user, you
0 commit comments