diff --git a/docs/getting-started/requirements.md b/docs/getting-started/requirements.md index 8a3d6d8a3c..49677119b2 100644 --- a/docs/getting-started/requirements.md +++ b/docs/getting-started/requirements.md @@ -175,6 +175,7 @@ export M365_PASSWORD="examplepassword" These two new environment variables are **required** to execute the PowerShell modules needed to retrieve information from M365 services. Prowler uses Service Principal authentication to access Microsoft Graph and user credentials to authenticate to Microsoft PowerShell modules. - `M365_USER` should be your Microsoft account email using the **assigned domain in the tenant**. This means it must look like `example@YourCompany.onmicrosoft.com` or `example@YourCompany.com`, but it must be the exact domain assigned to that user in the tenant. + ???+ warning If the user is newly created, you need to sign in with that account first, as Microsoft will prompt you to change the password. If you don’t complete this step, user authentication will fail because Microsoft marks the initial password as expired. diff --git a/docs/tutorials/microsoft365/getting-started-m365.md b/docs/tutorials/microsoft365/getting-started-m365.md index d5b94b178b..ef9a50da30 100644 --- a/docs/tutorials/microsoft365/getting-started-m365.md +++ b/docs/tutorials/microsoft365/getting-started-m365.md @@ -30,7 +30,7 @@ Go to the Entra ID portal, then you can search for `Domain` or go to Identity > ![Custom Domain Names](./img/custom-domain-names.png) -Once you are there just select the domain you want to use. +Once you are there just select the domain you want to use as unique identifier for your M365 account in Prowler Cloud/App. --- @@ -139,10 +139,7 @@ The permissions you need to grant depends on whether you are using user credenti Make sure you add the correct set of permissions for the authentication method you are using. -#### If using application(service principal) authentication - -???+ warning "Warning" - Currently Prowler Cloud only supports user authentication. +#### If using application(service principal) authentication (Recommended) To grant the permissions for the PowerShell modules via application authentication, you need to add the necessary APIs to your app registration. @@ -191,12 +188,15 @@ To grant the permissions for the PowerShell modules via application authenticati ![Final Permission Assignment](./img/final-permissions.png) +--- + +#### If using user authentication + +This method is not recommended because it requires a user with MFA enabled and Microsoft will not allow MFA capable users to authenticate programmatically after 1st September 2025. See [Microsoft documentation](https://learn.microsoft.com/en-us/entra/identity/authentication/concept-mandatory-multifactor-authentication?tabs=dotnet) for more information. + ???+ warning Remember that if the user is newly created, you need to sign in with that account first, as Microsoft will prompt you to change the password. If you don’t complete this step, user authentication will fail because Microsoft marks the initial password as expired. ---- - -#### If using user authentication (Currently Prowler Cloud only supports this method) 1. Search and select: diff --git a/docs/tutorials/prowler-app.md b/docs/tutorials/prowler-app.md index 6234fe7338..5178fb85b3 100644 --- a/docs/tutorials/prowler-app.md +++ b/docs/tutorials/prowler-app.md @@ -170,7 +170,7 @@ By default, the `kubeconfig` file is located at `~/.kube/config`. --- ### **Step 4.5: M365 Credentials** -For M365, Prowler App uses a service principal application with user and password to authenticate, for more information about the requirements needed for this provider check this [section](../getting-started/requirements.md#microsoft-365). Also, the detailed steps of how to add this provider to Prowler Cloud and start using it are [here](./microsoft365/getting-started-m365.md). +For M365, Prowler App uses a service principal application (before we already asked for user and password but now those parameters are optional, they will continue working only if you don't have MFA enabled) to authenticate, for more information about the requirements needed for this provider check this [section](../getting-started/requirements.md#microsoft-365). Also, the detailed steps of how to add this provider to Prowler Cloud and start using it are [here](./microsoft365/getting-started-m365.md). Prowler Cloud M365 Credentials