JDSRAO / AzureAppRegistrationMonitor

Azure App Registration Monitor scans the entire tenancy and consolidates a list of credentails (certificates and secrets) which are due to for expiry in configurable number of days and sends a consolidated email to relavent parties to take necessary action.

Azure App Registration Monitor

Azure App Registration Monitor scans the entire tenancy and consolidates a list of credentails (certificates and secrets) which are due to for expiry in configurable number of days and sends a consolidated email to relavent parties to take necessary action.

How this helps?

• Most of the time we face the challenge of having to follow up with the credentials expiry dates either by keeping reminders or manully checking the azure portal or in the worst case renew the credentails after they have expired. But no more, this app will monitor the azure tenency for app registrations expiring in the upcoming few days (configurable) and notify relavent people/owners and azure admins (configurable) to take necessary actions.

Help us improve the application

Help us improve out the application by sending us pull-requests or opening a GitHub Issue

Please note that this is still a work in progress

Table of Contents

1. Development
2. Configuration
3. License

Development

To use the samples with Git, clone the project repository with git clone https://github.com/JDSRAO/AzureAppRegistrationMonitor.git

After cloning the respository:

• To build the proejct, open AzureAppRegistrationMonitor.sln solution file in Visual Studio 2022 and build the solution.
• Alternatively, open the project directory in command prompt and type cd AzureAppRegistrationMonitor/AzureAppRegistrationMonitor and build with 'dotnet build' or 'msbuild' specifying the target project file.

The easiest way to use this proejct without using Git is to download the zip file containing the current version. You can then unzip the entire archive and use the solution in Visual Studio 2022.

Configration

• Below describes the necessary configruation that are needed for the application.

Microsoft Entra ID Configuration

• Please create a new app registration in Microsoft Entra ID.
• After creation, make a note of the client Id and tenant Id.
• Generate a new client secret for the above generated client Id.
• Under "Certificates and Secrets", add a new client secret and note it down.
• Under "API Permissions" menu,
  • Click on add permission
  • Select Microsoft Graph
  • Select Delegated Permissions
  • Add the below permissions
    • Application.ReadAll
    • Application.ReadWriteAll
    • Application.ReadWrite.OwnedBy
    • Directory.ReadAll
    • Mail.Send
    • User.Read

Function App Configuration Instructions

• AppRegistrationMonitorOrchestratorTimerScheduleCron - Schedule to run the app monitor in CRON expression.
• ClientId - Follow steps mentioned in Microsoft Entra ID Configuration to get this value.
• ClientSecret - Follow steps mentioned in Microsoft Entra ID Configuration to get this value.
• EmailFromAddress - An email, from which mailbox the summary email should be sent. Please note that, this user should have an active mailbox
• EmailSubject - Subject of the summary email.
• EmailToAzureAdmins - A semicolon (;) separated values of email(s), to whom the summary email should be sent for action. For example, [e-mail];[e-mail]
• IncludeExpiredCredentails - Flag to either include or exclude expired credentails from the summary email (supported values true/false).
• IncludeOwnersInEmail - Flag to either include or exclude owners in the CC section of the summary email.
• SearchCriteria - A semicolon (;) seperated search criteria based on which app registrations are filtered. If nothing is specified, the monitor will include all the app registaritons.
• TenantId - Follow steps mentioned in Microsoft Entra ID Configuration to get this value.
• TimeInDaysForNotification - Number of days before expiration when the notification needs to be sent.

License

Please refer here for license information