まず最初に、 今回実行するLambda関数に必要な権限を付与するためのIAMロールを作成していきます。
今回は、以下の権限を付与します。
前提条件
IAMへの権限
IAMに対してフル権限があること。
AWS CLI
以下のバージョンで動作確認済
- AWS CLI 1.10.60
aws --version
aws-cli/1.11.7 Python/2.7.11 Darwin/15.6.0 botocore/1.4.64
バージョンが古い場合は最新版に更新しましょう。
sudo -H pip install -U awscli
- 準備
=======
変数の確認
プロファイルが想定のものになっていることを確認します。
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
今回は、IAMでの作業となるため、リージョンはどこになっていても影響ありません。
- 事前作業
===========
1.1. IAMロール名の決定
作成するIAMロールの名称を決定します。
IAM_ROLE_NAME='lambdaVpnConnMonitorExecution'
同じ名前のIAMロールが存在しないことを確認します。
aws iam get-role \
--role-name ${IAM_ROLE_NAME}
A client error (NoSuchEntity) occurred when calling the GetRole operation: The role with name lambdaVpnConnMonitorExecution cannot be found.
1.2. プリンシパルの指定
作成するIAMロールを利用することができるサービス(プリンシパル)を指定し
ます。
IAM_PRINCIPAL='lambda.amazonaws.com'
上記の場合、このIAMロールを利用することができるのはlambda.amazonaws.comで動作するサービスに限定されます。
- IAMロールの作成
==================
IAMロールを作成していきます。
2.1. assumeロールポリシードキュメントの作成
IAMロールを作成するために、まずassumeロールポリシーを記述したドキュメントをJSON形式で作成します。
注釈: IAMでは、一時的にAWS上の特定の権限を得る仕組みを提供しています。この 一時的な権限を得る役割のことをAssumeロールと言い、そのAssumeロールに 付与される権限内容を記述するドキュメントがassumeロールポリシードキュ メントです。
FILE_INPUT="${IAM_ROLE_NAME}.json" \
&& echo ${FILE_INPUT}
cat << ETX
FILE_INPUT: ${FILE_INPUT}
IAM_PRINCIPAL: ${IAM_PRINCIPAL}
ETX
cat << EOF > ${FILE_INPUT}
{
"Version": "2012-10-17",
"Statement": [
{
"Action": "sts:AssumeRole",
"Principal": {
"Service": "${IAM_PRINCIPAL}"
},
"Effect": "Allow",
"Sid": ""
}
]
}
EOF
cat ${FILE_INPUT}
JSONファイルを作成したら、フォーマットが壊れてないか必ず確認します。
jsonlint -q ${FILE_INPUT}
エラーが出力されなければOKです。
2.2. IAMロールの作成
assumeロールポリシーを記述したら、次に実際にIAMロールを作成します。
cat << ETX
IAM_ROLE_NAME: ${IAM_ROLE_NAME}
FILE_INPUT: ${FILE_INPUT}
ETX
aws iam create-role \
--role-name ${IAM_ROLE_NAME} \
--assume-role-policy-document file://${FILE_INPUT}
{
"Role": {
"AssumeRolePolicyDocument": {
"Version": "2012-10-17",
"Statement": [
{
"Action": "sts:AssumeRole",
"Sid": "",
"Effect": "Allow",
"Principal": {
"Service": "lambda.amazonaws.com"
}
}
]
},
"RoleId": "AROAXXXXXXXXXXXXXXXXX",
"CreateDate": "2016-10-22T01:23:45.678Z",
"RoleName": "lambdaVpnConnMonitorExecution",
"Path": "/",
"Arn": "arn:aws:iam::XXXXXXXXXXXX:role/lambdaVpnConnMonitorExecution"
}
}
2.3. IAMロールの確認
作成したIAMロールの内容を確認しましょう。
aws iam get-role \
--role-name ${IAM_ROLE_NAME}
{
"Role": {
"AssumeRolePolicyDocument": {
"Version": "2012-10-17",
"Statement": [
{
"Action": "sts:AssumeRole",
"Principal": {
"Service": "lambda.amazonaws.com"
},
"Effect": "Allow",
"Sid": ""
}
]
},
"RoleId": "AROAXXXXXXXXXXXXXXXXX",
"CreateDate": "2016-10-22T01:23:45Z",
"RoleName": "lambdaVpnConnMonitorExecution",
"Path": "/",
"Arn": "arn:aws:iam::XXXXXXXXXXXX:role/lambdaVpnConnMonitorExecution"
}
}
出力結果の'AssumeRolePolicyDocument'が、assumeロールポリシードキュメントと同一の内容になっていれば、問題ありません。
この時点で、'lambda.amazonaws.com'で動作するサービスからこのIAMロールを利用することが可能となりました。
- IAMポリシーの適用
====================
次に、このIAMロールにIAMポリシーを適用して、このIAMロールを利用することで得られる権限を決定します。
3.1. IAMロールに適用するIAMポリシーの決定
今回のLambda関数を実行する上で必要となる権限については、すでにAWS管理ポリシーで''AWSLambdaBasicExecutionRole'という名前で提供されています。
まず、'Lambda'というキーワードでAWS管理ポリシーから検索してみましょう。
SEARCH_KEYWORD='Lambda'
aws iam list-policies \
--scope AWS \
--max-items 1000 \
--query "Policies[?contains(PolicyName, \`${SEARCH_KEYWORD}\`)].PolicyName"
[
"AWSLambdaFullAccess",
"AWSLambdaDynamoDBExecutionRole",
"AWSLambdaExecute",
"AWSLambdaKinesisExecutionRole",
"AWSLambdaReadOnlyAccess",
"AWSLambdaBasicExecutionRole",
"AWSLambdaInvocation-DynamoDB",
"AWSLambdaVPCAccessExecutionRole",
"AWSLambdaRole"
]
利用するIAMポリシーを決めます。
IAM_POLICY_NAME='AWSLambdaBasicExecutionRole'
次に、ポリシーを特定するためのAWSリソース識別名(ARN)を取得します。
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::aws:policy/service-role/AWSLambdaBasicExecutionRole
ポリシーの内容を見るために、そのポリシーの最新バージョン名を取得します
。
IAM_POLICY_VERSION=$( \
aws iam list-policies \
--max-items 1000 \
--query "Policies[?PolicyName==\`${IAM_POLICY_NAME}\`].DefaultVersionId" \
--output text \
) \
&& echo ${IAM_POLICY_VERSION}
v1
ポリシーの最新バージョンの内容を見てみましょう。
aws iam get-policy-version \
--policy-arn ${IAM_POLICY_ARN} \
--version-id ${IAM_POLICY_VERSION}
{
"PolicyVersion": {
"CreateDate": "2016-10-22T01:23:45Z",
"VersionId": "v1",
"Document": {
"Version": "2012-10-17",
"Statement": [
{
"Action": [
"logs:CreateLogGroup",
"logs:CreateLogStream",
"logs:PutLogEvents"
],
"Resource": "*",
"Effect": "Allow"
}
]
},
"IsDefaultVersion": true
}
}
以下の権限を許可されていることがわかります。
- logs:CreateLogGroup
- logs:CreateLogStream
- logs:PutLogEvents
これは、CloudWatch Logsにイベントログを書き込むために必要な権限です。
3.2. IAMポリシーの確認
IAMロールに適用されているIAMポリシーを確認してみましょう。
aws iam list-attached-role-policies \
--role-name ${IAM_ROLE_NAME}
{
"AttachedPolicies": [],
}
作成直後のIAMロールには、適用されているIAMポリシーはありません。
3.3. IAMポリシーの適用
IAMロールにIAMポリシーを適用します。
cat << ETX
IAM_ROLE_NAME: ${IAM_ROLE_NAME}
IAM_POLICY_ARN: ${IAM_POLICY_ARN}
ETX
aws iam attach-role-policy \
--role-name ${IAM_ROLE_NAME} \
--policy-arn ${IAM_POLICY_ARN}
(戻り値なし)
3.4. ポリシーの確認
IAMロールに適用されているIAMポリシーを再度確認してみましょう。
aws iam list-attached-role-policies \
--role-name ${IAM_ROLE_NAME}
{
"AttachedPolicies": [
{
"PolicyName": "AWSLambdaBasicExecutionRole",
"PolicyArn": "arn:aws:iam::aws:policy/service-role/AWSLambdaBasicExecutionRole"
}
]
}
完了
以上で、今回実行するLambda関数に必要なIAMロールの作成は完了です。