oAuth v2パスワード付与タイプを使用した認証の設定

ボットに認証を定義するには、以下の手順に従います。

1. 認証プロファイルを設定するボットを開きます。
2. トップメニューから構築タブを選択します。
3. 左側のメニューから、構成->認証プロファイルをクリックします
4. 追加をクリックします。新しい認証メカニズムダイアログが開きます。
5. 認証タイプドロップダウンリストでoAuth v2パスワード付与タイプを選択します。
6. ボットのカスタマイズされた承認を有効にするフィールドを定義します。

テナントを定義する

必要に応じて、サブドメインセクションで、ウェブアプリケーションにベースURLやユーザーインターフェイスがURLにテナント名を使用する場合、はいを選択してください。例えば、koreは、www.kore.someCompany.comとしてテナントを使用したウェブサービスのテナント組織です。下記の設定の例では、テンナンシーURLは{tenant}組織のプレースホルダが含まれます。

認証フィールドの追加

デフォルトでは、認証フィルドとはボットリクエストのメッセージのヘッダーの一部として調整されたものです。ボットのリクエストに追加の認証フィールドが必要、または想定される認証がヘッダーの一部ではない場合（例：ソーシャルセキュリティ番号やPINなど）、認証フィールドの追加をクリックして下図の通りにフィールドを定義します。

1. フィールドタイプフィルドに、以下のうちの一つを選択することができます。 必須のボットリクエストメッセージの位置および認証フィルドのタイプの次第です。
   • ヘッダー – ボットは認証フィールドをリクエストのヘッダーの一部として求めます。
   • ペイロード – ボットは認証フィールドをリクエスト本体のコンテンツの一部として求めます。
   • クエリー文字列 – ボットは認証フィールドをリクエストのボディにあるクエリー として予想します。
   • パースパラメータ（PathParam） – 認証フィールドをURLパースリクエストの一部として予想されるボット。
2. フィールドキーフィールドに、選択済のフィールドタイプフィールド名を入力してください。
3. フィールド値フィールドに、フィールドキーの指定された値を入力してください。
4. 追加をクリックします。新規の認証フィールドは認証フィールドのセクションに追加されました。
5. 認証フィールドを追加する場合、認証フィールドセクションの追加をクリックしてください。

フォーム フィールドの追加

デフォルトのユーザー名とパスワードのフィールドが承認入力のニーズを満たしていない場合は、承認 IDPフォームフィールドを追加することで、エンドユーザーに表示されるカスタムフィールドを追加できます。これらのフォームフィールドは、認証プロセスでPINコードが必要な場合などに使用することができます。認証フォームにフィールドを追加する場合、IDPフォームフィールドセクションで追加をクリックします。以下の図とはダイアログへのパスワード フィルドに追加する認証その定義の作例です。 以下のテーブルは認証IDPフォームフィルドの定義に使用するフィルドの説明です。

トークンURLの定義

トークンURLフィールドに、認証メカニズム付いたボットの配置の前に、ボットビルダーからのテスト認証設定に使用できるURLを任意に定義してください。ダイナミックフィールド、パスパラメータフィールド、クエリフィールドなどを使用して、http://{tenant}.someCompany.com/test/{{tokenId}}のようにテストURLを定義することができます。トークンURLメソッドフィールドで、トークンURLのHTTPリクエストメソッドタイプを選択します。PUT、POST、PATCH、DELETE、GETのいずれか。トークンURLコンテンツタイプフィールドで、トークンURLから予想されるコンテンツタイプを選択します。以下のうちの一つ：JSON、RSS、XML、URL符号化済のJSON、CSV、文字、ツイッター 符号化済の JSON、マルチパート/フォームデータ、マルチパート/関連、やOracle ADF。

コネクタを使用したアクセス

コネクタでアクセスのセクションで、はいを選択するとKore.aiコネクタエイジェントでKore.aiボットへのアクセスをできるようにします。もしご使用のドメインは定義済の活動的なKore.aiコネクタではない場合、警告メッセージは表示され、ボットのアドミンコンソールのシステムアドミニストレータに連絡します。詳細については、ボット管理コンソールのドキュメントのKore.aiコネクタの使用をご確認ください。認証を保存をクリックして認証設定を保存して新規認証メカニズムのダイアログを閉めます。

認証のテスト 

認証を保存した後、認証プロファイルページからテストをクリックすると、認証の定義をテストすることができます。テストをクリックすると、テスト認証ダイアログが表示され、認証チェックURLセクションにご指定のURLが追加されます。テストをクリックすると認証テストを開始します。認証の検証が完成の場合、テスト認証のウィンドウが閉じて、その検証の結果、成功や失敗は即刻、テスト認証のボタンに表示します。認証失敗の場合、下記の図の通りに、認証テスト失敗のメッセージはヘッダーおよびレスポンスのタブとともに表示します。