# Como apontar um domínio para a Azion

import Tabs from '~/components/tabs/Tabs'
import Code from '~/components/Code/Code.astro'

import Apiv4Rollout from '~/includes/snippets/apiv4Rollout/pt/snippet.mdx'

<Apiv4Rollout />

Se você já possui um domínio, pode associar o registro CNAME do seu domínio personalizado ao endereço do seu Azion Workload Domain, efetivamente direcionando acesso à sua application.

Antes de direcionar seu tráfego para a Azion, você pode testar seu domínio personalizado no edge localmente ao [fazer o staging da sua aplicação através do arquivo hosts](/pt-br/documentacao/produtos/guias/testar-edge-application-atraves-do-arquivo-hosts/).

:::note
Este processo exigirá que você associe um registro CNAME ao seu domínio. Para associar um registro ANAME, [migre seus nameservers para a Azion](/pt-br/documentacao/produtos/guias/migrar-ns-para-a-azion/).
:::

:::tip[Dica]
Neste guia, existem instruções separadas para API v3 e API v4. Se você não tem certeza de quais passos se aplicam à sua conta, consulte [o guia Verifique a migração da sua conta para a API v4](/pt-br/documentacao/produtos/guias/verificar-migracao-conta/) para determinar se sua conta já foi migrada.
:::

---

## Passo 1: Verifique o domínio personalizado

Para apontar seu domínio Azion para um domínio personalizado, você precisa listar os CNAMEs que deseja configurar para a aplicação:

<Tabs client:visible>
  <Fragment slot="tab.consoleworkloads">Console - Workloads</Fragment>
  <Fragment slot="tab.consoledomain">Console - Domains</Fragment>
  <Fragment slot="tab.apiv4">API v4</Fragment>
  <Fragment slot="tab.apiv3">API v3</Fragment>

<Fragment slot="panel.consoleworkloads">

1. Acesse o [Azion Console](/pt-br/documentacao/produtos/guias/como-acessar-o-azion-console/) > **Workloads**.
2. Clique no domínio que você deseja associar ao seu domínio personalizado.
3. Nos campos **Subdomain** e **Domain**, adicione os domínios personalizados para a aplicação. Por exemplo: `seudominio.com` e `*.seudominio.com`.
4. Desative a opção **Workload Domain Allow Access**.
5. Clique no botão **Save**.

Agora, seu Azion Workload está pronto para ser associado a um domínio personalizado no seu provedor de DNS.

</Fragment>

<Fragment slot="panel.consoledomain">

1. Acesse o [Azion Console](/pt-br/documentacao/produtos/guias/como-acessar-o-azion-console/) > **Domains**.
2. Clique no domínio que você deseja associar ao seu domínio personalizado.
3. No campo **CNAME**, adicione os domínios personalizados para a aplicação. Por exemplo: `seudominio.com` e `*.seudominio.com`.
4. Ative a opção **CNAME Access Only**.
5. Clique no botão **Save**.

Agora, seu domínio Azion está pronto para ser associado a um domínio personalizado no seu provedor de DNS.
</Fragment>

<Fragment slot="panel.apiv4">

1. Execute a seguinte requisição `GET` para recuperar o ID do seu workload, substituindo `[TOKEN VALUE]` pelo seu [personal token](/pt-br/documentacao/produtos/guias/personal-tokens/):

<Code lang="bash" code={`
curl --request GET \
  --url https://api.azion.com/v4/workspace/workloads \
  --header 'Accept: application/json' \
  --header 'Authorization: Token [TOKEN VALUE]'
`} />

2. Você receberá uma resposta semelhante a esta:

<Code lang="json" code={`
{
  "count": 3,
  "results": [
    {
      "id": "<workload_id>",
      "name": "My workload",
      "active": true,
      "last_editor": "your-email.example.com",
      "last_modified": "2025-08-06T17:53:47.460211Z",
      "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": [
        "xxxxxxx.azion.app"
      ],
      "workload_domain_allow_access": false,
      "workload_domain": "xxxxxxxx.map.azionedge.net",
      "product_version": "1.0"
    }
`} />

3. Localize o workload que você deseja vincular ao domínio personalizado e copie o valor `workload_id` recebido na resposta.
4. Execute uma requisição `PATCH`, substituindo `[TOKEN VALUE]` pelo seu [personal token](/pt-br/documentacao/produtos/guias/personal-tokens/) e adicionando o `workload_id` como um caminho, para atualizar o campo `domains` com os domínios que você deseja configurar:

<Code lang="bash" code={`
curl --request PATCH \
  --url https://api.azion.com/v4/workspace/workloads/<workload_id> \
  --header 'Accept: application/json' \
  --header 'Authorization: Token [TOKEN VALUE]' \
  --header 'Content-Type: application/json' \
  --data '{
    "domains": [
      "yourdomain.com",
      "*.yourdomain.com"
    ]
  }'
`} />

  | Chave | Descrição |
  | --- | --- |
  | `domains` | Aceita uma lista de CNAMEs para os workloads como valores. Por exemplo, `["*.seudominio.com", "*.seudominio.org"]`. |

:::tip
Se sua aplicação usa HTTPS, você pode combinar este processo com a [associação de um certificado digital](/pt-br/documentacao/produtos/guias/criar-certificado-digital/) ao seu domínio personalizado.
:::

5. Você deve receber uma resposta com os dados atualizados.
</Fragment>

<Fragment slot="panel.apiv3">

1. Execute a seguinte requisição `GET` para recuperar o ID do seu domínio, substituindo `[TOKEN VALUE]` pelo seu [personal token](/pt-br/documentacao/produtos/guias/personal-tokens/):

<Code lang="bash" code={`
curl --location 'https://api.azionapi.net/domains' \
--header 'Accept: application/json; version=3' \
--header 'Authorization: Token [TOKEN VALUE]' \
`} />

2. Você receberá uma resposta semelhante a esta:

<Code lang="json" code={`
{
    ...
    "results": [
        {
            "id": <domain_id>,
            "name": "seudominio.com CA1 DC-seudominio.com",
            "cnames": [],
            "cname_access_only": true,
            "digital_certificate_id": <digital_certificate_id>,
            "edge_application_id": <edge_application_id>,
            "is_active": true,
            "domain_name": "xxxxxxxxxx.map.azionedge.net"
        }
    ]
}
`} />

3. Localize o domínio que você deseja vincular ao domínio personalizado e copie o valor `domain_id` recebido na resposta.
4. Execute uma requisição `PATCH`, substituindo `[TOKEN VALUE]` pelo seu [personal token](/pt-br/documentacao/produtos/guias/personal-tokens/) e adicionando o `domain_id` como um caminho, para atualizar o campo `cnames` com os domínios que você deseja configurar:

<Code lang="bash" code={`
curl --location --request PATCH 'https://api.azionapi.net/domains/<domain_id>' \
--header 'Accept: application/json; version=3' \
--header 'Authorization: Token [TOKEN VALUE]' \
--header 'Content-Type: application/json' \
--data '{
    "cnames": [
        "seudominio.com",
        "*.seudominio.com"
    ]
}'
`} />

  | Chave | Descrição |
  | --- | --- |
  | `cnames` | Aceita uma lista de CNAMEs para os domínios como valores. Por exemplo, `["*.seudominio.com", "*.seudominio.org"]`. |

:::tip
Se sua application usa HTTPS, você pode combinar este processo com a [associação de um certificado digital](/pt-br/documentacao/produtos/guias/criar-certificado-digital/) ao seu domínio personalizado.
:::

5. Você deve receber uma resposta com os dados atualizados.
</Fragment>

</Tabs>

---

## Passo 2: Modifique os registros de domínio

Uma vez que você tenha um domínio, você precisa acessar seu provedor de DNS e localizar a área de **gerenciamento de registros**. Lá, você pode modificar cada entrada associada ao seu domínio. A entrada que você precisa associar ao seu domínio Azion é um registro **CNAME**.

:::note
Alguns serviços não permitem que você altere sua resolução ANAME diretamente. Para apontar seu registro ANAME para a sua aplicação, [migre seus nameservers para a Azion](/pt-br/documentacao/produtos/guias/migrar-ns-para-a-azion/).
:::

No seu provedor de DNS, você pode adicionar ou modificar um registro CNAME `www` e associá-lo à sua application. Veja a documentação sobre como editar registros de domínio de alguns dos provedores de DNS mais populares abaixo:

- [AWS Route53](https://aws.amazon.com/pt/getting-started/hands-on/get-a-domain/)
- [GoDaddy](https://www.godaddy.com/help/manage-dns-records-680)
- [Namecheap](https://www.namecheap.com/support/knowledgebase/article.aspx/767/10/how-to-change-dns-for-a-domain/)

Para configurar seus registros de DNS:

1. Faça login no seu provedor de DNS.
2. Escolha o seu domínio.
3. Localize a página onde você pode modificar os registros de DNS para o seu domínio.
4. Crie ou edite o registro CNAME `www` do seu domínio preenchendo as informações:

| Nome | Valor | Tipo |
| --- | --- | --- |
| `www` | `xxxxxxxxxx.map.azionedge.net` | CNAME |

:::tip
Alguns provedores permitem que você adicione um subdomínio wildcard (`*`) em vez de um subdomínio específico para cobrir todos os cenários. Desta forma, você não precisará especificar que `www.seudominio.com` e `blog.seudominio.com` apontam para a mesma application.
:::

5. Salve suas configurações.

Note que pode haver um atraso no tempo de propagação quando você acessa sua application. Se for o caso, [você pode executar o comando DIG](/pt-br/documentacao/produtos/guias/executar-o-comando-dig/) no seu terminal para verificar os registros de DNS do seu nó edge. Por exemplo:

<Code lang="bash" code={`
dig +short seudominio.org @200.0.0.0
`} />

Uma vez que as alterações tenham se propagado pelo edge, você poderá acessar sua application através do seu domínio personalizado.

:::tip
Confira a [documentação da API da Azion](https://api.azion.com/) para saber mais sobre todas as funcionalidades disponíveis via API.
:::