refactor: Update AI configuration references and improve authentication handling

- Renamed Azure OpenAI configuration to AI Endpoint in README and related files.
- Updated ai-config.env.example and README for clearer AI credential setup instructions.
- Enhanced load-config.sh to support optional API key for Azure AD authentication.
- Modified McpServer and RunMcpServerProcess to handle API key and Azure AD credentials.
- Removed outdated ai-config.local.env.template file.
- Adjusted demo.sh to ensure compatibility with .NET 9 and improved navigation.

Author: jkordick

.devcontainer/README.md

@@ -80,7 +80,7 @@ This checks:
 - ✅ Database status
 - ✅ Configuration files
 
-### 4. Configure Azure OpenAI (Required)
+### 4. Configure AI Endpoint (Required)
 
 ```bash
 # Copy the template
@@ -91,9 +91,9 @@ nano Config/ai-config.local.env
 ```
 
 Required values:
-- `AZURE_OPENAI_ENDPOINT` - Your Azure OpenAI endpoint URL
-- `AZURE_OPENAI_API_KEY` - Your API key
+- `AZURE_OPENAI_ENDPOINT` - Your AI endpoint URL
 - `AZURE_OPENAI_DEPLOYMENT_NAME` - Your deployment name (e.g., "gpt-5-mini-2" or "gpt-4o")
+- `AZURE_OPENAI_API_KEY` - Your API key (optional if using `az login`)
 
 ### 5. Run Demo
 

CobolToQuarkusMigration.csproj

@@ -8,6 +8,7 @@
   </PropertyGroup>
 
   <ItemGroup>
+    <PackageReference Include="Azure.Identity" Version="1.13.2" />
     <PackageReference Include="Microsoft.Extensions.Logging.Console" Version="8.0.0" />
     <PackageReference Include="Microsoft.SemanticKernel" Version="1.22.0" />
     <PackageReference Include="Microsoft.Data.Sqlite" Version="8.0.8" />

Config/ai-config.env.example

@@ -1,13 +1,13 @@
 # =============================================================================
-# Azure OpenAI Configuration
+# AI Configuration
 # =============================================================================
 # This file contains all AI-related configuration settings.
-# Add your actual Azure OpenAI credentials below.
+# Add your actual AI credentials below.
 # Add this file to .gitignore if you want to keep credentials private.
 # =============================================================================
 
-# Azure OpenAI Service Configuration  
-# TODO: Replace with your actual Azure OpenAI endpoint and API key
+# AI Service Configuration  
+# TODO: Replace with your actual AI endpoint and API key
 AZURE_OPENAI_ENDPOINT="https://your-resource-name.openai.azure.com/"
 AZURE_OPENAI_API_KEY="REPLACE_WITH_YOUR_API_KEY"
 

Config/ai-config.local.env.template

@@ -87,10 +87,9 @@ validate_config() {
 
     log_info "Validating configuration..."
 
-    # Required variables
+    # Required variables (API key is optional - Azure AD auth is supported)
     local required_vars=(
         "AZURE_OPENAI_ENDPOINT"
-        "AZURE_OPENAI_API_KEY"
         "AZURE_OPENAI_DEPLOYMENT_NAME"
         "AZURE_OPENAI_MODEL_ID"
     )
@@ -107,6 +106,19 @@ validate_config() {
         fi
     done
 
+    # API key is optional - check separately with warning instead of error
+    # Empty or placeholder values mean Azure AD auth will be used
+    if [ -z "${AZURE_OPENAI_API_KEY}" ] || [[ "${AZURE_OPENAI_API_KEY}" == *"your-"* ]] || [[ "${AZURE_OPENAI_API_KEY}" == *"placeholder"* ]]; then
+        log_warning "⚠️  AZURE_OPENAI_API_KEY is not set or contains placeholder - will use Azure AD (DefaultAzureCredential)"
+        log_warning "   Make sure you've run 'az login' before starting the migration"
+        # Clear placeholder to ensure Azure AD is used
+        if [[ "${AZURE_OPENAI_API_KEY}" == *"your-"* ]] || [[ "${AZURE_OPENAI_API_KEY}" == *"placeholder"* ]]; then
+            export AZURE_OPENAI_API_KEY=""
+        fi
+    else
+        log_success "✓ AZURE_OPENAI_API_KEY is configured"
+    fi
+    
     return $errors
 }
 
@@ -116,7 +128,13 @@ show_config_summary() {
     echo "  Endpoint: ${AZURE_OPENAI_ENDPOINT:-'NOT SET'}"
     echo "  Model ID: ${AZURE_OPENAI_MODEL_ID:-'NOT SET'}"
     echo "  Deployment: ${AZURE_OPENAI_DEPLOYMENT_NAME:-'NOT SET'}"
-    echo "  API Key: ${AZURE_OPENAI_API_KEY:0:10}... (${#AZURE_OPENAI_API_KEY} chars)"
+    if [ -n "${AZURE_OPENAI_API_KEY}" ] && [[ "${AZURE_OPENAI_API_KEY}" != *"your-"* ]] && [[ "${AZURE_OPENAI_API_KEY}" != *"placeholder"* ]]; then
+        echo "  API Key: ${AZURE_OPENAI_API_KEY:0:10}... (${#AZURE_OPENAI_API_KEY} chars)"
+        echo "  Auth Method: API Key"
+    else
+        echo "  API Key: (not set or placeholder)"
+        echo "  Auth Method: Azure AD (DefaultAzureCredential)"
+    fi
     echo "  Source Folder: ${COBOL_SOURCE_FOLDER:-'SampleCobol'}"
     echo "  Output Folder: ${JAVA_OUTPUT_FOLDER:-'JavaOutput'}"
 }

Config/load-config.sh

@@ -2,6 +2,7 @@
 using System.Text;
 using System.Text.Json;
 using System.Text.Json.Nodes;
+using Azure.Identity;
 using Microsoft.Extensions.Logging;
 using Microsoft.SemanticKernel;
 using Microsoft.SemanticKernel.ChatCompletion;
@@ -40,7 +41,7 @@ public McpServer(IMigrationRepository repository, int runId, ILogger<McpServer>
         _logger = logger;
         _aiSettings = aiSettings;
 
-        if (_aiSettings != null && !string.IsNullOrEmpty(_aiSettings.Endpoint) && !string.IsNullOrEmpty(_aiSettings.ApiKey))
+        if (_aiSettings != null && !string.IsNullOrEmpty(_aiSettings.Endpoint))
         {
             try
             {
@@ -51,10 +52,20 @@ public McpServer(IMigrationRepository repository, int runId, ILogger<McpServer>
                     deploymentName = _aiSettings.ModelId;
                 }
 
-                kernelBuilder.AddAzureOpenAIChatCompletion(
-                    deploymentName: deploymentName!,
-                    endpoint: _aiSettings.Endpoint,
-                    apiKey: _aiSettings.ApiKey);
+                if (!string.IsNullOrEmpty(_aiSettings.ApiKey))
+                {
+                    kernelBuilder.AddAzureOpenAIChatCompletion(
+                        deploymentName: deploymentName!,
+                        endpoint: _aiSettings.Endpoint,
+                        apiKey: _aiSettings.ApiKey);
+                }
+                else
+                {
+                    kernelBuilder.AddAzureOpenAIChatCompletion(
+                        deploymentName: deploymentName!,
+                        endpoint: _aiSettings.Endpoint,
+                        credentials: new DefaultAzureCredential());
+                }
 
                 _kernel = kernelBuilder.Build();
                 _modelId = deploymentName;

Mcp/McpServer.cs

@@ -2,6 +2,7 @@
 using System.Text;
 using System.Text.Json;
 using System.Text.Json.Nodes;
+using Azure.Identity;
 using Microsoft.Extensions.Logging;
 using Microsoft.SemanticKernel;
 using Microsoft.SemanticKernel.ChatCompletion;
@@ -40,7 +41,7 @@ public RunMcpServerProcess(IMigrationRepository repository, int runId, ILogger<R
         _logger = logger;
         _aiSettings = aiSettings;
 
-        if (_aiSettings != null && !string.IsNullOrEmpty(_aiSettings.Endpoint) && !string.IsNullOrEmpty(_aiSettings.ApiKey))
+        if (_aiSettings != null && !string.IsNullOrEmpty(_aiSettings.Endpoint))
         {
             try
             {
@@ -51,10 +52,20 @@ public RunMcpServerProcess(IMigrationRepository repository, int runId, ILogger<R
                     deploymentName = _aiSettings.ModelId;
                 }
 
-                kernelBuilder.AddAzureOpenAIChatCompletion(
-                    deploymentName: deploymentName!,
-                    endpoint: _aiSettings.Endpoint,
-                    apiKey: _aiSettings.ApiKey);
+                if (!string.IsNullOrEmpty(_aiSettings.ApiKey))
+                {
+                    kernelBuilder.AddAzureOpenAIChatCompletion(
+                        deploymentName: deploymentName!,
+                        endpoint: _aiSettings.Endpoint,
+                        apiKey: _aiSettings.ApiKey);
+                }
+                else
+                {
+                    kernelBuilder.AddAzureOpenAIChatCompletion(
+                        deploymentName: deploymentName!,
+                        endpoint: _aiSettings.Endpoint,
+                        credentials: new DefaultAzureCredential());
+                }
 
                 _kernel = kernelBuilder.Build();
                 _modelId = deploymentName;