Identity and Access Management no Amazon OpenSearch Service

O Amazon OpenSearch Service oferece várias maneiras de controlar o acesso aos seus domínios. Esta seção aborda os diversos tipos de políticas, como elass interagem entre si e como você pode criar suas próprias políticas personalizadas.

Tipos de políticas

OpenSearch O serviço oferece suporte a três tipos de políticas de acesso:

Políticas baseadas no recurso

Quando um domínio é criado, uma política baseada em recurso é adicionada, muitas vezes chamada de política de acesso ao domínio. Essas políticas especificam que ações uma entidade principal pode executar nos sub-recursos do domínio (com exceção da pesquisa entre clusters). Os sub-recursos incluem OpenSearch índices e. APIs O elemento Principal especifica as contas, os usuários ou as funções com acesso permitido. O elemento Resource especifica quais sub-recursos essas entidades principais podem acessar.

Por exemplo, a política baseada em recurso a seguir concede ao test-user (es:*) acesso total aos sub-recursos em test-domain:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "AWS": [
          "arn:aws:iam::123456789012:user/test-user"
        ]
      },
      "Action": [
        "es:*"
      ],
      "Resource": "arn:aws:es:us-west-1:987654321098:domain/test-domain/*"
    }
  ]
}

Duas considerações importantes se aplicam a essa política:

Você pode especificar um nome de índice parcial adicionando um curinga. Este exemplo identifica todos os índices que começam com commerce:

arn:aws:es:us-west-1:987654321098:domain/test-domain/commerce*

Nesse caso, o curinga significa que o test-user pode fazer solicitações para índices em test-domain que tenham nomes que comecem com commerce.

Para restringir ainda mais o test-user, você pode aplicar a seguinte política:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "AWS": [
          "arn:aws:iam::123456789012:user/test-user"
        ]
      },
      "Action": [
        "es:ESHttpGet"
      ],
      "Resource": "arn:aws:es:us-west-1:987654321098:domain/test-domain/commerce-data/_search"
    }
  ]
}

Agora, o test-user só pode executar uma operação: pesquisar no índice commerce-data. Todos os outros índices no domínio estão inacessíveis, e sem permissões para usar as ações es:ESHttpPut ou es:ESHttpPost, o test-user não pode adicionar ou modificar documentos.

Em seguida, você pode optar por configurar uma função para usuários avançados. Essa política dá power-user-role acesso aos PUT métodos HTTP GET e para todos URIs no índice:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "AWS": [
          "arn:aws:iam::123456789012:role/power-user-role"
        ]
      },
      "Action": [
        "es:ESHttpGet",
        "es:ESHttpPut"
      ],
      "Resource": "arn:aws:es:us-west-1:987654321098:domain/test-domain/commerce-data/*"
    }
  ]
}

Se seu domínio estiver em um VPC ou usar um controle de acesso refinado, você poderá usar uma política de acesso de domínio aberto. Caso contrário, sua diretiva de acesso ao domínio deverá conter alguma restrição, seja por endereço IP ou principal.

Para obter informações sobre todas as ações disponíveis, consulte Referência de elementos da política. Para obter um controle muito mais granular sobre seus dados, use uma política de acesso a domínio aberto com controle de acesso refinado.

Políticas baseadas em identidade

Ao contrário das políticas baseadas em recursos, que fazem parte de cada domínio do OpenSearch Serviço, você anexa políticas baseadas em identidade aos usuários ou funções usando o AWS Identity and Access Management serviço (). IAM Assim como nas políticas baseadas em recursos, as políticas baseadas em identidade especificam quem pode acessar um serviço, quais ações podem ser executadas e, se aplicável, em quais recursos essas ações podem ser executadas.

As políticas baseadas em identidade tendem a ser mais genéricas, embora não exista essa exigência. Eles geralmente controlam somente as API ações de configuração que um usuário pode realizar. Depois de implementar essas políticas, você pode usar políticas baseadas em recursos (ou controle de acesso refinado) no OpenSearch Service para oferecer aos usuários acesso a índices e. OpenSearch APIs

Como as políticas baseadas em identidade são vinculadas a usuários ou funções (diretores), elas JSON não especificam um diretor. A política a seguir concede acesso a ações que começam com Describe e List. Essa combinação de ações fornece acesso somente leitura a configurações de domínio, mas não aos dados armazenados no próprio domínio:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Action": [
        "es:Describe*",
        "es:List*"
      ],
      "Effect": "Allow",
      "Resource": "*"
    }
  ]
}

Um administrador pode ter acesso total ao OpenSearch Serviço e a todos os dados armazenados em todos os domínios:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Action": [
        "es:*"
      ],
      "Effect": "Allow",
      "Resource": "*"
    }
  ]
}

As políticas baseadas em identidade permitem que você use tags para controlar o acesso à configuração. API A seguinte política, por exemplo, permitirá que os principais anexados visualizem e atualizem a configuração de um domínio se o domínio tiver a tag team:devops:

{
  "Version": "2012-10-17",
  "Statement": [{
    "Action": [
      "es:UpdateDomainConfig",
      "es:DescribeDomain",
      "es:DescribeDomainConfig"
    ],
    "Effect": "Allow",
    "Resource": "*",
    "Condition": {
      "ForAnyValue:StringEquals": {
        "aws:ResourceTag/team": [
          "devops"
        ]
      }
    }
  }]
}

Você também pode usar tags para controlar o acesso ao OpenSearch API. As políticas baseadas em tags OpenSearch API só se aplicam aos HTTP métodos. Por exemplo, a política a seguir permite que os diretores anexados enviem GET e PUT solicitem OpenSearch API se o domínio tiver a environment:production tag:

{
  "Version": "2012-10-17",
  "Statement": [{
    "Action": [
      "es:ESHttpGet",
      "es:ESHttpPut"
    ],
    "Effect": "Allow",
    "Resource": "*",
    "Condition": {
      "ForAnyValue:StringEquals": {
        "aws:ResourceTag/environment": [
          "production"
        ]
      }
    }
  }]
}

Para um controle mais granular do OpenSearch API, considere usar um controle de acesso refinado.

OpenSearch O serviço suporta as chaves de condição TagKeys globais RequestTag e as chaves de condição para a configuraçãoAPI, não OpenSearch API o. Essas condições se aplicam somente às API chamadas que incluem tags na solicitaçãoCreateDomain, comoAddTags, RemoveTags e. A política a seguir permite que os principais anexados criem domínios, mas somente se incluírem a tag team:it na solicitação:

{
  "Version": "2012-10-17",
  "Statement": {
    "Effect": "Allow",
    "Action": [
      "es:CreateDomain",
      "es:AddTags"
    ],
    "Resource": "*",
    "Condition": {
      "StringEquals": {
        "aws:RequestTag/team": [
          "it"
        ]
      }
    }
  }
}

Para obter mais detalhes sobre o uso de tags para controle de acesso e as diferenças entre políticas baseadas em recursos e baseadas em identidade, consulte o Guia do usuário. IAM

Políticas baseadas em IP

As políticas baseadas em IP restringem o acesso a um domínio a um ou mais endereços IP ou CIDR blocos. Tecnicamente, as políticas baseadas em IP não são um tipo de política diferente. Na verdade, elas são apenas políticas baseadas em recursos que especificam uma entidade principal anônima e incluem um elemento Condition especial.

O principal atrativo das políticas baseadas em IP é que elas permitem solicitações não assinadas a um domínio de OpenSearch serviço, o que permite usar clientes como curl e OpenSearch painéis ou acessar o domínio por meio de um servidor proxy. Para saber mais, consulte Usando um proxy para acessar o OpenSearch serviço a partir de OpenSearch painéis.

A política a seguir concede acesso a todas as HTTP solicitações originadas do intervalo de IP especificado atest-domain:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "AWS": "*"
      },
      "Action": [
        "es:ESHttp*"
      ],
      "Condition": {
        "IpAddress": {
          "aws:SourceIp": [
            "192.0.2.0/24"
          ]
        }
      },
      "Resource": "arn:aws:es:us-west-1:987654321098:domain/test-domain/*"
    }
  ]
}

Se seu domínio tem um endpoint público e não usa controle de acesso refinado, recomendamos combinar endereços IAM principais e IP. Essa política concede test-user HTTP acesso somente se a solicitação for originada do intervalo de IP especificado:

{
  "Version": "2012-10-17",
  "Statement": [{
    "Effect": "Allow",
    "Principal": {
      "AWS": [
        "arn:aws:iam::987654321098:user/test-user"
      ]
    },
    "Action": [
      "es:ESHttp*"
    ],
    "Condition": {
      "IpAddress": {
        "aws:SourceIp": [
          "192.0.2.0/24"
        ]
      }
    },
    "Resource": "arn:aws:es:us-west-1:987654321098:domain/test-domain/*"
  }]
}

Fazendo e assinando solicitações OpenSearch de serviço

Mesmo se você configurar uma política de acesso totalmente aberta baseada em recursos, todas as solicitações para a configuração do OpenSearch Serviço API devem ser assinadas. Se suas políticas especificarem IAM funções ou usuários, as solicitações para o OpenSearch APIs também deverão ser assinadas usando o AWS Signature Version 4. O método de assinatura difere emAPI:

Quando há colisão de políticas

Quando as políticas discordam entre si ou não fazem nenhuma referência explícita a um usuário, surgem complexidades. Entender como IAM funciona o Guia IAM do Usuário fornece um resumo conciso da lógica de avaliação de políticas:

Por exemplo, se uma política baseada em recursos conceder acesso a um sub-recurso de domínio (um OpenSearch índice ouAPI), mas uma política baseada em identidade negar seu acesso, você terá acesso negado. Se uma política baseada em identidade concede acesso e uma política baseada em recursos não especifica se você deve ou não ter acesso, esse acesso é concedido. Consulte a tabela a seguir com o cruzamento de políticas para obter um resumo completo dos resultados para sub-recursos de domínios.

Referência de elementos da política

OpenSearch O serviço oferece suporte à maioria dos elementos de IAMpolítica na Referência de Elementos de Política, com exceção deNotPrincipal. A tabela a seguir mostra os elementos mais comuns.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "es:ESHttpGet",
        "es:DescribeDomain"
      ],
      "Resource": "*"
    }
  ]
}

"Condition": {
  "IpAddress": {
    "aws:SourceIp": [
      "192.0.2.0/32"
    ]
  }
}

Opções e API considerações avançadas

OpenSearch O serviço tem várias opções avançadas, uma das quais tem implicações de controle de acesso:rest.action.multi.allow_explicit_index. Como sua configuração padrão é verdadeiro, ela permite que os usuários ignorem as permissões de sub-recursos em determinadas circunstâncias.

Por exemplo, considere a seguinte política baseada em recurso:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "AWS": [
          "arn:aws:iam::123456789012:user/test-user"
        ]
      },
      "Action": [
        "es:ESHttp*"
      ],
      "Resource": [
        "arn:aws:es:us-west-1:987654321098:domain/test-domain/test-index/*",
        "arn:aws:es:us-west-1:987654321098:domain/test-domain/_bulk"
      ]
    },
    {
      "Effect": "Allow",
      "Principal": {
        "AWS": [
          "arn:aws:iam::123456789012:user/test-user"
        ]
      },
      "Action": [
        "es:ESHttpGet"
      ],
      "Resource": "arn:aws:es:us-west-1:987654321098:domain/test-domain/restricted-index/*"
    }
  ]
}

Essa política concede acesso test-user total test-index e OpenSearch em massaAPI. Ela também permite solicitações GET ao restricted-index.

A seguinte solicitação de indexação, como você pode esperar, falha devido a um erro de permissão:

PUT https://search-test-domain.us-west-1.es.amazonaws.com/restricted-index/movie/1
{
  "title": "Your Name",
  "director": "Makoto Shinkai",
  "year": "2016"
}

Ao contrário do índiceAPI, o volume API permite criar, atualizar e excluir vários documentos em uma única chamada. No entanto, você geralmente especifica essas operações no corpo da solicitação, e não na solicitaçãoURL. Como o OpenSearch Service usa URLs para controlar o acesso aos sub-recursos do domínio, test-user pode, na verdade, usar a massa API para fazer alterações em. restricted-index Embora o usuário não tenha permissões POST no índice, a seguinte solicitação é bem-sucedida:

POST https://search-test-domain.us-west-1.es.amazonaws.com/_bulk
{ "index" : { "_index": "restricted-index", "_type" : "movie", "_id" : "1" } }
{ "title": "Your Name", "director": "Makoto Shinkai", "year": "2016" }

Nesta situação, a política de acesso não consegue cumprir o que pretendia. Para evitar que os usuários ignorem esses tipos de restrições, você pode alterar o rest.action.multi.allow_explicit_index para o valor falso. Se esse valor for falso, todas as chamadas para bulk, mget e msearch APIs que especificam nomes de índice no corpo da solicitação deixarão de funcionar. Em outras palavras, as chamadas para _bulk não funcionam mais, mas as chamadas para o test-index/_bulk funcionam. Este segundo endpoint contém um nome de índice, portanto, você não precisa especificar um no corpo da solicitação.

OpenSearch Os painéis dependem muito de mget e msearch, portanto, é improvável que funcionem corretamente após essa alteração. Para remediação parcial, você pode deixar rest.action.multi.allow_explicit_index como verdadeiro e negar a determinados usuários o acesso a um ou mais delesAPIs.

Para obter informações sobre como alterar essa configuração, consulte Configurações avançadas do cluster.

Da mesma forma, a seguinte política baseada em recursos contém dois problemas sutis:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::123456789012:user/test-user"
      },
      "Action": "es:ESHttp*",
      "Resource": "arn:aws:es:us-west-1:987654321098:domain/test-domain/*"
    },
    {
      "Effect": "Deny",
      "Principal": {
        "AWS": "arn:aws:iam::123456789012:user/test-user"
      },
      "Action": "es:ESHttp*",
      "Resource": "arn:aws:es:us-west-1:987654321098:domain/test-domain/restricted-index/*"
    }
  ]
}

Em vez de misturar permissões amplas e negações focadas, a abordagem mais segura é seguir o princípio do privilégio mínimo e conceder apenas as permissões necessárias para executar uma tarefa. Para obter mais informações sobre como controlar o acesso a índices ou OpenSearch operações individuais, consulteControle de acesso refinado no Amazon Service OpenSearch .

Configuração de políticas de acesso

Exemplos adicionais de políticas

Embora este capítulo inclua muitos exemplos de políticas, o controle de AWS acesso é um assunto complexo que é melhor compreendido por meio de exemplos. Para obter mais informações, consulte Exemplos de políticas IAM baseadas em identidade no Guia do IAMusuário.