[JAWS-UG CLI] IAM #69 IAMポリシーの作成 (インスタンスプロファイル用:AMI構築環境)

AWS CLIを利用して、AMI構築に必要なS3バケットにアクセス可能なEC2用インスタンプロファイルに必要なIAMポリシを作成してみます。


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


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

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


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

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

* AWS CLI 1.11.28

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

結果(例):

      aws-cli/1.11.34 Python/2.7.10 Darwin/15.6.0 botocore/1.4.91

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

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

0. 準備
=======


プロファイルの確認
------------------

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

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

結果(例):

            Name                    Value             Type    Location
            ----                    -----             ----    --------
         profile       iamFull-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. IAMポリシー名の決定
------------------------

ポリシー名を決めます。

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


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

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

結果(例):

      XXXXXXXXXXXX

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

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

結果(例)

      An error occurred (NoSuchEntity) when calling the GetPolicy operation: Policy arn:aws:iam::XXXXXXXXXXXX:policy/EC2InstanceProfile_EnvAMI_RolePolicy does not exist or is not attachable.


1.3. 設定ファイルバケットの指定
-------------------------------

```bash:変数の設定:
S3_BUCKET_PREFIX_CONF='conf'
```


1.4. 設定ファイルバケットの指定
-------------------------------

```bash:変数の設定:
S3_BUCKET_PREFIX_LOG='log'
```


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

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

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

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

        FILE_INPUT:            ${FILE_INPUT}
        S3_BUCKET_PREFIX_CONF: ${S3_BUCKET_PREFIX_CONF}
        S3_BUCKET_PREFIX_LOG : ${S3_BUCKET_PREFIX_LOG}

ETX
```

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

```bash:コマンド:
cat << EOF > ${FILE_INPUT}
{
        "Version": "2012-10-17",
        "Statement": [
          {
            "Action": [
              "s3:Get*",
              "s3:List*"
            ],
            "Effect": "Allow",
            "Resource": [
              "arn:aws:s3:::${S3_BUCKET_PREFIX_CONF}-*",
              "arn:aws:s3:::${S3_BUCKET_PREFIX_CONF}-*/*"
            ]
          },
          {
            "Action": [
              "s3:Get*",
              "s3:PutObject",
              "s3:List*"
            ],
            "Effect": "Allow",
            "Resource": [
              "arn:aws:s3:::${S3_BUCKET_PREFIX_LOG}-*",
              "arn:aws:s3:::${S3_BUCKET_PREFIX_LOG}-*/*"
            ]
          }
        ]
}
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}
```

結果(例):

      {
        "Policy": {
          "PolicyName": "EC2InstanceProfile_EnvAMI_RolePolicy",
          "CreateDate": "2017-02-13T01:23:45.678Z",
          "AttachmentCount": 0,
          "IsAttachable": true,
          "PolicyId": "ANPAXXXXXXXXXXXXXXXXX",
          "DefaultVersionId": "v1",
          "Path": "/",
          "Arn": "arn:aws:iam:::XXXXXXXXXXXXpolicy/EC2InstanceProfile_EnvAMI_RolePolicy",
          "UpdateDate": "2017-02-13T01: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}"
```

結果(例):

      arn:aws:iam::XXXXXXXXXXXX:policy/EC2InstanceProfile_EnvAMI_RolePolicy

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

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

結果(例)

      v1

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

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

結果(例):

      {
        "PolicyVersion": {
          "CreateDate": "2017-02-13T01:23:45Z",
          "VersionId": "v1",
          "Document": {
              "Version": "2012-10-17",
              "Statement": [
                  {
                      "Action": [
                          "s3:Get*",
                          "s3:List*"
                      ],
                      "Resource": [
                          "arn:aws:s3:::conf-*",
                          "arn:aws:s3:::conf-*/*"
                      ],
                      "Effect": "Allow"
                  },
                  {
                      "Action": [
                          "s3:Get*",
                          "s3:PutObject",
                          "s3:List*"
                      ],
                      "Resource": [
                          "arn:aws:s3:::log-*",
                          "arn:aws:s3:::log-*/*"
                      ],
                      "Effect": "Allow"
                  }
              ]
          },
          "IsDefaultVersion": true
        }
      }


完了
====