この機能はデリゲーションを使用します。デフォルトでは、2017 年 6 月 8 日時点でアドオンを利用していないテナントでは、デリゲーションは無効になっています。現在、デリゲーションを必要とするアドオンを使用しているレガシーテナントは、この機能を引き続き利用できます。将来的にデリゲーション機能が変更またはサービスから削除される場合は、現在利用中のお客様に事前に通知し、移行に十分な時間が提供されます。さらに、デリゲーションはカスタムドメインの使用をサポートしていないため、これに依存する機能はカスタムドメインと併用すると完全には動作しない可能性がある点に注意してください。
ステップ 1 - Amazon API Gateway を設定する
- AWS Lambda 関数を使用して Amazon API Gateway を設定し、Amazon DynamoDB テーブルにペットを保存および取得するサービスロジックを実行できるようにする。
- ペットの一覧を取得および更新するための、認証不要の REST サービスメソッドを 2 つ作成する。
開始する前に、Node.js をインストールしておいてください。
ステップ 1. Amazon DynamoDB テーブルを作成する
- テーブル名: Pets
- プライマリキー: username
- プライマリキーの型: String
- デフォルト設定を使用: 未選択
- 読み込みキャパシティーユニット: 3
- 書き込みキャパシティーユニット: 3
Create をクリックして、指定した設定でテーブルを作成します。
テーブルの作成中に、Table details セクションにある Amazon Resource Name (ARN) を控えておいてください。次のステップでテーブルの ARN が必要になります。
ステップ 2. AWS Lambda 関数に DynamoDB Pets テーブルへのアクセスを許可するポリシーを作成する
APIGatewayLambdaExecRole を入力し、Next Step をクリックします。
ロールタイプを選択します。AWS Service Roles で、AWS Lambda を選択します。
Attach Policy 画面では、Next Step をクリックしてこの手順をスキップします。この時点で、入力した情報を確認します。内容に問題がなければ、Create Role をクリックします。完了すると、IAM ホームページに作成したロールが表示されます。
先ほど作成したロール APIGatewayLambdaExecRole を選択します。Inline Policies の下向き矢印をクリックし、Click Here リンクをクリックします。
Custom Policy を選択して Select をクリックします。ポリシー名に LogAndDynamoDBAccess を入力し、次のコードをポリシードキュメントとして追加します (先に DynamoDB テーブルの Amazon Resource Name (ARN) を更新してください) 。Apply Policy をクリックします。
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "AccessCloudwatchLogs",
"Action": ["logs:*"],
"Effect": "Allow",
"Resource": "arn:aws:logs:*:*:*"
},
{
"Sid": "PetsDynamoDBReadWrite",
"Effect": "Allow",
"Action": [
"dynamodb:DeleteItem",
"dynamodb:GetItem",
"dynamodb:PutItem",
"dynamodb:UpdateItem"
],
"Resource": ["DYNAMODB_TABLE_ARN_VALUE_FROM_PREVIOUS_STEP"]
}
]
}
ステップ 2. AWS Lambda 関数を作成する
GetPetInfo の Lambda 関数を作成する
- Name:
GetPetInfo
- Runtime: Node.js 6.10
以下のコードを Lambda function code 領域に貼り付け、DynamoDB テーブルからペット情報を読み取れるようにします。
var AWS = require('aws-sdk');
var DOC = require('dynamodb-doc');
var dynamo = new DOC.DynamoDB();
exports.handler = function(event, context) {
var cb = function(err, data) {
if(err) {
console.log('error on GetPetsInfo: ',err);
context.done('Unable to retrieve pet information', null);
} else {
if(data.Item && data.Item.pets) {
context.done(null, data.Item.pets);
} else {
context.done(null, {});
}
}
};
dynamo.getItem({TableName:"Pets", Key:{username:"default"}}, cb);
};
{}) が表示されます。テーブルは空のままです。
UpdatePetInfo 用の Lambda 関数を作成する
GetPetInfo 関数の作成時と同じ手順を繰り返しますが、関数コードには代わりに次のコードを使用します。
var AWS = require('aws-sdk');
var DOC = require('dynamodb-doc');
var dynamo = new DOC.DynamoDB();
exports.handler = function(event, context) {
var item = { username:"default",
pets: event.pets || {}
};
var cb = function(err, data) {
if(err) {
console.log(err);
context.fail('unable to update pets at this time');
} else {
console.log(data);
context.done(null, data);
}
};
dynamo.putItem({TableName:"Pets", Item:item}, cb);
};
{
"pets": [{
"id": 1,
"type": "dog",
"price": 249.99
}]
}
{}) が表示されるはずです。
GetPetInfo Lambda 関数に戻って、もう一度 Test をクリックします。今度は 1 匹のペットが表示されるはずです。
Lambda 関数をもう 1 つ追加で作成します。この関数自体は何も行いませんが、後のセクションで説明する CORS の OPTIONS メソッドで必要になります。
上記の手順に従って、NoOp という名前の Lambda 関数を作成します。関数のコードは次のとおりです。
exports.handler = function(event, context) {
context.succeed('');
}
ステップ 3. Amazon API Gateway API を作成する
GET するメソッド、もう 1 つはペット情報を POST するメソッドです。
Amazon API Gateway Console に移動し、Create API をクリックします。初めて API を作成する場合は、代わりに Get Started を促す画面が表示されます。
初めて API を作成する場合は、Example API を作成するよう求められます。ポップアップ通知を閉じるために OK をクリックし、Example API ボタンではなく New API ラジオボタンを選択します。
API 名を SecurePets にして、Create API をクリックします。
SecurePets API の Resources タブに移動し、Create Resource アクションをクリックします。
リソース名を Pets にして、もう一度 Create Resource をクリックします。
左側のペインで /pets を選択し、CreateMethod ボタンをクリックします。
ドロップダウンで GET を選択し、チェックマーク ボタンをクリックします。GET メソッドに次の設定値を指定します。
- Integration type: Lambda Function;
- Lambda Region: 使用しているリージョン;
- Lambda Function: GetPetInfo.
Lambda 関数に権限を付与するよう求めるポップアップが表示されたら、Save をクリックし、続けて OK をクリックします。
次に表示される Method Execution ウィンドウで、Test をクリックします。
レスポンス本文に 1 件のペット情報が返されるはずです。
ペット情報を POST するための API の作成は、ペット情報を GET するための API の作成とほぼ同じです。
左側のペインで /pets を選択し、CreateMethod をクリックします。
ドロップダウンで POST を選択し、チェックマーク ボタンをクリックします。
Integration Type で Lambda Function を選択し、現在使用しているリージョンを選択して、Lambda 関数 には UpdatePetInfo を選択します。
ポップアップが表示されて Lambda 関数 に権限を付与するよう求められたら、Save をクリックし、続けて OK をクリックします。
Test をクリックし、リクエスト本文に以下を貼り付けます。
{"pets": [
{"id": 1, "type": "dog", "price": 249.99},
{"id": 2, "type": "cat", "price": 124.99}
]
}
{}) が表示されるはずです。
GET メソッドに戻り、Test をもう一度クリックして、レスポンス本文に、テーブルに 2 匹のペットが一覧表示されていることが示されるのを確認します。
[
{
"id": 1,
"price": 249.99,
"type": "dog"
},
{
"id": 2,
"price": 124.99,
"type": "cat"
}
]
OPTIONS メソッドを作成できます。
左側のペインで /pets を選択し、CreateMethod をクリックします。ドロップダウンで OPTIONS を選択し、チェックマーク ボタンをクリックします。Integration Type にはモックを選択します。Save をクリックします。
Response Body は空のまま Test をクリックします。no data を示す Response Body が返されるはずです。
この時点では、AWS Lambda 関数と Amazon API Gateway メソッドは、セキュリティなしで定義されています。
認証
ユーザー管理
カスタマイズ
Auth0 AI
プラットフォーム
