[JAWS-UG CLI] IAM #49 IAMポリシーの作成 (VpnConnMonitor)

AWS CLIを利用して、VPNコネクションの監視に必要なアクセスが可能なIAMポリシを作成してみます。


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


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

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


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

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

- AWS CLI 1.11.8

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

```text:結果(例):
      aws-cli/1.11.7 Python/2.7.11 Darwin/15.6.0 botocore/1.4.64
```

バージョンが古い場合は最新版に更新しましょう。

```bash:コマンド:
sudo -H pip install -U awscli
```


0. 準備
=======


変数の確認
----------

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

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

```text:結果(例):
            Name                    Value             Type    Location
            ----                    -----             ----    --------
         profile       lambdaFull-prjz-mbp13        env    AWS_DEFAULT_PROFILE
      access_key     ****************XXXX shared-credentials-file
      secret_key     ****************XXXX shared-credentials-file
          region        ap-northeast-1        env    AWS_DEFAULT_REGION
```


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


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

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

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


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

ポリシー名を決めます。

```bash:変数の設定:
IAM_POLICY_NAME='VpnConnMonitorRole'
```

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

```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/VpnConnMonitorRoledoes not exist.
```


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

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

```bash:変数の設定:
FILE_INPUT="${IAM_POLICY_NAME}.json" \
          && echo ${FILE_INPUT}
```

ポリシードキュメントを作成します。

```bash:コマンド:
cat << EOF > ${FILE_INPUT}
{
          "Version": "2012-10-17",
          "Statement": [
              {
                  "Effect": "Allow",
                  "Action": [
                    "ec2:DescribeRegions",
                    "ec2:DescribeVpnConnections"
                  ],
                  "Resource": "*"
              },
              {
                  "Effect": "Allow",
                  "Action": [
                    "cloudwatch:PutMetricData"
                  ],
                  "Resource": "*"
              }
          ]
}
EOF

cat ${FILE_INPUT}
```

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

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

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


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

```bash:変数の確認:
cat << ETX

        IAM_POLICY_NAME: ${IAM_POLICY_NAME}
        FILE_INPUT:      ${FILE_INPUT}

ETX
```

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

```json:結果(例):
      {
        "Policy": {
          "PolicyName": "VpnConnMonitorRole",
          "CreateDate": "2016-10-22T01:23:45.678Z",
          "AttachmentCount": 0,
          "IsAttachable": true,
          "PolicyId": "ANPAXXXXXXXXXXXXXXXXX",
          "DefaultVersionId": "v1",
          "Path": "/",
          "Arn": "arn:aws:iam:::XXXXXXXXXXXXpolicy/VpnConnMonitorRole",
          "UpdateDate": "2016-10-22T01:23:45.678Z"
        }
      }
```


4. 事後作業
===========


IAMポリシーの確認
-----------------

ARNを取得します。

```bash:変数の設定:
IAM_POLICY_ARN=$( \
        aws iam list-policies \
          --max-items 1000 \
          --query "Policies[?PolicyName==\`${IAM_POLICY_NAME}\`].Arn" \
          --output text \
) \
        && echo "${IAM_POLICY_ARN}"
```

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

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

```bash:コマンド:
IAM_POLICY_VERSION=$( \
        aws iam list-policies \
          --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": "2016-10-22T01:23:45Z",
          "VersionId": "v1",
          "Document": {
            "Version": "2012-10-17",
            "Statement": [
              {
                  "Effect": "Allow",
                  "Action": [
                    "ec2:DescribeRegions",
                    "ec2:DescribeVpnConnections"
                  ],
                  "Resource": "*"
              },
              {
                  "Effect": "Allow",
                  "Action": [
                    "cloudwatch:PutMetricData"
                  ],
                  "Resource": "*"
              }
            ]
          },
          "IsDefaultVersion": true
        }
      }
```


完了
====