Certificados Microsoft.Web 2021-01-15
Definição de recurso do Bicep
O tipo de recurso de certificados pode ser implementado com operações que visam:
- Grupos de recursos – veja comandos de implementação de grupos de recursos
Para obter uma lista de propriedades alteradas em cada versão da API, veja registo de alterações.
Formato do recurso
Para criar um recurso Microsoft.Web/certificates, adicione o seguinte Bicep ao seu modelo.
resource symbolicname 'Microsoft.Web/certificates@2021-01-15' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
kind: 'string'
properties: {
canonicalName: 'string'
domainValidationMethod: 'string'
hostNames: [
'string'
]
keyVaultId: 'string'
keyVaultSecretName: 'string'
password: 'string'
pfxBlob: any()
serverFarmId: 'string'
}
}
Valores de propriedade
certificados
| Nome | Descrição | Valor |
|---|---|---|
| name | O nome do recurso | cadeia (obrigatório) Limite de carateres: 1-260 Carateres válidos: Não é possível utilizar: / Não é possível terminar com espaço ou ponto final. |
| localização | Localização do Recurso. | cadeia (obrigatório) |
| etiquetas | Etiquetas de recursos. | Dicionário de nomes e valores de etiquetas. Ver Etiquetas em modelos |
| tipo | Tipo de recurso. | string |
| propriedades | Propriedades específicas do recurso de certificado | CertificateProperties |
CertificateProperties
| Nome | Descrição | Valor |
|---|---|---|
| canonicalName | CNAME do certificado a emitir através de certificado gratuito | string |
| domainValidationMethod | Método de validação de domínio para certificado gratuito. Os valores possíveis incluem: "CNameValidationValue", "HttpTokenValidationValue" | string |
| hostNames | Os nomes de anfitrião a que o certificado se aplica. | cadeia[] |
| keyVaultId | Key Vault ID de recurso do CSM. | string |
| keyVaultSecretName | Key Vault nome do segredo. | string |
| palavra-passe | Palavra-passe do certificado. | string |
| pfxBlob | Blob Pfx. | Para o Bicep, pode utilizar a função any( ). |
| serverFarmId | ID de recurso do plano de Serviço de Aplicações associado, formatado como: "/subscriptions/{subscriptionID}/resourceGroups/{groupName}/providers/Microsoft.Web/serverfarms/{appServicePlanName}". | string |
Modelos de início rápido
Os seguintes modelos de início rápido implementam este tipo de recurso.
| Modelo | Description |
|---|---|
Criar e atribuir um Certificado de Serviço de Aplicações padrão
|
Cria um Certificado de Serviço de Aplicações padrão, verifica-o com uma Aplicação do Serviço de Aplicações e cria enlaces SSL assim que o certificado estiver pronto |
|
Criar e atribuir um Certificado de Serviço de Aplicações universal
|
Cria um certificado de Serviço de Aplicações universal, verifica-o com um Domínio do Serviço de Aplicações e cria enlaces SSL numa Aplicação Serviço de Aplicações assim que o certificado estiver pronto |
|
Criar um Certificado Gerido dos Serviços de Aplicações
|
Criar APEX de Certificado Gerido (Gratuito) (domínio de raiz) para a WebApp |
|
Certificado SSL para um ASE ILB ou um ASE V2 do ILB
|
Configura o certificado SSL predefinido para um ASE ILB ou ASE v2 ILB |
|
Integração de Aplicações Web com Key Vault
|
Implementar um certificado de Aplicação Web a partir de Key Vault segredo e utilizá-lo para criar um enlace SSL |
|
Aplicação Web com um domínio personalizado e enlace SSL opcional
|
Crie uma aplicação Web e com um domínio personalizado e, opcionalmente, adicione um certificado SSL para encriptação https. |
Definição de recurso de modelo do ARM
O tipo de recurso de certificados pode ser implementado com operações que visam:
- Grupos de recursos – veja comandos de implementação de grupos de recursos
Para obter uma lista de propriedades alteradas em cada versão da API, veja registo de alterações.
Formato do recurso
Para criar um recurso Microsoft.Web/certificates, adicione o seguinte JSON ao seu modelo.
{
"type": "Microsoft.Web/certificates",
"apiVersion": "2021-01-15",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"kind": "string",
"properties": {
"canonicalName": "string",
"domainValidationMethod": "string",
"hostNames": [ "string" ],
"keyVaultId": "string",
"keyVaultSecretName": "string",
"password": "string",
"pfxBlob": {},
"serverFarmId": "string"
}
}
Valores de propriedade
certificados
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de recurso | "Microsoft.Web/certificates" |
| apiVersion | A versão da API de recursos | '2021-01-15' |
| name | O nome do recurso | cadeia (obrigatório) Limite de carateres: 1-260 Carateres válidos: Não é possível utilizar: / Não é possível terminar com espaço ou ponto final. |
| localização | Localização do Recurso. | cadeia (obrigatório) |
| etiquetas | Etiquetas de recursos. | Dicionário de nomes e valores de etiquetas. Ver Etiquetas em modelos |
| tipo | Tipo de recurso. | string |
| propriedades | Propriedades específicas do recurso de certificado | CertificateProperties |
CertificateProperties
| Nome | Descrição | Valor |
|---|---|---|
| canonicalName | CNAME do certificado a emitir através de certificado gratuito | string |
| domainValidationMethod | Método de validação de domínio para certificado gratuito. Os valores possíveis incluem: "CNameValidationValue", "HttpTokenValidationValue" | string |
| hostNames | Os nomes de anfitrião a que o certificado se aplica. | cadeia[] |
| keyVaultId | Key Vault ID de recurso do CSM. | string |
| keyVaultSecretName | Key Vault nome do segredo. | string |
| palavra-passe | Palavra-passe do certificado. | string |
| pfxBlob | Blob Pfx. | |
| serverFarmId | ID de recurso do plano de Serviço de Aplicações associado, formatado como: "/subscriptions/{subscriptionID}/resourceGroups/{groupName}/providers/Microsoft.Web/serverfarms/{appServicePlanName}". | string |
Modelos de início rápido
Os seguintes modelos de início rápido implementam este tipo de recurso.
| Modelo | Description |
|---|---|
|
Criar e atribuir um Certificado de Serviço de Aplicações padrão
|
Cria um Certificado de Serviço de Aplicações padrão, verifica-o com uma Aplicação do Serviço de Aplicações e cria enlaces SSL assim que o certificado estiver pronto |
|
Criar e atribuir um Certificado de Serviço de Aplicações universal
|
Cria um certificado de Serviço de Aplicações universal, verifica-o com um Domínio do Serviço de Aplicações e cria enlaces SSL numa Aplicação Serviço de Aplicações assim que o certificado estiver pronto |
|
Criar um Certificado Gerido dos Serviços de Aplicações
|
Criar APEX de Certificado Gerido (Gratuito) (domínio de raiz) para a WebApp |
|
Certificado SSL para um ASE ILB ou um ASE V2 do ILB
|
Configura o certificado SSL predefinido para um ASE ILB ou ASE v2 ILB |
|
Integração de Aplicações Web com Key Vault
|
Implementar um certificado de Aplicação Web a partir de Key Vault segredo e utilizá-lo para criar um enlace SSL |
|
Aplicação Web com um domínio personalizado e enlace SSL opcional
|
Crie uma aplicação Web e com um domínio personalizado e, opcionalmente, adicione um certificado SSL para encriptação https. |
Definição de recurso do Terraform (fornecedor AzAPI)
O tipo de recurso de certificados pode ser implementado com operações que visam:
- Grupos de recursos
Para obter uma lista de propriedades alteradas em cada versão da API, veja registo de alterações.
Formato do recurso
Para criar um recurso Microsoft.Web/certificates, adicione o seguinte Terraform ao seu modelo.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Web/certificates@2021-01-15"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
body = jsonencode({
properties = {
canonicalName = "string"
domainValidationMethod = "string"
hostNames = [
"string"
]
keyVaultId = "string"
keyVaultSecretName = "string"
password = "string"
serverFarmId = "string"
}
kind = "string"
})
}
Valores de propriedade
certificados
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de recurso | "Microsoft.Web/certificates@2021-01-15" |
| name | O nome do recurso | cadeia (obrigatório) Limite de carateres: 1-260 Carateres válidos: Não é possível utilizar: / Não é possível terminar com espaço ou ponto final. |
| localização | Localização do Recurso. | cadeia (obrigatório) |
| parent_id | Para implementar num grupo de recursos, utilize o ID desse grupo de recursos. | cadeia (obrigatório) |
| etiquetas | Etiquetas de recursos. | Dicionário de nomes e valores de etiquetas. |
| tipo | Tipo de recurso. | string |
| propriedades | Propriedades específicas do recurso de certificado | CertificateProperties |
CertificateProperties
| Nome | Descrição | Valor |
|---|---|---|
| canonicalName | CNAME do certificado a emitir através de certificado gratuito | string |
| domainValidationMethod | Método de validação de domínio para certificado gratuito. Os valores possíveis incluem: "CNameValidationValue", "HttpTokenValidationValue" | string |
| hostNames | Os nomes de anfitrião a que o certificado se aplica. | cadeia[] |
| keyVaultId | Key Vault ID de recurso do CSM. | string |
| keyVaultSecretName | Key Vault nome do segredo. | string |
| palavra-passe | Palavra-passe do certificado. | string |
| pfxBlob | Blob Pfx. | |
| serverFarmId | ID de recurso do plano de Serviço de Aplicações associado, formatado como: "/subscriptions/{subscriptionID}/resourceGroups/{groupName}/providers/Microsoft.Web/serverfarms/{appServicePlanName}". | string |