Alexaアカウントリンクチュートリアル

チュートリアル

Alexa Skills公式チュートリアルで作成した応答メッセージを返すだけのSkillをカスタマイズして、アカウントリンクによって、対象ユーザの情報を返すスキルにする。

Auth0設定

a. ApplicationはApplication TypeをMachine to Machine Applicationsとして作成

b. Token Endpoint Authentication Method（Settings）をBasicにする

c. JsonWebTokenSignatureAlgorithmd（Settings -> Advanced Settings -> OAuth）をHS256にする

d. Allowed Callback URLsはAlexa指定のURLを設定 (ACCOUNT LINKING -> Alexa Redirect URLs)

e. Grant Type（Settings -> Advanced Settings -> Grant Types）としてAuthorization Codeを有効化

f. OAuthのエンドポイントの情報（Settings -> Advanced Settings -> Endpoints）を確認

Alexa Skill設定

a. 対象のスキルのBuildにあるACCOUNT LINKINGを開く

b. Do you allow users to create an account or link to an existing account with you? を有効化

c. Allow users to enable skill without account linking (Recommended). を有効化

d. Select an authorization grant typeでAuth Code Grantを選択

e. Auth0に関する以下の設定を実施

• Your Web Authorization URI: auth0のOAuth Authorization URL（Settings -> Advanced Settings -> Endpoints）
• Access Token URI: auth0のOAuth Token URL（Settings -> Advanced Settings -> Endpoints）
• Your Client ID: auth0のClient ID（Settings）
• Your Secret: auth0のClient Secret（Settings -> Client Secret）
• Your Authentication Scheme: HTTP Basic (Recommended)
• Scope: openid, offline_access, profile, email
• Domain List: cdn.auth0.com

Alexa Skillのカスタマイズ

a. LambdaでHTTPクライアントaxiosを実行するためにpackage.jsonへ追加する

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

{
  "name": "hello-world",
  "version": "1.2.0",
  "description": "alexa utility for quickly building skills",
  "main": "index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "author": "Amazon Alexa",
  "license": "Apache License",
  "dependencies": {
    "ask-sdk-core": "^2.7.0",
    "ask-sdk-model": "^1.19.0",
    "aws-sdk": "^2.326.0",
    "axios": "^0.18.0"
  }
}

b. Alexa Skillでアクセストークンを受け取り、/userinfoエンドポイントから取得したユーザ名を含んだ文を応答するコードに修正

• カスタムスキルコードでアクセストークンを検証して使用する
  var accessToken = handlerInput.requestEnvelope.context.System.user.accessToken;

最低限動かすポイントは2つ。

1. handlerInput.requestEnvelope.context.System.user.accessTokenを介してアクセストークンを受け取る
2. アクセエストークンを使って/userinfoエンドポイントを呼ぶ（Authorization: Bearer アクセストークン付きで/userinfoへリクエスト）

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42

/* *
 * This sample demonstrates handling intents from an Alexa skill using the Alexa Skills Kit SDK (v2).
 * Please visit https://alexa.design/cookbook for additional examples on implementing slots, dialog management,
 * session persistence, api calls, and more.
 * */
const Alexa = require('ask-sdk-core');
const axios = require('axios');
const auth0_userinfo = 'https://{auth0のドメイン}/userinfo';

const LaunchRequestHandler = {
    
    canHandle(handlerInput) {
        return Alexa.getRequestType(handlerInput.requestEnvelope) === 'LaunchRequest';
    },
    async handle(handlerInput) {
        let speakOutput = '';
        const { accessToken } = handlerInput.requestEnvelope.context.System.user;
        if (!accessToken) {
            // アカウントリンクできていないとアクセストークンが取得できない
            speakOutput = 'アカウントをリンクしてください';
            return handlerInput.responseBuilder.speak(speakOutput).getResponse();        
        } else {
            // アクセストークンを使って/userinfoエンドポイントから情報を取得
            let userInfoOptions = {
                headers: {
                    authorization: 'Bearer ' + accessToken
                }
            };
            const userInfoResponse = await axios.get(auth0_userinfo, userInfoOptions);
            const userName = userInfoResponse.data.name;
            speakOutput = `こんにちはけーくたいむへようこそ ${userName}さん`;
            
            //const speakOutput = 'Welcome, you can say Hello or Help. Which would you like to try?';
            //const speakOutput = 'こんにちはけーくたいむへようこそ';

            return handlerInput.responseBuilder
                .speak(speakOutput)
                //.reprompt(speakOutput)
                .getResponse();
        }
    }
};

c. TestにあるAlexa Simulatorを使い、応答を確認

コメント・シェア

Alexaアカウントリンク

アカウントリンクとは

アカウントリンクを使うことで、Amazon IDを他のアカウントとリンクさせる仕組み。

たとえば、ウェブベースでユーザーがタクシーを手配できる「タクシー予約」サービスがあるとします。それを元にして「アレクサ、タクシー予約でタクシーを頼んで」とユーザーがリクエストするカスタムスキルを作成できます。 このリクエストを完了するには、スキルがタクシー予約のユーザーとしてタクシー予約サービスにアクセスし、プロファイル情報と支払い情報を取得する必要があります。つまり、Alexa搭載デバイスで使うAmazonアカウントと、ユーザーのタクシー予約アカウントとのリンクが必要ということです。

認証方式

OAuth2.0

Alexa Skills Kitでは、AlexaユーザーのAmazonアカウントとサービスの既存アカウントのリンク作成に、OAuth 2.0認証フレームワークを使用します。

認証フロー

• Resource Owner: Alexa Skillの利用者
• Resource Server: 利用者のデータを持つサーバ（例：タクシー予約サービス）
• Client: Alexa Skill
• Authorization Server: OAuth2.0対応の認可サーバ（主にAuthorization code grantを使用）

認証画面のURI（Authorization URL）

アカウントリンクを開始すると認証画面のURI（Authorization URL）に移動。
認可サーバにアクセスするためのエントリーポイント。

アクセストークンのURI（Access Token URI）

認証画面のURI（Authorization URL）で認可コードを取得したら、アクセストークンのURI（Access Token URI）でアクセストークンと交換する。

Authorization ServerとしてAuth0を使う

Auth0との連携

具体的な例がInteraction-Based Authentication for Alexa Skills with Auth0にあるので参考に設定していく。

Auth0設定

• ApplicationはApplication TypeをMachine to Machine Applicationsとして作成
• Token Endpoint Authentication MethodをBasicにする
• JsonWebTokenSignatureAlgorithmをHS256にする
• Allowed Callback URLsはAlexa指定のURLを設定 (ACCOUNT LINKING -> Alexa Redirect URLs)
• Grant TypeとしてAuthorization Codeを有効化

Alexa Skill設定

Alexaの開発コンソールのACCOUNT LINKING (Build -> ACCOUNT LINKING)で以下を設定。

• **Do you allow users to create an account or link to an existing account with you?**を有効化
• **Allow users to enable skill without account linking (Recommended).**を有効化
• Select an authorization grant typeでAuth Code Grantを選択
• Your Web Authorization URI: auth0のOAuth Authorization URL（Settings -> Advanced Settings -> Endpoints）
• Access Token URI: auth0のOAuth Token URL（Settings -> Advanced Settings -> Endpoints）
• Your Client ID: auth0のClient ID（Settings）
• Your Secret: auth0のClient Secret（Settings -> Client Secret）
• Your Authentication Scheme: HTTP Basic (Recommended)
• Scope: openid, offline_access, profile, email
• Domain List: cdn.auth0.com

コメント・シェア

Alexa Skills Kitでスキル開発

Alexa Skills Kitでスキル開発にスキル開発の説明がある。

開発には**Amazon Developerアカウントが必要。

Alexaスキル公式チュートリアル（5分でスキルを作ってみよう）

チュートリアル

5分でスキルを作ってみよう

Step 1: ログイン

Alexa開発者コンソールにログイン。

Step 2: スキルを作成する

a. コンソールの右側にあるスキルの作成をクリックします。新しいページが表示されます。

Create Skillをクリック

b. スキル名フィールドにCake Timeと入力します。

c. デフォルトの言語を日本語に設定します。

d. これはカスタムスキルなので、スキルに追加するモデルを選択でカスタムを選択します。

e. スキルのバックエンドリソースをホスティングする方法を選択で、Alexaがホストを選択します。

となっているがAlexa Hostedは2つある。Node.jsを選択。

f. ページ上部にあるスキルを作成をクリックします。

Start from Scratchを使用して、Continue with templateをクリック

g.ビルドが完了したら、左パネルの呼び出し名をクリックします。

H.スキルの呼び出し名「ケークウォーク」を日本語で入力します。スキルの呼び出し名は必ず日本語で入力してください。

左パネルのInvocationで、Skill Invocation Nameを「ケークウォーク」にする

Step 3: ユーザーにあいさつする

a. Alexa開発者コンソールでCake Timeスキルを開きます。コードエディタタブをクリックします。コードエディタでindex.jsファイルが開きます。

b. LaunchRequestHandlerオブジェクトのhandle() 関数で、const speechTextで始まる行を探します。この行を以下の内容に置き換えます:

c. LaunchRequestHandlerのhandle() 関数で、.reprompt()で始まる行を探します。行の先頭にスラッシュを2つ（//）追加します。これはコメント行を意味します。つまり、コードを実行してもこの行は無視されます。

d. 次に、LaunchRequestHandlerの、今コメントアウトした行のすぐ下にある.getResponse()関数を探します。この関数は、responseBuilder’sが作成した内容をスキルが返す応答に変換します。returnで始まる行があったのを覚えているでしょうか。 この行は、送信ボタンを押すようなイメージで、応答を送信します。

修正は以下の2点

• speakOutputを独自のメッセージにカスタマイズ
• .reprompt(speakOutput)をコメントアウト

e. 保存をクリックします。

f. デプロイをクリックします

Saveをクリックしたのちに、Deploy。

InvocationでSave Modelをクリック

Build Modelをクリック

そして、Evalute Modelをクリック

Utterance profilerが起動するので、「ケークウォーク」でテスト。

Step 4: スキルをテストする

a. テスト タブをクリックします。テストシミュレーターが開きます。

b. ページ左上部のドロップダウンメニューで、開発中を選択します。

c. スキルをテストします。左上のボックスにケークウォークを開いて

ケークウォークだけでも反応する

設定した応答メッセージが表示された。

コメント・シェア

Wacom Intuos 4 Largeを入手

Wacom Intuos 4 Largeという板タブレットを購入。中古で6,590円だった。

ペン先がないと注意書きがあったが、ペンに装着されていたものは劣化しているが、ペン立て内臓の替えペン先はそのままだった。

板タブレットでUSB接続だが、当時の評価は極めて高い。

Windows 10で使えるか？

使える。
ドライバーをWacomのドライバーダウンロードページから探すがドライバーがない。
旧製品は旧タブレット製品へのリンクがあるのでそちらからダウンロードするようだ。

Intuos4 PTK-XXXがある。

見つけにくいがダウンロードボタンから。

タブレットの設定

インストールして再起動。タブレットの小さい液晶メニューが表示された。給電しただけでは表示されていなかった。

スタートメニューにワコムタブレットのプロパティが追加されている。

タブレットについてで状態をみると、バージョン6.3.30-6でデバイスドライバーが認識されている。

ペンのメニューが表示されていなかったが、タブレットに近づけて操作していると、追加されていた。
ここで感圧などを調整できる。

コメント・シェア

キーボード操作で強制的にクラッシュさせる

キーボードからのシステム クラッシュの強制実行の操作でクラッシュを起こすことができる。

キーボードの種類によって設定先のキーは異なるが、CrashOnCtrlScrollという名前でREG_DWORD値0x01を作成する。

• PS2キーボードは\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\i8042prt\Parameters
• USBキーボードは\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\kbdhid\Parameters
• Hyper-Vキーボードは\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\hyperkbd\Parameters

これを設定した状態で右Ctrlキーを押しながらScrollLockキーを2回押すとMANUALLY_INITIATED_CRASHでブルースクリーンとなる

クラッシュ操作のキーを変更する

こまったことにScrollKeyがないキーボードは多い。そのため、別のキーを割り当てなければならないことも多い。
これには、上記とおなじくキーボードの種類によって異なるが、crashdumpというキーを作成し、Dump1KeysとDump2Keyでキーの組み合わせを設定する。

• PS2キーボードは\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\i8042prt\crashdump
• USBキーボードは\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\kbdhid\crashdump
• Hyper-Vキーボードは\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\hyperkbd\crashdump

注意点

注意点が3点（うまく動かなくてハマった）

• CrashOnCtrlScrollの値を0x00にすること
• スペルに注意（crushdumpではなくてcrashdump）
• Dump1keys（複数形）とDump2Key（単数形）に注意

Dump1Keys

Dump1Keysという名前でREG_DWORDの値を以下で設定する。
これが複数系なのはたとえば0x11で左右のShiftキーのような設定が可能なため。

Dump2Key

Dump2Keyはこのコンピューターのキーボードレイアウト用のscancodeテーブルのインデックスとある。
scancodeで検索すれば各種キーボードの情報があるが、1つ挙げるとDeleteキーは0x4cだ。

設定例

たとえば右ShiftーとDeleteキー（2回）でクラッシュとする場合は以下のレジストリ設定。

1
2
3
4
5
6
7
8

Windows Registry Editor Version 5.00

[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\kbdhid\Parameters]
"CrashOnCtrlScroll"=dword:00000000

[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\kbdhid\crashdump]
"Dump1Keys"=dword:00000002
"Dump2Key"=dword:0000004c

コメント・シェア

クラッシュダンプで取得できるもの

Windowsはクラッシュ時にメモリダンプするが、設定によって取得できる領域が異なる。

これに加えて、Windows 10では以下のモードを利用することができる。デフォルトでは自動メモリダンプが選択されている。

レジストリでは\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\CrashControlに設定が保存されてている。

設定はシステムの詳細設定の起動と回復 -> 設定で確認できる。

カーネルメモリダンプに含まれないものは？

カーネルメモリダンプには未割当メモリやユーザモードアプリケーションに割り当てられたメモリは含まない。

ミニダンプに含まれるものは？

含まれているものは以下。

• Stopメッセージとそのパラメーターとその他のデータ
• 読み込まれたドライバーの一覧
• 停止したプロセッサのプロセッサ コンテキスト (PRCB)
• 停止したプロセスのプロセス情報とカーネル コンテキスト (EPROCESS)
• 停止したスレッドのプロセス情報とカーネル コンテキスト (ETHREAD)
• 停止したスレッドのカーネル モード呼び出し履歴

自動メモリダンプとカーネルメモリダンプの違いは？

2つの相違点は、ダンプファイル自体には含まれませんが、システムのページングファイルのサイズはWindowsによって設定されます。

違いはページングファイルのサイズを設定している場合に、自動的にページングファイルのサイズを大きくして取得するという点だ。
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\CrashControl\LastCrashTimeにそのイベントが記録され、ページングファイルサイズのサイズ増加は4週間保持される。

現在のページサイズはシステムの詳細設定のパフォーマンス -> 設定で確認できる。

アクティブダンプで除外されるものは？

以下が除外される。役に立たないその他さまざまな種類とは……

• 空きおよびゼロのリスト
• ファイルキャッシュ、ゲストVMのページ
• デバッグ中には役に立たないその他のさまざまな種類のメモリ上のページ

コメント・シェア

IPv6で通信できる機器はIPv6が優先される

IPv6で通信できる場合は、IPv6が優先されIPv6応答になる。

1
2
3
4
5
6

C:\Users\USER>ping TARGETHOST

TARGETHOST.local [fe80::208:9bXX:feXX:XX98%8]に ping を送信しています 32 バイトのデータ:
fe80::208:9bXX:feXX:XX98%8 からの応答: 時間 <1ms
fe80::208:9bXX:feXX:XX98%8 からの応答: 時間 <1ms
fe80::208:9bXX:feXX:XX98%8 からの応答: 時間 <1ms

IPv4で疎通を確認するには

IPv4のPingを実行するには-4オプションをつけて実行する。
-6オプションをつければIPv6で実行できる。

1
2
3
4
5
6
7

C:\Users\USER>ping -4 TARGETHOST

TARGETHOST [192.168.xxx.xxx]に ping を送信しています 32 バイトのデータ:
192.168.xxx.xxx からの応答: バイト数 =32 時間 <1ms TTL=64
192.168.xxx.xxx からの応答: バイト数 =32 時間 <1ms TTL=64
192.168.xxx.xxx からの応答: バイト数 =32 時間 <1ms TTL=64
192.168.xxx.xxx からの応答: バイト数 =32 時間 <1ms TTL=64

コメント・シェア