Refresh automation library documentation

Author: squioc

_shared_content/automate/library/microsoft-entra-id.md

@@ -6,7 +6,7 @@ type: playbook
 
 ![Microsoft Entra ID](/assets/playbooks/library/microsoft-entra-id.png){ align=right width=150 }
 
-Microsoft Entra ID (formely Azure Active Directory) is an enterprise identity service that provides single sign-on, multifactor authentication, and conditional access to guard against 99.9 percent of cybersecurity attacks.
+Microsoft Entra ID (formerly Azure Active Directory) is an enterprise identity service that provides single sign-on, multifactor authentication, and conditional access to guard against 99.9 percent of cybersecurity attacks.
 
 ## Configuration
 
@@ -28,7 +28,7 @@ Delete an app in azure AD. Requires the Application.ReadWrite.OwnedBy or Applica
 
 | Name      |  Type   |  Description  |
 | --------- | ------- | --------------------------- |
-| `id` | `string` | Object ID of the app. |
+| `objectId` | `string` | Object ID of the app. |
 
 ### Disable User
 
@@ -120,9 +120,9 @@ Get information about an user's authentication methods (such as their MFA status
 | --------- | ------- | --------------------------- |
 | `authenticationResults` | `array` |  |
 
-### Reset User Password
+### Reset User Password [DEPRECATED]
 
-Reset a user's password. You will need UserAuthenticationMethod.ReadWrite.All deleguated permission. And to disable the MFA authentication in your azure AD
+Reset a user's password (deprecated). You will need UserAuthenticationMethod.ReadWrite.All delegated permission. And to disable the MFA authentication in your azure AD
 
 **Arguments**
 
@@ -132,6 +132,27 @@ Reset a user's password. You will need UserAuthenticationMethod.ReadWrite.All de
 | `userPrincipalName` | `string` | Principal Name of the user. id or userPrincipalName should be specified. |
 | `userNewPassword` | `string` | New password, required to reset the old one of course. |
 
+### Reset User Password
+
+Resets a user's password by patching passwordProfile. Requires User-PasswordProfile.ReadWrite.All (Application), admin consent and appropriate Entra role assignment
+
+**Arguments**
+
+| Name      |  Type   |  Description  |
+| --------- | ------- | --------------------------- |
+| `id` | `string` | ID of the user. Only one of id or userPrincipalName should be specified. |
+| `userPrincipalName` | `string` | Principal Name of the user. Only one of id or userPrincipalName should be specified. |
+| `userNewPassword` | `['string', 'null']` | New password, to reset the old one. Let empty to generate a random password. If not empty, should comply with https://learn.microsoft.com/en-us/entra/identity/authentication/concept-password-ban-bad-combined-policy |
+| `forceChangePasswordNextSignIn` | `boolean` | Determines if the user must change their password on the next sign-in. |
+| `forceChangePasswordNextSignInWithMfa` | `boolean` | Determines if the user must perform a multifactor authentication (MFA) before being forced to change their password. |
+
+
+**Outputs**
+
+| Name      |  Type   |  Description  |
+| --------- | ------- | --------------------------- |
+| `newPassword` | `string` | New password |
+
 ### Revoke Sign in
 
 Invalidates all the refresh tokens issued to applications for a user. Requires the User.ReadWrite.All or Directory.ReadWrite.All permissions.
@@ -140,7 +161,7 @@ Invalidates all the refresh tokens issued to applications for a user. Requires t
 
 | Name      |  Type   |  Description  |
 | --------- | ------- | --------------------------- |
-| `id` | `string` | ID of the app. |
+| `id` | `string` | ID of the user. id or userPrincipalName should be specified. |
 | `userPrincipalName` | `string` | Principal Name of the user. id or userPrincipalName should be specified. |
 
 ## Set up
@@ -170,7 +191,7 @@ Invalidates all the refresh tokens issued to applications for a user. Requires t
 #### Add permissions
 
 1. Go to `Manage` > `API permissions`
-2. Click `Add a permissions`
+2. Click `Add a permission`
 3. On the right panel, Select `Microsoft APIs` tab
 4. Click `Microsoft Graph`
 5. Click `Application permissions`
@@ -180,11 +201,12 @@ Invalidates all the refresh tokens issued to applications for a user. Requires t
     3. `UserAuthenticationMethod.ReadWrite.All`
     4. `Directory.ReadWrite.All`
     5. `AuditLog.Read.All`
+    6. `User-PasswordProfile.ReadWrite.All`
 7. Click `Add permissions`
 8. In the `API permissions` page, click `Grant admin consent for TENANT_NAME`
 9. Click `Yes` in the `Grant admin consent confirmation` modal
 
 
 ## Extra
 
-Module **`Microsoft Entra ID` v2.9.0**
+Module **`Microsoft Entra ID` v2.10.16**

mkdocs.yml

@@ -99,7 +99,7 @@ nav:
       - Asset Context Panel (coming soon): xdr/features/investigate/asset_context_panel.md
       - Events Query Language: xdr/features/investigate/events_query_language.md
       - Querying Events: xdr/features/investigate/querying_events.md
-      - Query Builder: 
+      - Query Builder:
         - Discover the query builder: xdr/features/investigate/query_builder.md
         - Create and manage queries: xdr/features/investigate/create_manage_queries.md
         - Share and duplicate queries: xdr/features/investigate/share_queries.md
@@ -440,7 +440,6 @@ nav:
     - Threat Intelligence:
       - Prodaft USTA: integration/categories/threat_intelligence/prodaft_usta.md
   - List of Playbooks Actions:
-    - Overview: integration/action_library/overview.md
     - Applicative:
       - ElasticSearch: integration/action_library/elasticsearch.md
       - Mandrill: integration/action_library/mandrill.md
@@ -487,10 +486,12 @@ nav:
     - IAM:
       - Microsoft Active Directory: integration/action_library/microsoft-active-directory.md
       - Microsoft Entra ID: integration/action_library/microsoft-entra-id.md
+      - Microsoft Entra ID: integration/action_library/microsoft-entra-id.md
     - Network:
       - Fortigate Firewalls: integration/action_library/fortigate-firewalls.md
       - Sophos: integration/action_library/sophos.md
       - Zscaler: integration/action_library/zscaler.md
+    - Overview: integration/action_library/overview.md
     - Threat Intelligence:
       - BinaryEdge's API: integration/action_library/binaryedge-s-api.md
       - Censys: integration/action_library/censys.md