Skip to content

hmcts/azure-app-proxy-manager

Repository files navigation

azure-app-proxy-manager

This tool allows you to manage Azure AD Application Proxy applications from a YAML file. It is based on the Configure Application Proxy using the Microsoft Graph API tutorial by Microsoft.

Its goal is to allow you to completely manage your application proxy applications in a declarative way.

Prerequisites

  • Azure AD Premium P1 or P2 license.
  • Application administrator role or Directory.ReadWrite.All Graph API permission.
  • Azure CLI
  • Node.js 18 or higher
  • Yarn

Installing app proxy

See Azure Active Directory Application Proxy Implementation

Configuring app proxy

Create a YAML file with your applications in it. See the sample to get started.

yarn dlx azure-app-proxy-manager --config apps.yaml

apps.yaml schema

There is a JSON schema provided at apps.schema.json This is the quickest and easiest way to configure an app with autocompletion and documentation on the properties.

IDE Configuration:

Features to be implemented

  • Blog

Contributing

You can run this locally with:

yarn install
yarn build
yarn node --enable-source-maps lib/main.js --config apps.yaml

Tests

Login to Azure with an account that has the Application Administrator role in the tenant. It's recommended you use a sandbox tenant (e.g. E5 SANDBOX) for this.

Then run:

yarn test

Releases

Code pushed to the main branch is not published as a new release by default. Once your Pull Request has been merged, draft a new release. Once the release is published a Github Action is triggered to push the latest version to NPM.