Amazon Location Service의 자격 증명 기반 정책 예제

기본적으로 사용자와 역할에는 Amazon Location 리소스를 생성하거나 수정할 수 있는 권한이 없습니다. 또한 AWS Management Console, AWS Command Line Interface (AWS CLI) 또는 AWS API를 사용하여 작업을 수행할 수 없습니다. 사용자에게 사용자가 필요한 리소스에서 작업을 수행할 권한을 부여하려면 IAM 관리자가 IAM 정책을 생성하면 됩니다. 그런 다음 관리자가 IAM 정책을 역할에 추가하고, 사용자가 역할을 맡을 수 있습니다.

이러한 예제 JSON 정책 문서를 사용하여 IAM 자격 증명 기반 정책을 생성하는 방법을 알아보려면 IAM 사용 설명서의 IAM 정책 생성을 참조하세요.

각 리소스 유형에 대한 ARN 형식을 포함하여 Amazon Location에서 정의한 작업 및 리소스 유형에 대한 자세한 내용은 서비스 인증 참조에서 Amazon Location Service에 대한 작업, 리소스 및 조건 키를 참조하세요.

정책 모범 사례

자격 증명 기반 정책에 따라 계정에서 사용자가 Amazon Location 리소스를 생성, 액세스 또는 삭제할 수 있는지 여부가 결정됩니다. 이 작업으로 인해 AWS 계정에 비용이 발생할 수 있습니다. 자격 증명 기반 정책을 생성하거나 편집할 때는 다음 지침과 권장 사항을 따릅니다.

• AWS 관리형 정책으로 시작하고 최소 권한 권한으로 이동 — 사용자와 워크로드에 권한을 부여하려면 여러 일반적인 사용 사례에 권한을 부여하는 AWS 관리형 정책을 사용하세요. 해당 내용은 에서 사용할 수 있습니다. AWS 계정사용 사례에 맞는 AWS 고객 관리형 정책을 정의하여 권한을 더 줄이는 것이 좋습니다. 자세한 정보는 IAM 사용자 설명서의 AWS 관리형 정책 또는 AWS 직무에 대한 관리형 정책을 참조합니다.

• 최소 권한 적용 – IAM 정책을 사용하여 권한을 설정하는 경우 작업을 수행하는 데 필요한 권한만 부여합니다. 이렇게 하려면 least-privilege permissions(최소 권한)으로 알려진 특정 조건에서 특정 리소스에 대해 수행할 수 있는 작업을 정의합니다. IAM을 사용하여 권한을 적용하는 방법에 대한 자세한 정보는 IAM 사용자 설명서에 있는 IAM의 정책 및 권한을 참조합니다.

• Use conditions in IAM policies to further restrict access(IAM 정책의 조건을 사용하여 액세스 추가 제한) – 정책에 조건을 추가하여 작업 및 리소스에 대한 액세스를 제한할 수 있습니다. 예를 들어 SSL을 사용하여 모든 요청을 전송해야 한다고 지정하는 정책 조건을 생성할 수 있습니다. 예를 AWS 서비스들어 특정 작업을 통해 서비스 작업을 사용하는 경우 조건을 사용하여 서비스 작업에 대한 액세스 권한을 부여할 수도 AWS CloudFormation있습니다. 자세한 정보는 IAM 사용자 설명서의 IAM JSON 정책 요소: 조건을 참조합니다.

• IAM Access Analyzer를 통해 IAM 정책을 검증하여 안전하고 기능적인 권한 보장 – IAM Access Analyzer에서는 IAM 정책 언어(JSON)와 모범 사례가 정책에서 준수되도록 신규 및 기존 정책을 검증합니다. IAM Access Analyzer는 100개 이상의 정책 확인 항목과 실행 가능한 권장 사항을 제공하여 안전하고 기능적인 정책을 생성하도록 돕습니다. 자세한 정보는 IAM 사용자 설명서의 IAM Access Analyzer 정책 검증을 참조합니다.

• 멀티 팩터 인증 (MFA) 필요 - IAM 사용자 또는 루트 사용자가 필요한 시나리오가 있는 경우 추가 보안을 위해 AWS 계정MFA를 활성화하십시오. API 작업을 직접적으로 호출할 때 MFA가 필요하면 정책에 MFA 조건을 추가합니다. 자세한 정보는 IAM 사용자 설명서의 MFA 보호 API 액세스 구성을 참조합니다.

IAM의 모범 사례에 대한 자세한 내용은 IAM 사용 설명서의 IAM의 보안 모범 사례를 참조하세요.

Amazon Location 콘솔 사용

Amazon Location Service 콘솔에 액세스하려면 최소한의 권한 집합이 있어야 합니다. 이러한 권한을 통해 내 Amazon Location 리소스에 대한 세부 정보를 나열하고 볼 수 있어야 AWS 계정합니다. 최소 필수 권한보다 더 제한적인 ID 기반 정책을 만들면 콘솔이 해당 정책에 연결된 개체(사용자 또는 역할)에 대해 의도대로 작동하지 않습니다.

AWS CLI 또는 AWS API만 호출하는 사용자에게 최소 콘솔 권한을 허용할 필요는 없습니다. 그 대신, 수행하려는 API 작업과 일치하는 작업에만 액세스할 수 있도록 합니다.

사용자와 역할이 Amazon Location 콘솔을 사용할 수 있도록 하려면 엔터티에 다음 정책을 연결합니다. 자세한 내용은 IAM 사용 설명서의 사용자에게 권한 추가를 참조하세요.

다음 정책은 Amazon Location Service 콘솔에 대한 액세스 권한을 부여하여 AWS 계정의 Amazon Location 리소스에 대한 세부 정보를 생성, 삭제, 나열 및 확인할 수 있도록 합니다.

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

읽기 전용 권한을 부여하여 읽기 전용 액세스를 용이하게 할 수도 있습니다. 읽기 전용 권한을 사용하는 경우 사용자가 리소스 생성 또는 삭제와 같은 쓰기 작업을 시도하면 오류 메시지가 표시됩니다. 예시는 트래커 리소스에 대한 읽기 전용 정책에서 확인하세요.

사용자가 자신의 고유한 권한을 볼 수 있도록 허용

이 예제는 IAM 사용자가 자신의 사용자 자격 증명에 연결된 인라인 및 관리형 정책을 볼 수 있도록 허용하는 정책을 생성하는 방법을 보여줍니다. 이 정책에는 콘솔에서 AWS CLI 또는 AWS API를 사용하여 프로그래밍 방식으로 이 작업을 완료할 수 있는 권한이 포함됩니다.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "ViewOwnUserInfo",
            "Effect": "Allow",
            "Action": [
                "iam:GetUserPolicy",
                "iam:ListGroupsForUser",
                "iam:ListAttachedUserPolicies",
                "iam:ListUserPolicies",
                "iam:GetUser"
            ],
            "Resource": ["arn:aws:iam::*:user/${aws:username}"]
        },
        {
            "Sid": "NavigateInConsole",
            "Effect": "Allow",
            "Action": [
                "iam:GetGroupPolicy",
                "iam:GetPolicyVersion",
                "iam:GetPolicy",
                "iam:ListAttachedGroupPolicies",
                "iam:ListGroupPolicies",
                "iam:ListPolicyVersions",
                "iam:ListPolicies",
                "iam:ListUsers"
            ],
            "Resource": "*"
        }
    ]
}

정책에서 Amazon Location Service 리소스 사용

Amazon Location Service는 리소스에 다음과 같은 접두사를 사용합니다.

Amazon Location 리소스 접두사
Resource	리소스 접두사
맵 리소스	map
장소 리소스	place-index
경로 리소스	route-calculator
트래킹 리소스	tracker
지오펜스 컬렉션 리소스	geofence-collection

다음 ARN 구문을 사용합니다.

arn:Partition:geo:Region:Account:ResourcePrefix/ResourceName

ARN 형식에 대한 자세한 내용은 Amazon 리소스 이름 (ARN) 및 AWS 서비스 네임스페이스를 참조하십시오.

예제

• 다음 ARN을 사용하여 지정된 맵 리소스에 대한 액세스를 허용하세요.

  "Resource": "arn:aws:geo:us-west-2:account-id:map/map-resource-name"

• 특정 계정에 속하는 모든 map 리소스에 대한 액세스를 지정하려면 와일드카드(*)를 사용합니다.

  "Resource": "arn:aws:geo:us-west-2:account-id:map/*"

• 리소스 생성 작업과 같은 일부 Amazon Location 작업은 특정 리소스에서 수행할 수 없습니다. 이러한 경우, 와일드카드(*)를 사용해야 합니다.

  "Resource": "*"

Amazon Location 리소스 유형 및 해당 ARN 목록을 보려면 서비스 승인 참조에서 Amazon Location Service에서 정의한 리소스를 참조하세요. 각 리소스의 ARN을 지정할 수 있는 작업을 알아보려면 Amazon Location Service에서 정의한 작업을 참조하세요.

디바이스 위치 업데이트 권한

여러 트래커의 디바이스 위치를 업데이트하려면 사용자에게 하나 이상의 트래커 리소스에 대한 액세스 권한을 부여해야 합니다. 또한 사용자가 디바이스 위치를 일괄 업데이트할 수 있도록 허용해야 합니다.

이 예시에서는 Tracker1 및 Tracker2 리소스에 대한 액세스 권한을 부여하는 것 외에도 다음 정책은 Tracker1 및 Tracker2 리소스에 대해 geo:BatchUpdateDevicePosition 작업을 사용할 수 있는 권한을 부여합니다.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "UpdateDevicePositions",
      "Effect": "Allow",
      "Action": [
        "geo:BatchUpdateDevicePosition"
      ],
      "Resource": [
        "arn:aws:geo:us-west-2:account-id:tracker/Tracker1",
        "arn:aws:geo:us-west-2:account-id:tracker/Tracker2"
      ]
    }
  ]
}

사용자가 특정 디바이스의 디바이스 위치만 업데이트할 수 있도록 제한하려면 해당 디바이스 ID에 조건 키를 추가하면 됩니다.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "UpdateDevicePositions",
      "Effect": "Allow",
      "Action": [
        "geo:BatchUpdateDevicePosition"
      ],
      "Resource": [
        "arn:aws:geo:us-west-2:account-id:tracker/Tracker1",
        "arn:aws:geo:us-west-2:account-id:tracker/Tracker2"
      ],
      "Condition":{
        "ForAllValues:StringLike":{
          "geo:DeviceIds":[
            "deviceId"
          ]
        }
      }
    }
  ]
}

트래커 리소스에 대한 읽기 전용 정책

AWS 계정의 모든 트래커 리소스에 대한 읽기 전용 정책을 생성하려면 모든 트래커 리소스에 대한 액세스 권한을 부여해야 합니다. 또한 사용자에게 여러 디바이스의 위치를 가져오고, 단일 디바이스에서 디바이스 위치를 가져오고, 위치 기록을 가져오는 작업에 대한 액세스 권한을 부여할 수도 있습니다.

이 예에서 다음 정책은 다음 작업에 대한 권한을 부여합니다.

• 여러 디바이스의 위치를 검색할 geo:BatchGetDevicePosition 권한.

• 단일 디바이스의 위치를 검색할 geo:GetDevicePosition 권한.

• 한 디바이스의 위치 기록을 검색할 geo:GetDevicePositionHistory 권한.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "GetDevicePositions",
      "Effect": "Allow",
      "Action": [
        "geo:BatchGetDevicePosition",
        "geo:GetDevicePosition",
        "geo:GetDevicePositionHistory"
      ],
      "Resource": "arn:aws:geo:us-west-2:account-id:tracker/*"
    }
  ]
}

지오펜스 생성 정책

사용자가 지오펜스를 생성할 수 있도록 허용하는 정책을 만들려면 사용자가 지오펜스 컬렉션에 하나 이상의 지오펜스를 만들 수 있도록 허용하는 특정 작업에 대한 액세스 권한을 부여해야 합니다.

아래 정책은 컬렉션에 대한 다음 작업에 대한 권한을 부여합니다.

• 여러 지오펜스를 생성하는 geo:BatchPutGeofence.

• 단일 지오펜스를 생성하는 geo:PutGeofence.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "CreateGeofences",
      "Effect": "Allow",
      "Action": [
        "geo:BatchPutGeofence",
        "geo:PutGeofence"
      ],
      "Resource": "arn:aws:geo:us-west-2:account-id:geofence-collection/Collection"
    }
  ]
}

지오펜스에 대한 읽기 전용 정책

AWS 계정의 지오펜스 컬렉션에 저장된 지오펜스에 대한 읽기 전용 정책을 생성하려면 지오펜스를 저장하는 지오펜스 컬렉션에서 읽기 작업에 대한 액세스 권한을 부여해야 합니다.

아래 정책은 컬렉션에 대한 다음 작업에 대한 권한을 부여합니다.

• 지정된 지오펜스 컬렉션의 지오펜스를 나열할 geo:ListGeofences 권한.

• 지오펜스 컬렉션에서 지오펜스를 검색할 geo:GetGeofence 권한.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "GetGeofences",
      "Effect": "Allow",
      "Action": [
        "geo:ListGeofences",
        "geo:GetGeofence"
      ],
      "Resource": "arn:aws:geo:us-west-2:account-id:geofence-collection/Collection"
    }
  ]
}

맵 리소스를 렌더링하기 위한 권한

맵을 렌더링할 수 있는 충분한 권한을 부여하려면 맵 타일, 스프라이트, 글리프, 스타일 설명자에 대한 액세스 권한을 부여해야 합니다.

• geo:GetMapTile은(는) 맵에서 지형지물을 선택적으로 렌더링하는 데 사용되는 맵 타일을 검색합니다.

• geo:GetMapSprites은(는) PNG 스프라이트 시트와 그 안의 오프셋을 설명하는 해당 JSON 문서를 검색합니다.

• geo:GetMapGlyphs은(는) 텍스트를 표시하는 데 사용되는 글리프를 검색합니다.

• geo:GetMapStyleDescriptor은(는) 렌더링 규칙이 포함된 맵의 스타일 설명자를 검색합니다.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "GetTiles",
      "Effect": "Allow",
      "Action": [
        "geo:GetMapTile",
        "geo:GetMapSprites",
        "geo:GetMapGlyphs",
        "geo:GetMapStyleDescriptor"
      ],
      "Resource": "arn:aws:geo:us-west-2:account-id:map/Map"
    }
  ]
}

검색 작업을 허용하는 권한

검색 작업을 허용하는 정책을 만들려면 먼저 AWS 계정의 장소 색인 리소스에 대한 액세스 권한을 부여해야 합니다. 또한 사용자가 지오코딩을 통해 텍스트를 사용하여 검색하고 역지오코딩으로 위치를 사용하여 검색할 수 있는 작업에 대한 액세스 권한을 부여할 수도 있습니다.

이 예제에서 다음 정책은 액세스 권한을 부여하는 것 외에도 다음 작업에 대한 권한도 부여합니다. PlaceIndex

• geo:SearchPlaceIndexForPosition(으)로 특정 위치 근처의 장소나 관심 장소를 검색할 수 있습니다.

• geo:SearchPlaceIndexForText(으)로 자유 형식 텍스트를 사용하여 주소, 이름, 도시 또는 리전을 검색할 수 있습니다.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "Search",
      "Effect": "Allow",
      "Action": [
        "geo:SearchPlaceIndexForPosition",
        "geo:SearchPlaceIndexForText"
      ],
      "Resource": "arn:aws:geo:us-west-2:account-id:place-index/PlaceIndex"
    }
  ]
}

경로 계산기에 대한 읽기 전용 정책

사용자가 경로 계산기 리소스에 액세스하여 경로를 계산하도록 허용하는 읽기 전용 정책을 만들 수 있습니다.

이 예시에서는 액세스 권한을 부여하는 것 외에도 다음 정책에 따라 다음 작업에 대한 권한이 부여됩니다. ExampleCalculator

• geo:CalculateRoute은(는) 출발 위치, 목적지 위치, 웨이포인트 위치 목록을 고려하여 경로를 계산합니다.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "RoutesReadOnly",
      "Effect": "Allow",
      "Action": [
        "geo:CalculateRoute"
      ],
      "Resource": "arn:aws:geo:us-west-2:accountID:route-calculator/ExampleCalculator"
    }
  ]
}

조건 키를 기반으로 리소스 액세스 제어

지오펜스 또는 디바이스 위치를 사용할 수 있는 액세스 권한을 부여하는 IAM 정책을 생성할 때 조건 연산자를 사용하여 사용자가 액세스할 수 있는 지오펜스 또는 디바이스를 보다 정밀하게 제어할 수 있습니다. 정책의 Condition 요소에 지오펜스 ID 또는 디바이스 ID를 포함하여 이를 수행할 수 있습니다.

다음 예제 정책에서는 사용자가 특정 디바이스의 디바이스 위치를 업데이트하도록 허용하는 정책을 생성하는 방법을 보여줍니다.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "UpdateDevicePositions",
      "Effect": "Allow",
      "Action": [
        "geo:BatchUpdateDevicePosition"
      ],
      "Resource": [
        "arn:aws:geo:us-west-2:account-id:tracker/Tracker"
      ],
      "Condition":{
        "ForAllValues:StringLike":{
          "geo:DeviceIds":[
            "deviceId"
          ]
        }
      }
    }
  ]
}

태그를 기반으로 리소스에 대한 액세스 제어

Amazon Location 리소스 사용에 대한 액세스 권한을 부여하는 IAM 정책을 생성할 때 속성 기반 액세스 제어를 사용하여 사용자가 수정, 사용 또는 삭제할 수 있는 리소스를 더 잘 제어할 수 있습니다. 정책의 Condition 요소에 태그 정보를 포함하여 리소스 태그를 기반으로 액세스를 제어하면 됩니다.

다음 예제 정책은 사용자가 지오펜스를 생성하도록 허용하는 정책을 생성하는 방법을 보여줍니다. 이렇게 하면 컬렉션이라는 지오펜스 컬렉션에 하나 이상의 지오펜스를 만들 수 있는 다음 작업에 대한 권한이 부여됩니다.

• 여러 지오펜스를 생성하는 geo:BatchPutGeofence.

• 단일 지오펜스를 생성하는 geo:PutGeofence.

하지만 이 정책은 Condition 요소를 사용하여 컬렉션 태그 Owner에 해당 사용자의 사용자 이름 값이 있는 경우에만 권한을 부여합니다.

• 예를 들어 richard-roe(이)라는 사용자가 Amazon Location 컬렉션을 보려고 시도하는 경우 컬렉션에 Owner=richard-roe 또는 owner=richard-roe 태그를 지정해야 합니다. 그렇지 않으면 사용자는 액세스가 거부됩니다.

  참고

  조건 키 Owner은(는) 조건 키 이름이 대소문자를 구분하지 않기 때문에 Owner 및 owner 모두와 일치합니다. 자세한 정보는 IAM 사용 설명서의 IAM JSON 정책 요소: 조건을 참조하세요.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "CreateGeofencesIfOwner",
      "Effect": "Allow",
      "Action": [
        "geo:BatchPutGeofence",
        "geo:PutGeofence"
      ],
      "Resource": "arn:aws:geo:us-west-2:account-id:geofence-collection/Collection",
      "Condition": {
                "StringEquals": {"geo:ResourceTag/Owner": "${aws:username}"}
      }
    }
  ]
}

태그를 기반으로 AWS 리소스에 액세스할 권한을 정의하는 방법에 대한 자습서는 AWS Identity and Access Management 사용 설명서를 참조하세요.