サービスノードから認証を管理する外部アプリケーションに URL を提供することで、ボットのカスタム認証を実装できます。 プラットフォームは、成功および失敗した認証シナリオを処理し、対応するタスクフローを管理するために必要な機能を提供します。
カスタム認証を実装するための ボットビルダーメカニズムには、次のステップがあります。
ステップ１：サービスノードからカスタム認証URLを生成する
カスタム認証を実装するには、まず、認証サービスの URL を使用してダイアログタスクのサービスノードを設定する必要があります。 そうすることで、入力した認証 URL がボットの Webフックで内部的に追加され、カスタム認証 URL が作成されます。 これにより、認証サービスが認証プロセスの完了後に必要な詳細情報をプラットフォームに送信できるようになります。
ステップ２：コンテキストを入力し、カスタムURLをユーザーに提示する
タスクの実行中、ダイアログがサービスノードに到達すると、プラットフォームはコンテキスト内にカスタマー認証URLを入力し、認証証明を要求するメッセージをエンドユーザーに提示します。そのあと、プラットフォームは外部認証サービスがWebフック上でレスポンスを送信するまで待機します。
ステップ 3: 認証完了後のコールバックを受信する
外部システムは、コンテキストオブジェクトに入力されたWebフックURLを使用して、プラットフォームへのコールバックを実行します。すべての処理が完了すると、ノードに定義された遷移に基づいてダイアログタスクが進行します。
カスタム認証サービスの設定
- カスタム認証を実装するダイアログタスクを開きます。
- タスクフロー内の適切なノードの後に、サービスノードを追加します。
- ノードのコンポーネントプロパティパネルで、 ノード名を入力します。
- サービスタイプ ドロップダウンリストで、 カスタム認証サービス を選択します。
- 認証 URL フィールドに、外部認証サービスの URL を入力します。
- レスポンスセクションには、ボットがユーザーに提示するデフォルトの認証要求メッセージが表示されます。メッセージを直接編集するか、管理をクリックして、高度なまたはチャネル固有のメッセージを定義することができます。メッセージのフォーマットとテンプレートについて学習します。
注意： ここでのデフォルトメッセージは、サービスノードのデフォルト名に基づいています。 次の URL を使用して認証 {{context.<>.customAuthenticationURL}}に進んでください。 ノード名をあとで変更した場合は、変更後の名前を反映するようにメッセージも更新してください。
- 最後に、ノードの遷移を定義します。