

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Criar um token de acesso ao servidor Web do Apache Airflow
<a name="call-mwaa-apis-web"></a>

Você pode usar os comandos desta página para criar um token de acesso ao servidor Web. Um token de acesso permite acessar o ambiente do Amazon MWAA. Por exemplo, é possível obter um token e, em seguida, implantar DAGs de forma programática usando as APIs do Amazon MWAA. A seção a seguir inclui as etapas para criar um token da CLI do Apache Airflow usando a AWS CLI, um script bash, uma solicitação POST API ou um script Python. O token retornado na resposta é válido por 60 segundos.

**Importante**  
A partir de 19 de agosto de 2025, o Amazon MWAA adicionou suporte para endpoints IPv6 e agora oferece suporte a endpoints IPv4 e IPv6. A partir dessa data, todos os ambientes recém-criados passaram a usar domínios `.on.aws` para a interface de usuário (UI) do Airflow. Os clientes devem migrar sua interface de usuário do Airflow do domínio `.amazonaws.com` para o domínio `.on.aws` nos ambientes recém-criados. Os serviços de endpoint da nuvem privada virtual (VPC) para servidor web e banco de dados manterão seus domínios `.amazonaws.com` atuais sem a necessidade de alterações.

**Contents**
+ [Pré-requisitos](#call-mwaa-apis-web-prereqs)
  + [Acesso](#access-airflow-ui-prereqs-access)
  + [AWS CLI](#access-airflow-ui-prereqs-cli)
+ [Como usar o AWS CLI](#create-web-login-token-cli)
+ [Como usar um script bash](#create-web-login-token-bash)
+ [Como usar um script Python](#create-web-login-token-python)
+ [Próximas etapas](#mwaa-webcli-next-up)

## Pré-requisitos
<a name="call-mwaa-apis-web-prereqs"></a>

A seção a seguir descreve as etapas preliminares necessárias para usar os comandos e scripts desta página.

### Acesso
<a name="access-airflow-ui-prereqs-access"></a>
+ Acesso da Conta da AWS no AWS Identity and Access Management (IAM) à política de permissões do Amazon MWAA no [Política de acesso ao Apache Airflow UI: Amazon MWAAWeb ServerAccess](access-policies.md#web-ui-access).
+ Acesso da Conta da AWS no AWS Identity and Access Management (IAM) à política de permissões do Amazon MWAA [Política completa de acesso à API e ao console: Amazon MWAAFull ApiAccess](access-policies.md#full-access-policy).

### AWS CLI
<a name="access-airflow-ui-prereqs-cli"></a>

A AWS Command Line Interface (AWS CLI) é uma ferramenta de código aberto que pode ser usada para interagir com os serviços da AWS por meio de comandos no shell da linha de comando. Para concluir as etapas nesta página, é necessário o seguinte:
+ [AWS CLI – instalar a versão 2](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2.html).
+ [AWS CLI: configuração rápida com `aws configure`](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html).

## Como usar o AWS CLI
<a name="create-web-login-token-cli"></a>

O exemplo a seguir usa o comando [create-web–login-token](https://docs.aws.amazon.com/cli/latest/reference/mwaa/create-web-login-token.html) na AWS CLI para criar um token da CLI do Apache Airflow.

```
aws mwaa create-web-login-token --name YOUR_ENVIRONMENT_NAME
```

## Como usar um script bash
<a name="create-web-login-token-bash"></a>

O exemplo a seguir usa um script bash para chamar o comando [create-cli-token](https://docs.aws.amazon.com/cli/latest/reference/mwaa/create-web-login-token.html) na AWS CLI criar um token da CLI do Apache Airflow.

1. Copie o conteúdo da amostra de código a seguir e salve localmente como `get-web-token.sh`.

   ```
   #!/bin/bash
   HOST=YOUR_HOST_NAME
   YOUR_URL=https://$HOST/aws_mwaa/aws-console-sso?login=true#
   WEB_TOKEN=$(aws mwaa create-web-login-token --name YOUR_ENVIRONMENT_NAME --query WebToken --output text)
   echo $YOUR_URL$WEB_TOKEN
   ```

1. Substitua os espaços reservados em *vermelho* por `YOUR_HOST_NAME` e `YOUR_ENVIRONMENT_NAME`. Por exemplo, um nome de host para uma rede pública pode ser algo como (sem o *https://)*:

   ```
   123456a0-0101-2020-9e11-1b159eec9000.c2.us-east-1.airflow.amazonaws.com
   ```

1. (opcional) os usuários do macOS e do Linux podem precisar executar o comando a seguir para garantir que o script seja executável.

   ```
   chmod +x get-web-token.sh
   ```

1. Execute o script a seguir para obter um token de login na web.

   ```
   ./get-web-token.sh
   ```

   Seu prompt de comando exibe:

   ```
   https://123456a0-0101-2020-9e11-1b159eec9000.c2.us-east-1.airflow.amazonaws.com/aws_mwaa/aws-console-sso?login=true#{your-web-login-token}
   ```

## Como usar um script Python
<a name="create-web-login-token-python"></a>

O exemplo a seguir usa o método [boto3 create\$1web\$1login\$1token](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/mwaa.html#MWAA.Client.create_web_login_token) em um script Python para criar um token da CLI do Apache Airflow e acionar um DAG. É possível executar esse script fora do Amazon MWAA. Você só precisa instalar a biblioteca boto3. Talvez você queira criar um ambiente virtual para instalar a biblioteca. Ele pressupõe que você tenha [configurado as credenciais de autenticação da AWS](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html#configuration) para sua conta.

1. Copie o conteúdo da amostra de código a seguir e salve localmente como `create-web-login-token.py`.

   ```
   import boto3
     mwaa = boto3.client('mwaa')
     response = mwaa.create_web_login_token(
       Name="YOUR_ENVIRONMENT_NAME"
     )
     webServerHostName = response["WebServerHostname"]
     webToken = response["WebToken"]
     airflowUIUrl = 'https://{0}/aws_mwaa/aws-console-sso?login=true#{1}'.format(webServerHostName, webToken)
     print("Here is your Airflow UI URL: ")
     print(airflowUIUrl)
   ```

1. Substitua os espaços reservados em *vermelho* por `YOUR_ENVIRONMENT_NAME`.

1. Execute o script a seguir para obter um token de login na web.

   ```
   python3 create-web-login-token.py
   ```

## Próximas etapas
<a name="mwaa-webcli-next-up"></a>
+ Explore a operação da API Amazon MWAA usada para criar um token da CLI em [CreateCliToken](https://docs.aws.amazon.com/mwaa/latest/API/API_CreateWebLoginToken.html).