Amazon Alexa スポークのセットアップ

リリースバージョン: Zurich

更新日 2025年07月31日

所要時間：6分

Amazon Alexa にカスタム OAuth アプリケーションを作成して ServiceNow インスタンスと Amazon Alexa アカウントをデータ統合し、ServiceNow 要求を認証します。

始める前に

統合ハブサブスクリプションを要求します。
Amazon Alexa スポークを有効にします。
必要なロール：admin

セキュリティプロファイルの作成

ServiceNow インスタンスで Login with Amazon を使用するには、開発者コンソールでセキュリティプロファイルを作成および登録します。

始める前に

必要なロール：admin

手順

アドミン認証情報を使用して Amazon Developer Portal にログインします。
セキュリティプロファイルを作成します。
セキュリティプロファイルの作成の詳細については、「Amazon 開発者ドキュメント (Amazon Developer Documentation)」の「LwA セキュリティプロファイルの作成 (Create an LwA Security Profile)」を参照してください。
後で使用するために [クライアント ID] と [クライアントシークレット] の値をコピーして記録します。

セキュリティプロファイルを構成し、[Web 設定 (Web Settings)] で次の値を指定します。


フィールド	値
許可された作成元 (Allowed Origins)	ServiceNow インスタンス URL。
許可された戻り先 URL (Allowed Return URLs)	形式 `https://<Instance-Name>.com/oauth_redirect.do` での ServiceNowインスタンスリダイレクト URL

セキュリティポリシーの設定の詳細については、「Amazon 開発者ドキュメント (Amazon Developer Documentation)」の「セキュリティプロファイルへの Web サイトの追加 (Add your Website to your Security Profile)」を参照してください。

OAuth プロバイダーとしてAmazon Alexaを登録

セキュリティプロファイルの構成中に生成された情報を使用し、Amazon Alexa を OAuth プロバイダーとして登録して、ServiceNow インスタンスが OAuth 2.0 トークンを要求できるようにします。

始める前に

必要なロール：admin。

手順

移動先すべて > システム OAuth > アプリケーションレジストリー.
Amazon Alexa のレコードを開きます。

フォームに、次の値を入力します。

表 : 1. アプリケーションレジストリフォーム
フィールド	説明
クライアント ID	セキュリティプロファイルの構成中に作成されたクライアント ID。
クライアントシークレット	セキュリティプロファイルの構成中に作成されたクライアントシークレット。
認証 URL	OAuth 認証コードのエンドポイント。「`https://www.amazon.com/ap/oa`」と入力します。
トークン URL	OAuth サーバートークンエンドポイント。「`https://api.amazon.com/auth/o2/token`」と入力します。
リダイレクト URL	形式 `https://<instance>.service-now.com/oauth_redirect.do` での OAuth コールバックエンドポイント
デフォルトの権限許可タイプ	トークンを確立するために使用される権限許可のタイプ。認証コードを選択します。
アプリケーション	このレコードを含むアプリケーションスコープ。
有効	アプリケーションレジストリを積極的に使用するためのオプション。

フォームヘッダーを右クリックし、[保存] をクリックします。

Amazon Alexa スポークの認証情報レコードの作成

Amazon Alexa アカウント用の認証情報レコードを作成します。Amazon Alexa スポークの接続および資格情報エイリアスでは、これらの認証情報を使用してアクションを許可します。

始める前に

必要なロール：admin。

手順

移動先すべて > 接続 & 認証情報 > 認証情報.
[New] をクリックします。

「作成する認証情報のタイプは？」というメッセージが表示されます。
[OAuth 2.0 認証情報] を選択します。

フォームに、これらの値を入力します。

表 : 2. OAuth 2.0 認証情報フォーム
フィールド	説明
名前	レコードを一意に識別する名前を入力します。例：「`Alexa Cred`」。
有効	認証情報レコードを積極的に使用するオプションです。
OAuth エンティティプロファイル	Amazon Alexa を OAuth プロバイダーとして登録する際に作成される OAuth プロファイル。例：`Amazon Alexa default_profile`。
認証情報エイリアス	スポークに関連付けられた認証情報エイリアスです。

フォームヘッダーを右クリックし、[送信]をクリックします。
OAuth トークンを生成するには、[OAuth トークンの取得] 関連リンクをクリックします。
Amazon ポータルにリダイレクトされます。
[許可] をクリックします。
ServiceNow インスタンスにリダイレクトされて戻ります。

Amazon Alexa スポークの接続レコードの作成

Amazon Alexa アカウントの接続レコードを作成します。Amazon Alexa スポークの接続および資格情報エイリアスでは、これらの接続を使用して Amazon Alexa でアクションを実行します。

始める前に

必要なロール：admin。

手順

移動先すべて > 接続 & 認証情報 > 接続および資格情報エイリアス.
エイリアスレコード AmazonAlexa を開きます。
[接続] で、[新規] をクリックします。

フォームの各フィールドに入力します。

表 : 3. 接続フォーム
フィールド	説明
名前	レコードを一意に識別する名前を入力します。例：「`Alexa 接続`」。
認証情報	Amazon Alexa スポーク用に作成された認証情報レコード。例：「`Alexa Cred`」。
接続エイリアス	接続に関連付けられているエイリアスレコードです。
接続 URL	Amazon Alexa に接続するためのベース URL。「`https://api.amazonalexa.com`」と入力します。
有効	接続レコードを積極的に使用にするオプションです。
ドメイン	アクションを実行するドメイン。

[属性] タブで、[バージョン] に「v1」と入力します。
[送信] をクリックします。

Amazon Alexa スポークの Webhook のセットアップ

Webhook レジストリを作成して、Amazon Alexa アカウントから ServiceNow インスタンスへの受信要求を認証します。

始める前に

必要なロール：admin

手順

フィルターナビゲーターで、「token_verification.list」と入力します。
トークン検証 [token_verification] テーブルのレコードが表示されます。
[新規] をクリックします。

フォームに、次の値を入力します。

表 : 4. トークン検証フォーム
フィールド	説明
名前	トークンレコードを識別する名前。例：「`Alexa トークン`」。
説明	トークンの簡単な説明。
トークン	トークンの値。この値は、使用される前に暗号化されます。

[Submit (送信)] を選択します。
移動先 Alexa Webhook > Alexa Webhook レジストリ.
[New] をクリックします。

フォームに、次の値を入力します。

表 : 5. Alexa Webhook レジストリフォーム
フィールド	説明
名前	Webhook レジストリレコードを識別する名前。例：「`Alexa トークン`」。
説明	Webhook レジストリレコードの簡単な説明。
トークン	作成したトークン。例：「`Alexa トークン`」。
パス	スクリプト化された REST エンドポイント。デフォルトのエンドポイントを利用できます。要件に応じてデフォルト値を変更できます。

フォームヘッダーを右クリックし、 [保存] をクリックします。
[コールバック URL] をクリックします。
Webhook コールバック URL が確認メッセージに表示されます。この値をコピーして記録します。
AWS Management Console にログインします。
AWS Lambda 関数で、Webhook コールバック URL を指定し、変更を保存します。
Alexa 開発者コンソールにログインします。
移動先ビルド > カスタム > エンドポイントをクリックし、設定した AWS Lambda 関数の ARN を指定します。