ステップ4： アカウントリンクを設定する

スキルのエンドポイントの設定が完了したので、次はアカウントリンクの設定に進みましょう。すべてのスマートホームスキルでは、アカウントリンクを有効にして、AlexaユーザーのIDをシステムのユーザーIDに関連付ける必要があります。たとえば、電球のシステムに、電球のモデルと機能（調光式かどうかなど）を格納するユーザーアカウントがあるとします。ユーザーがAlexaアプリでスキルを有効にすると、Alexaはアカウントリンクプロセスを開始し、システムからアクセストークンを受け取ります。その後、ユーザーがAlexaに電球を暗くするように指示すると、Alexaはスキルにアクセストークンを送信します。このトークンを使用することで、スキルはシステムのユーザーアカウントにアクセスして、電球が調光式かどうかを確認できます。

簡潔にするため、このチュートリアルではLogin with Amazon（LWA）というAmazonの認可サーバーを使用します。スマートホームスキルを作成する場合は、LWAまたは独自のOAuth 2.0プロバイダーを使用できます。Alexaは、スマートホームスキルにAuthorization code grantタイプを使用します。

アカウントリンクの設定手順

アカウントリンクを有効にするには、次の手順を実行します。

1. セキュリティプロファイルを作成する
2. アカウントリンクを設定する
3. セキュリティプロファイルにリダイレクトURLを追加する

手順4.1： セキュリティプロファイルを作成する

この手順では、Amazon認可サーバー上でスマートホームスキル用のセキュリティプロファイルを作成します。

Login with Amazonコンソールでセキュリティプロファイルを作成するには

1. Amazon開発者アカウントを使用して、Login with Amazonコンソールにサインインします。
2. Login with Amazonページで、セキュリティプロファイルを新規作成をクリックします。
3. 新しいセキュリティプロファイルに名前を付けるで、次の情報を入力します。
   1. セキュリティプロファイル名に、「my-smart-home-skill-profile」と入力します。
   重要： セキュリティプロファイルには、製品の名前またはブランドと一致する名前を付けて、ユーザーがその製品に対して認証を行っていることを確認できるようにしてください。
   1. セキュリティプロファイルの説明に、製品の説明を入力します。
   2. プライバシー規約同意書URLに、ユーザーに表示する会社のプライバシーポリシーのURLを入力します（https://example.com）。
   3. 同意のロゴ画像に、プライバシーポリシーと共に表示する製品ロゴをアップロードします。
      このチュートリアルでは、このフィールドは無視して構いません。
4. 新しいセキュリティプロファイルを作成するには、保存をクリックします。
   Amazonで新しいセキュリティプロファイルが作成されると、プロファイルにクライアントIDとクライアントシークレットの認証情報が含まれます。
5. 認証情報を表示するには、作成したプロファイル名（my-smart-home-skill-profile）の横にあるクライアントIDおよびクライアントシークレットを表示をクリックします。
6. クライアントIDとクライアントシークレットをコピーして、スキル設定で使用できるようにします。
   余分な文字や空白をコピーしないように注意してください。
7. これらの値を、Windowsのメモ帳やMacのテキストエディットなど、参照しやすい場所に貼り付けて保存します。
   これらの値は次の手順で使用します。

手順4.2： アカウントリンクを設定する

この手順では、Alexa開発者コンソールでスキルの認可サーバーとセキュリティプロファイルを設定します。

Alexa開発者コンソールでアカウントリンクを設定するには

1. Alexa開発者コンソールのスキルに戻ります。
   スキルページを閉じた場合は、以下の手順でスキルを探してください。
   1. Alexa開発者コンソールにサインインします。
   2. スキルタブのスキル名で、ステップ1： スマートホームスキルを作成するで作成したmy-smart-home-skillスキルを探します。
   3. そのスキルの行で、アクションのドロップダウンメニューから編集を選択します。
2. スマートホームページの3. アカウントのリンクで、アカウントリンクを設定をクリックします。
   または、左側のメニューで、アカウントリンクをクリックします。
3. セキュリティプロバイダー情報のAuth Code Grantで、以下の情報を入力します。
   1. Web認証画面のURIに、「https://www.amazon.com/ap/oa」と入力します。
      AlexaはこのURIを使用してアカウントリンクを開始します。
   2. アクセストークンのURIに、「https://api.amazon.com/auth/o2/token」と入力します。
   3. ユーザーのクライアントIDに、セキュリティプロファイルのクライアントIDを貼り付けます。
   4. ユーザーのシークレットに、セキュリティプロファイルのクライアントシークレットを貼り付けます。
   5. ユーザーの認可スキームで、HTTP Basic認証（推奨）を選択します。
   6. スコープで、+スコープの追加をクリックし、「profile:user_id」と入力します。
   7. データを保存するには、保存をクリックします。
   8. ページの下部に移動し、Alexaのリダイレクト先のURLをコピーします。
   9. Windowsのメモ帳やMacのテキストエディットなど、参照しやすい場所にURLを貼り付けて保存します。これらの値は次のステップで使用します。

手順4.3： セキュリティプロファイルにリダイレクトURLを追加する

この手順では、セキュリティプロファイルにリダイレクトURLを追加します。認可サービスがユーザー認証を完了すると、認可サービスはユーザーをAlexaアプリにリダイレクトします。Alexaは、アカウントリンクリクエストで、設定済みのリダイレクトURLのいずれかを認可サービスに送信します。

Amazon開発者コンソールでセキュリティプロファイルにリダイレクトURLを追加するには

1. Login with Amazonコンソールで、セキュリティプロファイルに戻ります。
   ページを閉じた場合は、Login with Amazonコンソールにサインインしてください。
2. my-smart-home-skill-profileというセキュリティプロファイルを見つけます。
3. 管理するの下にある歯車アイコンにカーソルを合わせ、ウェブ設定を選択します。
4. セキュリティプロファイル管理で、画面の右下にある編集をクリックします。
5. 許可された返信URLで、別のものを追加するを2回クリックして、Alexa開発者コンソールからコピーしたAlexaリダイレクトURLを貼り付けます。
6. プロファイルを保存するには、保存をクリックします。

• 前へ – ステップ3： サービスエンドポイントを設定する
• 次へ – ステップ5： スキルをテストする

---

---

最終更新日: 2025 年 11 月 25 日