이 주제에서는 애플리케이션을 등록하는 방법과 애플리케이션과 Kore.ai 봇 플랫폼 간에 메시지를 교환하는 데 필요한 클라이언트의 자격 증명을 생성하는 방법을 설명합니다. 앱을 등록할 때, 보안 알고리즘을 선택해야 합니다.

  • HS256 – 봇 빌더는 서버에서 JWT 토큰을 생성하는 데 필요한 클라이언트 ID 및 클라이언트 시크릿을 생성하고 표시합니다.
  • RS256 – 공개 키를 플랫폼에 업로드하고 개인 키를 사용하여 서버에서 서명을 생성합니다.

앱 등록 방법

  1. 웹/모바일 클라이언트 채널을 추가하려는 봇을 엽니다.
  2. 상단 메뉴에서 배포 탭을 선택합니다
  3. 왼쪽 메뉴에서, 채널 > 웹/모바일 클라이언트를 클릭합니다.
  4. 앱 선택 드롭다운 목록에서, 기존 앱 등록을 선택하거나 앱 생성을 클릭하여 새 앱을 생성합니다.
  5. 이름 필드에서, 봇 빌더에 사용되는 앱 등록을 위한 이름을 입력합니다. 예: My App Registration.
  6. 앱의 이러한 범위 중 하나를 선택합니다.
    • 익명 사용자가 봇과 대화할 수 있도록 허용: 익명 사용자가 봇과 인터렉션 할 수 있습니다.
    • Kore.ai 봇 플랫폼에 새 사용자 자동 등록: 사용자 어설션(assertion)을 알 수 없는 경우 Kore.ai에서 자동 사용자 등록을 통제하려면 선택합니다.
  7. 클라이언트 앱 인증에 사용되는 JWT 서명 알고리즘 드롭다운 목록에서, 다음 보안 알고리즘 중 하나를 선택합니다.
    • RS256: 공개 키 필드를 활성화하려면 선택합니다. 공개 키는 Kore.ai 봇 플랫폼이 클라이언트 애플리케이션을 인증하는 데 사용됩니다.
    • HS256: 시크릿 키클라이언트 ID를 생성하려면 선택합니다. 클라이언트 ID는 SDK 초기화를 위해 필요하며, 시크릿 키는 Kore.ai 봇 플랫폼이 클라이언트 애플리케이션을 인증하는 데 사용됩니다.

    위의 키를 생성하는 방법은 여기를 참조하세요.

  8. 선택적으로, 푸시 알림 섹션에서, 활성화를 클릭한 다음, 알림을 보낼 URL을 지정합니다.
  9. 생성을 클릭합니다. 앱 등록 세부 정보가 나타납니다.
  10. 애플리케이션의 앱 등록 세부 정보를 클립보드에 복사하려면, 봇 이름, 봇 ID 및 클라이언트 ID에 대해 복사를 클릭할 수 있습니다. 클라이언트 시크릿의 경우, 보기를 클릭한 다음, 복사를 클릭합니다.
  11. 경고 작업 설정 허용 섹션에서, 를 선택하여 애플리케이션 사용자가 웹 클라이언트를 사용하여 자신의 경고 작업을 설정할 수 있도록 합니다. 기본적으로, 이 설정은 웹 클라이언트 사용자에게 비활성화되어 있지만, 모바일 클라이언트 사용자는 언제든지 자신의 알림을 설정할 수 있습니다.
  12. 채널 활성화 섹션에서, 를 선택하여 저장 후 바로 채널을 사용하도록 설정합니다.
  13. 저장을 클릭하여 설정을 저장하고 웹/모바일 클라이언트 채널 페이지를 닫습니다.

채널 정보가 성공적으로 업데이트 됨 메시지가 페이지의 오른쪽 상단 모서리에 표시됩니다.

이 주제에서는 애플리케이션을 등록하는 방법과 애플리케이션과 Kore.ai 봇 플랫폼 간에 메시지를 교환하는 데 필요한 클라이언트의 자격 증명을 생성하는 방법을 설명합니다. 앱을 등록할 때, 보안 알고리즘을 선택해야 합니다.

  • HS256 – 봇 빌더는 서버에서 JWT 토큰을 생성하는 데 필요한 클라이언트 ID 및 클라이언트 시크릿을 생성하고 표시합니다.
  • RS256 – 공개 키를 플랫폼에 업로드하고 개인 키를 사용하여 서버에서 서명을 생성합니다.

앱 등록 방법

  1. 웹/모바일 클라이언트 채널을 추가하려는 봇을 엽니다.
  2. 상단 메뉴에서 배포 탭을 선택합니다
  3. 왼쪽 메뉴에서, 채널 > 웹/모바일 클라이언트를 클릭합니다.
  4. 앱 선택 드롭다운 목록에서, 기존 앱 등록을 선택하거나 앱 생성을 클릭하여 새 앱을 생성합니다.
  5. 이름 필드에서, 봇 빌더에 사용되는 앱 등록을 위한 이름을 입력합니다. 예: My App Registration.
  6. 앱의 이러한 범위 중 하나를 선택합니다.
    • 익명 사용자가 봇과 대화할 수 있도록 허용: 익명 사용자가 봇과 인터렉션 할 수 있습니다.
    • Kore.ai 봇 플랫폼에 새 사용자 자동 등록: 사용자 어설션(assertion)을 알 수 없는 경우 Kore.ai에서 자동 사용자 등록을 통제하려면 선택합니다.
  7. 클라이언트 앱 인증에 사용되는 JWT 서명 알고리즘 드롭다운 목록에서, 다음 보안 알고리즘 중 하나를 선택합니다.
    • RS256: 공개 키 필드를 활성화하려면 선택합니다. 공개 키는 Kore.ai 봇 플랫폼이 클라이언트 애플리케이션을 인증하는 데 사용됩니다.
    • HS256: 시크릿 키클라이언트 ID를 생성하려면 선택합니다. 클라이언트 ID는 SDK 초기화를 위해 필요하며, 시크릿 키는 Kore.ai 봇 플랫폼이 클라이언트 애플리케이션을 인증하는 데 사용됩니다.

    위의 키를 생성하는 방법은 여기를 참조하세요.

  8. 선택적으로, 푸시 알림 섹션에서, 활성화를 클릭한 다음, 알림을 보낼 URL을 지정합니다.
  9. 생성을 클릭합니다. 앱 등록 세부 정보가 나타납니다.
  10. 애플리케이션의 앱 등록 세부 정보를 클립보드에 복사하려면, 봇 이름, 봇 ID 및 클라이언트 ID에 대해 복사를 클릭할 수 있습니다. 클라이언트 시크릿의 경우, 보기를 클릭한 다음, 복사를 클릭합니다.
  11. 경고 작업 설정 허용 섹션에서, 를 선택하여 애플리케이션 사용자가 웹 클라이언트를 사용하여 자신의 경고 작업을 설정할 수 있도록 합니다. 기본적으로, 이 설정은 웹 클라이언트 사용자에게 비활성화되어 있지만, 모바일 클라이언트 사용자는 언제든지 자신의 알림을 설정할 수 있습니다.
  12. 채널 활성화 섹션에서, 를 선택하여 저장 후 바로 채널을 사용하도록 설정합니다.
  13. 저장을 클릭하여 설정을 저장하고 웹/모바일 클라이언트 채널 페이지를 닫습니다.

채널 정보가 성공적으로 업데이트 됨 메시지가 페이지의 오른쪽 상단 모서리에 표시됩니다.

このトピックでは、アプリケーションを登録し、アプリケーションと Kore.ai ボット プラットフォームとの間でメッセージをやり取りするために必要なクライアントの資格情報を生成する方法について説明します。アプリを登録する際には、セキュリティ アルゴリズムを選択する必要があります:

  • HS256 ー ボットビルダーは、サーバーから JWT トークンを生成するのに必要なクライアント ID とクライアント シークレットを生成して表示します。
  • RS256 ー パブリック キーをプラットフォームにアップロードし、プライベート キーを使用してサーバーから署名を生成します。

アプリを登録するには

  1. Web/モバイル クライアント チャネルを追加したいボットを開きます。
  2. トップメニューから[デプロイ]タブを選択します
  3. 左側のメニューで、[チャネル > Web/モバイル] クライアントをクリックします。
  4. [アプリの選択] ドロップダウンリストで、既存のアプリ登録を選択するか、[アプリの作成] をクリックして新しいアプリを作成します。
  5. "名前" フィールドには、ボットビルダーで使用するアプリ登録の名前を入力します。例: マイ アプリの登録
  6. アプリのスコープのいずれか 1 つを選択します:
    • 匿名ユーザーがボットとのチャットを許可: 匿名ユーザーがボットと対話できるようにします。
    • Kore.ai ボット プラットフォームに新規ユーザー自動登録: ユーザー アサーションが不明な場合、Kore.ai での自動ユーザー登録を制御するために選択します。
  7. クライアント アプリの認証に使用するJWT 署名アルゴリズム ドロップダウンリストで、以下のセキュリティ アルゴリズムのいずれか 1 つを選択します:
    • RS256: "パブリック キー" フィールドを有効にするために選択します。[パブリック キー] は、Kore.ai ボット プラットフォームがクライアント アプリケーションを認証するために使用します。
    • HS256: [シークレット キー]と[クライアント ID] を生成するために選択します。[クライアント ID] は SDK の初期化に必要となるものであり、シークレット キーは Kore.ai ボット プラットフォームがクライアント アプリケーションを認証する際に使用します。

    上記キーの生成方法についてはこちらをご覧ください

  8. オプションとして、[プッシュ通知] セクションで [有効にする] をクリックし、通知の送信先の URL を指定します。
  9. [作成] をクリックします。アプリ登録の詳細が表示されます。
  10. [ボット名]、[ボット ID]、[クライアント ID] などのアプリ登録の詳細をクリップボードにコピーして使用するには、[コピー] をクリックします。 [クライアントのシークレット] については、[ビュー]をクリックし、さらに[コピー]をクリックします。
  11. [アラート タスクの設定を許可する]セクションでは、 [はい]を選択して、アプリケーションのユーザーが Web クライアントを使用して独自のアラート タスクをセットアップできるようにします。デフォルトでは、この設定は Web クライアントのユーザーに対しては無効になっていますが、モバイル クライアントのユーザーはいつでも独自のアラートをセットアップできます。
  12. [チャネルを有効にする] の項目で、[はい]を選択すると、保存後すぐにチャネルが有効になります。
  13. [保存] をクリックすると、設定が保存され、Web/モバイル チャネルのページが閉じます。

ページの右上に「チャネル情報が更新されました」のメッセージが表示されます。

This topic describes how to register your application and generate credentials for you clients that are required to exchange messages between your application and the Kore.ai Bots Platform.
When you register your app, you will need to select a security algorithm:

  • HS256 – Bot Builder generates and displays the Client ID and Client Secret necessary to generate the JWT token from your server.
  • RS256 – You upload your public key to the platform and use the private key to generate the signature from your server.

To register an app

  1. Open the bot to which you want to add the Web/Mobile Client channel.
  2. Select Deploy tab from the top menu
  3. From the left menu, click Channel > Web/Mobile Client.
  4. In the Select App drop-down list, select your existing app registration or click Create App to create a new app.
  5. In the Name field, enter the name for the app registration used in Bot Builder, for example, My App Registration.
  6. Select one of these scopes for the app:
    • Allow anonymous users to chat with the bot: enables anonymous users to interact with the bot.
    • Auto register new users on Kore.ai Bots Platform: Select to control the auto-user registration in Kore.ai if the user assertion is unknown.
  7. In the JWT Signing Algorithms Used For Client App Authentication drop-down list, select one of the following security algorithms:
    • RS256: Select to enable the Public Key field. The Public Key is used by the Kore.ai Bots Platform to authenticate the client application.
    • HS256: Select to generate a Secret Key and a Client ID. The Client ID is required for SDK initialization, and the Secret Key used by the Kore.ai Bots Platform to authenticate the client application.

    Refer here on how to generate the above keys.

  8. Optionally, In the Push Notifications section, click Enable and then specify a URL to send the notifications to.
  9. Click Create. The app registration details appear.
  10. To copy the app registration details to the clipboard for your application, you can click Copy for Bot Name, Bot ID, and Client ID. For Client Secret, click View, and then click Copy.
  11. In the Allow Alert Task Setup section, Select Yes to enable your application users to set up their own alert tasks using the web client. By default, this setting is disabled for web client users, but mobile client users can always setup their own alerts.
  12. In the Enable Channel section, select Yes to enable the channel immediately after saving.
  13. Click Save to save the settings and close the Web/Mobile Client Channel page.

The Channel Information updated successfully message is displayed on the top-right corner of the page.