Como acessar um ambiente do Amazon MWAA - Amazon Managed Workflows for Apache Airflow
Como funcionaAcesso total ao consoleAcesso total a uma APIAcesso de somente leitura ao consoleAcesso à IU do Apache AirflowAcesso à API REST do Apache AirflowAcesso à CLI do Apache AirflowComo criar uma política JSONExemplo de caso de usoPróximas etapas

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á.

Como acessar um ambiente do Amazon MWAA

Para usar o Amazon Managed Workflows for Apache Airflow, você deve usar uma conta e entidades do IAM com as permissões necessárias. Este tópico descreve as políticas de acesso que você pode anexar à sua equipe de desenvolvimento do Apache Airflow e aos usuários do Apache Airflow para seu ambiente Amazon Managed Workflows for Apache Airflow.

Recomendamos usar credenciais temporárias e configurar identidades federadas com grupos e perfis para acessar seus recursos do Amazon MWAA. Como prática recomendada, evite anexar políticas diretamente aos usuários do IAM e, em vez disso, defina grupos ou funções para fornecer acesso temporário aos AWS recursos.

Um perfil do IAM é uma identidade do IAM que você pode criar em sua conta que tem permissões específicas. Uma função do IAM é semelhante à de um usuário do IAM, pois é uma AWS identidade com políticas de permissões que determinam o que a identidade pode ou não fazer AWS. No entanto, em vez de ser exclusivamente associada a uma pessoa, o propósito do perfil é ser assumido por qualquer pessoa que precisar dele. Além disso, um perfil não tem credenciais de longo prazo padrão associadas a ele, como senha ou chaves de acesso. Em vez disso, quando você assumir um perfil, ele fornecerá credenciais de segurança temporárias para sua sessão de perfil.

Para atribuir permissões a identidades federadas, você pode criar um perfil e definir permissões para o perfil. Quando uma identidade federada é autenticada, essa identidade é associada ao perfil e recebe as permissões definidas por ele. Para ter mais informações sobre perfis para federação, consulte Criar um perfil para um provedor de identidade de terceiros (federação) no Guia do usuário do IAM. Se usar o Centro de Identidade do IAM, configure um conjunto de permissões. Para controlar o que suas identidades podem acessar após a autenticação, o Centro de Identidade do IAM correlaciona o conjunto de permissões a um perfil no IAM. Para obter informações sobre conjuntos de permissões, consulte Conjuntos de Permissões no Guia do Usuário do AWS IAM Identity Center .

Você pode usar uma função do IAM em sua conta para conceder outras Conta da AWS permissões para acessar os recursos da sua conta. Para ver um exemplo, consulte Tutorial: Delegar acesso ao Contas da AWS uso de funções do IAM no Guia do usuário do IAM.

Como funciona

Os recursos e serviços usados em um ambiente Amazon MWAA não estão acessíveis a todas as entidades AWS Identity and Access Management (IAM). Você deve criar uma política que conceda permissão aos usuários do Apache Airflow para acessar esses recursos. Por exemplo, é preciso conceder acesso à sua equipe de desenvolvimento do Apache Airflow.

O Amazon MWAA usa essas políticas para validar se um usuário tem as permissões necessárias para realizar uma ação no AWS console ou por meio da APIs usada por um ambiente.

Você pode usar as políticas JSON desse tópico para criar uma política para seus usuários do Apache Airflow no IAM e, em seguida, anexar a política a um usuário, grupo ou perfil no IAM.

Para conceder acesso, adicione as permissões aos seus usuários, grupos ou perfis:

Política completa de acesso ao console: Amazon MWAAFull ConsoleAccess

Um usuário pode precisar acessar a política de permissões AmazonMWAAFullConsoleAccess se precisar configurar um ambiente no console do Amazon MWAA.

nota

Sua política completa de acesso ao console deve incluir permissões para executar iam:PassRole. Isso permite que o usuário transfira perfis vinculados a serviços e perfis de execução ao Amazon MWAA. O Amazon MWAA assume cada função para chamar outros AWS serviços em seu nome. O exemplo a seguir usa a chave de condição iam:PassedToService para especificar a entidade principal de serviço do Amazon MWAA (airflow.amazonaws.com) como o serviço para o qual um perfil pode ser transferido.

Para obter mais informações sobre issoiam:PassRole, consulte Conceder permissões a um usuário para passar uma função para um AWS serviço no Guia do usuário do IAM.

Use a política a seguir se quiser criar e gerenciar seus ambientes do Amazon MWAA usando uma Chave pertencente à AWS para criptografia em repouso. 

{
   "Version":"2012-10-17",
   "Statement":[
      {
         "Effect":"Allow",
         "Action":"airflow:*",
         "Resource":"*"
      },
      {
         "Effect":"Allow",
         "Action":[
            "iam:PassRole"
         ],
         "Resource":"*",
         "Condition":{
            "StringLike":{
               "iam:PassedToService":"airflow.amazonaws.com"
            }
         }
      },
      {
         "Effect":"Allow",
         "Action":[
            "iam:ListRoles"
         ],
         "Resource":"*"
      },
      {
         "Effect":"Allow",
         "Action":[
            "iam:CreatePolicy"
         ],
         "Resource":"arn:aws:iam::YOUR_ACCOUNT_ID:policy/service-role/MWAA-Execution-Policy*"
      },
            {
         "Effect":"Allow",
         "Action":[
            "iam:AttachRolePolicy",
            "iam:CreateRole"
         ],
         "Resource":"arn:aws:iam::YOUR_ACCOUNT_ID:role/service-role/AmazonMWAA*"
      },
      {
         "Effect":"Allow",
         "Action":[
            "iam:CreateServiceLinkedRole"
         ],
         "Resource":"arn:aws:iam::*:role/aws-service-role/airflow.amazonaws.com/AWSServiceRoleForAmazonMWAA"
      },
      {
         "Effect":"Allow",
         "Action":[
            "s3:GetBucketLocation",
            "s3:ListAllMyBuckets",
            "s3:ListBucket",
            "s3:ListBucketVersions"
         ],
         "Resource":"*"
      },
      {
         "Effect":"Allow",
         "Action":[
            "s3:CreateBucket",
            "s3:PutObject",
            "s3:GetEncryptionConfiguration"
         ],
         "Resource":"arn:aws:s3:::*"
      },
      {
         "Effect":"Allow",
         "Action":[
            "ec2:DescribeSecurityGroups",
            "ec2:DescribeSubnets",
            "ec2:DescribeVpcs",
            "ec2:DescribeRouteTables"
         ],
         "Resource":"*"
      },
      {
         "Effect":"Allow",
         "Action":[
            "ec2:AuthorizeSecurityGroupIngress",
            "ec2:CreateSecurityGroup"
         ],
         "Resource":"arn:aws:ec2:*:*:security-group/airflow-security-group-*"
      },
      {
         "Effect":"Allow",
         "Action":[
            "kms:ListAliases"
         ],
         "Resource":"*"
      },
      {
         "Effect":"Allow",
         "Action":"ec2:CreateVpcEndpoint",
         "Resource":[
            "arn:aws:ec2:*:*:vpc-endpoint/*",
            "arn:aws:ec2:*:*:vpc/*",
            "arn:aws:ec2:*:*:subnet/*",
            "arn:aws:ec2:*:*:security-group/*"
         ]
      },
      {
         "Effect":"Allow",
         "Action":[
            "ec2:CreateNetworkInterface"
         ],
         "Resource":[
            "arn:aws:ec2:*:*:subnet/*",
            "arn:aws:ec2:*:*:network-interface/*"
         ]
      }
   ]
}

Use a política a seguir se quiser criar e gerenciar seus ambientes do Amazon MWAA usando uma chave gerenciada pelo cliente para criptografia em repouso. Para usar uma chave gerenciada pelo cliente, o diretor do IAM deve ter permissão para acessar AWS KMS recursos usando a chave armazenada em sua conta. 

{
   "Version":"2012-10-17",
   "Statement":[
      {
         "Effect":"Allow",
         "Action":"airflow:*",
         "Resource":"*"
      },
      {
         "Effect":"Allow",
         "Action":[
            "iam:PassRole"
         ],
         "Resource":"*",
         "Condition":{
            "StringLike":{
               "iam:PassedToService":"airflow.amazonaws.com"
            }
         }
      },
      {
         "Effect":"Allow",
         "Action":[
            "iam:ListRoles"
         ],
         "Resource":"*"
      },
      {
         "Effect":"Allow",
         "Action":[
            "iam:CreatePolicy"
         ],
         "Resource":"arn:aws:iam::YOUR_ACCOUNT_ID:policy/service-role/MWAA-Execution-Policy*"
      },
            {
         "Effect":"Allow",
         "Action":[
            "iam:AttachRolePolicy",
            "iam:CreateRole"
         ],
         "Resource":"arn:aws:iam::YOUR_ACCOUNT_ID:role/service-role/AmazonMWAA*"
      },
      {
         "Effect":"Allow",
         "Action":[
            "iam:CreateServiceLinkedRole"
         ],
         "Resource":"arn:aws:iam::*:role/aws-service-role/airflow.amazonaws.com/AWSServiceRoleForAmazonMWAA"
      },
      {
         "Effect":"Allow",
         "Action":[
            "s3:GetBucketLocation",
            "s3:ListAllMyBuckets",
            "s3:ListBucket",
            "s3:ListBucketVersions"
         ],
         "Resource":"*"
      },
      {
         "Effect":"Allow",
         "Action":[
            "s3:CreateBucket",
            "s3:PutObject",
            "s3:GetEncryptionConfiguration"
         ],
         "Resource":"arn:aws:s3:::*"
      },
      {
         "Effect":"Allow",
         "Action":[
            "ec2:DescribeSecurityGroups",
            "ec2:DescribeSubnets",
            "ec2:DescribeVpcs",
            "ec2:DescribeRouteTables"
         ],
         "Resource":"*"
      },
      {
         "Effect":"Allow",
         "Action":[
            "ec2:AuthorizeSecurityGroupIngress",
            "ec2:CreateSecurityGroup"
         ],
         "Resource":"arn:aws:ec2:*:*:security-group/airflow-security-group-*"
      },
      {
         "Effect":"Allow",
         "Action":[
            "kms:ListAliases"
         ],
         "Resource":"*"
      },
      {
         "Effect":"Allow",
         "Action":[
            "kms:DescribeKey",
            "kms:ListGrants",
            "kms:CreateGrant",
            "kms:RevokeGrant",
            "kms:Decrypt",
            "kms:Encrypt",
            "kms:GenerateDataKey*",
            "kms:ReEncrypt*"
         ],
         "Resource":"arn:aws:kms:*:YOUR_ACCOUNT_ID:key/YOUR_KMS_ID"
      },
      {
         "Effect":"Allow",
         "Action":"ec2:CreateVpcEndpoint",
         "Resource":[
            "arn:aws:ec2:*:*:vpc-endpoint/*",
            "arn:aws:ec2:*:*:vpc/*",
            "arn:aws:ec2:*:*:subnet/*",
            "arn:aws:ec2:*:*:security-group/*"
         ]
      },
      {
         "Effect":"Allow",
         "Action":[
            "ec2:CreateNetworkInterface"
         ],
         "Resource":[
            "arn:aws:ec2:*:*:subnet/*",
            "arn:aws:ec2:*:*:network-interface/*"
         ]
      }
   ]
}

Política completa de acesso à API e ao console: Amazon MWAAFull ApiAccess

Um usuário pode precisar acessar a política de AmazonMWAAFullApiAccess permissões se precisar acessar todo o Amazon MWAA APIs usado para gerenciar um ambiente. Ela não concede permissões para acesso da IU do Apache Airflow.

nota

Uma política de acesso completa à API deve incluir permissões para executar iam:PassRole. Isso permite que o usuário transfira perfis vinculados a serviços e perfis de execução ao Amazon MWAA. O Amazon MWAA assume cada função para chamar outros AWS serviços em seu nome. O exemplo a seguir usa a chave de condição iam:PassedToService para especificar a entidade principal de serviço do Amazon MWAA (airflow.amazonaws.com) como o serviço para o qual um perfil pode ser transferido.

Para obter mais informações sobre issoiam:PassRole, consulte Conceder permissões a um usuário para passar uma função para um AWS serviço no Guia do usuário do IAM.

Use a política a seguir se quiser criar e gerenciar seus ambientes Amazon MWAA usando uma Chave pertencente à AWS para criptografia em repouso. 

{
   "Version":"2012-10-17",
   "Statement":[
      {
         "Effect":"Allow",
         "Action":"airflow:*",
         "Resource":"*"
      },
      {
         "Effect":"Allow",
         "Action":[
            "iam:PassRole"
         ],
         "Resource":"*",
         "Condition":{
            "StringLike":{
               "iam:PassedToService":"airflow.amazonaws.com"
            }
         }
      },
      {
         "Effect":"Allow",
         "Action":[
            "iam:CreateServiceLinkedRole"
         ],
         "Resource":"arn:aws:iam::*:role/aws-service-role/airflow.amazonaws.com/AWSServiceRoleForAmazonMWAA"
      },
      {
         "Effect":"Allow",
         "Action":[
            "ec2:DescribeSecurityGroups",
            "ec2:DescribeSubnets",
            "ec2:DescribeVpcs",
            "ec2:DescribeRouteTables"
         ],
         "Resource":"*"
      },
      {
         "Effect":"Allow",
         "Action":[
            "s3:GetEncryptionConfiguration"
         ],
         "Resource":"arn:aws:s3:::*"
      },
      {
         "Effect":"Allow",
         "Action":"ec2:CreateVpcEndpoint",
         "Resource":[
            "arn:aws:ec2:*:*:vpc-endpoint/*",
            "arn:aws:ec2:*:*:vpc/*",
            "arn:aws:ec2:*:*:subnet/*",
            "arn:aws:ec2:*:*:security-group/*"
         ]
      },
      {
         "Effect":"Allow",
         "Action":[
            "ec2:CreateNetworkInterface"
         ],
         "Resource":[
            "arn:aws:ec2:*:*:subnet/*",
            "arn:aws:ec2:*:*:network-interface/*"
         ]
      }
   ]
}

Use a política a seguir se quiser criar e gerenciar seus ambientes do Amazon MWAA usando uma chave gerenciada pelo cliente para criptografia em repouso. Para usar uma chave gerenciada pelo cliente, o diretor do IAM deve ter permissão para acessar AWS KMS recursos usando a chave armazenada em sua conta. 

{
   "Version":"2012-10-17",
   "Statement":[
      {
         "Effect":"Allow",
         "Action":"airflow:*",
         "Resource":"*"
      },
      {
         "Effect":"Allow",
         "Action":[
            "iam:PassRole"
         ],
         "Resource":"*",
         "Condition":{
            "StringLike":{
               "iam:PassedToService":"airflow.amazonaws.com"
            }
         }
      },
      {
         "Effect":"Allow",
         "Action":[
            "iam:CreateServiceLinkedRole"
         ],
         "Resource":"arn:aws:iam::*:role/aws-service-role/airflow.amazonaws.com/AWSServiceRoleForAmazonMWAA"
      },
      {
         "Effect":"Allow",
         "Action":[
            "ec2:DescribeSecurityGroups",
            "ec2:DescribeSubnets",
            "ec2:DescribeVpcs",
            "ec2:DescribeRouteTables"
         ],
         "Resource":"*"
      },
      {
         "Effect":"Allow",
         "Action":[
            "kms:DescribeKey",
            "kms:ListGrants",
            "kms:CreateGrant",
            "kms:RevokeGrant",
            "kms:Decrypt",
            "kms:Encrypt",
            "kms:GenerateDataKey*",
            "kms:ReEncrypt*"
         ],
         "Resource":"arn:aws:kms:*:YOUR_ACCOUNT_ID:key/YOUR_KMS_ID"
      },
      {
         "Effect":"Allow",
         "Action":[
            "s3:GetEncryptionConfiguration"
         ],
         "Resource":"arn:aws:s3:::*"
      },
      {
         "Effect":"Allow",
         "Action":"ec2:CreateVpcEndpoint",
         "Resource":[
            "arn:aws:ec2:*:*:vpc-endpoint/*",
            "arn:aws:ec2:*:*:vpc/*",
            "arn:aws:ec2:*:*:subnet/*",
            "arn:aws:ec2:*:*:security-group/*"
         ]
      },
      {
         "Effect":"Allow",
         "Action":[
            "ec2:CreateNetworkInterface"
         ],
         "Resource":[
            "arn:aws:ec2:*:*:subnet/*",
            "arn:aws:ec2:*:*:network-interface/*"
         ]
      }
   ]
}

Política de acesso somente para leitura ao console: Amazon MWAARead OnlyAccess

Um usuário pode precisar acessar a política de permissões de AmazonMWAAReadOnlyAccess se precisar visualizar os recursos usados por um ambiente na página de detalhes do ambiente do console do Amazon MWAA. Ele não permite que um usuário crie novos ambientes, edite ambientes existentes ou permita que um usuário visualize a IU do Apache Airflow.

{
        "Version": "2012-10-17",
        "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "airflow:ListEnvironments",
                "airflow:GetEnvironment",
                "airflow:ListTagsForResource"
            ],
            "Resource": "*"
        }
    ]
}

Política de acesso ao Apache Airflow UI: Amazon MWAAWeb ServerAccess

Um usuário pode precisar acessar a política de permissões de AmazonMWAAWebServerAccess se precisar acessar a IU do Apache Airflow. Ele não permite que o usuário visualize ambientes no console do Amazon MWAA nem use o Amazon MWAA APIs para realizar nenhuma ação. Especifique o perfil Admin, Op, User, Viewer ou Public em {airflow-role} para personalizar o nível de acesso do usuário do token da web. Para obter mais informações, consulte Perfis padrão no Guia de referência do Apache Airflow.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "airflow:CreateWebLoginToken",
            "Resource": [
                "arn:aws:airflow:{your-region}:YOUR_ACCOUNT_ID:role/{your-environment-name}/{airflow-role}"
            ]
        }
    ]
}
nota

Política de acesso à API Apache Airflow Rest: Amazon MWAARest APIAccess

Para acessar a API REST do Apache Airflow, você deve conceder a permissão airflow:InvokeRestApi na política do IAM. No exemplo de política a seguir, especifique o Admin, Op, User, Viewer ou a função Public em {airflow-role} para personalizar o nível de acesso do usuário. Para obter mais informações, consulte Perfis padrão no Guia de referência do Apache Airflow. 

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AllowMwaaRestApiAccess",
      "Effect": "Allow",
      "Action": "airflow:InvokeRestApi",
      "Resource": [
        "arn:aws:airflow:{your-region}:YOUR_ACCOUNT_ID:role/{your-environment-name}/{airflow-role}"
      ]
    }
  ]
}
nota

  • Ao configurar um servidor Web privado, a ação InvokeRestApi não pode ser invocada de fora de uma nuvem privada virtual (VPC). Você pode usar a chave aws:SourceVpc para aplicar um controle de acesso mais granular para essa operação. Para obter mais informações, consulte aws: SourceVpc

  • O campo Resource nessa política pode ser usado para especificar as funções de controle de acesso baseadas em funções do Apache Airflow para o ambiente do Amazon MWAA. No entanto, ele não é compatível com o ARN (nome do recurso da Amazon) do ambiente do Amazon MWAA no campo Resource da política.

Política de CLI do Apache Airflow: Amazon MWAAAirflow CliAccess

Um usuário pode precisar acessar a política de permissões de AmazonMWAAAirflowCliAccess se precisar executar comandos de CLI do Apache Airflow (como trigger_dag). Ele não permite que o usuário visualize ambientes no console do Amazon MWAA nem use o Amazon MWAA APIs para realizar nenhuma ação. 

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "airflow:CreateCliToken"
            ],
            "Resource": "arn:aws:airflow:${Region}:${Account}:environment/${EnvironmentName}"
        }
    ]
}

Como criar uma política JSON

Você pode criar a política JSON e anexar a política ao seu usuário, perfil ou grupo no console do IAM. As etapas a seguir descrevem como criar uma política JSON no IAM.

Para criar política de JSON

  1. Abra a página de Políticas no console do IAM.

  2. Escolha Criar política.

  3. Escolha a guia JSON.

  4. Adicione sua política JSON.

  5. Escolha Revisar política.

  6. Insira um valor no campo de texto para Nome e Descrição.

    Por exemplo, você pode nomear a política AmazonMWAAReadOnlyAccess.

  7. Escolha Criar política.

Exemplo de caso de uso para anexar políticas a um grupo de desenvolvedores

Digamos que você esteja usando um grupo no IAM chamado AirflowDevelopmentGroup para aplicar permissões a todos os desenvolvedores da sua equipe de desenvolvimento do Apache Airflow. Esses usuários precisam acessar as políticas de permissão AmazonMWAAFullConsoleAccess, AmazonMWAAAirflowCliAccess e AmazonMWAAWebServerAccess. Esta seção descreve como criar um grupo no IAM, criar e anexar essas políticas, e associar o grupo a um usuário do IAM. As etapas pressupõem que você esteja usando uma chave pertencente àAWS.

Para criar a MWAAFull ConsoleAccess política da Amazon

  1. Baixe a política de MWAAFull ConsoleAccess acesso da Amazon.

  2. Abra a página de Políticas no console do IAM.

  3. Escolha Criar política.

  4. Escolha a guia JSON.

  5. Cole a política JSON para AmazonMWAAFullConsoleAccess.

  6. Substitua os seguintes valores:

    1. {your-account-id}— O ID AWS da sua conta (como0123456789)

    2. {your-kms-id}— O identificador exclusivo de uma chave gerenciada pelo cliente, aplicável somente se você usar uma chave gerenciada pelo cliente para criptografia em repouso.

  7. Escolha Revisar política.

  8. Digite AmazonMWAAFullConsoleAccess em Nome.

  9. Escolha Criar política.

Para criar a MWAAWeb ServerAccess política da Amazon

  1. Baixe a política de MWAAWeb ServerAccess acesso da Amazon.

  2. Abra a página de Políticas no console do IAM.

  3. Escolha Criar política.

  4. Escolha a guia JSON.

  5. Cole a política JSON para AmazonMWAAWebServerAccess.

  6. Substitua os seguintes valores:

    1. {your-region}— a região do seu ambiente Amazon MWAA (como) us-east-1

    2. {your-account-id}— o ID AWS da sua conta (como0123456789)

    3. {your-environment-name}— o nome do seu ambiente Amazon MWAA (como) MyAirflowEnvironment

    4. {airflow-role}— a função Admin padrão do Apache Airflow

  7. Escolha Revisar política.

  8. Digite AmazonMWAAWebServerAccess em Nome.

  9. Escolha Criar política.

Para criar a MWAAAirflow CliAccess política da Amazon

  1. Baixe a política de MWAAAirflow CliAccess acesso da Amazon.

  2. Abra a página de Políticas no console do IAM.

  3. Escolha Criar política.

  4. Escolha a guia JSON.

  5. Cole a política JSON para AmazonMWAAAirflowCliAccess.

  6. Escolha Revisar política.

  7. Digite AmazonMWAAAirflowCliAccess em Nome.

  8. Escolha Criar política.

Para criar o grupo

  1. Abra a página Grupos no console do IAM.

  2. Digite um nome de AirflowDevelopmentGroup.

  3. Escolha Próxima etapa.

  4. Digite AmazonMWAA para filtrar os resultados em Filtro.

  5. Selecione as três políticas que você criou.

  6. Escolha Próxima etapa.

  7. Selecione Criar grupo.

Para associar a um usuário

  1. Abra a página Usuários no console do IAM.

  2. Escolha um usuário.

  3. Selecione Grupos.

  4. Escolha Adicionar usuário aos grupos.

  5. Selecione o AirflowDevelopmentGroup.

  6. Selecione Add to Groups (Adicionar a grupos).

Próximas etapas