[JAWS-UG CLI] IAM:#28 APIGateway Lambda実行ポリシの作成


AWS CLIを利用して、API GatewayからLambdaへのアクセスが可能なIAMポリシを作成してみます。


前提条件
========


IAMへの権限
-----------

* IAMに対してフル権限があること。


AWS CLIのバージョン
-------------------

* 以下のバージョンで動作確認済

  * AWS CLI 1.9.8

```bash:コマンド:
aws --version
```

```text:結果(例):
      aws-cli/1.9.8 Python/2.7.5 Darwin/13.4.0 botocore/1.3.0
```


0. 準備
=======


0.1. 変数の確認
---------------

プロファイルが想定のものになっていることを確認します。

```bash:変数の確認:
aws configure list
```

```text:結果(例):
            Name                    Value             Type    Location
            ----                    -----             ----    --------
         profile       iamFull-prjZ-mbp13              env    AWS_DEFAULT_PROFILE
      access_key     ****************LOAQ shared-credentials-file
      secret_key     ****************I1O1 shared-credentials-file
          region                us-west-2      config-file    ~/.aws/config
```


0.2. AWSアカウントIDの取得
--------------------------

```bash:コマンド:
AWS_ID=$( \
  aws sts get-caller-identity \
    --query 'Account' \
    --output text \
) \
        && echo ${AWS_ID}
```

```text:結果(例):
      XXXXXXXXXXXX
```


1. 事前作業
===========


1.1. IAMポリシー名の決定
------------------------

ポリシー名を決めます。

```bash:コマンド:
IAM_POLICY_NAME='APIGatewayLambdaExecPolicy'
```

同じ名前のポリシーが無いことを確認します。

```bash:コマンド:
aws iam get-policy \
        --policy-arn arn:aws:iam::${AWS_ID}:policy/${IAM_POLICY_NAME}
```

```text:結果(例)
      A client error (NoSuchEntity) occurred when calling the GetPolicy operation: Policy arn:aws:iam::XXXXXXXXXXXX:policy/APIGatewayLambdaExecPolicy does not exist.
```


2. IAMポリシードキュメントの作成
================================

ポリシードキュメントのファイル名を決めます。

```bash:コマンド:
FILE_POLICY_DOC="${IAM_POLICY_NAME}.json" \
        && echo ${FILE_POLICY_DOC}
```

ポリシードキュメントを作成します。
今回は、CloudWatch Logsへのアクセスを許可します。

```bash:コマンド:
cat << EOF > ${FILE_POLICY_DOC}
{
  "Version": "2012-10-17", 
  "Statement": [
    {
      "Action": [ 
        "logs:*"
      ],
      "Effect": "Allow", 
      "Resource": "arn:aws:logs:*:*:*"
    }
  ]
}
EOF

cat ${FILE_POLICY_DOC}
```

JSONファイルを作成したら、フォーマットが壊れてないか必ず確認します。

```bash:コマンド:
jsonlint -q ${FILE_POLICY_DOC}
```

エラーが出力されなければOKです。


3. IAMポリシーの作成
====================

```bash:コマンド:
cat << ETX

          IAM_POLICY_NAME: ${IAM_POLICY_NAME}
          FILE_POLICY_DOC: ${FILE_POLICY_DOC}

ETX
```

```bash:コマンド:
aws iam create-policy \
        --policy-name ${IAM_POLICY_NAME} \
        --policy-document file://${FILE_POLICY_DOC}
```

```json:結果(例):
      {
        "Policy": {
          "PolicyName": "APIGatewayLambdaExecPolicy",
          "CreateDate": "2015-10-23T01:17:49.074Z",
          "AttachmentCount": 0,
          "IsAttachable": true,
          "PolicyId": "ANPAXXXXXXXXXXXXXXXXX",
          "DefaultVersionId": "v1",
          "Path": "/",
          "Arn": "arn:aws:iam::XXXXXXXXXXXX:policy/APIGatewayLambdaExecPolicy",
          "UpdateDate": "2015-10-23T01:17:49.074Z"
        }
      }
```


4. IAMポリシーの確認
====================

ARNを取得します。

```bash:コマンド:
IAM_POLICY_ARN=$( \
        aws iam list-policies \
          --scope Local \
          --max-items 1000 \
          --query "Policies[?PolicyName==\`${IAM_POLICY_NAME}\`].Arn" \
          --output text \
      ) \
        && echo "${IAM_POLICY_ARN}"
```

```text:結果(例):
      arn:aws:iam::XXXXXXXXXXXX:policy/APIGatewayLambdaExecPolicy
```

ポリシのバージョンを取得します。

```bash:コマンド:
IAM_POLICY_VERSION=$( \
        aws iam list-policies \
          --scope Local \
          --max-items 1000 \
          --query "Policies[?PolicyName==\`${IAM_POLICY_NAME}\`].DefaultVersionId" \
          --output text \
      ) \
        && echo ${IAM_POLICY_VERSION}
```

```text:結果(例):
      v1
```

ポリシの内容を見てみましょう。

```bash:コマンド:
aws iam get-policy-version \
        --policy-arn ${IAM_POLICY_ARN} \
        --version-id ${IAM_POLICY_VERSION}
```

```json:結果(例):
{
    "PolicyVersion": {
        "CreateDate": "2015-11-21T05:16:28Z", 
        "VersionId": "v1", 
        "Document": {
            "Version": "2012-10-17", 
            "Statement": [
                {
                    "Action": [
                        "logs:*"
                    ], 
                    "Resource": "arn:aws:logs:*:*:*", 
                    "Effect": "Allow"
                }
            ]
        }, 
        "IsDefaultVersion": true
    }
}
```


完了
====