💻
AWS認証・認可入門：Cognitoの活用方法

2025/02/26に公開
Docker
機械学習
プログラミング
tech
AWS（Amazon Web Services）は、クラウドコンピューティングのサービスを提供するプラットフォームで、さまざまな機能を利用することができます。その中でも、認証と認可は、アプリケーションのセキュリティを確保するために非常に重要な要素です。この記事では、AWSのCognitoを使った認証・認可の基本について、初心者向けにわかりやすく解説します。

 目次認証と認可の基本
AWS Cognitoとは
Cognitoの主要機能

Cognitoを使った認証の実装
1. Cognitoユーザープールの作成
2. ユーザーの登録とサインイン
3. アプリケーションからのCognitoの利用


Cognitoを使った認可の実装
1. IAMロールとポリシーの設定
2. 認可の実装

まとめ

 認証と認可の基本まず、認証と認可の違いについて理解しましょう。

認証（Authentication）：ユーザーが自分自身を証明するプロセスです。一般的には、ユーザー名とパスワードを使用して行います。

認可（Authorization）：認証されたユーザーが、どのリソースにアクセスできるかを決定するプロセスです。たとえば、特定のページやデータに対するアクセス権を管理します。
この2つのプロセスは、アプリケーションのセキュリティを確保するために欠かせません。

 AWS CognitoとはAWS Cognitoは、ユーザーの認証と認可を簡単に実装できるサービスです。Cognitoを使用することで、ユーザー管理やセキュリティを自動化し、開発者はアプリケーションの機能に集中することができます。
Cognitoには主に2つのコンポーネントがあります：

ユーザープール：ユーザーのサインアップやサインインを管理するためのディレクトリです。

IDプール：認証されたユーザーにAWSリソースへのアクセスを提供するためのサービスです。

 Cognitoの主要機能Cognitoには以下のような主要な機能があります：

ユーザー管理：ユーザーの登録、サインイン、パスワードリセットなどを簡単に管理できます。

ソーシャルログイン：FacebookやGoogleなどのソーシャルアカウントを使用してサインインできます。

多要素認証（MFA）：セキュリティを強化するために、追加の認証手段を提供できます。

カスタム属性：ユーザーに対して追加の情報を保存することができます。

 Cognitoを使った認証の実装ここでは、Cognitoを使ってユーザー認証を実装する手順を説明します。

 1. Cognitoユーザープールの作成まず、AWSマネジメントコンソールにログインし、Cognitoサービスを選択します。

ユーザープールの作成をクリックします。
ユーザープールの名前を入力し、レビューをクリックします。
必要な設定を行い、ユーザープールの作成をクリックします。
これでユーザープールが作成されました。

 2. ユーザーの登録とサインイン次に、ユーザーを登録し、サインインできるようにします。以下は、JavaScriptを使った簡単なサインアップとサインインのコード例です。
// AWS SDKの読み込み
const AWS = require('aws-sdk');
const AmazonCognitoIdentity = require('amazon-cognito-identity-js');

// ユーザープールの設定
const poolData = {
    UserPoolId: 'YOUR_USER_POOL_ID', // ユーザープールID
    ClientId: 'YOUR_CLIENT_ID' // クライアントID
};
const userPool = new AmazonCognitoIdentity.CognitoUserPool(poolData);

// ユーザーの登録
function signUp(username, password, email) {
    const attributeList = [];
    const dataEmail = {
        Name: 'email',
        Value: email
    };
    const attributeEmail = new AmazonCognitoIdentity.CognitoUserAttribute(dataEmail);
    attributeList.push(attributeEmail);

    userPool.signUp(username, password, attributeList, null, (err, result) => {
        if (err) {
            console.error(err);
            return;
        }
        console.log('ユーザー登録成功:', result.user);
    });
}

// ユーザーのサインイン
function signIn(username, password) {
    const authenticationData = {
        Username: username,
        Password: password,
    };
    const authenticationDetails = new AmazonCognitoIdentity.AuthenticationDetails(authenticationData);
    
    const userData = {
        Username: username,
        Pool: userPool
    };
    
    const cognitoUser = new AmazonCognitoIdentity.CognitoUser(userData);
    
    cognitoUser.authenticateUser(authenticationDetails, {
        onSuccess: (result) => {
            console.log('サインイン成功:', result);
        },
        onFailure: (err) => {
            console.error(err);
        },
    });
}
このコードでは、ユーザーの登録とサインインを行うための関数を定義しています。signUp関数は新しいユーザーを登録し、signIn関数は既存のユーザーをサインインさせます。

 3. アプリケーションからのCognitoの利用Cognitoを使ったアプリケーションを作成するには、上記の関数を呼び出すことでユーザーの登録やサインインを実行できます。たとえば、HTMLフォームからユーザー名やパスワードを取得し、これらの関数を呼び出すことができます。
<form id="signup-form">
    <input type="text" id="username" placeholder="ユーザー名" required>
    <input type="password" id="password" placeholder="パスワード" required>
    <input type="email" id="email" placeholder="メールアドレス" required>
    <button type="submit">登録</button>
</form>

<script>
document.getElementById('signup-form').addEventListener('submit', function(event) {
    event.preventDefault();
    const username = document.getElementById('username').value;
    const password = document.getElementById('password').value;
    const email = document.getElementById('email').value;
    signUp(username, password, email);
});
</script>
この例では、ユーザーがフォームに入力した情報を取得し、signUp関数を呼び出してユーザー登録を行います。

 Cognitoを使った認可の実装次に、Cognitoを使った認可の実装について説明します。

 1. IAMロールとポリシーの設定AWSでは、**IAM（Identity and Access Management）**を使用して、ユーザーやサービスに対するアクセス権を管理します。Cognitoを使って認証されたユーザーに特定のAWSリソースへのアクセスを許可するためには、IAMロールを設定する必要があります。
AWSマネジメントコンソールでIAMサービスを選択します。

ロールの作成をクリックします。

Cognitoを選択し、次にCognitoの認証ユーザーを選択します。
必要なポリシーを選択し、ロールに名前を付けて作成します。

 2. 認可の実装認可を実装するためには、Cognitoから取得したトークンを使用して、AWSリソースへのアクセスを制御します。以下は、API Gatewayを使用して認可を行う例です。
API Gatewayで新しいAPIを作成します。
リソースを作成し、メソッドを追加します。
メソッドの設定で、認証を選択し、先ほど作成したCognitoユーザープールを指定します。
これにより、Cognitoで認証されたユーザーのみがAPIにアクセスできるようになります。

 まとめこの記事では、AWS Cognitoを使った認証と認可の基本について解説しました。Cognitoを利用することで、ユーザー管理やセキュリティを簡単に実装できることがわかりました。これからのアプリケーション開発において、Cognitoを活用して安全なユーザー認証と認可を実現してみてください。
AWS Cognitoの詳細については、公式ドキュメントを参照してください。
目次

認証と認可の基本

AWS Cognitoとは

Cognitoの主要機能

Cognitoを使った認証の実装

1. Cognitoユーザープールの作成

2. ユーザーの登録とサインイン

3. アプリケーションからのCognitoの利用

Cognitoを使った認可の実装

1. IAMロールとポリシーの設定

2. 認可の実装

まとめ

Discussion
