Release 3.1

AzureEnterpriseApplicationOrchestrator.Tests/AzureEnterpriseApplicationOrchestrator.Tests.csproj

@@ -1,7 +1,7 @@
 <Project Sdk="Microsoft.NET.Sdk">
 
   <PropertyGroup>
-    <TargetFramework>net6.0</TargetFramework>
+    <TargetFramework>net8.0</TargetFramework>
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>enable</Nullable>
 

AzureEnterpriseApplicationOrchestrator.Tests/Client.cs

@@ -28,22 +28,33 @@
         ConfigureLogging();
     }
 
-    [IntegrationTestingFact]
-    public void GraphClient_Application_AddGetRemove_ReturnSuccess()
+    [IntegrationTestingTheory]
+    [InlineData("clientcert")]
+    [InlineData("clientsecret")]
+    public void GraphClient_Application_AddGetRemove_ReturnSuccess(string testAuthMethod)
     {
         // Arrange
         string certName = "AppTest" + Guid.NewGuid().ToString()[..6];
         X509Certificate2 ssCert = GetSelfSignedCert(certName);
         string b64Cert = Convert.ToBase64String(ssCert.Export(X509ContentType.Cert));
 
         IntegrationTestingFact env = new();
-
-        IAzureGraphClient client = new GraphClient.Builder()
+        IAzureGraphClientBuilder clientBuilder = new GraphClient.Builder()
             .WithTenantId(env.TenantId)
             .WithApplicationId(env.ApplicationId)
-            .WithClientSecret(env.ClientSecret)
-            .WithTargetApplicationId(env.TargetApplicationId)
-            .Build();
+            .WithTargetApplicationId(env.TargetApplicationId);
+
+        if (testAuthMethod == "clientcert")
+        {
+            clientBuilder.WithClientSecret(env.ClientSecret);
+        }
+        else
+        {
+            var cert = X509Certificate2.CreateFromPemFile(env.ClientCertificatePath);
+            clientBuilder.WithClientCertificate(cert);
+        }
+
+        IAzureGraphClient client = clientBuilder.Build();
 
         // Step 1 - Add the certificate to the Application
 
@@ -61,8 +72,8 @@
         // Assert
         Assert.True(operationResult.Success);
         Assert.NotNull(operationResult.Result);
         Assert.True(operationResult.Result.Any(c => c.Alias == certName));
         Assert.True(operationResult.Result.Any(c => c.Alias == certName && c.PrivateKeyEntry == false));
 
         // Step 3 - Determine if the certificate exists in the Application
 
@@ -89,8 +100,10 @@
         Assert.False(exists);
     }
 
-    [IntegrationTestingFact]
-    public void GraphClient_ServicePrincipal_AddGetRemove_ReturnSuccess()
+    [IntegrationTestingTheory]
+    [InlineData("clientcert")]
+    [InlineData("clientsecret")]
+    public void GraphClient_ServicePrincipal_AddGetRemove_ReturnSuccess(string testAuthMethod)
     {
         // Arrange
         const string password = "passwordpasswordpassword";
@@ -99,13 +112,22 @@
         string b64PfxSslCert = Convert.ToBase64String(ssCert.Export(X509ContentType.Pfx, password));
 
         IntegrationTestingFact env = new();
-
-        IAzureGraphClient client = new GraphClient.Builder()
+        IAzureGraphClientBuilder clientBuilder = new GraphClient.Builder()
             .WithTenantId(env.TenantId)
             .WithApplicationId(env.ApplicationId)
-            .WithClientSecret(env.ClientSecret)
-            .WithTargetApplicationId(env.TargetApplicationId)
-            .Build();
+            .WithTargetApplicationId(env.TargetApplicationId);
+
+        if (testAuthMethod == "clientcert")
+        {
+            clientBuilder.WithClientSecret(env.ClientSecret);
+        }
+        else
+        {
+            var cert = X509Certificate2.CreateFromPemFile(env.ClientCertificatePath);
+            clientBuilder.WithClientCertificate(cert);
+        }
+
+        IAzureGraphClient client = clientBuilder.Build();
 
         // Step 1 - Add the certificate to the Service Principal (and set it as the preferred SAML signing certificate)
 
@@ -121,8 +143,8 @@
         // Assert
         Assert.True(operationResult.Success);
         Assert.NotNull(operationResult.Result);
         Assert.True(operationResult.Result.Any(c => c.Alias == certName));
         Assert.True(operationResult.Result.Any(c => c.Alias == certName && c.PrivateKeyEntry));
 
         // Step 3 - Determine if the certificate exists in the Service Principal
 
@@ -152,8 +174,10 @@
         Assert.False(exists);
     }
 
-    [IntegrationTestingFact]
-    public void GraphClient_DiscoverApplicationIds_ReturnSuccess()
+    [IntegrationTestingTheory]
+    [InlineData("clientcert")]
+    [InlineData("clientsecret")]
+    public void GraphClient_DiscoverApplicationIds_ReturnSuccess(string testAuthMethod)
     {
         // Arrange
         const string password = "passwordpasswordpassword";
@@ -162,13 +186,22 @@
         string b64PfxSslCert = Convert.ToBase64String(ssCert.Export(X509ContentType.Pfx, password));
 
         IntegrationTestingFact env = new();
-
-        IAzureGraphClient client = new GraphClient.Builder()
+        IAzureGraphClientBuilder clientBuilder = new GraphClient.Builder()
             .WithTenantId(env.TenantId)
             .WithApplicationId(env.ApplicationId)
-            .WithClientSecret(env.ClientSecret)
-            .WithTargetApplicationId(env.TargetApplicationId)
-            .Build();
+            .WithTargetApplicationId(env.TargetApplicationId);
+
+        if (testAuthMethod == "clientcert")
+        {
+            clientBuilder.WithClientSecret(env.ClientSecret);
+        }
+        else
+        {
+            var cert = X509Certificate2.CreateFromPemFile(env.ClientCertificatePath);
+            clientBuilder.WithClientCertificate(cert);
+        }
+
+        IAzureGraphClient client = clientBuilder.Build();
 
         // Act
         OperationResult<IEnumerable<string>> operationResult = client.DiscoverApplicationIds();

AzureEnterpriseApplicationOrchestrator.Tests/FakeClient.cs

@@ -12,6 +12,7 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 
+using System.Security.Cryptography.X509Certificates;
 using AzureEnterpriseApplicationOrchestrator.Client;
 using Keyfactor.Logging;
 using Keyfactor.Orchestrators.Common.Enums;
@@ -31,6 +32,7 @@ public class FakeBuilder : IAzureGraphClientBuilder
         public string? _targetApplicationId { get; set; }
         public string? _applicationId { get; set; }
         public string? _clientSecret { get; set; }
+        public X509Certificate2? _clientCertificate { get; set; }
         public string? _azureCloudEndpoint { get; set; }
 
         public IAzureGraphClientBuilder WithTenantId(string tenantId)
@@ -57,6 +59,12 @@ public IAzureGraphClientBuilder WithClientSecret(string clientSecret)
             return this;
         }
 
+        public IAzureGraphClientBuilder WithClientCertificate(X509Certificate2 clientCertificate)
+        {
+            _clientCertificate = clientCertificate;
+            return this;
+        }
+
         public IAzureGraphClientBuilder WithAzureCloud(string azureCloud)
         {
             _azureCloudEndpoint = azureCloud;

AzureEnterpriseApplicationOrchestrator.Tests/IntegrationTestingFact.cs

@@ -19,6 +19,7 @@ public sealed class IntegrationTestingFact : FactAttribute
     public string TenantId { get; private set; }
     public string ApplicationId { get; private set; }
     public string ClientSecret { get; private set; }
+    public string ClientCertificatePath { get; private set; }
 
     public string TargetApplicationId { get; private set; }
 
@@ -27,6 +28,7 @@ public IntegrationTestingFact()
         TenantId = Environment.GetEnvironmentVariable("AZURE_TENANT_ID") ?? string.Empty;
         ApplicationId = Environment.GetEnvironmentVariable("AZURE_CLIENT_ID") ?? string.Empty;
         ClientSecret = Environment.GetEnvironmentVariable("AZURE_CLIENT_SECRET") ?? string.Empty;
+        ClientCertificatePath = Environment.GetEnvironmentVariable("AZURE_PATH_TO_CLIENT_CERTIFICATE") ?? string.Empty;
 
         TargetApplicationId = Environment.GetEnvironmentVariable("AZURE_TARGET_APPLICATION_ID") ?? string.Empty;
 
@@ -37,3 +39,27 @@ public IntegrationTestingFact()
     }
 }
 
+public sealed class IntegrationTestingTheory : TheoryAttribute
+{
+    public string TenantId { get; private set; }
+    public string ApplicationId { get; private set; }
+    public string ClientSecret { get; private set; }
+    public string ClientCertificatePath { get; private set; }
+
+    public string TargetApplicationId { get; private set; }
+
+    public IntegrationTestingTheory()
+    {
+        TenantId = Environment.GetEnvironmentVariable("AZURE_TENANT_ID") ?? string.Empty;
+        ApplicationId = Environment.GetEnvironmentVariable("AZURE_CLIENT_ID") ?? string.Empty;
+        ClientSecret = Environment.GetEnvironmentVariable("AZURE_CLIENT_SECRET") ?? string.Empty;
+        ClientCertificatePath = Environment.GetEnvironmentVariable("AZURE_PATH_TO_CLIENT_CERTIFICATE") ?? string.Empty;
+
+        TargetApplicationId = Environment.GetEnvironmentVariable("AZURE_TARGET_APPLICATION_ID") ?? string.Empty;
+
+        if (string.IsNullOrEmpty(TenantId) || string.IsNullOrEmpty(ApplicationId) || string.IsNullOrEmpty(ClientSecret) || string.IsNullOrEmpty(TargetApplicationId))
+        {
+            Skip = "Integration testing environment variables are not set - Skipping test. Please run `make setup` to set the environment variables.";
+        }
+    }
+}

AzureEnterpriseApplicationOrchestrator.Tests/JobClientBuilder.cs

@@ -12,6 +12,9 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 
+using System.Security.Cryptography;
+using System.Security.Cryptography.X509Certificates;
+using System.Text;
 using AzureEnterpriseApplicationOrchestrator;
 using AzureEnterpriseApplicationOrchestrator.Client;
 using AzureEnterpriseApplicationOrchestrator.Tests;
@@ -32,7 +35,7 @@ public AzureEnterpriseApplicationOrchestrator_JobClientBuilder()
     }
 
     [Fact]
-    public void GraphJobClientBuilder_ValidCertificateStoreConfig_BuildValidClient()
+    public void GraphJobClientBuilder_ValidCertificateStoreConfigWithClientSecret_BuildValidClient()
     {
         // Verify that the GraphJobClientBuilder uses the certificate store configuration
         // provided by Keyfactor Command/the Universal Orchestrator correctly as required
@@ -68,6 +71,93 @@ public void GraphJobClientBuilder_ValidCertificateStoreConfig_BuildValidClient()
 
         _logger.LogInformation("GraphJobClientBuilder_ValidCertificateStoreConfig_BuildValidClient - Success");
     }
+
+    [IntegrationTestingTheory]
+    [InlineData("pkcs12")]
+    [InlineData("pem")]
+    [InlineData("encryptedPem")]
+    public void GraphJobClientBuilder_ValidCertificateStoreConfigWithClientCertificate_BuildValidClient(string certificateFormat)
+    {
+        // Verify that the GraphJobClientBuilder uses the certificate store configuration
+        // provided by Keyfactor Command/the Universal Orchestrator correctly as required
+        // by the IAzureGraphClientBuilder interface.
+
+        // Arrange
+        GraphJobClientBuilder<FakeClient.FakeBuilder> jobClientBuilderWithFakeBuilder = new();
+
+        string password = "passwordpasswordpassword";
+        string certName = "SPTest" + Guid.NewGuid().ToString()[..6];
+        X509Certificate2 ssCert = GetSelfSignedCert(certName);
+
+        string b64ClientCertificate;
+        if (certificateFormat == "pkcs12")
+        {
+            b64ClientCertificate = Convert.ToBase64String(ssCert.Export(X509ContentType.Pfx, password));
+        }
+        else if (certificateFormat == "pem")
+        {
+            string pemCert = ssCert.ExportCertificatePem();
+            string keyPem = ssCert.GetRSAPrivateKey()!.ExportPkcs8PrivateKeyPem();
+            b64ClientCertificate = Convert.ToBase64String(Encoding.UTF8.GetBytes(keyPem + '\n' + pemCert));
+            password = "";
+        }
+        else
+        {
+            PbeParameters pbeParameters = new PbeParameters(
+                    PbeEncryptionAlgorithm.Aes256Cbc,
+                    HashAlgorithmName.SHA384,
+                    300_000);
+            string pemCert = ssCert.ExportCertificatePem();
+            string keyPem = ssCert.GetRSAPrivateKey()!.ExportEncryptedPkcs8PrivateKeyPem(password.ToCharArray(), pbeParameters);
+            b64ClientCertificate = Convert.ToBase64String(Encoding.UTF8.GetBytes(keyPem + '\n' + pemCert));
+        }
+
+        // Set up the certificate store with names that correspond to how we expect them to be interpreted by
+        // the builder
+        CertificateStore fakeCertificateStoreDetails = new()
+        {
+            ClientMachine = "fake-tenant-id",
+            StorePath = "fake-azure-target-application-id",
+            Properties = $@"{{""ServerUsername"": ""fake-azure-application-id"",""ServerPassword"": ""{password}"",""ClientCertificate"": ""{b64ClientCertificate}"",""AzureCloud"": ""fake-azure-cloud""}}"
+        };
+
+        // Act
+        IAzureGraphClient fakeAppGatewayClient = jobClientBuilderWithFakeBuilder
+            .WithCertificateStoreDetails(fakeCertificateStoreDetails)
+            .Build();
+
+        // Assert
+
+        // IAzureGraphClient doesn't require any of the properties set by the builder to be exposed
+        // since the production Build() method creates an Azure Resource Manager client.
+        // But, our builder is fake and exposes the properties we need to test (via the FakeBuilder class).
+        Assert.Equal("fake-tenant-id", jobClientBuilderWithFakeBuilder._builder._tenantId);
+        Assert.Equal("fake-azure-target-application-id", jobClientBuilderWithFakeBuilder._builder._targetApplicationId);
+        Assert.Equal("fake-azure-application-id", jobClientBuilderWithFakeBuilder._builder._applicationId);
+        Assert.Equal("fake-azure-cloud", jobClientBuilderWithFakeBuilder._builder._azureCloudEndpoint);
+        Assert.Equal(ssCert.GetCertHash(), jobClientBuilderWithFakeBuilder._builder._clientCertificate!.GetCertHash());
+        Assert.NotNull(jobClientBuilderWithFakeBuilder._builder._clientCertificate!.GetRSAPrivateKey());
+        Assert.Equal(jobClientBuilderWithFakeBuilder._builder._clientCertificate!.GetRSAPrivateKey()!.ExportRSAPrivateKeyPem(), ssCert.GetRSAPrivateKey()!.ExportRSAPrivateKeyPem());
+
+        _logger.LogInformation("GraphJobClientBuilder_ValidCertificateStoreConfig_BuildValidClient - Success");
+    }
+
+    public static X509Certificate2 GetSelfSignedCert(string hostname)
+    {
+        RSA rsa = RSA.Create(2048);
+        CertificateRequest req = new CertificateRequest($"CN={hostname}", rsa, HashAlgorithmName.SHA256,
+                RSASignaturePadding.Pkcs1);
+
+        SubjectAlternativeNameBuilder subjectAlternativeNameBuilder = new SubjectAlternativeNameBuilder();
+        subjectAlternativeNameBuilder.AddDnsName(hostname);
+        req.CertificateExtensions.Add(subjectAlternativeNameBuilder.Build());
+        req.CertificateExtensions.Add(new X509KeyUsageExtension(X509KeyUsageFlags.DataEncipherment | X509KeyUsageFlags.KeyEncipherment | X509KeyUsageFlags.DigitalSignature, false));        
+        req.CertificateExtensions.Add(new X509EnhancedKeyUsageExtension(new OidCollection { new Oid("2.5.29.32.0"), new Oid("1.3.6.1.5.5.7.3.1") }, false));
+
+        X509Certificate2 selfSignedCert = req.CreateSelfSigned(DateTimeOffset.Now, DateTimeOffset.Now.AddYears(5));
+        Console.Write($"Created self-signed certificate for \"{hostname}\" with thumbprint {selfSignedCert.Thumbprint}\n");
+        return selfSignedCert;
+    }
 
     static void ConfigureLogging()
     {

AzureEnterpriseApplicationOrchestrator/AzureEnterpriseApplicationOrchestrator.csproj

@@ -1,7 +1,7 @@
 <Project Sdk="Microsoft.NET.Sdk">
 
     <PropertyGroup>
-        <TargetFramework>net6.0</TargetFramework>
+        <TargetFramework>net8.0</TargetFramework>
         <ImplicitUsings>disable</ImplicitUsings>
         <AppendTargetFrameworkToOutputPath>false</AppendTargetFrameworkToOutputPath>
         <AppendRuntimeIdentifierToOutputPath>false</AppendRuntimeIdentifierToOutputPath>
@@ -10,16 +10,16 @@
     </PropertyGroup>
 
     <ItemGroup>
-      <PackageReference Include="Azure.Core" Version="1.38.0" />
-      <PackageReference Include="Azure.Identity" Version="1.10.4" />
-      <PackageReference Include="Azure.ResourceManager" Version="1.10.2" />
-      <PackageReference Include="coverlet.collector" Version="6.0.1">
+      <PackageReference Include="Azure.Core" Version="1.39.0" />
+      <PackageReference Include="Azure.Identity" Version="1.11.3" />
+      <PackageReference Include="Azure.ResourceManager" Version="1.12.0" />
+      <PackageReference Include="coverlet.collector" Version="6.0.2">
         <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
         <PrivateAssets>all</PrivateAssets>
       </PackageReference>
       <PackageReference Include="Keyfactor.Logging" Version="1.1.1" />
       <PackageReference Include="Keyfactor.Orchestrators.IOrchestratorJobExtensions" Version="0.7.0" />
-      <PackageReference Include="Microsoft.Graph" Version="5.44.0" />
+      <PackageReference Include="Microsoft.Graph" Version="5.54.0" />
     </ItemGroup>
 
     <ItemGroup>

AzureEnterpriseApplicationOrchestrator/Client/GraphClient.cs

@@ -64,6 +64,7 @@ public class Builder : IAzureGraphClientBuilder
         private string _tenantId { get; set; }
         private string _applicationId { get; set; }
         private string _clientSecret { get; set; }
+        private X509Certificate2 _clientCertificate { get; set; }
         private string _targetApplicationId { get; set; }
         private Uri _azureCloudEndpoint { get; set; }
 
@@ -91,6 +92,12 @@ public IAzureGraphClientBuilder WithClientSecret(string clientSecret)
             return this;
         }
 
+        public IAzureGraphClientBuilder WithClientCertificate(X509Certificate2 clientCertificate)
+        {
+            _clientCertificate = clientCertificate;
+            return this;
+        }
+
         public IAzureGraphClientBuilder WithAzureCloud(string azureCloud)
         {
             if (string.IsNullOrWhiteSpace(azureCloud)) 
@@ -129,9 +136,24 @@ public IAzureGraphClient Build()
                               AdditionallyAllowedTenants = { "*" } 
             };
 
-            TokenCredential credential = new ClientSecretCredential(
-                    _tenantId, _applicationId, _clientSecret, credentialOptions
-                    );
+            TokenCredential credential;
+            if (!string.IsNullOrWhiteSpace(_clientSecret)) 
+            {
+                credential = new ClientSecretCredential(
+                        _tenantId, _applicationId, _clientSecret, credentialOptions
+                        );
+            }
+            else if (_clientCertificate != null) 
+            {
+                credential = new ClientCertificateCredential(
+                        _tenantId, _applicationId, _clientCertificate, credentialOptions
+                        );
+            }
+            else 
+            {
+                throw new Exception("Client secret or client certificate must be provided.");
+            }
+
 
             string[] scopes = { "https://graph.microsoft.com/.default" };