Table of Contents

Azure Marketplace Guide

The user performing this installation must be an authorized M365 tenant Administrator.

  • Visit the offer page

  • Click the "Get It Now" button, and on the following screen, select a "Plan" option and click the blue "Create" button. Azure Marketplace Create Screenshot

  • Click into the "Basics" tab. Select an Azure "Subscription", specify a new "Resource Group" specifically for the Swirl Managed App, select a Region, and provide an Application Name of your choosing. The "Managed Resource Group" value should already be provided. Click the "Next" button to save this configuration. Azure Marketplace Basics Screenshot

Make note of the Application Name value as it will be used in the next steps!

  • Click into the "App Registration" tab and read the instructions provided there. Azure Marketplace Select Screenshot

  • Download the script using the link at the bottom of the "App Registration" tab and run it in the target installation tenant. The "Application Name" value from above is required in some of the script inputs.

    Enter the FQDN for the Swirl app: <your-application-name>.<your-domain>
Enter your Azure Tenant ID: <your-tenant-id>
Enter your Azure Subscription ID: <your-subscription-id>
Enter your name of the App to register (no spaces, use _ or - for multiword): <your-application-name>
Enter your DNS Zone Resource Group: <your-DNS-zone-resource-group>

Save the script output as it will be used in for the next step!

  • Click into the "Deployment Configuration" tab. Fill out the form, including all required values, using the values reported by the script from the previous step. Azure Marketplace Configure Screenshot
Field Explanation
Environment Your "Application Name" from the Basics tab.
Client ID Value provided by the swirl_appreg.sh script
Object ID Value provided by running the az command found in the tooltips: az ad signed-in-user show --query id -o tsv
User Identity Name Value provided by the swirl_appreg.sh script
Azure DNS Zone The existing DNS Zone the application will be deployed in (e.g.: example.com)
DNS Zone Resource Group Value required for Swirl to automatically update the DNS Zone swirl will be registered in. Search your Azure DNS Zones for the appropriate Zone name to identify the the Resource Group this zonefile is associated with.
App Endpoint Prefix Your "Application Name" from the Basics tab.
OpenAI API Key Allows Swirl to connect to and use an OpenAI account via the API.
App Admin User Email The email of the user registering/deploying this application
  • When all of the above steps are completed, click into the "Review + create" tab and review your configuration. Click the "Create" button to complete the setup and install Swirl! Azure Marketplace Confirm Screenshot

Questions

If you encounter errors or warnings, please contact support for assistance (see below).