Amplify Auth のセットアップ
Amplify Auth は Amazon Cognito により提供されています。Cognito は、ユーザー登録、認証、アカウント復旧、その他の操作を処理する堅牢なユーザーディレクトリサービスです。概念を確認してさらに学ぶ。
認証リソースの定義を開始するには、認証リソースファイルを開くか作成します:
import { defineAuth } from "@aws-amplify/backend"
/** * Define and configure your auth resource * @see https://docs.amplify.aws/gen2/build-a-backend/auth */export const auth = defineAuth({ loginWith: { email: true, },})デフォルトでは、認証リソースは email をデフォルトのログインメカニズムとしてスキャフォルドされます。認証リソースを設定して以下でのサインインを許可することもできます:
- 電話番号
- 外部プロバイダー(Google、Facebook、Amazon、または Sign in with Apple)
- パスワードレス認証(メール OTP、SMS OTP、または WebAuthn パスキー)
パスワードレス認証を有効化
パスワードレス認証方法を有効にして、より安全でユーザーフレンドリーなエクスペリエンスを提供できます:
import { defineAuth } from '@aws-amplify/backend';
export const auth = defineAuth({ loginWith: { email: { otpLogin: true // Enable email-based one-time passwords } }});認証リソースをデプロイ
認証リソースを選択して定義した後、以下のコマンドを実行して、個人用クラウドサンドボックスにリソースを作成します。
npx ampx sandboxデプロイが成功した後、このコマンドは出力ファイル(amplify_outputs.json)も生成します。これにより、フロントエンドアプリがバックエンドリソースに接続できるようになります。バックエンド認証リソースで設定する値は、生成された出力ファイルに設定され、フロントエンドの Authenticator 接続コンポーネント が自動的に設定されます。
アプリケーションコードを認証リソースに接続
サインインフローを作成して正しく実装することは、複雑で時間がかかることがあります。Amplify の Authenticator UI コンポーネントはこれを簡素化し、アプリ全体の認証フローを迅速に構築できるようにします。コンポーネントは amplify/auth/resource.ts の設定とシームレスに連携して、バックエンドリソースに自動的に接続します。
Amplify には React、Vue、Angular、React Native、Swift、Android、Flutter 向けの事前構築 UI コンポーネントがあります。このガイドでは、Web アプリケーション向けのコンポーネントに焦点を当てています。
まず、@aws-amplify/ui-vue ライブラリをインストールします:
npm add @aws-amplify/ui-vue次に、src/App.vue を開いて Authenticator コンポーネントを追加します。
Authenticator
Authenticator コンポーネントは、アプリに認証フローを追加するシンプルな方法を提供します。このコンポーネントは、選択したフレームワークで認証ワークフローをカプセル化し、バックエンド Auth リソースによって支えられています。Authenticator は user 情報と signOut 関数を内部テンプレートに渡します。
<script setup> import { Authenticator } from "@aws-amplify/ui-vue"; import "@aws-amplify/ui-vue/styles.css";
import { Amplify } from 'aws-amplify'; import outputs from '../amplify_outputs.json';
Amplify.configure(outputs);</script>
<template> <authenticator> <template v-slot="{ user, signOut }"> <h1>Hello {{ user.username }}!</h1> <button @click="signOut">Sign Out</button> </template> </authenticator></template>まず、@aws-amplify/ui-components ライブラリをインストールします:
npm add @aws-amplify/ui-components次に src/main.ts を開いて、最後のインポートの下に以下を追加します:
import '@aws-amplify/ui-components';import { applyPolyfills, defineCustomElements} from '@aws-amplify/ui-components/loader';import Vue from 'vue';
Vue.config.ignoredElements = [/amplify-\w*/];
applyPolyfills().then(() => { defineCustomElements(window);});次に、src/App.ts を開いて amplify-authenticator コンポーネントを追加します。
amplify-authenticator
amplify-authenticator コンポーネントは、アプリに認証フローを追加するシンプルな方法を提供します。このコンポーネントは、選択したフレームワークで認証ワークフローをカプセル化し、バックエンド Auth リソースによって支えられています。オプションの amplify-sign-out コンポーネントは、サインアウトボタンをレンダリングしたい場合に利用できます。
<template> <amplify-authenticator> <div> My App <amplify-sign-out></amplify-sign-out> </div> </amplify-authenticator></template>Authenticator コンポーネントをアプリに追加したら、サインアップ、サインイン、サインアウト機能をテストできます。また Authenticator 接続コンポーネントをカスタマイズ して、必要に応じて色とスタイルを調整することもできます。
次のステップ
Amplify アプリでメールとパスワードを使用した認証のセットアップが完了しました。さらに機能を追加したい場合は、以下について学ぶことをお勧めします: