Amazon Alexa スポークのセットアップ
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)] で次の値を指定します。
セキュリティポリシーの設定の詳細については、「Amazon 開発者ドキュメント (Amazon Developer Documentation)」の「セキュリティプロファイルへの Web サイトの追加 (Add your Website to your Security Profile)」を参照してください。フィールド 値 許可された作成元 (Allowed Origins) ServiceNow インスタンス URL。 許可された戻り先 URL (Allowed Return URLs) 形式 https://<Instance-Name>.com/oauth_redirect.do での ServiceNowインスタンスリダイレクト URL
Amazon Alexa スポークの接続の設定
Amazon Alexa 接続を追加して設定し、Amazon Alexa スポークで ServiceNow 要求を認証します。
始める前に
必要なロール:admin
手順
- 移動先 すべて > プロセス自動化 > ワークフロースタジオ.
- [統合] タブをクリックします。
- [ 接続] には、デフォルトで 送信 接続が表示されます。
- AmazonAlexa 接続エイリアスを見つけて、[詳細を表示] をクリックします。
-
[接続] フォームのフィールドに入力します。
フィールド 説明 接続情報 接続名 レコードを一意に識別する名前。デフォルトでは、名前は AmazonAlexa です。 接続 URL Amazon Alexa に接続するためのベース URL。「https://api.amazonalexa.com」と入力します。 API バージョン Amazon Alexa の必要な API バージョン。v1 と入力します。 認証情報 OAuth エンティティ名 OAuth エンティティレコードを識別する名前です。例: Amazon Alexa OAuth。 OAuth クライアント ID セキュリティプロファイルの構成中に作成されたクライアント ID。 OAuth クライアントシークレット セキュリティプロファイルの構成中に作成されたクライアントシークレット。 OAuth リダイレクト URL OAuth コールバックエンドポイントのフォーマット:https://<instance>.service-now.com/oauth_redirect.do<instance> をServiceNowインスタンス名に置き換えます。 - [OAuth トークンを設定して取得 (Configure and get OAuth Token)] をクリックします。
Amazon Alexa スポークの Webhook のセットアップ
Webhook レジストリを作成して、Amazon Alexa アカウントから ServiceNow インスタンスへの受信要求を認証します。
始める前に
必要なロール:admin
手順
-
フィルターナビゲーターで、「token_verification.list」と入力します。
トークン検証 [token_verification] テーブルのレコードが表示されます。
- [新規] をクリックします。
-
フォームに、次の値を入力します。
表 : 1. トークン検証フォーム フィールド 説明 名前 トークンレコードを識別する名前。例:「Alexa トークン」。 説明 トークンの簡単な説明。 トークン トークンの値。この値は、使用される前に暗号化されます。 - [送信] をクリックします。
- 移動先 Alexa Webhook > Alexa Webhook レジストリ.
- [New] をクリックします。
-
フォームに、次の値を入力します。
表 : 2. Alexa Webhook レジストリフォーム フィールド 説明 名前 Webhook レジストリレコードを識別する名前。例:「Alexa トークン」。 説明 Webhook レジストリレコードの簡単な説明。 トークン 作成したトークン。例:「Alexa トークン」。 パス スクリプト化された REST エンドポイント。デフォルトのエンドポイントを利用できます。要件に応じてデフォルト値を変更できます。 - フォームヘッダーを右クリックし、 [保存] をクリックします。
-
[コールバック URL] をクリックします。
Webhook コールバック URL が確認メッセージに表示されます。この値をコピーして記録します。
- AWS Management Console にログインします。
-
AWS Lambda 関数で、Webhook コールバック URL を指定し、変更を保存します。
- Alexa 開発者コンソールにログインします。
-
移動先 ビルド > CUSTOM > エンドポイント をクリックし、設定した AWS Lambda 関数の ARN を指定します。