こちらで、Kore.aiのバーチャルアシスタントプラットフォームでの通知タスクの設定方法について確認しました。このセクションでは、通知タスクに対する基本的な権限の設定方法について見ていきます。
フォームフィールド
デフォルトのユーザー名とパスワードのフィールドがご需要を満たしていない場合、認証フォームのフィールドを追加することで、エンドユーザーに表示される新しいフィールドを追加することができます。認証フォームにフィールドを追加するには、[+フォーム フィールドの追加] をクリックします。以下の図とはダイアログへのパスワード フィールドに追加する認証その定義の作例です。 以下のテーブルは認証IDPフォームフィールドの定義に使用するフィールドの説明です。
フィールド名 | 説明 |
---|---|
フィールド タイトル | 認証ダイアログでエンドユーザー表示するフィールド名を指定します。 |
フィールドキー | この値は認証サービスにエンドユーザーが入力する値を示します。 |
ヘルプのヒント | フィールドに表示されるヘルプ文字はフィールドに入力すべくものを説明しています。 |
フィールドタイプ | 上級オプションと選択した場合、エンドユーザーインターフェイスに表示されるフィールドのタイプを指定して、ユーザー入力の割り当てたフィールドキー値として収集します、以下のうちの一つ:
|
必須 | 上級オプションと選択した場合、エンドユーザーは必ずこのフィールドを定義して認証を完成してください。 |
データタイプ | 上級オプションと選択した場合、エンドユーザーからの入力と予想するデータタイプを指定してください。例えば、文字列。 |
可視性 | [詳細オプション] を選択した場合、認証フィールドを表示、非表示、または読み取り専用のいずれにするかを指定します。 |
承認フィールド
デフォルトでは、認証フィールドとはタスクリクエストのメッセージのヘッダーの一部として調整されたものです。もしタスクリクエストには追加の認証フィールドが必須、または予想の認証はのヘッダーの一部ではないの場合(例:ソーシャルセキュリティ番号やPINなど)、+認証フィールドの追加をクリックして下記の図の通りにフィールドを定義します。
- フィールドタイプフィールドに、以下のうちの一つを選択することができます: 必須のタスクリクエストメッセージの位置および認証フィールドのタイプの次第です。ヘッダー―Botは、リクエストのヘッダの一部として認証フィールドを予想します。ペイロード―Botは、リクエストの本文のコンテンツの一部として認証フィールドを予想します。クエリー文字列―Botは認証フィールドをリクエストのボディにあるクエリー として予想します。パースパラメータ(PathParam)―認証フィールドをURLパースリクエストの一部として予想されるBot。
- フィールドキーフィールドに、選択済のフィールドタイプフィールド名を入力してください。
- フィールド値フィールドに、フィールドキーの指定された値を入力してください。
- 完了をクリックします。新規の認証フィールドは認証フィールドのセクションに追加されました。
- 認証フィールドを追加する場合、認証フィールドセクションの追加をクリックしてください。
- 認証チェックURLフィールドで、認証メカニズムでボットを展開する前にボットビルダー から認証設定をテストするために使用できるURLを定義します。ダイナミックフィールド、パスパラメータフィールド、クエリフィールドなどを使用して、テスト URL を定義することができます。たとえば、https://kore.someCompany.com/sap/opu/odata/sap/{{authfield1}}/?$format=json
- コネクタでアクセスのセクションで、はいを選択するとKore.aiコネクタエイジェントでKore.aiボットへのアクセスをできるようにします。もしご使用のドメインは定義済の活動的なKore.ai コネクタではないの場合、警告メッセージは表示され、ボットのアドミンコンソールのシステムアドミニストレータに連絡します。詳細については、ボット管理コンソールのドキュメントのKore.aiコネクタの使用を参照してください。
- 保存をクリックして保存認証を保存して新規認証メカニズムのダイアログを閉めます。
テスト
認証の保存後、新しい認証タイプに認証確認URLを定義していた場合は、認証タブで認証定義をテストすることができます。
- タスクの残りの手順の開発を続ける前に、認証をテストをクリックします。
- テスト認証をクリックすると、下記の図の通りに、テスト認証ダイアログは表示され、そして認証チェックURLセクションにご指定のURLが発生します。
認証(基本認証)のテストの設定は、以下の手順に従います。
- 認証チェックURLフィールドに、実証やURLをテスト認証調整に入力してください。
- Botはサブドメインを使用する場合、テンナンシーフィールドは表示されて、必ずテナントを指定してください。
- ウェブサービスのユーザー名とパスワードを入力します。
- URL として求めるコンテンツ タイプは、 [コンテンツ タイプ] フィールドで選択します。
- URLのテストの場合、方法フィールドはリードオンリーそしてGETと設定されました。</li>
- テストをクリックすると認証テストを開始します。
認証の検証が完成の場合、下記の図の通りに、テスト認証のウィンドウが閉じて、その検証の結果、成功や失敗は即刻、テスト認証のボタンに表示します。 認証失敗の場合、下記の図の通りに、認証テスト失敗のメッセージはヘッダーおよび応答のタブとともに表示します。
仕組みについて
タスクに基本認証を使用する場合、下記の図の通り、Kore.aiアプリケーションは自動的にユーザーをプロンプトしてクレデンシャルのロクインでウェブアプリケーションやウェブサービスへのアクセスへ進めます。エンドユーザーが承認された後、以下のシンタックスを使用して設定が保存されます。
{{ First Name }} {{ Last Name }} {{ Bot Name }} {{ Account # }} {{ Sequence # }}
たとえば、ジョン・スミスのツイッター アカウント#1。Kore.aiアプリケーションは、このアカウントを使用して、将来のすべてのタスクリクエストに対して、WebアプリケーションまたはWebサービスにアクセスすることができます。その他、エンドユーザーはアカウントを他のタスクに同じボットで再使用することができます。