AWS Cognito
AWS Cognito の表示メトリクスには、ユーザープール数、ユーザーログイン要求数、ユーザー登録数、制限されたユーザーログイン要求数、トークン更新数などがあります。
設定¶
Func のインストール¶
おすすめは Guance の統合 - 拡張 - ホスト版 Func です。前提条件はすべて自動でインストールされるため、そのままスクリプトのインストールに進んでください。
Func を自分でデプロイする場合はFunc の自前デプロイ を参照してください
スクリプトのインストール¶
注意：要件を満たす Amazon AK をあらかじめ用意してください。簡単にするため、全体読み取り権限
ReadOnlyAccessを直接付与しても構いません。
ホスト版の有効化スクリプト¶
- Guance コンソールにログインします
- 【統合】メニューをクリックし、【クラウドアカウント管理】を選択します
- 【クラウドアカウントを追加】をクリックし、【AWS】を選択して画面に必要な情報を入力します。以前にクラウドアカウント情報を設定済みの場合は、この手順は省略できます
- 【テスト】をクリックし、成功したら【保存】をクリックします。失敗した場合は、関連設定が正しいか確認してから再度テストしてください
- 【クラウドアカウント管理】の一覧で追加済みのクラウドアカウントを確認できます。該当するクラウドアカウントをクリックして詳細画面に入ります
- クラウドアカウント詳細画面の【統合】ボタンをクリックし、
未インストール一覧からAWS Cognitoを見つけて【インストール】をクリックすると、インストール画面が表示されるのでそのままインストールします。
手動で有効化するスクリプト¶
-
Func コンソールにログインし、【スクリプトマーケット】をクリックして Guance のスクリプトマーケットに入り、
integration_aws_cognitoを検索します -
【インストール】をクリックし、対応するパラメータとして AWS AK ID、AK Secret、およびアカウント名を入力します。
-
【起動スクリプトをデプロイ】をクリックすると、システムが自動的に
Startupスクリプトセットを作成し、対応する起動スクリプトを自動で設定します。 -
有効化後は「管理 / 自動トリガー設定」で対応する自動トリガー設定を確認できます。【実行】をクリックすると、定期実行を待たずにすぐ 1 回実行できます。少し待ってから、実行タスクの記録と対応するログを確認できます。
確認¶
- 「管理 / 自動トリガー設定」で、対応するタスクに自動トリガー設定が存在するか確認し、あわせてタスク記録とログを確認して異常がないかチェックします
- Guance の「インフラストラクチャ / カスタム」で資産情報が存在するか確認します
- Guance の「メトリクス」で対応する監視データがあるか確認します
メトリクス¶
Amazon CloudWatch を設定すると、デフォルトのメトリクスセットは次のとおりです。設定により、さらに多くのメトリクスを収集できます:
Amazon CloudWatch AWS Cognito メトリクス詳細
| メトリクス名 | 説明 | 単位 | メトリクス次元 |
|---|---|---|---|
SignUpSuccesses |
Amazon Cognito ユーザープールに対して送信された成功したユーザー登録リクエストの総数を示します。成功したユーザー登録リクエストは値 1 を生成し、失敗したリクエストは値 0 を生成します。制限されたリクエストも失敗したリクエストとして扱われるため、制限されたリクエストもカウント 0 を生成します。成功したユーザー登録リクエストの割合を求めるには、このメトリクスに Average 統計を使用します。ユーザー登録リクエストの総数を計算するには、このメトリクスに Sample Count 統計を使用します。成功したユーザー登録リクエストの総数を計算するには、このメトリクスに Sum 統計を使用します。失敗したユーザー登録リクエストの総数を計算するには、CloudWatch Math 式を使用し、Sum 統計から Sample Count 統計を引きます。このメトリクスは、各ユーザープールクライアントごとに発行されます。ユーザー登録が管理者によって実行された場合は、Admin としてユーザープールクライアントとともにメトリクスが発行されます。なお、ユーザーのインポートおよびユーザー移行のケースでは、このメトリクスは発行されません。 | カウント | UserPool、UserPoolClient |
SignUpThrottles |
Amazon Cognito ユーザープールに対して送信された成功したユーザー認証リクエストの総数を示します。ユーザー認証トークンが発行されると、ユーザー認証は成功と見なされます。成功した認証は値 1 を生成し、失敗したリクエストは値 0 を生成します。制限されたリクエストも失敗したリクエストとして扱われるため、制限されたリクエストもカウント 0 を生成します。成功したユーザー認証リクエストの割合を求めるには、このメトリクスに Average 統計を使用します。ユーザー認証リクエストの総数を計算するには、このメトリクスに Sample Count 統計を使用します。成功したユーザー認証リクエストの総数を計算するには、このメトリクスに Sum 統計を使用します。失敗したユーザー認証リクエストの総数を計算するには、CloudWatch Math 式を使用し、Sum 統計から Sample Count 統計を引きます。このメトリクスは、各クライアントごとの各ユーザープールに対して発行されます。リクエストで無効なユーザープールクライアントが指定された場合、メトリクス内の対応するユーザープールクライアント値には、リクエストで送信された実際の無効な値ではなく、固定値 Invalid が含まれます。Amazon Cognito のトークン更新リクエストはこのメトリクスには含まれません。Refresh トークンの統計を提供するための別のメトリクスがあります。 |
カウント | UserPool、UserPoolClient |
SignInSuccesses |
Amazon Cognito ユーザープールに対して送信された制限されたユーザー認証リクエストの総数を示します。認証リクエストが制限されると、カウント 1 が発行されます。制限されたユーザー認証リクエストの総数を計算するには、このメトリクスに Sum 統計を使用します。このメトリクスは、各クライアントごとの各ユーザープールに対して発行されます。リクエストで無効なユーザープールクライアントが指定された場合、メトリクス内の対応するユーザープールクライアント値には、リクエストで送信された実際の無効な値ではなく、固定値 Invalid が含まれます。Amazon Cognito のトークン更新リクエストはこのメトリクスには含まれません。Refresh トークンの統計を提供するための別のメトリクスがあります。 |
カウント | Sum |
SignInThrottles |
Amazon Cognito ユーザープールに対して送信された制限されたユーザー認証リクエストの総数を示します。認証リクエストが制限されると、カウント 1 が発行されます。制限されたユーザー認証リクエストの総数を計算するには、このメトリクスに Sum 統計を使用します。このメトリクスは、各クライアントごとの各ユーザープールに対して発行されます。リクエストで無効なユーザープールクライアントが指定された場合、メトリクス内の対応するユーザープールクライアント値には、リクエストで送信された実際の無効な値ではなく、固定値 Invalid が含まれます。Amazon Cognito のトークン更新リクエストはこのメトリクスには含まれません。Refresh トークンの統計を提供するための別のメトリクスがあります。 |
カウント | UserPool、UserPoolClient |
TokenRefreshSuccesses |
Amazon Cognito ユーザープールに対して送信された、成功した Amazon Cognito トークン更新リクエストの総数を示します。成功した Amazon Cognito トークン更新リクエストは値 1 を生成し、失敗したリクエストは値 0 を生成します。制限されたリクエストも失敗したリクエストとして扱われるため、制限されたリクエストもカウント 0 を生成します。成功した Amazon Cognito トークン更新リクエストの割合を求めるには、このメトリクスに Average 統計を使用します。Amazon Cognito トークン更新リクエストの総数を計算するには、このメトリクスに Sample Count 統計を使用します。成功した Amazon Cognito トークン更新リクエストの総数を計算するには、このメトリクスに Sum 統計を使用します。Amazon Cognito トークン更新の失敗リクエスト総数を計算するには、CloudWatch Math 式を使用し、Sum 統計から Sample Count 統計を引きます。このメトリクスは、各ユーザープールクライアントごとに発行されます。無効なユーザープールクライアントがリクエストに含まれている場合、ユーザープールクライアント値には固定値 Invalid が含まれます。 |
カウント | UserPool、UserPoolClient |
TokenRefreshThrottles |
Amazon Cognito ユーザープールに対して送信された、制限された Amazon Cognito トークン更新リクエストの総数を示します。Amazon Cognito トークン更新リクエストが制限されると、カウント 1 が発行されます。制限された Amazon Cognito トークン更新リクエストの総数を計算するには、このメトリクスに Sum 統計を使用します。このメトリクスは、各クライアントごとの各ユーザープールに対して発行されます。リクエストで無効なユーザープールクライアントが指定された場合、メトリクス内の対応するユーザープールクライアント値には、リクエストで送信された実際の無効な値ではなく、固定値 Invalid が含まれます。 |
バイト | UserPool、UserPoolClient |
FederationSuccesses |
Amazon Cognito ユーザープールに対して送信された、成功したフェデレーション認証リクエストの総数を示します。Amazon Cognito がユーザーに認証トークンを発行すると、フェデレーション認証は成功と見なされます。成功したフェデレーション認証リクエストは値 1 を生成し、失敗したリクエストは値 0 を生成します。スロットリングされたリクエスト、および認可コードは生成されたがトークンがないリクエストは 0 を生成します。成功したフェデレーション認証リクエストの割合を求めるには、このメトリクスに Average 統計を使用します。フェデレーション認証リクエストの総数を計算するには、このメトリクスに Sample Count 統計を使用します。成功したフェデレーション認証リクエストの総数を計算するには、このメトリクスに Sum 統計を使用します。失敗したフェデレーション認証リクエストの総数を計算するには、CloudWatch Math 式を使用し、Sum 統計から Sample Count 統計を引きます。 | カウント | UserPool、UserPoolClient、IdentityProvider |
FederationThrottles |
Amazon Cognito ユーザープールに対して送信された、制限されたフェデレーション認証リクエストの総数を示します。フェデレーション認証リクエストが制限されると、カウント 1 が発行されます。制限されたフェデレーション認証リクエストの総数を計算するには、このメトリクスに Sum 統計を使用します。 | カウント | UserPool、UserPoolClient、IdentityProvider |
CallCount |
カテゴリに関連する、顧客による呼び出しの総数を示します。このメトリクスには、制限された呼び出し、失敗した呼び出し、成功した呼び出しを含むすべての呼び出しが含まれます。アカウントとリージョン全体のすべてのユーザープールで、各 AWS アカウントはカテゴリクォータを使用する必要があります。このメトリクスの Sum 統計を使用して、呼び出しの総数を計算できます。 | カウント | サービス、種類、リソース、クラス |
ThrottleCount |
カテゴリに関連する制限付き呼び出しの総数を示します。このメトリクスはアカウントレベルで発行されます。このメトリクスの Sum 統計を使用して、あるカテゴリ内の呼び出しの総数を計算できます。 | カウント | サービス、種類、リソース、クラス |
脅威防御メトリクスの表示¶
| メトリクス名 | 説明 | メトリクス次元 | 名前空間 |
|---|---|---|---|
CompromisedCredentialRisk |
Amazon Cognito が漏えいした認証情報を検出したリクエスト |
|
AWS/Cognito |
AccountTakeoverRisk |
Amazon Cognito がアカウント乗っ取りリスクを検出したリクエスト |
|
AWS/Cognito |
OverrideBlock |
開発者が提供した設定により Amazon Cognito によってブロックされたリクエスト |
|
AWS/Cognito |
Risk |
Amazon Cognito によってリスクありと判定されたリクエスト |
|
AWS/Cognito |
NoRisk |
Amazon Cognito がいかなるリスクも識別しなかったリクエスト |
|
AWS/Cognito |