Azure AD Integration - Fetch Users

Integrating Azure AD with PhishGuard 

Integrating Azure Active Directory (Azure AD) with PhishGuard enables seamless user management and enhances security awareness training. This knowledge base article provides detailed instructions on how to register an app in Azure AD, configure permissions, create a client secret, and set up PhishGuard to fetch users from Azure AD.

Prerequisites:

Before proceeding with the integration, ensure that:

• Your Azure account has permissions to manage applications in Azure Active Directory.
• You have one of the following Azure AD roles with the required permissions: Application administrator, Application developer, Cloud application administrator.

Steps to Register an App:

1. Sign in to the Azure Portal.
2. Navigate to Azure Active Directory.
3. Under "Manage," select "App Registration" > "New registration."
4. Enter a display name for your app and click "Register."
   
   

After the registration process is complete, the app overview pane will be displayed.

Granting Required Permissions:

1. Click on "API permissions" > "Add a permission" > "Microsoft Graph" > "Application permissions" > "User.Read.All" > "Add Permissions."
2. Grant admin consent for the organization.
   
   

After granting the required permissions, proceed to create a client secret.

Creating a Client Secret:

• Select "Certificates & secrets" > "New client secret".
• Add a description for the client secret and click "Save".
  

PhishGuard Configurations:

After registering the app, granting required permissions, and creating a client secret, follow these steps to configure PhishGuard:

1. Add your Tenant ID, Client ID, and Client secret to Azure Fetch Users App settings
   
2. Navigate to "Groups" > "New Group" > Choose "Azure AD" and click on "Import targets from Azure AD" and users data should be imported.
   
3. Optional Filtering: When importing from Azure AD, you can filter users based on their status (enabled or disabled) and department.   
   

By following these steps, you can seamlessly integrate Azure AD with PhishGuard, allowing for efficient user management and targeted security awareness training.