Configure Azure OpenAI in Drupal Using miniOrange SharePoint integration module

Configure Azure OpenAI in Drupal using the miniOrange Azure OpenAI Integration module. This guide covers Azure OpenAI resource creation, model deployment, credential configuration, and connecting your Drupal site to Azure OpenAI services.

Prerequisites

Before you start, make sure you have:

• The miniOrange SharePoint Integration module is installed.
• You have administrator access to your Drupal site.
• An active Microsoft Azure account.
• Permission to create resources in Azure.
• Access to Azure AI Foundry.

Set Up Azure OpenAI in the Module

• After installing the module, navigate to the AI Settings tab in the module configuration.
• Select the AI Provider as Azure OpenAI + Microsoft Graph.
• Under the Connection section, enable the Azure AI Chat Widget toggle.

Create an Azure OpenAI Resource

• Sign in to the Azure Portal.
• Click Create a Resource.

• In the search bar, search for Azure OpenAI.
• Select Azure OpenAI from the search results.

• Click Create.
• Fill in the required information:
  • Subscription: Select the Azure subscription that will be used for billing.
  • Resource Group: Choose an existing resource group or create a new one.
  • Region: Select a region that supports Azure OpenAI services.
  • Resource Name: Enter a unique name for your Azure OpenAI resource.
  • Pricing Tier: Select the pricing tier that matches your organization's requirements.
  • After entering all required details, click Next.

• Azure may present additional configuration screens such as:
  • Networking
  • Security
  • Tags
  • Identity
• Review the settings and keep the default values unless your organization requires custom configurations.
• Click Next to continue.
• Azure will automatically validate your configuration.
• Wait for validation to complete successfully.
• Once done, click on the Create button.

• Azure will begin deploying your OpenAI resource. (Deployment may take several minutes.)
• Once deployment is completed successfully, your Azure OpenAI resource is ready to use.

Open the Created Resource

• After deployment click Go to Resource
• Open the Azure OpenAI resource you just created.
• From the resource page, click Go to Foundry Portal.

• Alternatively, open the Azure AI Foundry portal directly and select your newly created resource.
• Navigate to Deployments from the left-hand menu.
• Click Deploy Model.
• Choose Deploy a Base Model.

• Azure will display the available AI models.
• Select a model based on your requirements and Azure subscription plan
• Examples may include:
  • GPT-4o
  • GPT-4.1
  • GPT-4.1 Mini
  • GPT-4o Mini
• Select the agent based on your plan.

Configure Deployment Settings

• Deployment Name: Provide a unique deployment name.
• Deployment Type: Select Standard deployment.
• Using the Standard deployment option allows you to customize and manage the deployment configuration.
• Review your deployment settings.
• Click Create Resource and Deploy.

• Wait for the deployment process to finish.
• Once the model deployment is completed:
  • Open the deployed model details.
  • Scroll down to Explore More Samples.
  • Locate the following values:
  • Copy the deployment name.
  • Copy the API version shown in the deployment details.

• Go back to your Drupal site.
• Navigate to the Azure OpenAI module configuration page.
• Locate the Deployment Name field and paste the deployment name copied from Azure AI Foundry.
• Locate the API Version field and paste the API version copied from Azure AI Foundry.

 Retrieve API Credentials

• Return to your Azure OpenAI resource.
• Open the Azure resource page.
• Navigate to Keys and Endpoints.
• Copy the Key 1 (or Key 2) & Endpoint URL.

Complete Drupal Configuration

• In your Drupal Azure OpenAI module settings:
  • API Key: Paste the copied Azure Key.
  • Endpoint: Paste the Azure Endpoint URL.
  • Deployment Name: Paste the Deployment Name.
  • API Version: Paste the API Version.
  • Save the configuration.
  • Click Test Connection in the Drupal module.
  • Wait for the verification process.
  • If the connection succeeds, your Drupal site is now connected to Azure OpenAI.

• You can now start using Azure OpenAI-powered features within Drupal.