Como configurar um domínio

Com a Azion, você pode criar e executar aplicações diretamente no edge. Para permitir o acesso à sua aplicação através do navegador e começar a receber usuários e monitorar métricas, você precisa de um domínio.

Para criar um endereço de domínio gratuito para sua aplicação no formato xxxxxxxxxx.map.azionedge.net, siga os passos na aba apropriada abaixo. Há instruções separadas para as configurações do Domains legado e para o novo produto Workloads.

Configure um domínio com a Azion

Para criar um novo Workload:

Acesse o Azion Console > Workloads.
Clique no botão + Workload.
Dê um nome a seu Workload.
Selecione a Infrastructure para seu Workload: Production Infrastructure ou Staging Infrastructure (ambiente para testes).
Defina os hostnames da sua aplicação nos campos Subdomain e Domain. Você pode utilizar endereços de domínios personalizados para vincular à sua aplicação.
Em Edge Application, selecione sua Edge Application.
Em Edge Firewall, selecione your edge firewall.
Em Digital Certificate, selecione, crie um novo, ou use o certificado Azion SAN se você pretende usar o Azion Custom Domain ou o Workload Domain.
Clique no botão Save.

Aguarde alguns minutos para que seu novo Workload se propague para os edge nodes e acesse o endereço xxxxxxxxxx.map.azionedge.net para visualizar sua edge application online.

Acesse o Azion Console > Domains.
Clique no botão + Domain.
Dê um nome ao seu domínio.
Selecione o Environment Type para seu domínio: Global Edge Network (ambiente de produção) ou Staging Network (ambiente de teste).
Em Edge Application, selecione sua edge application.
Em Edge Firewall, selecione seu edge firewall.
Desative CNAME Access Only. Isso permitirá que os usuários acessem sua aplicação usando o endereço xxxxxxxxxx.map.azionedge.net.
No campo CNAME, você pode listar endereços de domínios personalizados para vincular à sua aplicação.
Em Digital Certificate, selecione o certificado Azion SAN.
Clique no botão Save.

Aguarde alguns minutos para que seu novo domínio se propague para os edge nodes e acesse o endereço xxxxxxxxxx.map.azionedge.net para visualizar sua edge application online.

Execute a seguinte requisição POST, substituindo [TOKEN VALUE] pelo seu personal token, a variável <edge_application_id> pelo ID da sua edge application:

curl --location 'https://api.azionapi.net/domains' --header 'Accept: application/json; version=3' --header 'Authorization: Token [TOKEN VALUE]'--header 'Content-Type: application/json' --data '{
  "name": "Example CN0 DC0",
  "cname_access_only": false,
  "digital_certificate_id": null,
  "edge_application_id": "<edge_application_id>"
}'

Chave	Descrição
`name`	Define a string no valor como um nome da entrada do domínio com a Azion. Como este valor não representa um endereço de domínio, você pode modificá-lo para se adequar às suas necessidades.
`cname_access_only`	Quando definido como `false`, permite o acesso via endereço Azion.
`digital_certificate_id`	Quando `null`, seleciona o certificado Azion SAN. Você também pode associar um certificado digital a seu domínio.
`edge_application_id`	O ID da edge application vinculada ao domínio.

Você receberá uma resposta semelhante a:

{
    "results": {
        "id": "<domain_id>",
        "name": "Example CN0 DC0",
        "cnames": [],
        "cname_access_only": false,
        "digital_certificate_id": null,
        "edge_application_id": "<edge_application_id>",
        "is_active": true,
        "domain_name": "xxxxxxxxxx.map.azionedge.net",
        "is_mtls_enabled": false,
        "mtls_verification": "enforce",
        "mtls_trusted_ca_certificate_id": null
    }
}

O domain_name recebido na resposta carrega o endereço do domínio Azion da sua application como uma string. Aguarde alguns minutos para que as alterações se propaguem e cole essa URL em seu navegador para acessar a aplicação.

Execute a seguinte requisição POST, substituindo [TOKEN VALUE] pelo seu personal token para criar um novo Workload.

curl --request POST --url https://api.azion.com/v4/workspace/workloads --header 'Accept: application/json' --header 'Authorization: Token [TOKEN VALUE]' --header 'Content-Type: application/json' --data '{
  "name": "Example CN0 DC0",
  "active": true,
  "infrastructure": 1,
  "protocols": {
    "http": {
      "versions": [
        "http1",
        "http2"
      ]
    }
  },
  "workload_domain_allow_access": true
}'

Chave	Descrição
`name`	Define a string no valor como um nome da entrada do domínio com a Azion. Como este valor não representa um endereço de domínio, você pode modificá-lo para se adequar às suas necessidades.
`workload_domain_allow_access`	Quando definido como `true`, permite o acesso via endereço Azion `xxxxxxxxxx.map.azionedge.net`.
`infrastructure`	Infraestrutura para seu Workload: Production Infrastructure (1) ou Staging Infrastructure (2).
`digital_certificate_id`	Quando `null`, seleciona o certificado Azion SAN. Você também pode associar um certificado digital a seu Workload.

Você receberá uma resposta semelhante a:

{
"state": "pending",
"data": {
  "id": "<workload_id>",
  "name": "Example CN0 DC0",
  "active": true,
  "last_editor": "your-email@example.com",
  "last_modified": "2025-07-25T18:58:25.817955Z",
  "infrastructure": 1,
  "tls": {
    "certificate": null,
    "ciphers": 7,
    "minimum_version": "tls_1_3"
  },
  "protocols": {
    "http": {
      "versions": [
        "http1",
        "http2"
      ],
      "http_ports": [
        80
      ],
      "https_ports": [
        443
      ],
      "quic_ports": null
    }
  },
  "mtls": {
    "verification": null,
    "certificate": null,
    "crl": null
  },
  "domains": [],
  "workload_domain_allow_access": true,
  "workload_domain": "xxxxxxxxxxx.azionedge.net",
  "product_version": "1.0"
}
}

Copie a URL no campo workload_domain e cole em um editor de texto para acessar posteriormente.
Agora você deve vincular o Workload criado a uma Edge Application. Isso é feito criando um Workload Deployment. Execute a seguinte requisição POST em seu terminal, substituindo [TOKEN VALUE] pelo seu token pessoal, <edge_application_id> pelo ID da Edge Application desejada e <workload_id> pelo ID do Workload que você criou na etapa anterior.

curl --request POST --url https://api.azion.com/v4/workspace/workloads/"<workload_id>"/deployments --header 'Accept: application/json' --header 'Authorization: Token [TOKEN VALUE]' --header 'Content-Type: application/json' --data '{
  "name": "My Workload Deployment",
  "current": true,
  "active": true,
  "strategy": {
    "type": "default",
    "attributes": {
      "edge_application": "<edge_application_id>"
    }
  }
}'

O workload_domain recebido na resposta carrega o endereço do domínio Azion da sua application como uma string. Aguarde alguns minutos para que as alterações se propaguem e cole essa URL em seu navegador para acessar a aplicação.

Vincule um domínio personalizado à sua application

Além do domínio Azion padrão, você tem a opção de associar um domínio personalizado no formato CNAME, como seudominio.com, à sua aplicação. Isso permite que você personalize o nome do domínio que os usuários usarão para acessar sua aplicação.

Quando um usuário insere o nome do domínio em seu navegador, é iniciado um processo de DNS lookup. Durante esse processo, o navegador do usuário envia uma requisição a um servidor DNS para encontrar o endereço IP associado ao domínio. Logo, o servidor DNS verifica sua base de dados para encontrar o endereço IP correspondente ao nome do domínio. Se o domínio estiver configurado para apontar para o domínio Azion, o servidor DNS retorna o endereço IP do edge node mais próximo na edge network.

Uma vez que o navegador recebe o endereço IP, ele estabelece uma conexão com o edge node apropriado. O edge node então serve o conteúdo solicitado e o navegador entrega a edge application.

Para personalizar o domínio de sua edge application, você pode optar por associar um registro de domínio ou migrar nameservers para a Azion.