{"title":"Codeunit 1286 X509Certificate2, procedures","url":"https://jonas-paprotka.de/ref/codeunit/1286-x509certificate2/procedures/","author":"JOP-AL","license":"Metadata from Microsoft's symbol packages. AL source MIT, Copyright (c) Microsoft Corporation. Selection and wording © 2026 JOP-AL. https://jonas-paprotka.de/licenses/","subject":"Microsoft Dynamics 365 Business Central","checked":"2026-11-20","changed":"2026-10-05","object":{"type":"codeunit","id":1286,"name":"X509Certificate2","app":"System Application","versions":"17-29","url":"https://jonas-paprotka.de/ref/codeunit/1286-x509certificate2/","json":"https://jonas-paprotka.de/ref/codeunit/1286-x509certificate2.json"},"aspect":"procedures","total":29,"rows":[{"name":"VerifyCertificate","sig":"(var Text, Text, Enum X509 Content Type)","named":"(var CertBase64Value: Text; Password: Text; X509ContentType: Enum \"X509 Content Type\")","returns":"Boolean","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Use VerifyCertificate with SecretText data type for Password.","tag":"24.0"},"range":"17-26","first":17,"last":26,"obsoleteSince":24,"spans":[{"from":17,"to":23,"named":"(var CertBase64Value: Text; Password: Text; X509ContentType: Enum \"X509 Content Type\")","returns":"Boolean","kind":"procedure","access":"public","obsolete":null},{"from":24,"to":26,"named":"(var CertBase64Value: Text; Password: Text; X509ContentType: Enum \"X509 Content Type\")","returns":"Boolean","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Use VerifyCertificate with SecretText data type for Password.","tag":"24.0"}}]},{"name":"GetCertificateFriendlyName","sig":"(Text, Text, var Text)","named":"(CertBase64Value: Text; Password: Text; var FriendlyName: Text)","returns":"","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Use GetCertificateFriendlyName with SecretText data type for Password.","tag":"24.0"},"range":"17-26","first":17,"last":26,"obsoleteSince":24,"spans":[{"from":17,"to":23,"named":"(CertBase64Value: Text; Password: Text; var FriendlyName: Text)","returns":"","kind":"procedure","access":"public","obsolete":null},{"from":24,"to":26,"named":"(CertBase64Value: Text; Password: Text; var FriendlyName: Text)","returns":"","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Use GetCertificateFriendlyName with SecretText data type for Password.","tag":"24.0"}}]},{"name":"GetCertificateSubject","sig":"(Text, Text, var Text)","named":"(CertBase64Value: Text; Password: Text; var Subject: Text)","returns":"","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Use GetCertificateSubject with SecretText data type for Password.","tag":"24.0"},"range":"17-26","first":17,"last":26,"obsoleteSince":24,"spans":[{"from":17,"to":23,"named":"(CertBase64Value: Text; Password: Text; var Subject: Text)","returns":"","kind":"procedure","access":"public","obsolete":null},{"from":24,"to":26,"named":"(CertBase64Value: Text; Password: Text; var Subject: Text)","returns":"","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Use GetCertificateSubject with SecretText data type for Password.","tag":"24.0"}}]},{"name":"GetCertificateThumbprint","sig":"(Text, Text, var Text)","named":"(CertBase64Value: Text; Password: Text; var Thumbprint: Text)","returns":"","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Use GetCertificateThumbprint with SecretText data type for Password.","tag":"24.0"},"range":"17-26","first":17,"last":26,"obsoleteSince":24,"spans":[{"from":17,"to":23,"named":"(CertBase64Value: Text; Password: Text; var Thumbprint: Text)","returns":"","kind":"procedure","access":"public","obsolete":null},{"from":24,"to":26,"named":"(CertBase64Value: Text; Password: Text; var Thumbprint: Text)","returns":"","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Use GetCertificateThumbprint with SecretText data type for Password.","tag":"24.0"}}]},{"name":"GetCertificateIssuer","sig":"(Text, Text, var Text)","named":"(CertBase64Value: Text; Password: Text; var Issuer: Text)","returns":"","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Use GetCertificateIssuer with SecretText data type for Password.","tag":"24.0"},"range":"17-26","first":17,"last":26,"obsoleteSince":24,"spans":[{"from":17,"to":23,"named":"(CertBase64Value: Text; Password: Text; var Issuer: Text)","returns":"","kind":"procedure","access":"public","obsolete":null},{"from":24,"to":26,"named":"(CertBase64Value: Text; Password: Text; var Issuer: Text)","returns":"","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Use GetCertificateIssuer with SecretText data type for Password.","tag":"24.0"}}]},{"name":"GetCertificateExpiration","sig":"(Text, Text, var DateTime)","named":"(CertBase64Value: Text; Password: Text; var Expiration: DateTime)","returns":"","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Use GetCertificateExpiration with SecretText data type for Password.","tag":"24.0"},"range":"17-26","first":17,"last":26,"obsoleteSince":24,"spans":[{"from":17,"to":23,"named":"(CertBase64Value: Text; Password: Text; var Expiration: DateTime)","returns":"","kind":"procedure","access":"public","obsolete":null},{"from":24,"to":26,"named":"(CertBase64Value: Text; Password: Text; var Expiration: DateTime)","returns":"","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Use GetCertificateExpiration with SecretText data type for Password.","tag":"24.0"}}]},{"name":"GetCertificateNotBefore","sig":"(Text, Text, var DateTime)","named":"(CertBase64Value: Text; Password: Text; var NotBefore: DateTime)","returns":"","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Use GetCertificateNotBefore with SecretText data type for Password.","tag":"24.0"},"range":"17-26","first":17,"last":26,"obsoleteSince":24,"spans":[{"from":17,"to":23,"named":"(CertBase64Value: Text; Password: Text; var NotBefore: DateTime)","returns":"","kind":"procedure","access":"public","obsolete":null},{"from":24,"to":26,"named":"(CertBase64Value: Text; Password: Text; var NotBefore: DateTime)","returns":"","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Use GetCertificateNotBefore with SecretText data type for Password.","tag":"24.0"}}]},{"name":"HasPrivateKey","sig":"(Text, Text)","named":"(CertBase64Value: Text; Password: Text)","returns":"Boolean","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Use HasPrivateKey with SecretText data type for Password.","tag":"24.0"},"range":"17-26","first":17,"last":26,"obsoleteSince":24,"spans":[{"from":17,"to":23,"named":"(CertBase64Value: Text; Password: Text)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null},{"from":24,"to":26,"named":"(CertBase64Value: Text; Password: Text)","returns":"Boolean","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Use HasPrivateKey with SecretText data type for Password.","tag":"24.0"}}]},{"name":"GetCertificatePropertiesAsJson","sig":"(Text, Text, var Text)","named":"(CertBase64Value: Text; Password: Text; var CertPropertyJson: Text)","returns":"","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Use GetCertificatePropertiesAsJson with SecretText data type for Password.","tag":"24.0"},"range":"17-26","first":17,"last":26,"obsoleteSince":24,"spans":[{"from":17,"to":23,"named":"(CertBase64Value: Text; Password: Text; var CertPropertyJson: Text)","returns":"","kind":"procedure","access":"public","obsolete":null},{"from":24,"to":26,"named":"(CertBase64Value: Text; Password: Text; var CertPropertyJson: Text)","returns":"","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Use GetCertificatePropertiesAsJson with SecretText data type for Password.","tag":"24.0"}}]},{"name":"GetCertificatePublicKey","sig":"(Text, Text)","named":"(CertBase64Value: Text; Password: Text)","returns":"Text","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Use GetCertificatePublicKey with SecretText data type for Password.","tag":"24.0"},"range":"19-26","first":19,"last":26,"obsoleteSince":24,"spans":[{"from":19,"to":23,"named":"(CertBase64Value: Text; Password: Text)","returns":"Text","kind":"procedure","access":"public","obsolete":null},{"from":24,"to":26,"named":"(CertBase64Value: Text; Password: Text)","returns":"Text","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Use GetCertificatePublicKey with SecretText data type for Password.","tag":"24.0"}}]},{"name":"GetCertificatePrivateKey","sig":"(Text, Text)","named":"(CertBase64Value: Text; Password: Text)","returns":"Text","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Use GetCertificatePrivateKey with SecretText data type for Password and return value.","tag":"24.0"},"range":"19-26","first":19,"last":26,"obsoleteSince":24,"spans":[{"from":19,"to":23,"named":"(CertBase64Value: Text; Password: Text)","returns":"Text","kind":"procedure","access":"public","obsolete":null},{"from":24,"to":26,"named":"(CertBase64Value: Text; Password: Text)","returns":"Text","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Use GetCertificatePrivateKey with SecretText data type for Password and return value.","tag":"24.0"}}]},{"name":"GetCertificateSerialNumber","sig":"(Text, Text, var Text)","named":"(CertBase64Value: Text; Password: Text; var SerialNumber: Text)","returns":"","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Use GetCertificateSerialNumber with SecretText data type for Password.","tag":"24.0"},"range":"22-26","first":22,"last":26,"obsoleteSince":24,"spans":[{"from":22,"to":23,"named":"(CertBase64Value: Text; Password: Text; var SerialNumber: Text)","returns":"","kind":"procedure","access":"public","obsolete":null},{"from":24,"to":26,"named":"(CertBase64Value: Text; Password: Text; var SerialNumber: Text)","returns":"","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Use GetCertificateSerialNumber with SecretText data type for Password.","tag":"24.0"}}]},{"name":"GetCertificateSerialNumberAsASCII","sig":"(Text, Text, var Text)","named":"(CertBase64Value: Text; Password: Text; var SerialNumberASCII: Text)","returns":"","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Use GetCertificateSerialNumberAsASCII with SecretText data type for Password.","tag":"24.0"},"range":"22-26","first":22,"last":26,"obsoleteSince":24,"spans":[{"from":22,"to":23,"named":"(CertBase64Value: Text; Password: Text; var SerialNumberASCII: Text)","returns":"","kind":"procedure","access":"public","obsolete":null},{"from":24,"to":26,"named":"(CertBase64Value: Text; Password: Text; var SerialNumberASCII: Text)","returns":"","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Use GetCertificateSerialNumberAsASCII with SecretText data type for Password.","tag":"24.0"}}]},{"name":"VerifyCertificate","sig":"(var Text, SecretText, Enum X509 Content Type)","named":"(var CertBase64Value: Text; Password: SecretText; X509ContentType: Enum \"X509 Content Type\")","returns":"Boolean","kind":"procedure","access":"public","obsolete":null,"range":"24-29","first":24,"last":29,"obsoleteSince":null,"spans":[{"from":24,"to":29,"named":"(var CertBase64Value: Text; Password: SecretText; X509ContentType: Enum \"X509 Content Type\")","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}]},{"name":"GetCertificateFriendlyName","sig":"(Text, SecretText, var Text)","named":"(CertBase64Value: Text; Password: SecretText; var FriendlyName: Text)","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"24-29","first":24,"last":29,"obsoleteSince":null,"spans":[{"from":24,"to":29,"named":"(CertBase64Value: Text; Password: SecretText; var FriendlyName: Text)","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"GetCertificateSubject","sig":"(Text, SecretText, var Text)","named":"(CertBase64Value: Text; Password: SecretText; var Subject: Text)","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"24-29","first":24,"last":29,"obsoleteSince":null,"spans":[{"from":24,"to":29,"named":"(CertBase64Value: Text; Password: SecretText; var Subject: Text)","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"GetCertificateThumbprint","sig":"(Text, SecretText, var Text)","named":"(CertBase64Value: Text; Password: SecretText; var Thumbprint: Text)","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"24-29","first":24,"last":29,"obsoleteSince":null,"spans":[{"from":24,"to":29,"named":"(CertBase64Value: Text; Password: SecretText; var Thumbprint: Text)","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"GetCertificateIssuer","sig":"(Text, SecretText, var Text)","named":"(CertBase64Value: Text; Password: SecretText; var Issuer: Text)","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"24-29","first":24,"last":29,"obsoleteSince":null,"spans":[{"from":24,"to":29,"named":"(CertBase64Value: Text; Password: SecretText; var Issuer: Text)","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"GetCertificateExpiration","sig":"(Text, SecretText, var DateTime)","named":"(CertBase64Value: Text; Password: SecretText; var Expiration: DateTime)","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"24-29","first":24,"last":29,"obsoleteSince":null,"spans":[{"from":24,"to":29,"named":"(CertBase64Value: Text; Password: SecretText; var Expiration: DateTime)","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"GetCertificateNotBefore","sig":"(Text, SecretText, var DateTime)","named":"(CertBase64Value: Text; Password: SecretText; var NotBefore: DateTime)","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"24-29","first":24,"last":29,"obsoleteSince":null,"spans":[{"from":24,"to":29,"named":"(CertBase64Value: Text; Password: SecretText; var NotBefore: DateTime)","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"HasPrivateKey","sig":"(Text, SecretText)","named":"(CertBase64Value: Text; Password: SecretText)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null,"range":"24-29","first":24,"last":29,"obsoleteSince":null,"spans":[{"from":24,"to":29,"named":"(CertBase64Value: Text; Password: SecretText)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}]},{"name":"GetCertificatePropertiesAsJson","sig":"(Text, SecretText, var Text)","named":"(CertBase64Value: Text; Password: SecretText; var CertPropertyJson: Text)","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"24-29","first":24,"last":29,"obsoleteSince":null,"spans":[{"from":24,"to":29,"named":"(CertBase64Value: Text; Password: SecretText; var CertPropertyJson: Text)","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"GetCertificatePublicKey","sig":"(Text, SecretText)","named":"(CertBase64Value: Text; Password: SecretText)","returns":"Text","kind":"procedure","access":"public","obsolete":null,"range":"24-29","first":24,"last":29,"obsoleteSince":null,"spans":[{"from":24,"to":29,"named":"(CertBase64Value: Text; Password: SecretText)","returns":"Text","kind":"procedure","access":"public","obsolete":null}]},{"name":"GetCertificatePrivateKey","sig":"(Text, SecretText)","named":"(CertBase64Value: Text; Password: SecretText)","returns":"SecretText","kind":"procedure","access":"public","obsolete":null,"range":"24-29","first":24,"last":29,"obsoleteSince":null,"spans":[{"from":24,"to":29,"named":"(CertBase64Value: Text; Password: SecretText)","returns":"SecretText","kind":"procedure","access":"public","obsolete":null}]},{"name":"GetCertificateSerialNumber","sig":"(Text, SecretText, var Text)","named":"(CertBase64Value: Text; Password: SecretText; var SerialNumber: Text)","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"24-29","first":24,"last":29,"obsoleteSince":null,"spans":[{"from":24,"to":29,"named":"(CertBase64Value: Text; Password: SecretText; var SerialNumber: Text)","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"GetCertificateSerialNumberAsASCII","sig":"(Text, SecretText, var Text)","named":"(CertBase64Value: Text; Password: SecretText; var SerialNumberASCII: Text)","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"24-29","first":24,"last":29,"obsoleteSince":null,"spans":[{"from":24,"to":29,"named":"(CertBase64Value: Text; Password: SecretText; var SerialNumberASCII: Text)","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"CreateFromPemAndExportAsBase64","sig":"(Text, SecretText, SecretText)","named":"(CertificateBase64: Text; PrivateKeyXmlString: SecretText; Password: SecretText)","returns":"Text","kind":"procedure","access":"public","obsolete":null,"range":"27-29","first":27,"last":29,"obsoleteSince":null,"spans":[{"from":27,"to":29,"named":"(CertificateBase64: Text; PrivateKeyXmlString: SecretText; Password: SecretText)","returns":"Text","kind":"procedure","access":"public","obsolete":null}]},{"name":"GetCertificatePublicKeyAsBase64String","sig":"(Text, SecretText)","named":"(CertBase64Value: Text; Password: SecretText)","returns":"Text","kind":"procedure","access":"public","obsolete":null,"range":"28-29","first":28,"last":29,"obsoleteSince":null,"spans":[{"from":28,"to":29,"named":"(CertBase64Value: Text; Password: SecretText)","returns":"Text","kind":"procedure","access":"public","obsolete":null}]},{"name":"GetRawCertDataAsBase64String","sig":"(Text, SecretText)","named":"(CertBase64Value: Text; Password: SecretText)","returns":"Text","kind":"procedure","access":"public","obsolete":null,"range":"28-29","first":28,"last":29,"obsoleteSince":null,"spans":[{"from":28,"to":29,"named":"(CertBase64Value: Text; Password: SecretText)","returns":"Text","kind":"procedure","access":"public","obsolete":null}]}]}