CertificateValidation/Microsoft.AzureStack.PublicCertificateRequest.psm1
|
Import-Module $PSScriptRoot\Microsoft.AzureStack.PublicCertificateRequest.Internal.psm1 -Force Import-Module $PSScriptRoot\..\Microsoft.AzureStack.ReadinessChecker.Utilities.psm1 -Force function New-AzsCertificateSigningRequest { <# .SYNOPSIS Wrapper function to build SANs and call internal certreq.exe function for multiSAN CSR or SingleSAN CSR .DESCRIPTION Imports the standard Azure Stack SANs and builds the SAN list, required/recommended certificate attributes and calls internal functions to generate multiple Certificate Signing Request files. .EXAMPLE $certificateRequestParams = @{ 'CertificateType' = 'Deployment' 'IdentitySystem' = 'AAD' 'regionName' = 'azurestack' 'externalFQDN' = 'contoso.com' 'subject' = "C=US,ST=Washington,L=Redmond,O=Microsoft,OU=Azure Stack" 'requestType' = 'MultipleCSR' 'OutputRequestPath' = "$ENV:USERPROFILE\Documents\AzsCertRequests" } New-AzsCertificateSigningRequest @certificateRequestParams Generates multiple CSRs for deployment of Azure Stack Hub e.g. portal.azurestack.contoso.com, management.azurestack.contoso.com etc.. .EXAMPLE $certificateRequestParams = @{ 'CertificateType' = 'Deployment' 'IdentitySystem' = 'AAD' 'regionName' = 'azurestack' 'externalFQDN' = 'contoso.com' 'subject' = "C=US,ST=Washington,L=Redmond,O=Microsoft,OU=Azure Stack" 'KeyLength' = 4096 'requestType' = 'MultipleCSR' 'OutputRequestPath' = "$ENV:USERPROFILE\Documents\AzsCertRequests" } New-AzsCertificateSigningRequest @certificateRequestParams Generates multiple CSRs for deployment of Azure Stack with Key Length of 4096 (rather than default 2048) .EXAMPLE $certificateRequestParams = @{ 'CertificateType' = 'Deployment' 'IdentitySystem' = 'AAD' 'regionName' = 'azurestack' 'externalFQDN' = 'contoso.com' 'subject' = "C=US,ST=Washington,L=Redmond,O=Microsoft,OU=Azure Stack" 'HashAlgorithm' = 'SHA384' 'requestType' = 'MultipleCSR' 'OutputRequestPath' = "$ENV:USERPROFILE\Documents\AzsCertRequests" } New-AzsCertificateSigningRequest @certificateRequestParams Generates multiple CSRs for deployment of Azure Stack with signature algorithm of SHA384 (rather than default SHA256) .EXAMPLE $certificateRequestParams = @{ 'CertificateType' = 'AppServices' # or DataboxEdge, DBAdapter, EventHubs, IoTHub. 'regionName' = 'azurestack' 'externalFQDN' = 'contoso.com' 'subject' = "C=US,ST=Washington,L=Redmond,O=Microsoft,OU=Azure Stack" 'OutputRequestPath' = "$ENV:USERPROFILE\Documents\AzsCertRequests" } New-AzsCertificateSigningRequest @certificateRequestParams Generates multiple CSRs for AppServices of Azure Stack .EXAMPLE $certificateRequestParams = @{ CertificateType = 'AzureStackEdgeDevice' DeviceName = 'DBG-KARB2NP5J' NodeSerialNumber = 'WIN-KARB2NP5J3O' externalFQDN = 'azurestackedge.contoso.com' OutputRequestPath = "$ENV:USERPROFILE\Documents\AzsCertRequests" } New-AzsCertificateSigningRequest @certificateRequestParams Generates multiple CSRs for Azure Stack Edge device certificates .EXAMPLE $certificateRequestParams = @{ CertificateType = 'AzureStackEdgeVPN' Subject = "C=US,ST=Washington,L=Redmond,O=Microsoft,OU=Azure Stack Edge" externalFQDN = 'azurestackedge.contoso.com' OutputRequestPath = "$ENV:USERPROFILE\Documents\AzsCertRequests" } New-AzsCertificateSigningRequest @certificateRequestParams Generates a CSR for a Azure Stack Edge VPN certificate .EXAMPLE $certificateRequestParams = @{ CertificateType = 'AzureStackEdgeVPN' Subject = "C=US,ST=Washington,L=Redmond,O=Microsoft,OU=Azure Stack Edge" EnhancedKeyUsage = @('Server Authentication',@{'Custom Usage' = '1.3.6.1.5.7.8.2.1'}) externalFQDN = 'azurestackedge.contoso.com' OutputRequestPath = "$ENV:USERPROFILE\Documents\AzsCertRequests" } New-AzsCertificateSigningRequest @certificateRequestParams Generates a CSRs for a Azure Stack Edge VPN certificate with custom OID for enhanced key usage. Note: You should include the required usage for the certificate and the custom usage as a hashtable where key = friendlyName; value = OID .EXAMPLE New-AzsCertificateSigningRequest -certificateType Deployment -StampEndpoint portal.azurestack.contoso.com -OutputRequestPath "$ENV:USERPROFILE\Documents\AzsCertRequests" Connects to existing endpoint https://portal.azurestack.contoso.com read the current SSL certificate, clones the attributes and creates Certificate Signing Requests with those attributes. For use with renewal of soon-to-be expired certs. .OUTPUTS None - This is a wrapper function that calls an internal function to generate the encoded CSR .PARAMETER CertificateType Specifies the Azure Stack certificate type to generate a request for e.g. Deployment, AppServices, EventHubs, IoTHub etc. .PARAMETER RegionName Specifies the Azure Stack deployment's region name, must be alphanumeric. .PARAMETER externalFQDN Specifies the Azure Stack deployment's External FQDN, also aliased as ExternalFQDN and FQDN, must be valid DNSHostName .PARAMETER DeviceName Specifies the serial number of an Azure Stack Edge device. .PARAMETER NodeSerialNumber Specifies the node name(s) of an Azure Stack Edge device. .PARAMETER DistinguishedName Specifies a DistinguishedName to be used on the certificate. Must be a valid System.Security.Cryptography.X509Certificates.X500DistinguishedName value. Common Name (CN) is not required, the appropriate value for the Azure Stack Service will be placed in the Common Name (CN). If a Common Name (CN) is given it will be honoured on every certificate request if supplied. Also aliased as subject. .PARAMETER DistinguishedNameFlag Specifies a string for the distinguished name flag to be used in the distinguished name. UseUTF8Encoding is selected by default. More information on x500DistinguishNameFlags can be found at https://aka.ms/dnflags .PARAMETER KeyLength Defines the length of the public and private key for the certificate request generation. Default is 2048. Valid values 2048, 4096, 8192 .PARAMETER HashAlgorithm Hash Algorithm to be used for the certificate request generation. Default is SHA256. Valid values SHA256, SHA384, SHA512 .PARAMETER EnhancedKeyUsage Extended (Enhanced) Key Usage to be included in the certificate request. Provide the required usage for the target certificate as well as the custom usage in hashtable format. e.g. @('Client Authentication','Server Authentication',@{'Custom Usage' = '1.3.6.1.5.7.8.2.1'}) will request Client and Server Auth key usage and the custom usage. .PARAMETER RequestType Specifies the SAN type of the certificate request. Valid values: MultipleCSR, SingleCSR. SingleCSR generates one certificate request for all services (not recommended for production). User will be prompted to confirm use. MultipleCSR generates multiple certificate requests, one for each service (strongly recommended in production environments). .PARAMETER StampEndpoint Provide a dns hostname of an existing stamp endpoint (region.external.fqdn) to clone the certificate attributes to be used to generate the certificate signing request. .PARAMETER OutputRequestPath Specifies the destination path for certificate request files, directory must already exist. .PARAMETER IdentitySystem Specifies the Azure Stack deployment's Identity System valid values, AAD or ADFS, for Azure Active Directory and Active Directory Federated Services respectively .PARAMETER IncludeContainerRegistry Include Azure Container Registry certificate request. .PARAMETER OutputPath Specifies custom path to save Readiness JSON report and Verbose log file. .PARAMETER ForceTLS12 Force the use of TLS 1.2, true by default, set to false to use to system default. .PARAMETER LowPrivilege Use in low privilege environment were elevation is not allowed. Generates INF certificate request templates. .LINK Generate Azure Stack Certificate Requests - https://aka.ms/AzsCSR Azure Stack Readiness Checker Tool - https://aka.ms/AzsReadinessChecker .NOTES #> [outputType([string])] [cmdletbinding()] [Alias("New-AzsCSR", "New-AzsCertificateRequest", "Write-AzsCertificateRequestFile")] param ( [Parameter(Mandatory = $true, HelpMessage = "Specify the Azure Stack certificate type to generate a request")] [ArgumentCompleter({Get-AzsCertificateRequestTypes | Sort-Object})] [ValidateScript({$_ -in (Get-AzsCertificateRequestTypes)})] [string] $CertificateType, [Parameter(Mandatory = $false, HelpMessage = "Enter Azure Stack Hub Region Name")] [string]$RegionName, [Parameter(Mandatory = $false, HelpMessage = "Enter Azure Stack Fully Qualified Domain Name (without region name)")] [Alias("FQDN", "ExternalDomainName")] [ValidateScript( {[System.Uri]::CheckHostName($_) -eq 'dns' <#FQDN must be valid DNSHostName#>})] [string]$ExternalFQDN, [Parameter(Mandatory = $false, HelpMessage = 'Provide subject name as a string, CN is not required and will be overwritten. E.g. "C=US,ST=Washington,L=Redmond,O=Microsoft,OU=Azure Stack"')] [Alias("Subject")] [System.Security.Cryptography.X509Certificates.X500DistinguishedName]$DistinguishedName, [Parameter(Mandatory = $false, HelpMessage = 'Provide X500DistinguishedNameFlags if The distinguished name has special characteristics. Default UseUTF8Encoding.')] [System.Security.Cryptography.X509Certificates.X500DistinguishedNameFlags]$DistinguishedNameFlag = 'UseUTF8Encoding', [Parameter(Mandatory = $false, HelpMessage = 'Provide Key Length: 2048, 4096 or 8192')] [ValidateSet(2048, 4096, 8192)] [int]$KeyLength = 2048, [Parameter(Mandatory = $false, HelpMessage = 'Provide Hash Algorithm: SHA256, SHA384 or SHA512')] [ValidateSet('SHA256', 'SHA384', 'SHA512')] [System.Security.Cryptography.HashAlgorithmName]$HashAlgorithm = 'SHA256', [Parameter(Mandatory = $false, HelpMessage = "Optionally provide Extended (Enhanced) Key Usage. By default, certificate config will be used. e.g. @('Client Authentication', 'Server Authentication', @{'Custom Usage' = '1.3.6.1.5.15.7.3.2'})")] $EnhancedKeyUsage, [Parameter(Mandatory = $false, HelpMessage = "Enter Certificate Request generation type ('Single' = Request individual wildcard certificates, 'Multiple' = Request single multi domain wildcard certificates")] [ValidateSet('MultipleCSR', 'SingleCSR')] [string]$requestType = 'MultipleCSR', [Parameter(Mandatory = $false, HelpMessage = "Enter Azure Stack Identity System (AAD or ADFS) when generating deployment certificates")] [ValidateSet('AAD', 'ADFS')] [string]$IdentitySystem, [Parameter(Mandatory = $false, HelpMessage = "Include Azure Container Registry certificate request.")] [switch]$IncludeContainerRegistry, [Parameter(Mandatory = $false, HelpMessage = "Optionally provide an existing stamp endpoint (region.fqdn) to clone the certificate attributes to be used to generate the certificate signing request.")] [ValidateScript( {[System.Uri]::CheckHostName($_) -eq 'dns' <#FQDN must be valid DNSHostName#>})] $StampEndpoint, [Parameter(Mandatory = $false, HelpMessage = "Force the use of TLS 1.2, true by default")] [bool]$ForceTLS12 = $true, [Parameter(Mandatory = $true, HelpMessage = "Destination Path for Certificate Request(s)")] [ValidateScript( {Test-Path -Path $_ -PathType Container <# should be a valid directory path #>})] [string]$OutputRequestPath, [Parameter(Mandatory = $false, HelpMessage = "Directory path for log and report output")] [string]$OutputPath = "$ENV:TEMP\AzsReadinessChecker", [Parameter(Mandatory = $false, HelpMessage = "Use in low privilege environment were elevation is not allowed. Generates INF certificate request templates.")] [switch]$LowPrivilege ) DynamicParam { if ('AzureStackEdgeDevice' -in $certificateType) { $ParamAttrib = New-Object System.Management.Automation.ParameterAttribute $ParamAttrib.Mandatory = $true $ParamAttrib.ParameterSetName = 'AzureStackEdgeDevice' $AttribColl = New-Object System.Collections.ObjectModel.Collection[System.Attribute] $AttribColl.Add($ParamAttrib) # Create addition parameters for AzureStackEdge $RuntimeParamDic = New-Object System.Management.Automation.RuntimeDefinedParameterDictionary $RuntimeParam = New-Object System.Management.Automation.RuntimeDefinedParameter('DeviceName', [string], $AttribColl) $RuntimeParamDic.Add('DeviceName', $RuntimeParam) $RuntimeParam = New-Object System.Management.Automation.RuntimeDefinedParameter('NodeSerialNumber', [string[]], $AttribColl) $RuntimeParamDic.Add('NodeSerialNumber', $RuntimeParam) } if ($RuntimeParamDic) { return $RuntimeParamDic } } process { $thisFunction = $MyInvocation.MyCommand.Name $GLOBAL:OutputPath = $OutputPath Import-Module $PSScriptRoot\..\Microsoft.AzureStack.ReadinessChecker.Reporting.psm1 -Force Import-Module $PSScriptRoot\Microsoft.AzureStack.PublicCertificateRequest.Internal.psm1 -Force Write-Header -invocation $MyInvocation -params $PSBoundParameters if (-not $LowPrivilege) { if (Test-Elevation) { Write-AzsReadinessLog -Message ("Powershell running as Administrator. Continuing.") -Type Info } else { Write-AzsReadinessLog -Message ("Running as administrator is required for this operation. `nPlease restart PowerShell as Administrator and retry.") -Type Error -toScreen Write-AzsReadinessLog -Message ("This is because certificate request generation creates sensitive key material in the local certificate store") -Type Error -toScreen Write-AzsReadinessLog -Message ("If you are unable to elevate to Administrator, you can create the Certificate Request Template files by running the previous command and adding -LowPrivilege.") -Type Error -toScreen throw "This operation requires elevation." } } else { Write-AzsReadinessLog -Message ("LowPrivilege:$lowPrivilege. Skipping elevation check. Continuing.") -Type Info } $certificateConfigDataFile = Import-PowerShellDataFile -Path $PSScriptRoot\Microsoft.AzureStack.CertificateConfig.psd1 try { # gather attributes from an existing certificate if ($StampEndpoint) { # Get intended certificate config $StampEndpointExpectedConfig = $certificateConfigDataFile.CertificateTypes[$PSBoundParameters.CertificateType] $FixedEndpoint = Get-FixedEndPoints -certificateConfig $StampEndpointExpectedConfig -stampEndpoint $stampEndpoint # Force Security Profile to TLS1.2 if ($ForceTLS12) { # Change Security Protocol to TLS1.2 for the session and track for clean up later. $restoreSecurityProtocol = [Net.ServicePointManager]::SecurityProtocol $tempSecurityProtocol = [Net.SecurityProtocolType]::Tls12 Set-SecurityProtocol -securityProtocol $tempSecurityProtocol } # check the endpoint(s) for the certificate $csrParams = Get-AzsCSRParameters -StampEndpoint $FixedEndpoint if (-not $csrParams){ $csrParamError = ("Failed to query {0} for existing certificate.`r`nPlease create certificate signing request as a new request." -f ($FixedEndpoint -join ',')) Write-AzsReadinessLog -Message $csrParamError -Type Error throw $csrParamError } # Set params for certificate request, omit anything null i.e. null distinguished name (CN only scenario) foreach ($key in $csrParams.Keys) { if ($csrParams.$key) { Set-Variable -Name $key -Value $csrParams.$key Write-AzsReadinessLog -Message ("Setting {0} to {1}" -f $key,$csrParams.$key) -Type Info -Function $thisFunction } } } # Join RegionName and ExternalFQDN if ($regionName -and $CertificateType -ne 'AzureStackEdgeDevice') { $ExternalFQDN = "{0}" -f (($regionName,$ExternalFQDN) -join '.') } # Check Extended Key Usage if ($EnhancedKeyUsage) { ConvertTo-EnhancedKeyUsage -EnhancedKeyUsages $EnhancedKeyUsage } foreach ($certificateType in $PSBoundParameters.CertificateType) { Write-AzsReadinessLog -Message ("Starting Certificate Request Process for {0}" -f $certificateType) -Type Info -Function $thisFunction -toScreen # Check the DistinguishedName is good to use. if ($DistinguishedName) { $testDistinguishedName = Test-DistinguishedName -DistinguishedName $DistinguishedName -DistinguishedNameFlag $DistinguishedNameFlag if (-not $testDistinguishedName) { Write-AzsReadinessLog -Message ("Distinguished name '{0}' cannot be processed with x500DistinguishedName with flag '{1}', explicitly provide the right flag with -DistinguishedNameFlag. See https://aka.ms/azscsr for more information." -f $DistinguishedName,$DistinguishedNameFlag) -Type Error -Function $thisFunction -toScreen break } } # Check the user provided appropriate parameters # IdentitySystem if Deployment certificates are being generated (dynamic parameter do not allow this valdiate on the param block) if ($certificateType -eq 'Deployment' -AND -not $IdentitySystem) { throw "CertificateType is Deployment and IdentitySystem not provided. Please re-run providing -IdentitySystem valid values are AAD or ADFS." } # NodeSerialNumber is AzureStackEdgeDevice if ($certificateType -eq 'AzureStackEdgeDevice' -and !$PSBoundParameters.NodeSerialNumber) { throw "CertificateType is $certificateType and NodeSerialNumber not provided. Please re-run providing -NodeSerialNumber and the appropriate value for your system." } $certificateConfig = $certificateConfigDataFile.CertificateTypes[$CertificateType] if ($certificateType -eq 'Deployment' -AND $IdentitySystem -eq 'AAD') { Write-AzsReadinessLog -Message "CertificateType is Deployment and IdentitySystem is AAD, removing Graph and ADFS from config" -Type Info -Function $thisFunction $certificateConfig.Remove('Graph') $certificateConfig.Remove('ADFS') } # Remove container registry if it is not required if ($certificateType -eq 'Deployment' -AND -not $IncludeContainerRegistry) { $certificateConfig.Remove('Container Registry') } # Adding support for multiple node certs, adding and setting DNSName (template) in one go. if ($CertificateType -eq 'AzureStackEdgeDevice') { if ($PSBoundParameters.nodeSerialNumber.count -gt 1) { $num = 0 $PSBoundParameters.nodeSerialNumber | ForEach-Object { $newNode = $certificateConfig.node.Clone() $nodeKey = "Node{0:d2}" -f $num $certificateConfig.Add($nodeKey,$newNode) $certificateConfig[$nodeKey].DnsName = $PSITEM $num++ } $certificateConfig.remove('Node') } } # attributes should be user specified (globally), certificate specific or defaults $CertificateDefaults = $certificateConfigDataFile.CertificateDefaults foreach ($certificate in $certificateConfig.Keys) { Write-AzsReadinessLog -Message ("Starting attribute calculation for certificate {0}." -f $certificate) -Type Info -Function $thisFunction foreach ($attribute in $certificateConfig.$Certificate.keys | where-Object {$PSITEM -notin 'DNSName', 'IncludeTests', 'ExcludeTests'}) { Write-AzsReadinessLog -Message ("Starting attribute {0}." -f $attribute) -Type Info -Function $thisFunction # user first if ($attribute -in $PSBoundParameters.Keys) { Write-AzsReadinessLog -Message ("Attribute {0} found on user parameters supplied. Replacing default value ({1}) with ({2})." -f $attribute,$CertificateDefaults[$attribute],$PSBoundParameters[$attribute]) -Type Info -Function $thisFunction $certificateConfig.$Certificate.$attribute = $PSBoundParameters[$attribute] } else { if ($certificateConfig.$Certificate.$attribute -eq 'default') { Write-AzsReadinessLog -Message ("Attribute {0} should be default value ({1})." -f $attribute,$CertificateDefaults[$attribute]) -Type Info -Function $thisFunction $certificateConfig.$Certificate.$attribute = $CertificateDefaults.$attribute } else { Write-AzsReadinessLog -Message ("Attribute {0} is non default, keeping certificate config ({1})." -f $attribute,(($certificateConfig.$Certificate.$attribute) -join ',')) -Type Info -Function $thisFunction } } } } if ($requestType -eq 'SingleCSR') { # Handle SANs for AzureStackEdge certificates with DeviceName, NodeSerialNumbers # Append region & fqdn to dnsname for the rest if ($CertificateType -match 'AzureStackEdge') { foreach ($key in $certificateConfig.Keys) { $certificateConfig.$key.DNSName = $certificateConfig.$key.DNSName | Foreach-Object { ` $PSITEM.replace('[[DeviceName]]',$PSBoundParameters.DeviceName).replace('[[NodeSerialNumber]]',$PSBoundParameters.NodeSerialNumber) } } } # If region name exists, append region & fqdn to dnsname, otherwise just use fqdn $subjectAlternativeNames = $certificateConfig.Keys | ForEach-Object {$certificateConfig.$PSITEM.DNSName} | Foreach-Object { ` if ($PSITEM -ne '') { "{0}.{1}" -f $PSITEM,$externalFQDN } else { $externalFQDN } } | Sort-Object $commonName = $subjectAlternativeNames | Sort-Object | Select-Object -First 1 # Set subject to first SAN or (if supplied) honour users common name $certificateSubjectParams = @{ distinguishedName = $DistinguishedName DistinguishedNameFlag = $DistinguishedNameFlag commonName = $commonName } $certificateSubject = Set-CertificateSubject @certificateSubjectParams # set request path to include regionname/devicename, externalfqdn and SingleCSR if ($PSCmdlet.ParameterSetName -eq 'AzureStackEdgeDevice') { $leaf = "{0}_{1}_{2}_SingleCSR" -f $CertificateType,$PSBoundParameters.DeviceName,$ExternalFQDN.replace('.','_') $OutputRequestPathSeed = Join-Path -Path $OutputRequestPath -ChildPath $leaf } else { $OutputRequestPathSeed = Join-Path -Path $OutputRequestPath -ChildPath ("{0}_{1}_SingleCSR" -f $CertificateType,$ExternalFQDN.replace('.','_')) } # TO DO remove this hardcoding of CN for AzureStackEdgeDevice if ($key -in $certificateConfigDataFile.CertificateTypes.AzureStackEdgeDevice.Keys) { $certificateSubject = [System.Security.Cryptography.X509Certificates.X500DistinguishedName]::new("CN=$commonName") } # Call CSR generation $csrParams = @{ 'subject' = $certificateSubject.decode($DistinguishedNameFlag) 'subjectAltNames' = $SubjectAlternativeNames 'KeyLength' = $certificateConfig.keys | ForEach-Object {$certificateConfig.$PSITEM.KeyLength} | Sort-Object -Descending | Select-Object -first 1 'HashAlgorithm' = $certificateConfig.keys | ForEach-Object {$certificateConfig.$PSITEM.HashAlgorithm} | Sort-Object -Descending | Select-Object -first 1 'KeyUsageEKUExtension' = $certificateConfig.keys | ForEach-Object {$certificateConfig.$PSITEM.EnhancedKeyUsage.Keys} | Sort-Object | Get-Unique 'KeyUsage' = $certificateConfig.keys | ForEach-Object {$certificateConfig.$PSITEM.KeyUsage.Keys} | Sort-Object | Get-Unique 'DistinguishedNameFlag' = $DistinguishedNameFlag 'OutputRequestPath' = $OutputRequestPathSeed 'LowPrivilege' = $LowPrivilege } Write-AzsCertificateRequestFileInternal @csrParams } else { foreach ($key in $certificateConfig.Keys) { # Handle SANs for AzureStackEdgeDevice appliance certificates with DeviceName and NodeSerialNumbers # Append region & fqdn to dnsname for the rest $AzureStackEdgeDeviceApplianceCertificates = $certificateConfigDataFile.CertificateTypes.AzureStackEdgeDevice.Keys + ` $certificateConfigDataFile.CertificateTypes.AzureStackEdgeVPN.Keys if ($key -in $AzureStackEdgeDeviceApplianceCertificates) { $certificateConfig.$key.DNSName = $certificateConfig.$key.DNSName | Foreach-Object { ` $PSITEM.replace('[[DeviceName]]',$PSBoundParameters.DeviceName).replace('[[NodeSerialNumber]]',$PSBoundParameters.NodeSerialNumber) } | Sort-Object } # If region name exists, append region & fqdn to dnsname, otherwise just use fqdn $subjectAlternativeNames = $certificateConfig.$key.DNSName | Foreach-Object { ` if ($PSITEM -ne '') { "{0}.{1}" -f $PSITEM,$externalFQDN } else { $externalFQDN } } | Sort-Object # Set subject to first SAN or (if supplied) honour users common name $commonName = $subjectAlternativeNames | Sort-Object -Descending | Select-Object -First 1 $certificateSubjectParams = @{ distinguishedName = $DistinguishedName DistinguishedNameFlag = $DistinguishedNameFlag commonName = $commonName } $certificateSubject = Set-CertificateSubject @certificateSubjectParams # TO DO remove this hardcoding of CN for AzureStackEdgeDevice if ($key -in $certificateConfigDataFile.CertificateTypes.AzureStackEdgeDevice.Keys) { $certificateSubject = [System.Security.Cryptography.X509Certificates.X500DistinguishedName]::new("CN=$commonName") } # Check the object type of EKU if ($certificateConfig.$key.EnhancedKeyUsage -is [HashTable]) { $KeyUsageEKUExtension = $certificateConfig.$key.EnhancedKeyUsage.Keys } else { $KeyUsageEKUExtension = $certificateConfig.$key.EnhancedKeyUsage } $OutputRequestPathSeed = Join-Path -Path $OutputRequestPath -ChildPath $commonName.Replace('.', '_').Replace('*', 'wildcard') # Call CSR generation $csrParams = @{ 'subject' = $certificateSubject.decode($DistinguishedNameFlag) 'subjectAltNames' = $SubjectAlternativeNames 'KeyLength' = $certificateConfig.$key.KeyLength 'HashAlgorithm' = $certificateConfig.$key.HashAlgorithm 'KeyUsageEKUExtension' = $KeyUsageEKUExtension 'KeyUsage' = $certificateConfig.$key.KeyUsage.Keys 'DistinguishedNameFlag' = $DistinguishedNameFlag 'OutputRequestPath' = $OutputRequestPathSeed 'LowPrivilege' = $LowPrivilege } Write-AzsCertificateRequestFileInternal @csrParams } } if ($LowPrivilege) { Write-AzsReadinessLog -Message ("ACTIONS REQUIRED: `n`t 1) Copy templates from {0} to a system that allows elevation. `n`t 2) Run 'certreq -new <example.inf> <example.req>' to generate Certificate Request files." -f $OutputRequestPath) -Type Info -Function $thisFunction -toScreen } } } catch { Write-AzsReadinessLog -Message ("New-AzsCertificateSigningRequest failed with exception: {0}" -f $_.exception) -Type Error -Function $thisFunction -toScreen } finally { # Restore TLS back to default if ($ForceTLS12 -and $restoreSecurityProtocol) { Set-SecurityProtocol -securityProtocol $restoreSecurityProtocol } Write-Footer -invocation $MyInvocation } } } function Get-AzsCertificateRequestTypes { param ([string[]]$certificateTypeExclusions = @('Hardware')) $certificateConfigDataFile = Import-PowerShellDataFile -Path $PSScriptRoot\Microsoft.AzureStack.CertificateConfig.psd1 $certificateTypes = $certificateConfigDataFile.CertificateTypes | Select-Object -ExpandProperty Keys | Where-Object {$PSITEM -notin $certificateTypeExclusions} $certificateTypes | Sort-Object } function New-SelfSignedHardwareCertificate { <# .SYNOPSIS Generates Self Signed Certificates for use with Hardware baseboard interfaces .DESCRIPTION Generates Self Signed Certificates for use with Hardware baseboard interfaces Overwrites existing pfx with the same name OutputPath\DNSName.pfx .EXAMPLE $outputPath = "$ENV:USERPROFILE\Documents\AzureStackCSR" $pfxPassword = Read-Host -Prompt "PFX Password" -AsSecureString New-SelfSignedHardwareCertificate -CertificateType BMC -DnsRecord node01-bmc -pfxPassword $pfxPassword -OutputPath $ENV:USERPROFILE\Documents\AzureStackCSR Creates a self-signed certificate for BMC with a dnsname of node01-bmc and places the pfx in $ENV:USERPROFILE\Documents\AzureStackCSR\node01-bmc.pfx .EXAMPLE $json = Get-Content "C:\Users\jerskine\OneDrive - Microsoft\DocumentsMSOneDrive\AzureStack\AzsReadinessChecker\TestAssets\DeploymentData.json" | Convertfrom-Json $outputPath = "$ENV:USERPROFILE\Documents\AzureStackCSR" $pfxPassword = Read-Host -Prompt "PFX Password" -AsSecureString $NodeDnsNames = $json.DeploymentData.PhysicalNodes.Name | Foreach-Object {"{0}.{1}.{2}" -f $PSITEM,$json.DeploymentData.RegionName, $json.DeploymentData.ExternalDomainFQDN} $NodeDnsNames | Foreach-Object {New-SelfSignedHardwareCertificate -CertificateType BMC -DnsRecord $PSITEM -pfxPassword $pfxPassword -OutputPath $outputPath} Creates a self-signed certificate for BMC for each node in a deploymentdata.json .OUTPUTS PFX File Path - String .NOTES Intended for deployment team usage at deployment site. #> [CmdletBinding(SupportsShouldProcess = $true, ConfirmImpact = 'Medium')] param ( [Parameter(Mandatory = $true, HelpMessage = "DNS Name for Certificate")] [string] $DnsRecord, [Parameter(Mandatory = $true, HelpMessage = "Password for Certificate")] [securestring] $pfxPassword, [Parameter(Mandatory = $true, HelpMessage = "Destination Path for Certificate")] [ValidateScript( {Test-Path -Path $_ -PathType Container <# should be a valid directory path #>})] [string]$OutputPath, [Parameter(Mandatory = $false, HelpMessage = "Leave certificate in store and pass System.Security.Cryptography.X509Certificates.X509Certificate2 object")] [switch]$passThru ) DynamicParam { #Certificate Type Param $ParamAttrib = New-Object System.Management.Automation.ParameterAttribute $ParamAttrib.Mandatory = $true $ParamAttrib.ParameterSetName = '__AllParameterSets' $AttribColl = New-Object System.Collections.ObjectModel.Collection[System.Attribute] $AttribColl.Add($ParamAttrib) $certificateConfigDataFile = Import-PowerShellDataFile -Path $PSScriptRoot\Microsoft.AzureStack.CertificateConfig.psd1 $certificateTypes = $certificateConfigDataFile.CertificateTypes.Hardware | Select-Object -ExpandProperty Keys $AttribColl.Add((New-Object System.Management.Automation.ValidateSetAttribute($certificateTypes))) $RuntimeParam = New-Object System.Management.Automation.RuntimeDefinedParameter('CertificateType', [string], $AttribColl) $RuntimeParamDic = New-Object System.Management.Automation.RuntimeDefinedParameterDictionary $RuntimeParamDic.Add('CertificateType', $RuntimeParam) return $RuntimeParamDic } process { try { # Ensure we are elevated if (Test-Elevation) { Write-AzsReadinessLog -Message ("Powershell running as Administrator. Continuing.") -Type Info } else { Write-AzsReadinessLog -Message ("Running as administrator is required for this operation. `nPlease restart PowerShell as Administrator and retry.") -Type Error -toScreen Write-AzsReadinessLog -Message ("This is because sensitive key material must be generated in order to create a self signed certificate.") -Type Error -toScreen throw "This operation requires elevation." } Import-Module $PSScriptRoot\PublicCertHelper.psd1 -force $certPath = 'cert:/localmachine/my' # Get Certificate from config $certificateConfig = $certificateConfigDataFile.CertificateTypes.Hardware[$PSBoundParameters.CertificateType] # Get certificate default and replace with any values with user supplied values $CertificateDefaults = $certificateConfigDataFile.CertificateDefaults $certConfig = @{} foreach ($key in $certificateConfig.Keys) { if ($certificateConfig.$key -eq 'default') { $certConfig.Add($key,$CertificateDefaults.$key) } else { $certConfig.Add($key,$certificateConfig.$key) } } $NewCertParams = @{ dnsname = $DnsRecord KeyUsage = @($certConfig.KeyUsage.Keys) HashAlgorithm = $certConfig.HashAlgorithm KeyLength = $certConfig.KeyLength NotAfter = [System.Datetime]::Now.AddYears(2) KeyUsageProperty = 'All' Provider = "Microsoft Enhanced RSA and AES Cryptographic Provider" KeyExportPolicy = 'Exportable' certstorelocation = $certPath } $certificate = New-SelfSignedCertificate @NewCertParams $filePath = Join-Path -Path $OutputPath -ChildPath "$DnsRecord.pfx" Export-AzsCertificate -filePath $filePath -certPath $certificate -pfxPassword $pfxPassword } catch { throw $_.exception } finally { if ($passThru) { $certificate } else { $certificate | Remove-Item -Force -ErrorAction Continue $filePath } } } } function ConvertTo-PEM { <# .SYNOPSIS Write the certificate in pem format. .DESCRIPTION Write the certificate in pem format. .EXAMPLE $cert = Get-Item Cert:\LocalMachine\my\04B781836CD350D78888FAC5612BCEBA9C2FA25F $path = "C:\scratch\{0}.key" -f $cert.Thumbprint ConvertTo-PEM -certificate $cert -path $path Convert the certificate to PEM format and generate key file. #> [CmdletBinding()] param ( [System.Security.Cryptography.X509Certificates.X509Certificate2] $certificate, [ValidateScript( { Test-Path $PSITEM -PathType Container } <#parent path must exist#>)] [string]$path ) try { # Ensure we are elevated if (Test-Elevation) { Write-AzsReadinessLog -Message ("Powershell running as Administrator. Continuing.") -Type Info } else { Write-AzsReadinessLog -Message ("Running as administrator is required for this operation. `nPlease restart PowerShell as Administrator and retry.") -Type Error -toScreen Write-AzsReadinessLog -Message ("This is because sensitive key material must be loaded in order to write it to file.") -Type Error -toScreen throw "This operation requires elevation." } # build string $sb = [System.Text.StringBuilder]::new() [void]$sb.AppendLine('-----BEGIN CERTIFICATE-----') $base64 = [System.Convert]::ToBase64String($certificate.RawData, "InsertLineBreaks") [void]$sb.AppendLine($base64) [void]$sb.AppendLine('-----END CERTIFICATE-----') # write to file $filePath = "{0}\{1}.pem" -f $Path, $certificate.Thumbprint $stream = [System.IO.StreamWriter]::new($filePath) $stream.WriteLine($sb.ToString()) $stream.close() Write-Verbose "Finished $filePath" if ($certificate.HasPrivateKey) { $key = Write-PrivateKeyFile -path $path -certificate $certificate } else { Write-Verbose "Certificate does not contain private key, key file cannot be written" } if (-not $key) { Write-Verbose "Failed to create key file" } $path } catch { throw $_ } } function Write-PrivateKeyFile { <# .SYNOPSIS Write the private key of a certificate in pem format. .DESCRIPTION Write the private key of a certificate in pem format. .EXAMPLE $cert = Get-Item Cert:\LocalMachine\my\04B781836CD350D78888FAC5612BCEBA9C2FA25F $path = "C:\scratch\{0}.key" -f $cert.Thumbprint Write-PrivateKeyFile -certificate $cert -path $path Write the private key of certificate to a file named after the certificate thumbprint. #> [CmdletBinding()] param ( [System.Security.Cryptography.X509Certificates.X509Certificate2] $certificate, [ValidateScript( { Test-Path $PSITEM -PathType Container } <#parent path must exist#>)] [string]$path ) try { # Get key material $key = [System.Security.Cryptography.X509Certificates.RSACertificateExtensions]::GetRSAPrivateKey($certificate) $Pkcs8 = $key.key.Export([System.Security.Cryptography.CngKeyBlobFormat]::Pkcs8PrivateBlob) $base64 = [Convert]::ToBase64String($Pkcs8, "InsertLineBreaks") # Build key string $sb = [System.Text.StringBuilder]::new() [void]$sb.AppendLine('-----BEGIN RSA PRIVATE KEY-----') [void]$sb.AppendLine($base64) [void]$sb.AppendLine("-----END RSA PRIVATE KEY-----") # write to file $filePath = "{0}\{1}.key" -f $Path, $certificate.Thumbprint $stream = [System.IO.StreamWriter]::new($filePath) $stream.WriteLine($sb.ToString()) $stream.close() Write-Verbose "Finished $filePath" $path } catch { Write-Verbose "Unable to create private key file err: $($_.exception.message)" } } function New-AzsEdgeDeviceCertificateSigningRequest { <# .SYNOPSIS Generates Certificate Signing Requests for Azure Stack Edge Device Certificates .DESCRIPTION Calls New-AzsCertificateSigningRequest with neccessary parameters to generate CSR for Azure Stack Edge Device certificates .EXAMPLE $certificateRequestParams = @{ DeviceName = 'DBG-KARB2NP5J' NodeSerialNumber = 'WIN-KARB2NP5J3O' externalFQDN = 'azurestackedge.contoso.com' OutputRequestPath = "$ENV:USERPROFILE\Documents\AzsCertRequests" } New-AzsEdgeDeviceCertificateSigningRequest @certificateRequestParams Generates Certificate Signing Requests for Azure Stack Edge Device Certificates .EXAMPLE $certificateRequestParams = @{ DeviceName = 'DBG-KARB2NP5J' NodeSerialNumber = 'WIN-KARB2NP5J3O','WIN-GBWB7ML4K9O' externalFQDN = 'azurestackedge.contoso.com' OutputRequestPath = "$ENV:USERPROFILE\Documents\AzsCertRequests" } New-AzsEdgeDeviceCertificateSigningRequest @certificateRequestParams Generates Certificate Signing Requests for multi-node Azure Stack Edge Device Certificates .PARAMETER DeviceName Specifies the serial number of an Azure Stack Edge device. .PARAMETER NodeSerialNumber Specifies the node name(s) of an Azure Stack Edge device. .PARAMETER externalFQDN Specifies the Azure Stack deployment's External FQDN, also aliased as ExternalFQDN and FQDN, must be valid DNSHostName .PARAMETER OutputRequestPath Specifies the destination path for certificate request files, directory must already exist. .PARAMETER LowPrivilege Use in low privilege environment were elevation is not allowed. Generates INF certificate request templates. #> [CmdletBinding()] param ( [Parameter(Mandatory = $false, HelpMessage = 'Provide subject name as a string, CN is not required and will be overwritten. E.g. "C=US,ST=Washington,L=Redmond,O=Microsoft,OU=Azure Stack"')] [Alias("Subject")] [System.Security.Cryptography.X509Certificates.X500DistinguishedName]$DistinguishedName, [Parameter(Mandatory = $false, HelpMessage = 'Provide X500DistinguishedNameFlags if The distinguished name has special characteristics. Default UseUTF8Encoding.')] [System.Security.Cryptography.X509Certificates.X500DistinguishedNameFlags]$DistinguishedNameFlag = 'UseUTF8Encoding', [Parameter(Mandatory = $true, HelpMessage = "Enter the Device Name of an Azure Stack Edge device.")] [string]$DeviceName, [Parameter(Mandatory = $true, HelpMessage = "Enter the Node Serial Number of an Azure Stack Edge device.")] [string[]]$NodeSerialNumber, [Parameter(Mandatory = $false, HelpMessage = 'Provide Key Length: 2048, 4096 or 8192')] [ValidateSet(2048, 4096, 8192)] [int]$KeyLength = 2048, [Parameter(Mandatory = $false, HelpMessage = 'Provide Hash Algorithm: SHA256, SHA384 or SHA512')] [ValidateSet('SHA256', 'SHA384', 'SHA512')] [System.Security.Cryptography.HashAlgorithmName]$HashAlgorithm = 'SHA256', [Parameter(Mandatory = $false, HelpMessage = "Optionally provide Extended (Enhanced) Key Usage. By default, certificate config will be used. e.g. @('Client Authentication', 'Server Authentication', @{'Custom Usage' = '1.3.6.1.5.15.7.3.2'})")] $EnhancedKeyUsage, [Parameter(Mandatory = $false, HelpMessage = "Enter Certificate Request generation type ('Single' = Request individual wildcard certificates, 'Multiple' = Request single multi domain wildcard certificates")] [ValidateSet('MultipleCSR', 'SingleCSR')] [string]$requestType = 'MultipleCSR', [Parameter(Mandatory = $true, HelpMessage = "Enter Azure Stack Fully Qualified Domain Name (without region name)")] [Alias("FQDN", "ExternalDomainName")] [ValidateScript( {[System.Uri]::CheckHostName($_) -eq 'dns' <#FQDN must be valid DNSHostName#>})] [string]$ExternalFQDN, [Parameter(Mandatory = $true, HelpMessage = "Destination Path for Certificate Request(s)")] [ValidateScript( {Test-Path -Path $_ -PathType Container <# should be a valid directory path #>})] [string]$OutputRequestPath, [Parameter(Mandatory = $false, HelpMessage = "Directory path for log and report output")] [string]$OutputPath = "$ENV:TEMP\AzsReadinessChecker", [Parameter(Mandatory = $false, HelpMessage = "Use in low privilege environment were elevation is not allowed. Generates INF certificate request templates.")] [switch]$LowPrivilege ) New-AzsCertificateSigningRequest @PSBoundParameters -CertificateType AzureStackEdgeDevice } function New-AzsEdgeVPNCertificateSigningRequest { <# .SYNOPSIS Generates Certificate Signing Requests for Azure Stack Edge VPN Certificates .DESCRIPTION Calls New-AzsCertificateSigningRequest with neccessary parameters to generate CSR for Azure Stack Edge VPN certificates .EXAMPLE $certificateRequestParams = @{ Subject = "C=US,ST=Washington,L=Redmond,O=Microsoft,OU=Azure Stack Edge" externalFQDN = 'azurestackedge.contoso.com' OutputRequestPath = "$ENV:USERPROFILE\Documents\AzsCertRequests" } New-AzsEdgeVPNCertificateSigningRequest @certificateRequestParams Generates Certificate Signing Requests for Azure Stack Edge VPN Certificates .PARAMETER externalFQDN Specifies the Azure Stack deployment's External FQDN, also aliased as ExternalFQDN and FQDN, must be valid DNSHostName .PARAMETER DistinguishedName Specifies a DistinguishedName to be used on the certificate. Must be a valid System.Security.Cryptography.X509Certificates.X500DistinguishedName value. Common Name (CN) is not required, the appropriate value for the Azure Stack Service will be placed in the Common Name (CN). If a Common Name (CN) is given it will be honoured on every certificate request if supplied. Also aliased as subject. .PARAMETER DistinguishedNameFlag Specifies a string for the distinguished name flag to be used in the distinguished name. UseUTF8Encoding is selected by default. More information on x500DistinguishNameFlags can be found at https://aka.ms/dnflags .PARAMETER KeyLength Defines the length of the public and private key for the certificate request generation. Default is 2048. Valid values 2048, 4096, 8192 .PARAMETER HashAlgorithm Hash Algorithm to be used for the certificate request generation. Default is SHA256. Valid values SHA256, SHA384, SHA512 .PARAMETER EnhancedKeyUsage Extended (Enhanced) Key Usage to be included in the certificate request. Provide the required usage for the target certificate as well as the custom usage in hashtable format. e.g. @('Client Authentication','Server Authentication',@{'Custom Usage' = '1.3.6.1.5.7.8.2.1'}) will request Client and Server Auth key usage and the custom usage. .PARAMETER RequestType Specifies the SAN type of the certificate request. Valid values: MultipleCSR, SingleCSR. SingleCSR generates one certificate request for all services (not recommended for production). User will be prompted to confirm use. MultipleCSR generates multiple certificate requests, one for each service (strongly recommended in production environments). .PARAMETER OutputRequestPath Specifies the destination path for certificate request files, directory must already exist. .PARAMETER OutputPath Specifies custom path to save verbose log file. .PARAMETER LowPrivilege Use in low privilege environment were elevation is not allowed. Generates INF certificate request templates. #> [CmdletBinding()] param ( [Parameter(Mandatory = $true, HelpMessage = 'Provide subject name as a string, CN is not required and will be overwritten. E.g. "C=US,ST=Washington,L=Redmond,O=Microsoft,OU=Azure Stack"')] [Alias("Subject")] [System.Security.Cryptography.X509Certificates.X500DistinguishedName]$DistinguishedName, [Parameter(Mandatory = $false, HelpMessage = 'Provide X500DistinguishedNameFlags if The distinguished name has special characteristics. Default UseUTF8Encoding.')] [System.Security.Cryptography.X509Certificates.X500DistinguishedNameFlags]$DistinguishedNameFlag = 'UseUTF8Encoding', [Parameter(Mandatory = $false, HelpMessage = 'Provide Key Length: 2048, 4096 or 8192')] [ValidateSet(2048, 4096, 8192)] [int]$KeyLength = 2048, [Parameter(Mandatory = $false, HelpMessage = 'Provide Hash Algorithm: SHA256, SHA384 or SHA512')] [ValidateSet('SHA256', 'SHA384', 'SHA512')] [System.Security.Cryptography.HashAlgorithmName]$HashAlgorithm = 'SHA256', [Parameter(Mandatory = $false, HelpMessage = "Optionally provide Extended (Enhanced) Key Usage. By default, certificate config will be used. e.g. @('Client Authentication', 'Server Authentication', @{'Custom Usage' = '1.3.6.1.5.15.7.3.2'})")] $EnhancedKeyUsage, [Parameter(Mandatory = $false, HelpMessage = "Enter Certificate Request generation type ('Single' = Request individual wildcard certificates, 'Multiple' = Request single multi domain wildcard certificates")] [ValidateSet('MultipleCSR', 'SingleCSR')] [string]$requestType = 'MultipleCSR', [Parameter(Mandatory = $true, HelpMessage = "Enter Azure Stack Fully Qualified Domain Name (without region name)")] [Alias("FQDN", "ExternalDomainName")] [ValidateScript( {[System.Uri]::CheckHostName($_) -eq 'dns' <#FQDN must be valid DNSHostName#>})] [string]$ExternalFQDN, [Parameter(Mandatory = $true, HelpMessage = "Destination Path for Certificate Request(s)")] [ValidateScript( {Test-Path -Path $_ -PathType Container <# should be a valid directory path #>})] [string]$OutputRequestPath, [Parameter(Mandatory = $false, HelpMessage = "Directory path for log and report output")] [string]$OutputPath = "$ENV:TEMP\AzsReadinessChecker", [Parameter(Mandatory = $false, HelpMessage = "Use in low privilege environment were elevation is not allowed. Generates INF certificate request templates.")] [switch]$LowPrivilege ) New-AzsCertificateSigningRequest @PSBoundParameters -CertificateType AzureStackEdgeVPN } function New-AzsHubDeploymentCertificateSigningRequest { <# .SYNOPSIS Generates Certificate Signing Requests for Azure Stack Hub Deployment Certificates .DESCRIPTION Calls New-AzsCertificateSigningRequest with neccessary parameters to generate CSR for Azure Stack Hub Deployment certificates .EXAMPLE $certificateRequestParams = @{ 'IdentitySystem' = 'AAD' 'regionName' = 'azurestack' 'externalFQDN' = 'contoso.com' 'subject' = "C=US,ST=Washington,L=Redmond,O=Microsoft,OU=Azure Stack" 'OutputRequestPath' = "$ENV:USERPROFILE\Documents\AzsCertRequests" } New-AzsHubDeploymentCertificateSigningRequest @certificateRequestParams Generates Certificate Signing Requests for Azure Stack Hub Deployment Certificates .EXAMPLE New-AzsHubDeploymentCertificateSigningRequest -StampEndpoint portal.azurestack.contoso.com -OutputRequestPath "$ENV:USERPROFILE\Documents\AzsCertRequests" Connects to existing endpoint https://portal.azurestack.contoso.com read the current SSL certificate, clones the attributes and creates Certificate Signing Requests with those attributes. For use with renewal of soon-to-be expired certs. .PARAMETER RegionName Specifies the Azure Stack deployment's region name, must be alphanumeric. .PARAMETER externalFQDN Specifies the Azure Stack deployment's External FQDN, also aliased as ExternalFQDN and FQDN, must be valid DNSHostName .PARAMETER DistinguishedName Specifies a DistinguishedName to be used on the certificate. Must be a valid System.Security.Cryptography.X509Certificates.X500DistinguishedName value. Common Name (CN) is not required, the appropriate value for the Azure Stack Service will be placed in the Common Name (CN). If a Common Name (CN) is given it will be honoured on every certificate request if supplied. Also aliased as subject. .PARAMETER DistinguishedNameFlag Specifies a string for the distinguished name flag to be used in the distinguished name. UseUTF8Encoding is selected by default. More information on x500DistinguishNameFlags can be found at https://aka.ms/dnflags .PARAMETER KeyLength Defines the length of the public and private key for the certificate request generation. Default is 2048. Valid values 2048, 4096, 8192 .PARAMETER HashAlgorithm Hash Algorithm to be used for the certificate request generation. Default is SHA256. Valid values SHA256, SHA384, SHA512 .PARAMETER EnhancedKeyUsage Extended (Enhanced) Key Usage to be included in the certificate request. Provide the required usage for the target certificate as well as the custom usage in hashtable format. e.g. @('Client Authentication','Server Authentication',@{'Custom Usage' = '1.3.6.1.5.7.8.2.1'}) will request Client and Server Auth key usage and the custom usage. .PARAMETER RequestType Specifies the SAN type of the certificate request. Valid values: MultipleCSR, SingleCSR. SingleCSR generates one certificate request for all services (not recommended for production). User will be prompted to confirm use. MultipleCSR generates multiple certificate requests, one for each service (strongly recommended in production environments). .PARAMETER IdentitySystem Specifies the Azure Stack deployment's Identity System valid values, AAD or ADFS, for Azure Active Directory and Active Directory Federated Services respectively .PARAMETER IncludeContainerRegistry Include Azure Container Registry certificate request. .PARAMETER StampEndpoint Provide a dns hostname of an existing stamp endpoint (region.external.fqdn) to clone the certificate attributes to be used to generate the certificate signing request. .PARAMETER OutputRequestPath Specifies the destination path for certificate request files, directory must already exist. .PARAMETER ForceTLS12 Force the use of TLS 1.2, true by default, set to false to use to system default. .PARAMETER LowPrivilege Use in low privilege environment were elevation is not allowed. Generates INF certificate request templates. .INPUTS Inputs (if any) .OUTPUTS Output (if any) .LINK Generate Azure Stack Certificate Requests - https://aka.ms/AzsCSR Azure Stack Readiness Checker Tool - https://aka.ms/AzsReadinessChecker .NOTES General notes #> [CmdletBinding(DefaultParameterSetName = 'Manual')] param ( [Parameter(Mandatory = $false, ParameterSetName = 'Manual', HelpMessage = "Enter Azure Stack Hub Region Name")] [string]$RegionName, [Parameter(Mandatory = $true, ParameterSetName = 'Manual', HelpMessage = "Enter Azure Stack Fully Qualified Domain Name (without region name)")] [Alias("FQDN", "ExternalDomainName")] [ValidateScript( {[System.Uri]::CheckHostName($_) -eq 'dns' <#FQDN must be valid DNSHostName#>})] [string]$ExternalFQDN, [Parameter(Mandatory = $true, ParameterSetName = 'Manual', HelpMessage = 'Provide subject name as a string, CN is not required and will be overwritten. E.g. "C=US,ST=Washington,L=Redmond,O=Microsoft,OU=Azure Stack"')] [Alias("Subject")] [System.Security.Cryptography.X509Certificates.X500DistinguishedName]$DistinguishedName, [Parameter(Mandatory = $false, ParameterSetName = 'Manual', HelpMessage = 'Provide X500DistinguishedNameFlags if The distinguished name has special characteristics. Default UseUTF8Encoding.')] [System.Security.Cryptography.X509Certificates.X500DistinguishedNameFlags]$DistinguishedNameFlag = 'UseUTF8Encoding', [Parameter(Mandatory = $false, ParameterSetName = 'Manual', HelpMessage = 'Provide Key Length: 2048, 4096 or 8192')] [ValidateSet(2048, 4096, 8192)] [int]$KeyLength = 2048, [Parameter(Mandatory = $false, ParameterSetName = 'Manual', HelpMessage = 'Provide Hash Algorithm: SHA256, SHA384 or SHA512')] [ValidateSet('SHA256', 'SHA384', 'SHA512')] [System.Security.Cryptography.HashAlgorithmName]$HashAlgorithm = 'SHA256', [Parameter(Mandatory = $false, ParameterSetName = 'Manual', HelpMessage = "Optionally provide Extended (Enhanced) Key Usage. By default, certificate config will be used. e.g. @('Client Authentication', 'Server Authentication', @{'Custom Usage' = '1.3.6.1.5.15.7.3.2'})")] $EnhancedKeyUsage, [Parameter(Mandatory = $true, ParameterSetName = 'ExistingEndpoint', HelpMessage = "Optionally provide an existing stamp endpoint (region.fqdn) to clone the certificate attributes to be used to generate the certificate signing request.")] [ValidateScript( {[System.Uri]::CheckHostName($_) -eq 'dns' <#FQDN must be valid DNSHostName#>})] $StampEndpoint, [Parameter(Mandatory = $false, ParameterSetName = 'Manual', HelpMessage = "Enter Azure Stack Identity System (AAD or ADFS) when generating deployment certificates")] [ValidateSet('AAD', 'ADFS')] [string]$IdentitySystem, [Parameter(Mandatory = $false, HelpMessage = "Include Azure Container Registry certificate request.")] [switch]$IncludeContainerRegistry, [Parameter(Mandatory = $false, HelpMessage = "Enter Certificate Request generation type ('Single' = Request individual wildcard certificates, 'Multiple' = Request single multi domain wildcard certificates")] [ValidateSet('MultipleCSR', 'SingleCSR')] [string]$requestType = 'MultipleCSR', [Parameter(Mandatory = $true, HelpMessage = "Destination Path for Certificate Request(s)")] [ValidateScript( {Test-Path -Path $_ -PathType Container <# should be a valid directory path #>})] [string]$OutputRequestPath, [Parameter(Mandatory = $false, ParameterSetName = 'ExistingEndpoint', HelpMessage = "Force the use of TLS 1.2, true by default")] [bool]$ForceTLS12 = $true, [Parameter(Mandatory = $false, HelpMessage = "Directory path for log and report output")] [string]$OutputPath = "$ENV:TEMP\AzsReadinessChecker", [Parameter(Mandatory = $false, HelpMessage = "Use in low privilege environment were elevation is not allowed. Generates INF certificate request templates.")] [switch]$LowPrivilege ) New-AzsCertificateSigningRequest @PSBoundParameters -CertificateType Deployment } function New-AzsHubAppServicesCertificateSigningRequest { <# .SYNOPSIS Generates Certificate Signing Requests for Azure Stack Hub AppServices Resource Provider Certificates .DESCRIPTION Calls New-AzsCertificateSigningRequest with neccessary parameters to generate CSR for Azure Stack Hub AppServices Resource Provider certificates .EXAMPLE $certificateRequestParams = @{ 'regionName' = 'azurestack' 'externalFQDN' = 'contoso.com' 'subject' = "C=US,ST=Washington,L=Redmond,O=Microsoft,OU=Azure Stack" 'OutputRequestPath' = "$ENV:USERPROFILE\Documents\AzsCertRequests" } New-AzsHubAppServicesCertificateSigningRequest @certificateRequestParams Generates Certificate Signing Requests for Azure Stack Hub AppServices Resource Provider Certificates .EXAMPLE New-AzsHubAppServicesCertificateSigningRequest -StampEndpoint portal.azurestack.contoso.com -OutputRequestPath "$ENV:USERPROFILE\Documents\AzsCertRequests" Connects to existing endpoint https://portal.azurestack.contoso.com read the current SSL certificate, clones the attributes and creates Certificate Signing Requests with those attributes. For use with renewal of soon-to-be expired certs. .PARAMETER RegionName Specifies the Azure Stack deployment's region name, must be alphanumeric. .PARAMETER externalFQDN Specifies the Azure Stack deployment's External FQDN, also aliased as ExternalFQDN and FQDN, must be valid DNSHostName .PARAMETER DistinguishedName Specifies a DistinguishedName to be used on the certificate. Must be a valid System.Security.Cryptography.X509Certificates.X500DistinguishedName value. Common Name (CN) is not required, the appropriate value for the Azure Stack Service will be placed in the Common Name (CN). If a Common Name (CN) is given it will be honoured on every certificate request if supplied. Also aliased as subject. .PARAMETER DistinguishedNameFlag Specifies a string for the distinguished name flag to be used in the distinguished name. UseUTF8Encoding is selected by default. More information on x500DistinguishNameFlags can be found at https://aka.ms/dnflags .PARAMETER KeyLength Defines the length of the public and private key for the certificate request generation. Default is 2048. Valid values 2048, 4096, 8192 .PARAMETER HashAlgorithm Hash Algorithm to be used for the certificate request generation. Default is SHA256. Valid values SHA256, SHA384, SHA512 .PARAMETER EnhancedKeyUsage Extended (Enhanced) Key Usage to be included in the certificate request. Provide the required usage for the target certificate as well as the custom usage in hashtable format. e.g. @('Client Authentication','Server Authentication',@{'Custom Usage' = '1.3.6.1.5.7.8.2.1'}) will request Client and Server Auth key usage and the custom usage. .PARAMETER StampEndpoint Provide a dns hostname of an existing stamp endpoint (region.external.fqdn) to clone the certificate attributes to be used to generate the certificate signing request. .PARAMETER RequestType Specifies the SAN type of the certificate request. Valid values: MultipleCSR, SingleCSR. SingleCSR generates one certificate request for all services (not recommended for production). User will be prompted to confirm use. MultipleCSR generates multiple certificate requests, one for each service (strongly recommended in production environments). .PARAMETER OutputRequestPath Specifies the destination path for certificate request files, directory must already exist. .PARAMETER ForceTLS12 Force the use of TLS 1.2, true by default, set to false to use to system default. .PARAMETER LowPrivilege Use in low privilege environment were elevation is not allowed. Generates INF certificate request templates. .INPUTS Inputs (if any) .OUTPUTS Output (if any) .LINK Generate Azure Stack Certificate Requests - https://aka.ms/AzsCSR Azure Stack Readiness Checker Tool - https://aka.ms/AzsReadinessChecker .NOTES General notes #> [CmdletBinding(DefaultParameterSetName = 'Manual')] param ( [Parameter(Mandatory = $false, ParameterSetName = 'Manual', HelpMessage = "Enter Azure Stack Hub Region Name")] [string]$RegionName, [Parameter(Mandatory = $true, ParameterSetName = 'Manual', HelpMessage = "Enter Azure Stack Fully Qualified Domain Name (without region name)")] [Alias("FQDN", "ExternalDomainName")] [ValidateScript( {[System.Uri]::CheckHostName($_) -eq 'dns' <#FQDN must be valid DNSHostName#>})] [string]$ExternalFQDN, [Parameter(Mandatory = $true, ParameterSetName = 'Manual', HelpMessage = 'Provide subject name as a string, CN is not required and will be overwritten. E.g. "C=US,ST=Washington,L=Redmond,O=Microsoft,OU=Azure Stack"')] [Alias("Subject")] [System.Security.Cryptography.X509Certificates.X500DistinguishedName]$DistinguishedName, [Parameter(Mandatory = $false, ParameterSetName = 'Manual', HelpMessage = 'Provide X500DistinguishedNameFlags if The distinguished name has special characteristics. Default UseUTF8Encoding.')] [System.Security.Cryptography.X509Certificates.X500DistinguishedNameFlags]$DistinguishedNameFlag = 'UseUTF8Encoding', [Parameter(Mandatory = $false, ParameterSetName = 'Manual', HelpMessage = 'Provide Key Length: 2048, 4096 or 8192')] [ValidateSet(2048, 4096, 8192)] [int]$KeyLength = 2048, [Parameter(Mandatory = $false, ParameterSetName = 'Manual', HelpMessage = 'Provide Hash Algorithm: SHA256, SHA384 or SHA512')] [ValidateSet('SHA256', 'SHA384', 'SHA512')] [System.Security.Cryptography.HashAlgorithmName]$HashAlgorithm = 'SHA256', [Parameter(Mandatory = $false, ParameterSetName = 'Manual', HelpMessage = "Optionally provide Extended (Enhanced) Key Usage. By default, certificate config will be used. e.g. @('Client Authentication', 'Server Authentication', @{'Custom Usage' = '1.3.6.1.5.15.7.3.2'})")] $EnhancedKeyUsage, [Parameter(Mandatory = $true, ParameterSetName = 'ExistingEndpoint', HelpMessage = "Optionally provide an existing stamp endpoint (region.external.fqdn) to clone the certificate attributes to be used to generate the certificate signing request.")] [ValidateScript( {[System.Uri]::CheckHostName($_) -eq 'dns' <#FQDN must be valid DNSHostName#>})] $StampEndpoint, [Parameter(Mandatory = $false, HelpMessage = "Enter Certificate Request generation type ('Single' = Request individual wildcard certificates, 'Multiple' = Request single multi domain wildcard certificates")] [ValidateSet('MultipleCSR', 'SingleCSR')] [string]$requestType = 'MultipleCSR', [Parameter(Mandatory = $true, HelpMessage = "Destination Path for Certificate Request(s)")] [ValidateScript( {Test-Path -Path $_ -PathType Container <# should be a valid directory path #>})] [string]$OutputRequestPath, [Parameter(Mandatory = $false, ParameterSetName = 'ExistingEndpoint', HelpMessage = "Force the use of TLS 1.2, true by default")] [bool]$ForceTLS12 = $true, [Parameter(Mandatory = $false, HelpMessage = "Directory path for log and report output")] [string]$OutputPath = "$ENV:TEMP\AzsReadinessChecker", [Parameter(Mandatory = $false, HelpMessage = "Use in low privilege environment were elevation is not allowed. Generates INF certificate request templates.")] [switch]$LowPrivilege ) New-AzsCertificateSigningRequest @PSBoundParameters -CertificateType AppServices } function New-AzsHubEventHubsCertificateSigningRequest { <# .SYNOPSIS Generates Certificate Signing Requests for Azure Stack Hub Event Hubs Resource Provider Certificates .DESCRIPTION Calls New-AzsCertificateSigningRequest with neccessary parameters to generate CSR for Azure Stack Hub Event Hubs Resource Provider certificates .EXAMPLE $certificateRequestParams = @{ 'regionName' = 'azurestack' 'externalFQDN' = 'contoso.com' 'subject' = "C=US,ST=Washington,L=Redmond,O=Microsoft,OU=Azure Stack" 'OutputRequestPath' = "$ENV:USERPROFILE\Documents\AzsCertRequests" } New-AzsHubEventHubsCertificateSigningRequest @certificateRequestParams Generates Certificate Signing Requests for Azure Stack Hub EventHubs Resource Provider Certificates .EXAMPLE New-AzsHubEventHubsCertificateSigningRequest -StampEndpoint portal.azurestack.contoso.com -OutputRequestPath "$ENV:USERPROFILE\Documents\AzsCertRequests" Connects to existing endpoint https://portal.azurestack.contoso.com read the current SSL certificate, clones the attributes and creates Certificate Signing Requests with those attributes. For use with renewal of soon-to-be expired certs. .PARAMETER RegionName Specifies the Azure Stack deployment's region name, must be alphanumeric. .PARAMETER externalFQDN Specifies the Azure Stack deployment's External FQDN, also aliased as ExternalFQDN and FQDN, must be valid DNSHostName .PARAMETER DistinguishedName Specifies a DistinguishedName to be used on the certificate. Must be a valid System.Security.Cryptography.X509Certificates.X500DistinguishedName value. Common Name (CN) is not required, the appropriate value for the Azure Stack Service will be placed in the Common Name (CN). If a Common Name (CN) is given it will be honoured on every certificate request if supplied. Also aliased as subject. .PARAMETER DistinguishedNameFlag Specifies a string for the distinguished name flag to be used in the distinguished name. UseUTF8Encoding is selected by default. More information on x500DistinguishNameFlags can be found at https://aka.ms/dnflags .PARAMETER KeyLength Defines the length of the public and private key for the certificate request generation. Default is 2048. Valid values 2048, 4096, 8192 .PARAMETER HashAlgorithm Hash Algorithm to be used for the certificate request generation. Default is SHA256. Valid values SHA256, SHA384, SHA512 .PARAMETER EnhancedKeyUsage Extended (Enhanced) Key Usage to be included in the certificate request. Provide the required usage for the target certificate as well as the custom usage in hashtable format. e.g. @('Client Authentication','Server Authentication',@{'Custom Usage' = '1.3.6.1.5.7.8.2.1'}) will request Client and Server Auth key usage and the custom usage. .PARAMETER RequestType Specifies the SAN type of the certificate request. Valid values: MultipleCSR, SingleCSR. SingleCSR generates one certificate request for all services (not recommended for production). User will be prompted to confirm use. MultipleCSR generates multiple certificate requests, one for each service (strongly recommended in production environments). .PARAMETER StampEndpoint Provide a dns hostname of an existing stamp endpoint (region.external.fqdn) to clone the certificate attributes to be used to generate the certificate signing request. .PARAMETER OutputRequestPath Specifies the destination path for certificate request files, directory must already exist. .PARAMETER ForceTLS12 Force the use of TLS 1.2, true by default, set to false to use to system default. .PARAMETER LowPrivilege Use in low privilege environment were elevation is not allowed. Generates INF certificate request templates. .INPUTS Inputs (if any) .OUTPUTS Output (if any) .LINK Generate Azure Stack Certificate Requests - https://aka.ms/AzsCSR Azure Stack Readiness Checker Tool - https://aka.ms/AzsReadinessChecker .NOTES General notes #> [CmdletBinding(DefaultParameterSetName = 'Manual')] param ( [Parameter(Mandatory = $false, ParameterSetName = 'Manual', HelpMessage = "Enter Azure Stack Hub Region Name")] [string]$RegionName, [Parameter(Mandatory = $true, ParameterSetName = 'Manual', HelpMessage = "Enter Azure Stack Fully Qualified Domain Name (without region name)")] [Alias("FQDN", "ExternalDomainName")] [ValidateScript( {[System.Uri]::CheckHostName($_) -eq 'dns' <#FQDN must be valid DNSHostName#>})] [string]$ExternalFQDN, [Parameter(Mandatory = $true, ParameterSetName = 'Manual', HelpMessage = 'Provide subject name as a string, CN is not required and will be overwritten. E.g. "C=US,ST=Washington,L=Redmond,O=Microsoft,OU=Azure Stack"')] [Alias("Subject")] [System.Security.Cryptography.X509Certificates.X500DistinguishedName]$DistinguishedName, [Parameter(Mandatory = $false, ParameterSetName = 'Manual', HelpMessage = 'Provide X500DistinguishedNameFlags if The distinguished name has special characteristics. Default UseUTF8Encoding.')] [System.Security.Cryptography.X509Certificates.X500DistinguishedNameFlags]$DistinguishedNameFlag = 'UseUTF8Encoding', [Parameter(Mandatory = $false, ParameterSetName = 'Manual', HelpMessage = 'Provide Key Length: 2048, 4096 or 8192')] [ValidateSet(2048, 4096, 8192)] [int]$KeyLength = 2048, [Parameter(Mandatory = $false, ParameterSetName = 'Manual', HelpMessage = 'Provide Hash Algorithm: SHA256, SHA384 or SHA512')] [ValidateSet('SHA256', 'SHA384', 'SHA512')] [System.Security.Cryptography.HashAlgorithmName]$HashAlgorithm = 'SHA256', [Parameter(Mandatory = $false, ParameterSetName = 'Manual', HelpMessage = "Optionally provide Extended (Enhanced) Key Usage. By default, certificate config will be used. e.g. @('Client Authentication', 'Server Authentication', @{'Custom Usage' = '1.3.6.1.5.15.7.3.2'})")] $EnhancedKeyUsage, [Parameter(Mandatory = $true, ParameterSetName = 'ExistingEndpoint', HelpMessage = "Optionally provide an existing stamp endpoint (region.external.fqdn) to clone the certificate attributes to be used to generate the certificate signing request.")] [ValidateScript( {[System.Uri]::CheckHostName($_) -eq 'dns' <#FQDN must be valid DNSHostName#>})] $StampEndpoint, [Parameter(Mandatory = $false, HelpMessage = "Enter Certificate Request generation type ('Single' = Request individual wildcard certificates, 'Multiple' = Request single multi domain wildcard certificates")] [ValidateSet('MultipleCSR', 'SingleCSR')] [string]$requestType = 'MultipleCSR', [Parameter(Mandatory = $true, HelpMessage = "Destination Path for Certificate Request(s)")] [ValidateScript( {Test-Path -Path $_ -PathType Container <# should be a valid directory path #>})] [string]$OutputRequestPath, [Parameter(Mandatory = $false, ParameterSetName = 'ExistingEndpoint', HelpMessage = "Force the use of TLS 1.2, true by default")] [bool]$ForceTLS12 = $true, [Parameter(Mandatory = $false, HelpMessage = "Directory path for log and report output")] [string]$OutputPath = "$ENV:TEMP\AzsReadinessChecker", [Parameter(Mandatory = $false, HelpMessage = "Use in low privilege environment were elevation is not allowed. Generates INF certificate request templates.")] [switch]$LowPrivilege ) New-AzsCertificateSigningRequest @PSBoundParameters -CertificateType EventHubs } function New-AzsHubIoTHubCertificateSigningRequest { <# .SYNOPSIS Generates Certificate Signing Requests for Azure Stack Hub IoTHub Resource Provider Certificates .DESCRIPTION Calls New-AzsCertificateSigningRequest with neccessary parameters to generate CSR for Azure Stack Hub IoTHub Resource Provider certificates .EXAMPLE $certificateRequestParams = @{ 'regionName' = 'azurestack' 'externalFQDN' = 'contoso.com' 'subject' = "C=US,ST=Washington,L=Redmond,O=Microsoft,OU=Azure Stack" 'OutputRequestPath' = "$ENV:USERPROFILE\Documents\AzsCertRequests" } New-AzsHubIoTHubCertificateSigningRequest @certificateRequestParams Generates Certificate Signing Requests for Azure Stack Hub IoTHub Resource Provider Certificates .EXAMPLE New-AzsHubIoTHubCertificateSigningRequest -StampEndpoint portal.azurestack.contoso.com -OutputRequestPath "$ENV:USERPROFILE\Documents\AzsCertRequests" Connects to existing endpoint https://portal.azurestack.contoso.com read the current SSL certificate, clones the attributes and creates Certificate Signing Requests with those attributes. For use with renewal of soon-to-be expired certs. .PARAMETER RegionName Specifies the Azure Stack deployment's region name, must be alphanumeric. .PARAMETER externalFQDN Specifies the Azure Stack deployment's External FQDN, also aliased as ExternalFQDN and FQDN, must be valid DNSHostName .PARAMETER DistinguishedName Specifies a DistinguishedName to be used on the certificate. Must be a valid System.Security.Cryptography.X509Certificates.X500DistinguishedName value. Common Name (CN) is not required, the appropriate value for the Azure Stack Service will be placed in the Common Name (CN). If a Common Name (CN) is given it will be honoured on every certificate request if supplied. Also aliased as subject. .PARAMETER DistinguishedNameFlag Specifies a string for the distinguished name flag to be used in the distinguished name. UseUTF8Encoding is selected by default. More information on x500DistinguishNameFlags can be found at https://aka.ms/dnflags .PARAMETER KeyLength Defines the length of the public and private key for the certificate request generation. Default is 2048. Valid values 2048, 4096, 8192 .PARAMETER HashAlgorithm Hash Algorithm to be used for the certificate request generation. Default is SHA256. Valid values SHA256, SHA384, SHA512 .PARAMETER EnhancedKeyUsage Extended (Enhanced) Key Usage to be included in the certificate request. Provide the required usage for the target certificate as well as the custom usage in hashtable format. e.g. @('Client Authentication','Server Authentication',@{'Custom Usage' = '1.3.6.1.5.7.8.2.1'}) will request Client and Server Auth key usage and the custom usage. .PARAMETER RequestType Specifies the SAN type of the certificate request. Valid values: MultipleCSR, SingleCSR. SingleCSR generates one certificate request for all services (not recommended for production). User will be prompted to confirm use. MultipleCSR generates multiple certificate requests, one for each service (strongly recommended in production environments). .PARAMETER StampEndpoint Provide a dns hostname of an existing stamp endpoint (region.external.fqdn) to clone the certificate attributes to be used to generate the certificate signing request. .PARAMETER OutputRequestPath Specifies the destination path for certificate request files, directory must already exist. .PARAMETER ForceTLS12 Force the use of TLS 1.2, true by default, set to false to use to system default. .PARAMETER LowPrivilege Use in low privilege environment were elevation is not allowed. Generates INF certificate request templates. .INPUTS Inputs (if any) .OUTPUTS Output (if any) .LINK Generate Azure Stack Certificate Requests - https://aka.ms/AzsCSR Azure Stack Readiness Checker Tool - https://aka.ms/AzsReadinessChecker .NOTES General notes #> [CmdletBinding(DefaultParameterSetName = 'Manual')] param ( [Parameter(Mandatory = $false, ParameterSetName = 'Manual', HelpMessage = "Enter Azure Stack Hub Region Name")] [string]$RegionName, [Parameter(Mandatory = $true, ParameterSetName = 'Manual', HelpMessage = "Enter Azure Stack Fully Qualified Domain Name (without region name)")] [Alias("FQDN", "ExternalDomainName")] [ValidateScript( {[System.Uri]::CheckHostName($_) -eq 'dns' <#FQDN must be valid DNSHostName#>})] [string]$ExternalFQDN, [Parameter(Mandatory = $true, ParameterSetName = 'Manual', HelpMessage = 'Provide subject name as a string, CN is not required and will be overwritten. E.g. "C=US,ST=Washington,L=Redmond,O=Microsoft,OU=Azure Stack"')] [Alias("Subject")] [System.Security.Cryptography.X509Certificates.X500DistinguishedName]$DistinguishedName, [Parameter(Mandatory = $false, ParameterSetName = 'Manual', HelpMessage = 'Provide X500DistinguishedNameFlags if The distinguished name has special characteristics. Default UseUTF8Encoding.')] [System.Security.Cryptography.X509Certificates.X500DistinguishedNameFlags]$DistinguishedNameFlag = 'UseUTF8Encoding', [Parameter(Mandatory = $false, ParameterSetName = 'Manual', HelpMessage = 'Provide Key Length: 2048, 4096 or 8192')] [ValidateSet(2048, 4096, 8192)] [int]$KeyLength = 2048, [Parameter(Mandatory = $false, ParameterSetName = 'Manual', HelpMessage = 'Provide Hash Algorithm: SHA256, SHA384 or SHA512')] [ValidateSet('SHA256', 'SHA384', 'SHA512')] [System.Security.Cryptography.HashAlgorithmName]$HashAlgorithm = 'SHA256', [Parameter(Mandatory = $false, ParameterSetName = 'Manual', HelpMessage = "Optionally provide Extended (Enhanced) Key Usage. By default, certificate config will be used. e.g. @('Client Authentication', 'Server Authentication', @{'Custom Usage' = '1.3.6.1.5.15.7.3.2'})")] $EnhancedKeyUsage, [Parameter(Mandatory = $true, ParameterSetName = 'ExistingEndpoint', HelpMessage = "Optionally provide an existing stamp endpoint (region.external.fqdn) to clone the certificate attributes to be used to generate the certificate signing request.")] [ValidateScript( {[System.Uri]::CheckHostName($_) -eq 'dns' <#FQDN must be valid DNSHostName#>})] $StampEndpoint, [Parameter(Mandatory = $false, HelpMessage = "Enter Certificate Request generation type ('Single' = Request individual wildcard certificates, 'Multiple' = Request single multi domain wildcard certificates")] [ValidateSet('MultipleCSR', 'SingleCSR')] [string]$requestType = 'MultipleCSR', [Parameter(Mandatory = $true, HelpMessage = "Destination Path for Certificate Request(s)")] [ValidateScript( {Test-Path -Path $_ -PathType Container <# should be a valid directory path #>})] [string]$OutputRequestPath, [Parameter(Mandatory = $false, ParameterSetName = 'ExistingEndpoint', HelpMessage = "Force the use of TLS 1.2, true by default")] [bool]$ForceTLS12 = $true, [Parameter(Mandatory = $false, HelpMessage = "Directory path for log and report output")] [string]$OutputPath = "$ENV:TEMP\AzsReadinessChecker", [Parameter(Mandatory = $false, HelpMessage = "Use in low privilege environment were elevation is not allowed. Generates INF certificate request templates.")] [switch]$LowPrivilege ) New-AzsCertificateSigningRequest @PSBoundParameters -CertificateType IoTHub } function New-AzsHubDBAdapterCertificateSigningRequest { <# .SYNOPSIS Generates Certificate Signing Requests for Azure Stack Hub DBAdapter Resource Provider Certificates .DESCRIPTION Calls New-AzsCertificateSigningRequest with neccessary parameters to generate CSR for Azure Stack Hub DBAdapter Resource Provider certificates .EXAMPLE $certificateRequestParams = @{ 'regionName' = 'azurestack' 'externalFQDN' = 'contoso.com' 'subject' = "C=US,ST=Washington,L=Redmond,O=Microsoft,OU=Azure Stack" 'OutputRequestPath' = "$ENV:USERPROFILE\Documents\AzsCertRequests" } New-AzsHubDBAdapterCertificateSigningRequest @certificateRequestParams Generates Certificate Signing Requests for Azure Stack Hub DBAdapter Resource Provider Certificates .EXAMPLE New-AzsHubDBAdapterCertificateSigningRequest -StampEndpoint portal.azurestack.contoso.com -OutputRequestPath "$ENV:USERPROFILE\Documents\AzsCertRequests" Connects to existing endpoint https://portal.azurestack.contoso.com read the current SSL certificate, clones the attributes and creates Certificate Signing Requests with those attributes. For use with renewal of soon-to-be expired certs. .PARAMETER RegionName Specifies the Azure Stack deployment's region name, must be alphanumeric. .PARAMETER externalFQDN Specifies the Azure Stack deployment's External FQDN, also aliased as ExternalFQDN and FQDN, must be valid DNSHostName .PARAMETER DistinguishedName Specifies a DistinguishedName to be used on the certificate. Must be a valid System.Security.Cryptography.X509Certificates.X500DistinguishedName value. Common Name (CN) is not required, the appropriate value for the Azure Stack Service will be placed in the Common Name (CN). If a Common Name (CN) is given it will be honoured on every certificate request if supplied. Also aliased as subject. .PARAMETER DistinguishedNameFlag Specifies a string for the distinguished name flag to be used in the distinguished name. UseUTF8Encoding is selected by default. More information on x500DistinguishNameFlags can be found at https://aka.ms/dnflags .PARAMETER KeyLength Defines the length of the public and private key for the certificate request generation. Default is 2048. Valid values 2048, 4096, 8192 .PARAMETER HashAlgorithm Hash Algorithm to be used for the certificate request generation. Default is SHA256. Valid values SHA256, SHA384, SHA512 .PARAMETER EnhancedKeyUsage Extended (Enhanced) Key Usage to be included in the certificate request. Provide the required usage for the target certificate as well as the custom usage in hashtable format. e.g. @('Client Authentication','Server Authentication',@{'Custom Usage' = '1.3.6.1.5.7.8.2.1'}) will request Client and Server Auth key usage and the custom usage. .PARAMETER RequestType Specifies the SAN type of the certificate request. Valid values: MultipleCSR, SingleCSR. SingleCSR generates one certificate request for all services (not recommended for production). User will be prompted to confirm use. MultipleCSR generates multiple certificate requests, one for each service (strongly recommended in production environments). .PARAMETER StampEndpoint Provide a dns hostname of an existing stamp endpoint (region.external.fqdn) to clone the certificate attributes to be used to generate the certificate signing request. .PARAMETER OutputRequestPath Specifies the destination path for certificate request files, directory must already exist. .PARAMETER ForceTLS12 Force the use of TLS 1.2, true by default, set to false to use to system default. .PARAMETER LowPrivilege Use in low privilege environment were elevation is not allowed. Generates INF certificate request templates. .INPUTS Inputs (if any) .OUTPUTS Output (if any) .LINK Generate Azure Stack Certificate Requests - https://aka.ms/AzsCSR Azure Stack Readiness Checker Tool - https://aka.ms/AzsReadinessChecker .NOTES General notes #> [CmdletBinding(DefaultParameterSetName = 'Manual')] param ( [Parameter(Mandatory = $false, ParameterSetName = 'Manual', HelpMessage = "Enter Azure Stack Hub Region Name")] [string]$RegionName, [Parameter(Mandatory = $true, ParameterSetName = 'Manual', HelpMessage = "Enter Azure Stack Fully Qualified Domain Name (without region name)")] [Alias("FQDN", "ExternalDomainName")] [ValidateScript( {[System.Uri]::CheckHostName($_) -eq 'dns' <#FQDN must be valid DNSHostName#>})] [string]$ExternalFQDN, [Parameter(Mandatory = $true, ParameterSetName = 'Manual', HelpMessage = 'Provide subject name as a string, CN is not required and will be overwritten. E.g. "C=US,ST=Washington,L=Redmond,O=Microsoft,OU=Azure Stack"')] [Alias("Subject")] [System.Security.Cryptography.X509Certificates.X500DistinguishedName]$DistinguishedName, [Parameter(Mandatory = $false, ParameterSetName = 'Manual', HelpMessage = 'Provide X500DistinguishedNameFlags if The distinguished name has special characteristics. Default UseUTF8Encoding.')] [System.Security.Cryptography.X509Certificates.X500DistinguishedNameFlags]$DistinguishedNameFlag = 'UseUTF8Encoding', [Parameter(Mandatory = $false, ParameterSetName = 'Manual', HelpMessage = 'Provide Key Length: 2048, 4096 or 8192')] [ValidateSet(2048, 4096, 8192)] [int]$KeyLength = 2048, [Parameter(Mandatory = $false, ParameterSetName = 'Manual', HelpMessage = 'Provide Hash Algorithm: SHA256, SHA384 or SHA512')] [ValidateSet('SHA256', 'SHA384', 'SHA512')] [System.Security.Cryptography.HashAlgorithmName]$HashAlgorithm = 'SHA256', [Parameter(Mandatory = $false, ParameterSetName = 'Manual', HelpMessage = "Optionally provide Extended (Enhanced) Key Usage. By default, certificate config will be used. e.g. @('Client Authentication', 'Server Authentication', @{'Custom Usage' = '1.3.6.1.5.15.7.3.2'})")] $EnhancedKeyUsage, [Parameter(Mandatory = $true, ParameterSetName = 'ExistingEndpoint', HelpMessage = "Optionally provide an existing stamp endpoint (region.external.fqdn) to clone the certificate attributes to be used to generate the certificate signing request.")] [ValidateScript( {[System.Uri]::CheckHostName($_) -eq 'dns' <#FQDN must be valid DNSHostName#>})] $StampEndpoint, [Parameter(Mandatory = $false, HelpMessage = "Enter Certificate Request generation type ('Single' = Request individual wildcard certificates, 'Multiple' = Request single multi domain wildcard certificates")] [ValidateSet('MultipleCSR', 'SingleCSR')] [string]$requestType = 'MultipleCSR', [Parameter(Mandatory = $true, HelpMessage = "Destination Path for Certificate Request(s)")] [ValidateScript( {Test-Path -Path $_ -PathType Container <# should be a valid directory path #>})] [string]$OutputRequestPath, [Parameter(Mandatory = $false, ParameterSetName = 'ExistingEndpoint', HelpMessage = "Force the use of TLS 1.2, true by default")] [bool]$ForceTLS12 = $true, [Parameter(Mandatory = $false, HelpMessage = "Directory path for log and report output")] [string]$OutputPath = "$ENV:TEMP\AzsReadinessChecker", [Parameter(Mandatory = $false, HelpMessage = "Use in low privilege environment were elevation is not allowed. Generates INF certificate request templates.")] [switch]$LowPrivilege ) New-AzsCertificateSigningRequest @PSBoundParameters -CertificateType DBAdapter } function New-AzsHubDataBoxEdgeCertificateSigningRequest { <# .SYNOPSIS Generates Certificate Signing Requests for Azure Stack Hub Databox Edge Resource Provider Certificates .DESCRIPTION Calls New-AzsCertificateSigningRequest with neccessary parameters to generate CSR for Azure Stack Hub DBAdapter Resource Provider certificates .EXAMPLE $certificateRequestParams = @{ 'regionName' = 'azurestack' 'externalFQDN' = 'contoso.com' 'subject' = "C=US,ST=Washington,L=Redmond,O=Microsoft,OU=Azure Stack" 'OutputRequestPath' = "$ENV:USERPROFILE\Documents\AzsCertRequests" } New-AzsHubDataBoxEdgeCertificateSigningRequest @certificateRequestParams Generates Certificate Signing Requests for Azure Stack Hub Databox Edge Resource Provider Certificates .EXAMPLE New-AzsHubDataBoxEdgeCertificateSigningRequest -StampEndpoint portal.azurestack.contoso.com -OutputRequestPath "$ENV:USERPROFILE\Documents\AzsCertRequests" Connects to existing endpoint https://portal.azurestack.contoso.com read the current SSL certificate, clones the attributes and creates Certificate Signing Requests with those attributes. For use with renewal of soon-to-be expired certs. .PARAMETER RegionName Specifies the Azure Stack deployment's region name, must be alphanumeric. .PARAMETER externalFQDN Specifies the Azure Stack deployment's External FQDN, also aliased as ExternalFQDN and FQDN, must be valid DNSHostName .PARAMETER DistinguishedName Specifies a DistinguishedName to be used on the certificate. Must be a valid System.Security.Cryptography.X509Certificates.X500DistinguishedName value. Common Name (CN) is not required, the appropriate value for the Azure Stack Service will be placed in the Common Name (CN). If a Common Name (CN) is given it will be honoured on every certificate request if supplied. Also aliased as subject. .PARAMETER DistinguishedNameFlag Specifies a string for the distinguished name flag to be used in the distinguished name. UseUTF8Encoding is selected by default. More information on x500DistinguishNameFlags can be found at https://aka.ms/dnflags .PARAMETER KeyLength Defines the length of the public and private key for the certificate request generation. Default is 2048. Valid values 2048, 4096, 8192 .PARAMETER HashAlgorithm Hash Algorithm to be used for the certificate request generation. Default is SHA256. Valid values SHA256, SHA384, SHA512 .PARAMETER EnhancedKeyUsage Extended (Enhanced) Key Usage to be included in the certificate request. Provide the required usage for the target certificate as well as the custom usage in hashtable format. e.g. @('Client Authentication','Server Authentication',@{'Custom Usage' = '1.3.6.1.5.7.8.2.1'}) will request Client and Server Auth key usage and the custom usage. .PARAMETER RequestType Specifies the SAN type of the certificate request. Valid values: MultipleCSR, SingleCSR. SingleCSR generates one certificate request for all services (not recommended for production). User will be prompted to confirm use. MultipleCSR generates multiple certificate requests, one for each service (strongly recommended in production environments). .PARAMETER StampEndpoint Provide a dns hostname of an existing stamp endpoint (region.external.fqdn) to clone the certificate attributes to be used to generate the certificate signing request. .PARAMETER OutputRequestPath Specifies the destination path for certificate request files, directory must already exist. .PARAMETER ForceTLS12 Force the use of TLS 1.2, true by default, set to false to use to system default. .PARAMETER LowPrivilege Use in low privilege environment were elevation is not allowed. Generates INF certificate request templates. .INPUTS Inputs (if any) .OUTPUTS Output (if any) .LINK Generate Azure Stack Certificate Requests - https://aka.ms/AzsCSR Azure Stack Readiness Checker Tool - https://aka.ms/AzsReadinessChecker .NOTES General notes #> [CmdletBinding(DefaultParameterSetName = 'Manual')] param ( [Parameter(Mandatory = $false, ParameterSetName = 'Manual', HelpMessage = "Enter Azure Stack Hub Region Name")] [string]$RegionName, [Parameter(Mandatory = $true, ParameterSetName = 'Manual', HelpMessage = "Enter Azure Stack Fully Qualified Domain Name (without region name)")] [Alias("FQDN", "ExternalDomainName")] [ValidateScript( {[System.Uri]::CheckHostName($_) -eq 'dns' <#FQDN must be valid DNSHostName#>})] [string]$ExternalFQDN, [Parameter(Mandatory = $true, ParameterSetName = 'Manual', HelpMessage = 'Provide subject name as a string, CN is not required and will be overwritten. E.g. "C=US,ST=Washington,L=Redmond,O=Microsoft,OU=Azure Stack"')] [Alias("Subject")] [System.Security.Cryptography.X509Certificates.X500DistinguishedName]$DistinguishedName, [Parameter(Mandatory = $false, ParameterSetName = 'Manual', HelpMessage = 'Provide X500DistinguishedNameFlags if The distinguished name has special characteristics. Default UseUTF8Encoding.')] [System.Security.Cryptography.X509Certificates.X500DistinguishedNameFlags]$DistinguishedNameFlag = 'UseUTF8Encoding', [Parameter(Mandatory = $false, ParameterSetName = 'Manual', HelpMessage = 'Provide Key Length: 2048, 4096 or 8192')] [ValidateSet(2048, 4096, 8192)] [int]$KeyLength = 2048, [Parameter(Mandatory = $false, ParameterSetName = 'Manual', HelpMessage = 'Provide Hash Algorithm: SHA256, SHA384 or SHA512')] [ValidateSet('SHA256', 'SHA384', 'SHA512')] [System.Security.Cryptography.HashAlgorithmName]$HashAlgorithm = 'SHA256', [Parameter(Mandatory = $false, ParameterSetName = 'Manual', HelpMessage = "Optionally provide Extended (Enhanced) Key Usage. By default, certificate config will be used. e.g. @('Client Authentication', 'Server Authentication', @{'Custom Usage' = '1.3.6.1.5.15.7.3.2'})")] $EnhancedKeyUsage, [Parameter(Mandatory = $true, ParameterSetName = 'ExistingEndpoint', HelpMessage = "Optionally provide an existing stamp endpoint (region.external.fqdn) to clone the certificate attributes to be used to generate the certificate signing request.")] [ValidateScript( {[System.Uri]::CheckHostName($_) -eq 'dns' <#FQDN must be valid DNSHostName#>})] $StampEndpoint, [Parameter(Mandatory = $false, HelpMessage = "Enter Certificate Request generation type ('Single' = Request individual wildcard certificates, 'Multiple' = Request single multi domain wildcard certificates")] [ValidateSet('MultipleCSR', 'SingleCSR')] [string]$requestType = 'MultipleCSR', [Parameter(Mandatory = $true, HelpMessage = "Destination Path for Certificate Request(s)")] [ValidateScript( {Test-Path -Path $_ -PathType Container <# should be a valid directory path #>})] [string]$OutputRequestPath, [Parameter(Mandatory = $false, ParameterSetName = 'ExistingEndpoint', HelpMessage = "Force the use of TLS 1.2, true by default")] [bool]$ForceTLS12 = $true, [Parameter(Mandatory = $false, HelpMessage = "Directory path for log and report output")] [string]$OutputPath = "$ENV:TEMP\AzsReadinessChecker", [Parameter(Mandatory = $false, HelpMessage = "Use in low privilege environment were elevation is not allowed. Generates INF certificate request templates.")] [switch]$LowPrivilege ) New-AzsCertificateSigningRequest @PSBoundParameters -CertificateType DataBoxEdge } function New-AzsHubAzureContainerRegistryCertificateSigningRequest { <# .SYNOPSIS Generates Certificate Signing Requests for Azure Stack Hub Azure Container Registry Resource Provider Certificates .DESCRIPTION Calls New-AzsCertificateSigningRequest with neccessary parameters to generate CSR for Azure Stack Hub Azure Container Registry Resource Provider certificates .EXAMPLE $certificateRequestParams = @{ 'regionName' = 'azurestack' 'externalFQDN' = 'contoso.com' 'subject' = "C=US,ST=Washington,L=Redmond,O=Microsoft,OU=Azure Stack" 'OutputRequestPath' = "$ENV:USERPROFILE\Documents\AzsCertRequests" } New-AzsHubAzureContainerRegistryCertificateSigningRequest @certificateRequestParams Generates Certificate Signing Requests for Azure Stack Hub Azure Container Registry Resource Provider Certificates .EXAMPLE New-AzsHubAzureContainerRegistryCertificateSigningRequest -StampEndpoint azurestack.contoso.com -OutputRequestPath "$ENV:USERPROFILE\Documents\AzsCertRequests" Connects to existing endpoint read the current SSL certificate, clones the attributes and creates Certificate Signing Requests with those attributes. For use with renewal of soon-to-be expired certs. .PARAMETER RegionName Specifies the Azure Stack deployment's region name, must be alphanumeric. .PARAMETER externalFQDN Specifies the Azure Stack deployment's External FQDN, also aliased as ExternalFQDN and FQDN, must be valid DNSHostName .PARAMETER DistinguishedName Specifies a DistinguishedName to be used on the certificate. Must be a valid System.Security.Cryptography.X509Certificates.X500DistinguishedName value. Common Name (CN) is not required, the appropriate value for the Azure Stack Service will be placed in the Common Name (CN). If a Common Name (CN) is given it will be honoured on every certificate request if supplied. Also aliased as subject. .PARAMETER DistinguishedNameFlag Specifies a string for the distinguished name flag to be used in the distinguished name. UseUTF8Encoding is selected by default. More information on x500DistinguishNameFlags can be found at https://aka.ms/dnflags .PARAMETER KeyLength Defines the length of the public and private key for the certificate request generation. Default is 2048. Valid values 2048, 4096, 8192 .PARAMETER HashAlgorithm Hash Algorithm to be used for the certificate request generation. Default is SHA256. Valid values SHA256, SHA384, SHA512 .PARAMETER EnhancedKeyUsage Extended (Enhanced) Key Usage to be included in the certificate request. Provide the required usage for the target certificate as well as the custom usage in hashtable format. e.g. @('Client Authentication','Server Authentication',@{'Custom Usage' = '1.3.6.1.5.7.8.2.1'}) will request Client and Server Auth key usage and the custom usage. .PARAMETER RequestType Specifies the SAN type of the certificate request. Valid values: MultipleCSR, SingleCSR. SingleCSR generates one certificate request for all services (not recommended for production). User will be prompted to confirm use. MultipleCSR generates multiple certificate requests, one for each service (strongly recommended in production environments). .PARAMETER StampEndpoint Provide a dns hostname of an existing stamp endpoint (region.external.fqdn) to clone the certificate attributes to be used to generate the certificate signing request. .PARAMETER OutputRequestPath Specifies the destination path for certificate request files, directory must already exist. .PARAMETER ForceTLS12 Force the use of TLS 1.2, true by default, set to false to use to system default. .PARAMETER LowPrivilege Use in low privilege environment were elevation is not allowed. Generates INF certificate request templates. .INPUTS Inputs (if any) .OUTPUTS Output (if any) .LINK Generate Azure Stack Certificate Requests - https://aka.ms/AzsCSR Azure Stack Readiness Checker Tool - https://aka.ms/AzsReadinessChecker .NOTES General notes #> [CmdletBinding(DefaultParameterSetName = 'Manual')] param ( [Parameter(Mandatory = $false, ParameterSetName = 'Manual', HelpMessage = "Enter Azure Stack Hub Region Name")] [string]$RegionName, [Parameter(Mandatory = $true, ParameterSetName = 'Manual', HelpMessage = "Enter Azure Stack Fully Qualified Domain Name (without region name)")] [Alias("FQDN", "ExternalDomainName")] [ValidateScript( {[System.Uri]::CheckHostName($_) -eq 'dns' <#FQDN must be valid DNSHostName#>})] [string]$ExternalFQDN, [Parameter(Mandatory = $true, ParameterSetName = 'Manual', HelpMessage = 'Provide subject name as a string, CN is not required and will be overwritten. E.g. "C=US,ST=Washington,L=Redmond,O=Microsoft,OU=Azure Stack"')] [Alias("Subject")] [System.Security.Cryptography.X509Certificates.X500DistinguishedName]$DistinguishedName, [Parameter(Mandatory = $false, ParameterSetName = 'Manual', HelpMessage = 'Provide X500DistinguishedNameFlags if The distinguished name has special characteristics. Default UseUTF8Encoding.')] [System.Security.Cryptography.X509Certificates.X500DistinguishedNameFlags]$DistinguishedNameFlag = 'UseUTF8Encoding', [Parameter(Mandatory = $false, ParameterSetName = 'Manual', HelpMessage = 'Provide Key Length: 2048, 4096 or 8192')] [ValidateSet(2048, 4096, 8192)] [int]$KeyLength = 2048, [Parameter(Mandatory = $false, ParameterSetName = 'Manual', HelpMessage = 'Provide Hash Algorithm: SHA256, SHA384 or SHA512')] [ValidateSet('SHA256', 'SHA384', 'SHA512')] [System.Security.Cryptography.HashAlgorithmName]$HashAlgorithm = 'SHA256', [Parameter(Mandatory = $false, ParameterSetName = 'Manual', HelpMessage = "Optionally provide Extended (Enhanced) Key Usage. By default, certificate config will be used. e.g. @('Client Authentication', 'Server Authentication', @{'Custom Usage' = '1.3.6.1.5.15.7.3.2'})")] $EnhancedKeyUsage, [Parameter(Mandatory = $true, ParameterSetName = 'ExistingEndpoint', HelpMessage = "Optionally provide an existing stamp endpoint (region.external.fqdn) to clone the certificate attributes to be used to generate the certificate signing request.")] [ValidateScript( {[System.Uri]::CheckHostName($_) -eq 'dns' <#FQDN must be valid DNSHostName#>})] $StampEndpoint, [Parameter(Mandatory = $false, HelpMessage = "Enter Certificate Request generation type ('Single' = Request individual wildcard certificates, 'Multiple' = Request single multi domain wildcard certificates")] [ValidateSet('MultipleCSR', 'SingleCSR')] [string]$requestType = 'MultipleCSR', [Parameter(Mandatory = $true, HelpMessage = "Destination Path for Certificate Request(s)")] [ValidateScript( {Test-Path -Path $_ -PathType Container <# should be a valid directory path #>})] [string]$OutputRequestPath, [Parameter(Mandatory = $false, ParameterSetName = 'ExistingEndpoint', HelpMessage = "Force the use of TLS 1.2, true by default")] [bool]$ForceTLS12 = $true, [Parameter(Mandatory = $false, HelpMessage = "Directory path for log and report output")] [string]$OutputPath = "$ENV:TEMP\AzsReadinessChecker", [Parameter(Mandatory = $false, HelpMessage = "Use in low privilege environment were elevation is not allowed. Generates INF certificate request templates.")] [switch]$LowPrivilege ) New-AzsCertificateSigningRequest @PSBoundParameters -CertificateType ACR } function New-AzsHubAzureSiteRecoveryCertificateSigningRequest { <# .SYNOPSIS Generates Certificate Signing Requests for Azure Stack Hub Azure Site Recovery Resource Provider Certificates .DESCRIPTION Calls New-AzsCertificateSigningRequest with neccessary parameters to generate CSR for Azure Stack Hub Azure Azure Site Recovery Resource Provider certificates .EXAMPLE $certificateRequestParams = @{ 'regionName' = 'azurestack' 'externalFQDN' = 'contoso.com' 'subject' = "C=US,ST=Washington,L=Redmond,O=Microsoft,OU=Azure Stack" 'OutputRequestPath' = "$ENV:USERPROFILE\Documents\AzsCertRequests" } New-AzsHubAzureSiteRecoveryCertificateSigningRequest @certificateRequestParams Generates Certificate Signing Requests for Azure Stack Hub Azure Azure Site Recovery Resource Provider Certificates .EXAMPLE New-AzsHubAzureSiteRecoveryCertificateSigningRequest -StampEndpoint azurestack.contoso.com -OutputRequestPath "$ENV:USERPROFILE\Documents\AzsCertRequests" Connects to existing endpoint read the current SSL certificate, clones the attributes and creates Certificate Signing Requests with those attributes. For use with renewal of soon-to-be expired certs. .PARAMETER RegionName Specifies the Azure Stack deployment's region name, must be alphanumeric. .PARAMETER externalFQDN Specifies the Azure Stack deployment's External FQDN, also aliased as ExternalFQDN and FQDN, must be valid DNSHostName .PARAMETER DistinguishedName Specifies a DistinguishedName to be used on the certificate. Must be a valid System.Security.Cryptography.X509Certificates.X500DistinguishedName value. Common Name (CN) is not required, the appropriate value for the Azure Stack Service will be placed in the Common Name (CN). If a Common Name (CN) is given it will be honoured on every certificate request if supplied. Also aliased as subject. .PARAMETER DistinguishedNameFlag Specifies a string for the distinguished name flag to be used in the distinguished name. UseUTF8Encoding is selected by default. More information on x500DistinguishNameFlags can be found at https://aka.ms/dnflags .PARAMETER KeyLength Defines the length of the public and private key for the certificate request generation. Default is 2048. Valid values 2048, 4096, 8192 .PARAMETER HashAlgorithm Hash Algorithm to be used for the certificate request generation. Default is SHA256. Valid values SHA256, SHA384, SHA512 .PARAMETER EnhancedKeyUsage Extended (Enhanced) Key Usage to be included in the certificate request. Provide the required usage for the target certificate as well as the custom usage in hashtable format. e.g. @('Client Authentication','Server Authentication',@{'Custom Usage' = '1.3.6.1.5.7.8.2.1'}) will request Client and Server Auth key usage and the custom usage. .PARAMETER RequestType Specifies the SAN type of the certificate request. Valid values: MultipleCSR, SingleCSR. SingleCSR generates one certificate request for all services (not recommended for production). User will be prompted to confirm use. MultipleCSR generates multiple certificate requests, one for each service (strongly recommended in production environments). .PARAMETER StampEndpoint Provide a dns hostname of an existing stamp endpoint (region.external.fqdn) to clone the certificate attributes to be used to generate the certificate signing request. .PARAMETER OutputRequestPath Specifies the destination path for certificate request files, directory must already exist. .PARAMETER ForceTLS12 Force the use of TLS 1.2, true by default, set to false to use to system default. .PARAMETER LowPrivilege Use in low privilege environment were elevation is not allowed. Generates INF certificate request templates. .INPUTS Inputs (if any) .OUTPUTS Output (if any) .LINK Generate Azure Stack Certificate Requests - https://aka.ms/AzsCSR Azure Stack Readiness Checker Tool - https://aka.ms/AzsReadinessChecker .NOTES General notes #> [CmdletBinding(DefaultParameterSetName = 'Manual')] param ( [Parameter(Mandatory = $false, ParameterSetName = 'Manual', HelpMessage = "Enter Azure Stack Hub Region Name")] [string]$RegionName, [Parameter(Mandatory = $true, ParameterSetName = 'Manual', HelpMessage = "Enter Azure Stack Fully Qualified Domain Name (without region name)")] [Alias("FQDN", "ExternalDomainName")] [ValidateScript( {[System.Uri]::CheckHostName($_) -eq 'dns' <#FQDN must be valid DNSHostName#>})] [string]$ExternalFQDN, [Parameter(Mandatory = $true, ParameterSetName = 'Manual', HelpMessage = 'Provide subject name as a string, CN is not required and will be overwritten. E.g. "C=US,ST=Washington,L=Redmond,O=Microsoft,OU=Azure Stack"')] [Alias("Subject")] [System.Security.Cryptography.X509Certificates.X500DistinguishedName]$DistinguishedName, [Parameter(Mandatory = $false, ParameterSetName = 'Manual', HelpMessage = 'Provide X500DistinguishedNameFlags if The distinguished name has special characteristics. Default UseUTF8Encoding.')] [System.Security.Cryptography.X509Certificates.X500DistinguishedNameFlags]$DistinguishedNameFlag = 'UseUTF8Encoding', [Parameter(Mandatory = $false, ParameterSetName = 'Manual', HelpMessage = 'Provide Key Length: 2048, 4096 or 8192')] [ValidateSet(2048, 4096, 8192)] [int]$KeyLength = 2048, [Parameter(Mandatory = $false, ParameterSetName = 'Manual', HelpMessage = 'Provide Hash Algorithm: SHA256, SHA384 or SHA512')] [ValidateSet('SHA256', 'SHA384', 'SHA512')] [System.Security.Cryptography.HashAlgorithmName]$HashAlgorithm = 'SHA256', [Parameter(Mandatory = $false, ParameterSetName = 'Manual', HelpMessage = "Optionally provide Extended (Enhanced) Key Usage. By default, certificate config will be used. e.g. @('Client Authentication', 'Server Authentication', @{'Custom Usage' = '1.3.6.1.5.15.7.3.2'})")] $EnhancedKeyUsage, [Parameter(Mandatory = $true, ParameterSetName = 'ExistingEndpoint', HelpMessage = "Optionally provide an existing stamp endpoint (region.external.fqdn) to clone the certificate attributes to be used to generate the certificate signing request.")] [ValidateScript( {[System.Uri]::CheckHostName($_) -eq 'dns' <#FQDN must be valid DNSHostName#>})] $StampEndpoint, [Parameter(Mandatory = $false, HelpMessage = "Enter Certificate Request generation type ('Single' = Request individual wildcard certificates, 'Multiple' = Request single multi domain wildcard certificates")] [ValidateSet('MultipleCSR', 'SingleCSR')] [string]$requestType = 'MultipleCSR', [Parameter(Mandatory = $true, HelpMessage = "Destination Path for Certificate Request(s)")] [ValidateScript( {Test-Path -Path $_ -PathType Container <# should be a valid directory path #>})] [string]$OutputRequestPath, [Parameter(Mandatory = $false, ParameterSetName = 'ExistingEndpoint', HelpMessage = "Force the use of TLS 1.2, true by default")] [bool]$ForceTLS12 = $true, [Parameter(Mandatory = $false, HelpMessage = "Directory path for log and report output")] [string]$OutputPath = "$ENV:TEMP\AzsReadinessChecker", [Parameter(Mandatory = $false, HelpMessage = "Use in low privilege environment were elevation is not allowed. Generates INF certificate request templates.")] [switch]$LowPrivilege ) New-AzsCertificateSigningRequest @PSBoundParameters -CertificateType ASR } function Get-AzsCSRParameters { <# .SYNOPSIS Get CSR parameters from existing endpoint. .DESCRIPTION Get CSR parameters from existing endpoint. .EXAMPLE PS C:\> Get-AzsCSRParameters -StampEndpoint management.east.azurestack.contoso.com Explanation of what the example does .INPUTS Uri - System.Uri .OUTPUTS Hashtable .NOTES General notes #> param ([System.Uri[]]$StampEndPoint) # Support multiple endpoints and fail only if it runs out of options. $success = $false $errMsg = @() foreach ($EndPoint in $StampEndPoint) { Write-AzsReadinessLog -Message ("Querying StampEndpoint {0} for existing certificate" -f $EndPoint) -Type Info if (Resolve-DnsName -Name $EndPoint -ErrorAction SilentlyContinue -QuickTimeout) { #try and retrieve certificate inventory from SSL endpoint try { foreach ($port in 443,44300,44307) { try { $Timeout = 1000 $tcpClient = New-Object System.Net.Sockets.TcpClient $portOpened = $tcpClient.ConnectAsync($EndPoint.OriginalString, $port).Wait($Timeout) if ($portOpened) { #create service connection point to the target SSL endpoint $SSLEndPoint = "https://{0}:{1}" -f $EndPoint, $port Write-AzsReadinessLog -Message ("Testing StampEndpoint {0}." -f $SSLEndPoint) -Type Info -ToScreen try { $null = Invoke-WebRequest $SSLEndPoint -TimeoutSec 3 -ErrorAction SilentlyContinue -UseBasicParsing } catch { if ($_.exception.InnerException.Message -like '*The client and server cannot communicate, because they do not possess a common algorithm*') { # this shouldnt happen we force tls1.2 by default, the user can override this and set the protocol settings system-wide or process-wide. throw "TLS mismatch. Ensure the client is using a TLS version that matches the end point. Using -ForceTLS12 parameter can toggle between TLS1.2 and system settings." } Write-AzsReadinessLog -Message ("Errors are expected. Web request returned: {0}" -f $_.exception.message) -Type Info } # read certificate [System.Security.Cryptography.X509Certificates.X509Certificate2]$certificate = Get-SslCertificateChain -Url $sslEndPoint | Select-Object -last 1 Write-AzsReadinessLog -Message ("Certificate returned by $sslEndPoint`: " ) -Type Info -toScreen Write-CertificateToLog -Certificate $certificate -toScreen # if we were succesfully, break so we dont waste time checking other ports. if ($certificate) { break } else { throw "Unable to read certificate from $SSLEndPoint. Refer to the above in this case." } } } catch { throw $_.exception.message # allow errors, we only want the certificate from the handshake and will catch a null certificate instead. } } Import-Module $PSScriptRoot\Microsoft.AzureStack.PublicCertificatePackaging.psm1 -force $externalFqdn = Get-AzsExternalDomain -dnsNamesFromConfig (Get-AzsCertificateDnsNamesFromConfig) -certificate $Certificate # If subject contains a DNSName, remove it to let the tool populate it normally, # We don't want to take a single distinguished name throughout all certificates e.g. cn=adminportal on portal certificate etc. # If subject does not contain a DNSName, the previous certificate had a custom subject that must be honoured. e.g. CN=Contoso Cloud. foreach ($name in $certificate.DnsNameList.Unicode) { if ($certificate.SubjectName.Name -like "*CN=$Name*") { $subject = $certificate.SubjectName.Format($true) -split "`n" | Where-Object { $PSITEM -inotmatch 'cn=' -and $PSITEM -ne ""} } break } if (-not $subject) { # if the subject only matches the CN, we can ignore it and let the tool generate the subject # otherwise its custom like CN=Contoso Cloud Ltd and we need to carry that forward to all certs. if ($certificate.SubjectName.Name -eq "CN=$name") { Write-AzsReadinessLog -Message ("CN only subject detected {0}." -f $certificate.SubjectName.Name) -Type Info $subject = "" } else { $subject = $certificate.SubjectName.Name Write-AzsReadinessLog -Message ("Custom subject detected {0}." -f $subject) -Type Info } } else { $subject = $subject.replace("`r","") -join ', ' Write-AzsReadinessLog -Message ("Tool generated subject detected {0}. Removing common name and continuing." -f $subject) -Type Info } # convert Oid to HashAlgorithm Name try { [System.Security.Cryptography.HashAlgorithmName]$algorithm = ($certificate.SignatureAlgorithm.FriendlyName | select-string -Pattern 'SHA[0-9]{3}').Matches[0].value if (-not $algorithm) { throw $_ } } catch { $errmsg = ("Unable to convert {0} to type System.Security.Cryptography.HashAlgorithmName Error:{1}" -f $certificate.SignatureAlgorithm.FriendlyName, $_.exception.message) Write-AzsReadinessLog -Message $errmsg -Type Error -toScreen throw $_.exception.Message } # construct params needed to request new certificate. $params = @{ DistinguishedName = $subject.ToString() ExternalFQDN = $externalFqdn KeyLength = $certificate.PublicKey.Key.KeySize HashAlgorithm = $algorithm } # If this is Azure Stack Hub Deployment certificates, get IdentitySystem and add to parameters if ((Get-PSCallStack).arguments -match 'CertificateType=Deployment') { try { Write-AzsReadinessLog -Message "Checking if identity system is AAD or ADFS..." -Type Info -ToScreen $ADFSRequest = Invoke-WebRequest "https://management.$externalFqdn/metadata/endpoints?api-version=2015-01-01" -UseBasicParsing -Timeout 5 $loginEndPoint = ($ADFSRequest.Content | ConvertFrom-Json).Authentication.LoginEndpoint if ($loginEndPoint -like '*ADFS*') { $params.Add('IdentitySystem','ADFS') Write-AzsReadinessLog -Message ("ADFS detected. Login endpoint $loginEndPoint`n") -Type Info -ToScreen } else { Write-AzsReadinessLog -Message ("AAD detected. Login endpoint $loginEndPoint`n") -Type Info -ToScreen $params.Add('IdentitySystem','AAD') } } catch { Write-AzsReadinessLog -Message ("Checking for AAD or ADFS identity integration failed with {0}." -f $_.exception.message) -Type Warning -ToScreen Write-AzsReadinessLog -Message "ADFS and Graph certificates requests will be generated in case they are needed." -Type Warning -ToScreen Write-AzsReadinessLog -Message "If the stamp is AAD integrated, the ADFS and Graph requests files can be safely discarded.`n" -Type Warning -ToScreen $params.Add('IdentitySystem','ADFS') } } $paramToString = ($params.GetEnumerator() | ForEach-Object { "$($_.Key)=$($_.Value)" }) -join ';' Write-AzsReadinessLog -Message ("Found CSR params {0}" -f ($paramToString)) -Type Info $success = $true $params break } catch { $ConnectionError = $_.exception.message $errMsg += ("Failed to query {0} for existing certificate. Error: {1}" -f $SSLEndPoint,$ConnectionError) Write-AzsReadinessLog -Message $errMsg[-1] -Type Warning } } else { $errMsg += ("Unable to resolve StampEndpoint {0}. Ensure StampEndpoint can be resolved." -f $EndPoint) Write-AzsReadinessLog -Message $errMsg[-1] -Type Warning } } if (-not $success) { Write-AzsReadinessLog -Message ("Unable to read CSR parameters for existing StampEndpoint(s):`r`n{0}" -f ($errMsg | Out-String)) -Type Error -toScreen } } function Get-FixedEndPoints { <# .SYNOPSIS Resolve fixed endpoints to check existing certificates against. .DESCRIPTION Resolve fixed endpoints to check existing certificates against, first by using FixedEndPoint property of certificate configuration, and fall back to dnsname and remove any wildcards. #> [cmdletbinding()] param ( [ValidateNotNullOrEmpty()] $certificateConfig, [ValidateNotNullOrEmpty()] $stampEndpoint) $fixedEndPoints = @() $fixedEndPoints = $certificateConfig.Keys | ForEach-Object {` if ($certificateConfig[$_].FixedEndPoint) { $certificateConfig[$_].FixedEndPoint } else { $certificateConfig[$_].DnsName } } $output = $fixedEndPoints | where-object {$PSITEM -notmatch '\*.'} | Sort-Object -Descending | Foreach-Object {"{0}.{1}" -f $PSITEM, $stampEndpoint} Write-AzsReadinessLog -Message ("Resolved fixed endpoints {0}" -f $fixedEndPoints -join ',') return $output } # SIG # Begin signature block # MIIoLQYJKoZIhvcNAQcCoIIoHjCCKBoCAQExDzANBglghkgBZQMEAgEFADB5Bgor # BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG # KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCAExZCUpyEbjI8w # RenuZbrfJKm4RNALD2AP2Ygq1JfLD6CCDXYwggX0MIID3KADAgECAhMzAAADrzBA # DkyjTQVBAAAAAAOvMA0GCSqGSIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMwEQYD # VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy # b3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25p # bmcgUENBIDIwMTEwHhcNMjMxMTE2MTkwOTAwWhcNMjQxMTE0MTkwOTAwWjB0MQsw # CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u # ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYDVQQDExVNaWNy # b3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB # AQDOS8s1ra6f0YGtg0OhEaQa/t3Q+q1MEHhWJhqQVuO5amYXQpy8MDPNoJYk+FWA # hePP5LxwcSge5aen+f5Q6WNPd6EDxGzotvVpNi5ve0H97S3F7C/axDfKxyNh21MG # 0W8Sb0vxi/vorcLHOL9i+t2D6yvvDzLlEefUCbQV/zGCBjXGlYJcUj6RAzXyeNAN # xSpKXAGd7Fh+ocGHPPphcD9LQTOJgG7Y7aYztHqBLJiQQ4eAgZNU4ac6+8LnEGAL # go1ydC5BJEuJQjYKbNTy959HrKSu7LO3Ws0w8jw6pYdC1IMpdTkk2puTgY2PDNzB # tLM4evG7FYer3WX+8t1UMYNTAgMBAAGjggFzMIIBbzAfBgNVHSUEGDAWBgorBgEE # AYI3TAgBBggrBgEFBQcDAzAdBgNVHQ4EFgQURxxxNPIEPGSO8kqz+bgCAQWGXsEw # RQYDVR0RBD4wPKQ6MDgxHjAcBgNVBAsTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEW # MBQGA1UEBRMNMjMwMDEyKzUwMTgyNjAfBgNVHSMEGDAWgBRIbmTlUAXTgqoXNzci # tW2oynUClTBUBgNVHR8ETTBLMEmgR6BFhkNodHRwOi8vd3d3Lm1pY3Jvc29mdC5j # b20vcGtpb3BzL2NybC9NaWNDb2RTaWdQQ0EyMDExXzIwMTEtMDctMDguY3JsMGEG # CCsGAQUFBwEBBFUwUzBRBggrBgEFBQcwAoZFaHR0cDovL3d3dy5taWNyb3NvZnQu # Y29tL3BraW9wcy9jZXJ0cy9NaWNDb2RTaWdQQ0EyMDExXzIwMTEtMDctMDguY3J0 # MAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADggIBAISxFt/zR2frTFPB45Yd # mhZpB2nNJoOoi+qlgcTlnO4QwlYN1w/vYwbDy/oFJolD5r6FMJd0RGcgEM8q9TgQ # 2OC7gQEmhweVJ7yuKJlQBH7P7Pg5RiqgV3cSonJ+OM4kFHbP3gPLiyzssSQdRuPY # 1mIWoGg9i7Y4ZC8ST7WhpSyc0pns2XsUe1XsIjaUcGu7zd7gg97eCUiLRdVklPmp # XobH9CEAWakRUGNICYN2AgjhRTC4j3KJfqMkU04R6Toyh4/Toswm1uoDcGr5laYn # TfcX3u5WnJqJLhuPe8Uj9kGAOcyo0O1mNwDa+LhFEzB6CB32+wfJMumfr6degvLT # e8x55urQLeTjimBQgS49BSUkhFN7ois3cZyNpnrMca5AZaC7pLI72vuqSsSlLalG # OcZmPHZGYJqZ0BacN274OZ80Q8B11iNokns9Od348bMb5Z4fihxaBWebl8kWEi2O # PvQImOAeq3nt7UWJBzJYLAGEpfasaA3ZQgIcEXdD+uwo6ymMzDY6UamFOfYqYWXk # ntxDGu7ngD2ugKUuccYKJJRiiz+LAUcj90BVcSHRLQop9N8zoALr/1sJuwPrVAtx # HNEgSW+AKBqIxYWM4Ev32l6agSUAezLMbq5f3d8x9qzT031jMDT+sUAoCw0M5wVt # CUQcqINPuYjbS1WgJyZIiEkBMIIHejCCBWKgAwIBAgIKYQ6Q0gAAAAAAAzANBgkq # hkiG9w0BAQsFADCBiDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24x # EDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlv # bjEyMDAGA1UEAxMpTWljcm9zb2Z0IFJvb3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5 # IDIwMTEwHhcNMTEwNzA4MjA1OTA5WhcNMjYwNzA4MjEwOTA5WjB+MQswCQYDVQQG # EwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwG # A1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSgwJgYDVQQDEx9NaWNyb3NvZnQg # Q29kZSBTaWduaW5nIFBDQSAyMDExMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIIC # CgKCAgEAq/D6chAcLq3YbqqCEE00uvK2WCGfQhsqa+laUKq4BjgaBEm6f8MMHt03 # a8YS2AvwOMKZBrDIOdUBFDFC04kNeWSHfpRgJGyvnkmc6Whe0t+bU7IKLMOv2akr # rnoJr9eWWcpgGgXpZnboMlImEi/nqwhQz7NEt13YxC4Ddato88tt8zpcoRb0Rrrg # OGSsbmQ1eKagYw8t00CT+OPeBw3VXHmlSSnnDb6gE3e+lD3v++MrWhAfTVYoonpy # 4BI6t0le2O3tQ5GD2Xuye4Yb2T6xjF3oiU+EGvKhL1nkkDstrjNYxbc+/jLTswM9 # sbKvkjh+0p2ALPVOVpEhNSXDOW5kf1O6nA+tGSOEy/S6A4aN91/w0FK/jJSHvMAh # dCVfGCi2zCcoOCWYOUo2z3yxkq4cI6epZuxhH2rhKEmdX4jiJV3TIUs+UsS1Vz8k # A/DRelsv1SPjcF0PUUZ3s/gA4bysAoJf28AVs70b1FVL5zmhD+kjSbwYuER8ReTB # w3J64HLnJN+/RpnF78IcV9uDjexNSTCnq47f7Fufr/zdsGbiwZeBe+3W7UvnSSmn # Eyimp31ngOaKYnhfsi+E11ecXL93KCjx7W3DKI8sj0A3T8HhhUSJxAlMxdSlQy90 # lfdu+HggWCwTXWCVmj5PM4TasIgX3p5O9JawvEagbJjS4NaIjAsCAwEAAaOCAe0w # ggHpMBAGCSsGAQQBgjcVAQQDAgEAMB0GA1UdDgQWBBRIbmTlUAXTgqoXNzcitW2o # ynUClTAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMAQTALBgNVHQ8EBAMCAYYwDwYD # VR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBRyLToCMZBDuRQFTuHqp8cx0SOJNDBa # BgNVHR8EUzBRME+gTaBLhklodHRwOi8vY3JsLm1pY3Jvc29mdC5jb20vcGtpL2Ny # bC9wcm9kdWN0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFfMDNfMjIuY3JsMF4GCCsG # AQUFBwEBBFIwUDBOBggrBgEFBQcwAoZCaHR0cDovL3d3dy5taWNyb3NvZnQuY29t # L3BraS9jZXJ0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFfMDNfMjIuY3J0MIGfBgNV # HSAEgZcwgZQwgZEGCSsGAQQBgjcuAzCBgzA/BggrBgEFBQcCARYzaHR0cDovL3d3 # dy5taWNyb3NvZnQuY29tL3BraW9wcy9kb2NzL3ByaW1hcnljcHMuaHRtMEAGCCsG # AQUFBwICMDQeMiAdAEwAZQBnAGEAbABfAHAAbwBsAGkAYwB5AF8AcwB0AGEAdABl # AG0AZQBuAHQALiAdMA0GCSqGSIb3DQEBCwUAA4ICAQBn8oalmOBUeRou09h0ZyKb # C5YR4WOSmUKWfdJ5DJDBZV8uLD74w3LRbYP+vj/oCso7v0epo/Np22O/IjWll11l # hJB9i0ZQVdgMknzSGksc8zxCi1LQsP1r4z4HLimb5j0bpdS1HXeUOeLpZMlEPXh6 # I/MTfaaQdION9MsmAkYqwooQu6SpBQyb7Wj6aC6VoCo/KmtYSWMfCWluWpiW5IP0 # wI/zRive/DvQvTXvbiWu5a8n7dDd8w6vmSiXmE0OPQvyCInWH8MyGOLwxS3OW560 # STkKxgrCxq2u5bLZ2xWIUUVYODJxJxp/sfQn+N4sOiBpmLJZiWhub6e3dMNABQam # ASooPoI/E01mC8CzTfXhj38cbxV9Rad25UAqZaPDXVJihsMdYzaXht/a8/jyFqGa # J+HNpZfQ7l1jQeNbB5yHPgZ3BtEGsXUfFL5hYbXw3MYbBL7fQccOKO7eZS/sl/ah # XJbYANahRr1Z85elCUtIEJmAH9AAKcWxm6U/RXceNcbSoqKfenoi+kiVH6v7RyOA # 9Z74v2u3S5fi63V4GuzqN5l5GEv/1rMjaHXmr/r8i+sLgOppO6/8MO0ETI7f33Vt # Y5E90Z1WTk+/gFcioXgRMiF670EKsT/7qMykXcGhiJtXcVZOSEXAQsmbdlsKgEhr # /Xmfwb1tbWrJUnMTDXpQzTGCGg0wghoJAgEBMIGVMH4xCzAJBgNVBAYTAlVTMRMw # EQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN # aWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNp # Z25pbmcgUENBIDIwMTECEzMAAAOvMEAOTKNNBUEAAAAAA68wDQYJYIZIAWUDBAIB # BQCgga4wGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwHAYKKwYBBAGCNwIBCzEO # MAwGCisGAQQBgjcCARUwLwYJKoZIhvcNAQkEMSIEIPsCIoDqR1b0OkjPLT/hdWBD # capsIR5kmAthWnGck+AOMEIGCisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8A # cwBvAGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEB # BQAEggEAe/Fe6tmAo/yeM1TtaKCCT+8nnR9VNJi/kW1rhuFiZi049/RraYOKbNrW # 555cuEV38VM31FzyUPN6ECBZcrm+Vrjekpaos6GXuPoKjP9n0qjin2ip84oZXmlL # jnG6Xm5HKzZYA5ijX9oNDLWX8D0KylbrSurmultCLGA2VG6vbT6NRPEqbjaApVno # cbxeEUhclZRl3STqfQKsGBBoTieQKky3ScrhX+maIMU4QacNfFH4CgkEwbl5VDff # FQKyeWGXntaQQGYc6aWm74KuAxgMCo5VxaJbokvQVKeWsKNhfybxPOc4+6HQdOWP # 7Yn7j4Dg79dodThnAT1bXLlmRQDZuKGCF5cwgheTBgorBgEEAYI3AwMBMYIXgzCC # F38GCSqGSIb3DQEHAqCCF3AwghdsAgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFSBgsq # hkiG9w0BCRABBKCCAUEEggE9MIIBOQIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFl # AwQCAQUABCAu615s8tPcTHnDRPuV7XymPYrirCxbXn3SriUAjhmVxgIGZfLpnQUs # GBMyMDI0MDMyNTA3MjU0MS42MDdaMASAAgH0oIHRpIHOMIHLMQswCQYDVQQGEwJV # UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UE # ChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSUwIwYDVQQLExxNaWNyb3NvZnQgQW1l # cmljYSBPcGVyYXRpb25zMScwJQYDVQQLEx5uU2hpZWxkIFRTUyBFU046OTIwMC0w # NUUwLUQ5NDcxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZpY2Wg # ghHtMIIHIDCCBQigAwIBAgITMwAAAecujy+TC08b6QABAAAB5zANBgkqhkiG9w0B # AQsFADB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE # BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYD # VQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDAeFw0yMzEyMDYxODQ1 # MTlaFw0yNTAzMDUxODQ1MTlaMIHLMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2Fz # aGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENv # cnBvcmF0aW9uMSUwIwYDVQQLExxNaWNyb3NvZnQgQW1lcmljYSBPcGVyYXRpb25z # MScwJQYDVQQLEx5uU2hpZWxkIFRTUyBFU046OTIwMC0wNUUwLUQ5NDcxJTAjBgNV # BAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZpY2UwggIiMA0GCSqGSIb3DQEB # AQUAA4ICDwAwggIKAoICAQDCV58v4IuQ659XPM1DtaWMv9/HRUC5kdiEF89YBP6/ # Rn7kjqMkZ5ESemf5Eli4CLtQVSefRpF1j7S5LLKisMWOGRaLcaVbGTfcmI1vMRJ1 # tzMwCNIoCq/vy8WH8QdV1B/Ab5sK+Q9yIvzGw47TfXPE8RlrauwK/e+nWnwMt060 # akEZiJJz1Vh1LhSYKaiP9Z23EZmGETCWigkKbcuAnhvh3yrMa89uBfaeHQZEHGQq # dskM48EBcWSWdpiSSBiAxyhHUkbknl9PPztB/SUxzRZjUzWHg9bf1mqZ0cIiAWC0 # EjK7ONhlQfKSRHVLKLNPpl3/+UL4Xjc0Yvdqc88gOLUr/84T9/xK5r82ulvRp2A8 # /ar9cG4W7650uKaAxRAmgL4hKgIX5/0aIAsbyqJOa6OIGSF9a+DfXl1LpQPNKR79 # 2scF7tjD5WqwIuifS9YUiHMvRLjjKk0SSCV/mpXC0BoPkk5asfxrrJbCsJePHSOE # blpJzRmzaP6OMXwRcrb7TXFQOsTkKuqkWvvYIPvVzC68UM+MskLPld1eqdOOMK7S # bbf2tGSZf3+iOwWQMcWXB9gw5gK3AIYK08WkJJuyzPqfitgubdRCmYr9CVsNOuW+ # wHDYGhciJDF2LkrjkFUjUcXSIJd9f2ssYitZ9CurGV74BQcfrxjvk1L8jvtN7mul # IwIDAQABo4IBSTCCAUUwHQYDVR0OBBYEFM/+4JiAnzY4dpEf/Zlrh1K73o9YMB8G # A1UdIwQYMBaAFJ+nFV0AXmJdg/Tl0mWnG1M1GelyMF8GA1UdHwRYMFYwVKBSoFCG # Tmh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvY3JsL01pY3Jvc29mdCUy # MFRpbWUtU3RhbXAlMjBQQ0ElMjAyMDEwKDEpLmNybDBsBggrBgEFBQcBAQRgMF4w # XAYIKwYBBQUHMAKGUGh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvY2Vy # dHMvTWljcm9zb2Z0JTIwVGltZS1TdGFtcCUyMFBDQSUyMDIwMTAoMSkuY3J0MAwG # A1UdEwEB/wQCMAAwFgYDVR0lAQH/BAwwCgYIKwYBBQUHAwgwDgYDVR0PAQH/BAQD # AgeAMA0GCSqGSIb3DQEBCwUAA4ICAQB0ofDbk+llWi1cC6nsfie5Jtp09o6b6ARC # pvtDPq2KFP+hi+UNNP7LGciKuckqXCmBTFIhfBeGSxvk6ycokdQr3815pEOaYWTn # HvQ0+8hKy86r1F4rfBu4oHB5cTy08T4ohrG/OYG/B/gNnz0Ol6v7u/qEjz48zXZ6 # ZlxKGyZwKmKZWaBd2DYEwzKpdLkBxs6A6enWZR0jY+q5FdbV45ghGTKgSr5ECAOn # LD4njJwfjIq0mRZWwDZQoXtJSaVHSu2lHQL3YHEFikunbUTJfNfBDLL7Gv+sTmRi # DZky5OAxoLG2gaTfuiFbfpmSfPcgl5COUzfMQnzpKfX6+FkI0QQNvuPpWsDU8sR+ # uni2VmDo7rmqJrom4ihgVNdLaMfNUqvBL5ZiSK1zmaELBJ9a+YOjE5pmSarW5sGb # n7iVkF2W9JQIOH6tGWLFJS5Hs36zahkoHh8iD963LeGjZqkFusKaUW72yMj/yxTe # GEDOoIr35kwXxr1Uu+zkur2y+FuNY0oZjppzp95AW1lehP0xaO+oBV1XfvaCur/B # 5PVAp2xzrosMEUcAwpJpio+VYfIufGj7meXcGQYWA8Umr8K6Auo+Jlj8IeFS6lSv # KhqQpmdBzAMGqPOQKt1Ow3ZXxehK7vAiim3ZiALlM0K546k0sZrxdZPgpmz7O8w9 # gHLuyZAQezCCB3EwggVZoAMCAQICEzMAAAAVxedrngKbSZkAAAAAABUwDQYJKoZI # hvcNAQELBQAwgYgxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAw # DgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x # MjAwBgNVBAMTKU1pY3Jvc29mdCBSb290IENlcnRpZmljYXRlIEF1dGhvcml0eSAy # MDEwMB4XDTIxMDkzMDE4MjIyNVoXDTMwMDkzMDE4MzIyNVowfDELMAkGA1UEBhMC # VVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNV # BAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRp # bWUtU3RhbXAgUENBIDIwMTAwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoIC # AQDk4aZM57RyIQt5osvXJHm9DtWC0/3unAcH0qlsTnXIyjVX9gF/bErg4r25Phdg # M/9cT8dm95VTcVrifkpa/rg2Z4VGIwy1jRPPdzLAEBjoYH1qUoNEt6aORmsHFPPF # dvWGUNzBRMhxXFExN6AKOG6N7dcP2CZTfDlhAnrEqv1yaa8dq6z2Nr41JmTamDu6 # GnszrYBbfowQHJ1S/rboYiXcag/PXfT+jlPP1uyFVk3v3byNpOORj7I5LFGc6XBp # Dco2LXCOMcg1KL3jtIckw+DJj361VI/c+gVVmG1oO5pGve2krnopN6zL64NF50Zu # yjLVwIYwXE8s4mKyzbnijYjklqwBSru+cakXW2dg3viSkR4dPf0gz3N9QZpGdc3E # XzTdEonW/aUgfX782Z5F37ZyL9t9X4C626p+Nuw2TPYrbqgSUei/BQOj0XOmTTd0 # lBw0gg/wEPK3Rxjtp+iZfD9M269ewvPV2HM9Q07BMzlMjgK8QmguEOqEUUbi0b1q # GFphAXPKZ6Je1yh2AuIzGHLXpyDwwvoSCtdjbwzJNmSLW6CmgyFdXzB0kZSU2LlQ # +QuJYfM2BjUYhEfb3BvR/bLUHMVr9lxSUV0S2yW6r1AFemzFER1y7435UsSFF5PA # PBXbGjfHCBUYP3irRbb1Hode2o+eFnJpxq57t7c+auIurQIDAQABo4IB3TCCAdkw # EgYJKwYBBAGCNxUBBAUCAwEAATAjBgkrBgEEAYI3FQIEFgQUKqdS/mTEmr6CkTxG # NSnPEP8vBO4wHQYDVR0OBBYEFJ+nFV0AXmJdg/Tl0mWnG1M1GelyMFwGA1UdIARV # MFMwUQYMKwYBBAGCN0yDfQEBMEEwPwYIKwYBBQUHAgEWM2h0dHA6Ly93d3cubWlj # cm9zb2Z0LmNvbS9wa2lvcHMvRG9jcy9SZXBvc2l0b3J5Lmh0bTATBgNVHSUEDDAK # BggrBgEFBQcDCDAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMAQTALBgNVHQ8EBAMC # AYYwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBTV9lbLj+iiXGJo0T2UkFvX # zpoYxDBWBgNVHR8ETzBNMEugSaBHhkVodHRwOi8vY3JsLm1pY3Jvc29mdC5jb20v # cGtpL2NybC9wcm9kdWN0cy9NaWNSb29DZXJBdXRfMjAxMC0wNi0yMy5jcmwwWgYI # KwYBBQUHAQEETjBMMEoGCCsGAQUFBzAChj5odHRwOi8vd3d3Lm1pY3Jvc29mdC5j # b20vcGtpL2NlcnRzL01pY1Jvb0NlckF1dF8yMDEwLTA2LTIzLmNydDANBgkqhkiG # 9w0BAQsFAAOCAgEAnVV9/Cqt4SwfZwExJFvhnnJL/Klv6lwUtj5OR2R4sQaTlz0x # M7U518JxNj/aZGx80HU5bbsPMeTCj/ts0aGUGCLu6WZnOlNN3Zi6th542DYunKmC # VgADsAW+iehp4LoJ7nvfam++Kctu2D9IdQHZGN5tggz1bSNU5HhTdSRXud2f8449 # xvNo32X2pFaq95W2KFUn0CS9QKC/GbYSEhFdPSfgQJY4rPf5KYnDvBewVIVCs/wM # nosZiefwC2qBwoEZQhlSdYo2wh3DYXMuLGt7bj8sCXgU6ZGyqVvfSaN0DLzskYDS # PeZKPmY7T7uG+jIa2Zb0j/aRAfbOxnT99kxybxCrdTDFNLB62FD+CljdQDzHVG2d # Y3RILLFORy3BFARxv2T5JL5zbcqOCb2zAVdJVGTZc9d/HltEAY5aGZFrDZ+kKNxn # GSgkujhLmm77IVRrakURR6nxt67I6IleT53S0Ex2tVdUCbFpAUR+fKFhbHP+Crvs # QWY9af3LwUFJfn6Tvsv4O+S3Fb+0zj6lMVGEvL8CwYKiexcdFYmNcP7ntdAoGokL # jzbaukz5m/8K6TT4JDVnK+ANuOaMmdbhIurwJ0I9JZTmdHRbatGePu1+oDEzfbzL # 6Xu/OHBE0ZDxyKs6ijoIYn/ZcGNTTY3ugm2lBRDBcQZqELQdVTNYs6FwZvKhggNQ # MIICOAIBATCB+aGB0aSBzjCByzELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hp # bmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jw # b3JhdGlvbjElMCMGA1UECxMcTWljcm9zb2Z0IEFtZXJpY2EgT3BlcmF0aW9uczEn # MCUGA1UECxMeblNoaWVsZCBUU1MgRVNOOjkyMDAtMDVFMC1EOTQ3MSUwIwYDVQQD # ExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNloiMKAQEwBwYFKw4DAhoDFQCz # cgTnGasSwe/dru+cPe1NF/vwQ6CBgzCBgKR+MHwxCzAJBgNVBAYTAlVTMRMwEQYD # VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy # b3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1w # IFBDQSAyMDEwMA0GCSqGSIb3DQEBCwUAAgUA6as9ujAiGA8yMDI0MDMyNTAwMDMw # NloYDzIwMjQwMzI2MDAwMzA2WjB3MD0GCisGAQQBhFkKBAExLzAtMAoCBQDpqz26 # AgEAMAoCAQACAhKDAgH/MAcCAQACAhOUMAoCBQDprI86AgEAMDYGCisGAQQBhFkK # BAIxKDAmMAwGCisGAQQBhFkKAwKgCjAIAgEAAgMHoSChCjAIAgEAAgMBhqAwDQYJ # KoZIhvcNAQELBQADggEBADrbbzWQHLFCwHE/OjaZRaBbCYh3w0xgCriv+GMKx2Sb # lBMnoxlg4yjDas1I4BphGeMpydviQzC01D0k7V6muujQ0JJIq+eovRttK3aEzEjx # K/fuk9r+7C7IFofpaugNwidNR16IRybtme+43oil2uwfe+JYydM0/n+x/scE1W66 # h51/eCUN/fNL1kHBo2lic+qAFahhb/bGpeDTp/YNIOjgOq3/dsyK6vic4vHDRwVQ # JvtlR2NZve4YZScjBBXSndGM+Ko+qB+de0oZOQ6CrF8zGsLARXoGnuhZJCWeDrN3 # RMS2ZRkkfgrrSnvlZu7G7dBt8FT1QmOBtUK/ae6SX8cxggQNMIIECQIBATCBkzB8 # MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVk # bW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1N # aWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMAITMwAAAecujy+TC08b6QABAAAB # 5zANBglghkgBZQMEAgEFAKCCAUowGgYJKoZIhvcNAQkDMQ0GCyqGSIb3DQEJEAEE # MC8GCSqGSIb3DQEJBDEiBCDHylDOZTYHkGYuHsQWQPypdSk2iZTd9iTdIgwBsV46 # 5DCB+gYLKoZIhvcNAQkQAi8xgeowgecwgeQwgb0EIOU2XQ12aob9DeDFXM9UFHeE # X74Fv0ABvQMG7qC51nOtMIGYMIGApH4wfDELMAkGA1UEBhMCVVMxEzARBgNVBAgT # Cldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29m # dCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENB # IDIwMTACEzMAAAHnLo8vkwtPG+kAAQAAAecwIgQgdO+34UlQvMoklSh8zNwnwhwm # ZhjIzS/5/zqMqhR7i7wwDQYJKoZIhvcNAQELBQAEggIAt7vScR/BH+m72WjEvJ// # ipgJL2VIh3HKy8u1nQxQXGZA3r4d1fJikljBs5REzfQT6oWHJ5BYCr+287MI0kog # HwaBsLeMrTieQ6GFMy8ygH+HMZWtjN053VMihVk+1b9Aq6PXhgSvBuuYTYmb0o6J # qr3LbKPYigI9RfUYyof9YgztpE+3Rcd8/0LI6iUWYETvfjeWcJNrywpvhN87wxYK # 8gt/i56b0tx+mjtSjVn3FumvGkGgSm8oFtYtjrStmus3Ip4xTcmMrFK/UM42qfCc # NmnAaM0Rhyr0jdZAy3XcfyMpFozIZ0/RXO35I6S0Syr54k5pm4yue4E1URbGzkZw # mi2zJGA3ISLYvkkL4SbneHrFBPJTHEvsma/nR4JunyoPqVj5+q4YNFlnqNsqA+w3 # Vh8GLoSDP50wgaDYJfNDZzZ/+GIrn2a1xo1orp8PqOEYArqpl4j3lVODEZ9XurV4 # SNZcVRAsAto36LjJSzLZCpsDmaEORVacvINATK98+jQILo9zdXIkkvGSUPGjt5MD # zCZnMioAA4ZSLvU1JsDkYSElY2d2b8mm047ldh+7lQt6e+ELm8SZQCx8VTjY5led # SX/dF8VF0e/jv3i2ebk18co1cc11w1+N8vuDDhtYyaMgMQ1TLnobTbJsPqLINLMw # V5lL1miGgUSIVPIvRWGe/aI= # SIG # End signature block |