Fixes certificate based authentication

Author: maben-mw

Documentation/APIReference.md

@@ -47,9 +47,11 @@ features like proxy settings.
 
 ### `Common` Azure App Registration
 
-Configure an Azure App for which a Client Secret has been generated as the
-`Storage` App Registration. And if also running the interactive authentication
-tests make sure that for this App:
+Configure an Azure App for which a Client Secret has been generated and a
+Client Certificate has been registered. Ensure this App's service principal
+is granted access to the storage account used for testing, see also
+[Storage Account](#storage-account) below. And if also running the
+interactive authentication tests make sure that for this App:
 
 * A Redirect Uri has been configured in the form of `http://localhost:PORT`
   where *PORT* is configurable.
@@ -92,7 +94,7 @@ which:
 
 * A Client Secret has been generated.
 
-### `Storage` Storage Account
+### Storage Account
 
 The storage account should contain three containers:
 
@@ -134,6 +136,7 @@ Once generated note down the "Connection string" and "SAS token".
 | `STORAGE_ACCOUNT_NAME`      | Name of the storage account                    |
 | `AZURE_CLIENT_ID`           | Client ID of the Azure App                     |
 | `AZURE_CLIENT_SECRET`       | Client Secret which has been generated for the App |
+| `AZURE_CLIENT_CERTIFICATE`  | Base64 encoded PEM-format certificate as registered for the App |
 | `AZURE_TENANT_ID`           | Azure Tenant ID                                |
 
 ## `/KeyVault` Azure Key Vault unit tests
@@ -174,4 +177,4 @@ A Key Vault account needs to exist:
 | `KEYVAULT_TENANT_ID`    | Azure Tenant ID                                    |
 | `KEYVAULT_VAULT_NAME`   | Name of the Key Vault                              |
 
-[//]: #  (Copyright 2021-2022 The MathWorks, Inc.)
+[//]: #  (Copyright 2021-2023 The MathWorks, Inc.)

Documentation/Testing.md

@@ -2,6 +2,10 @@
 
 ## Release Notes
 
+## Release 0.3.1 April 11th 2023
+
+* Fixes issue with client certificate authentication
+
 ## Release 0.3.0 March 27th 2023
 
 * Added EndPoint setting support

RELEASENOTES.md

@@ -178,10 +178,14 @@
                     write(logObj,'error',['pem certificate file not found: ', strrep(char(settings.PemCertificate),'\','\\')]);
                 else
                     usePemfile = true;
+                    builder = azure.identity.ClientCertificateCredentialBuilder();
                 end
+            else
+                write(logObj,'error','PemCertificate may not be set to an empty string');
             end
+        else
+            builder = azure.identity.ClientSecretCredentialBuilder();
         end
-        builder = azure.identity.ClientSecretCredentialBuilder();
         builder = builder.clientId(settings.ClientId);
         builder = builder.tenantId(settings.TenantId);
         % If a pem file is configured and exists use it else default to the client secret

Software/MATLAB/app/functions/configureCredentials.m

@@ -0,0 +1,22 @@
+classdef ClientCertificateCredential < azure.core.credential.TokenCredential
+% CLIENTCERTIFICATECREDENTIAL AAD credential acquires a token with a client certificate
+
+% Copyright 2023 The MathWorks, Inc.
+
+properties    
+end
+
+methods
+    function obj = ClientCertificateCredential(clientCertificateCredentialj)
+        % Created using a ClientCertificateCredential java object from the
+        % ClientCertificateCredentialBuilder class only
+        if isa(clientCertificateCredentialj, 'com.azure.identity.ClientCertificateCredential')
+            obj.Handle = clientCertificateCredentialj;
+        else
+            logObj = Logger.getLogger();
+            write(logObj,'error','Expected argument of type com.azure.identity.ClientCertificateCredential');
+        end
+    end
+end
+
+end

Software/MATLAB/app/system/+azure/+identity/@ClientCertificateCredential/ClientCertificateCredential.m

@@ -0,0 +1,26 @@
+classdef ClientCertificateCredentialBuilder < azure.identity.CredentialBuilderBase
+    % CLIENTCERTIFICATECREDENTIALBUILDER Builder for ClientCertificateCredential
+
+    % Copyright 2023 The MathWorks, Inc.
+
+    properties
+    end
+
+    methods
+
+        function obj = ClientCertificateCredentialBuilder(varargin)
+
+            initialize('loggerPrefix', 'Azure:Common');
+            if nargin == 0
+                obj.Handle = com.azure.identity.ClientCertificateCredentialBuilder();
+            elseif nargin == 1 && isa(varargin{1}, 'com.azure.identity.ClientCertificateCredentialBuilder')
+                obj.Handle = varargin{1};
+            else
+                logObj = Logger.getLogger();
+                write(logObj,'error','Invalid argument(s)');
+            end
+
+        end %function
+
+    end %methods
+end %class

Software/MATLAB/app/system/+azure/+identity/@ClientCertificateCredentialBuilder/ClientCertificateCredentialBuilder.m

@@ -0,0 +1,15 @@
+function clientCertificateCredentialBuilder = authorityHost(obj, authorityHost)
+% AUTHORITYHOST Specifies the Azure Active Directory endpoint to acquire tokens
+% An updated ClientCertificateCredentialBuilder is returned.
+
+% Copyright 2023 The MathWorks, Inc.
+
+if ~(ischar(authorityHost) || isStringScalar(authorityHost))
+    logObj = Logger.getLogger();
+    write(logObj,'error','Expected argument of type character vector or scalar string');
+end
+
+clientCertificateCredentialBuilderj = obj.Handle.authorityHost(authorityHost);
+clientCertificateCredentialBuilder = azure.identity.ClientCertificateCredentialBuilder(clientCertificateCredentialBuilderj);
+
+end

Software/MATLAB/app/system/+azure/+identity/@ClientCertificateCredentialBuilder/authorityHost.m

@@ -0,0 +1,9 @@
+function clientCertificateCredential = build(obj)
+% BUILD Creates new ClientCertificateCredential with the configured options set
+
+% Copyright 2023 The MathWorks, Inc.
+
+clientCertificateCredentialj = obj.Handle.build();
+clientCertificateCredential = azure.identity.ClientCertificateCredential(clientCertificateCredentialj);
+
+end

Software/MATLAB/app/system/+azure/+identity/@ClientCertificateCredentialBuilder/build.m

@@ -0,0 +1,15 @@
+function clientCertificateCredentialBuilder = clientId(obj, clientId)
+% CLIENTID Sets client id
+% An updated ClientCertificateCredentialBuilder is returned.
+
+% Copyright 2020 The MathWorks, Inc.
+
+if ~(ischar(clientId) || isStringScalar(clientId))
+    logObj = Logger.getLogger();
+    write(logObj,'error','Expected argument of type character vector or scalar string');
+end
+
+clientCertificateCredentialBuilderj = obj.Handle.clientId(clientId);
+clientCertificateCredentialBuilder = azure.identity.ClientCertificateCredentialBuilder(clientCertificateCredentialBuilderj);
+
+end

Software/MATLAB/app/system/+azure/+identity/@ClientCertificateCredentialBuilder/clientId.m

@@ -1,6 +1,6 @@
-function clientSecretCredentialBuilder = pemCertificate(obj, certificatePath)
+function clientCertificateCredentialBuilder = pemCertificate(obj, certificatePath)
 % PEMCERTIFICATE Sets the path of the PEM certificate for authenticating to AAD
-% An updated ClientSecretCredentialBuilder is returned.
+% An updated ClientCertificateCredentialBuilder is returned.
 
 % Copyright 2020 The MathWorks, Inc.
 
@@ -14,7 +14,7 @@
     write(logObj,'error',['File not found: ', strrep(char(certificatePath),'\','\\')]);
 end 
 
-clientSecretCredentialBuilderj = obj.Handle.pemCertificate(certificatePath);
-clientSecretCredentialBuilder = azure.identity.ClientSecretCredentialBuilder(clientSecretCredentialBuilderj);
+clientCertificateCredentialBuilderj = obj.Handle.pemCertificate(certificatePath);
+clientCertificateCredentialBuilder = azure.identity.ClientCertificateCredentialBuilder(clientCertificateCredentialBuilderj);
 
 end