テレフォニーサービスプロバイダーのカスタマイズ
デフォルトでは、Oktaはテレフォニーワークフローを所定のサービスプロバイダーにルーティングします。ただし、テレフォニーインラインフックを使用して、Organizationのテレフォニーサービスプロバイダーをカスタマイズできます。
テレフォニーインラインフックを構成すると、SMSテキストメッセージまたは音声通話を送信するすべてのワークフローに対して、Okta Verify登録を除く任意のテレフォニーサービスプロバイダーを使用できます。たとえば、テレフォニーインラインフックを作成して、エンドユーザーまたは顧客がSMSテキストメッセージとして送信されるワンタイムパスコード(OTP)を要求したときに使用する通信プロバイダーに接続できます。
テレフォニーインラインフックを使用するには、OrganizationにOkta Identity Engineが必要です。
外部サービスへの接続
テレフォニーインラインフックを使用すると、外部Webサービスを設定してテレフォニーサービスプロバイダーに接続し、電話をオーセンティケーターとして使用する登録、認証、および復旧ワークフローを実行できます。たとえば、ユーザーが多要素認証の一部としてワンタイムパスコードを要求した場合、Oktaは外部Webサービスを使用してサービスプロバイダーに接続し、ユーザーに代わって要求を行います。サービスプロバイダーはOTPを要求者のデバイスに配信し、外部WebサービスはOTPの配信が成功したか失敗したかを示すメッセージでOktaに応答します。
各Organizationが使用できるアクティブなテレフォニーインラインフックは、一度に1つだけです。ただし、外部Webサービスのロジックで、指定した条件に基づいて、要求をさまざまなテレフォニープロバイダーに送信できます。たとえば、要求の送信元の国に基づいて、異なるテレフォニープロバイダーに要求を送信できます。同様に、カスタムコードには、プライマリテレフォニープロバイダーがメッセージの配信に失敗した場合にセカンダリテレフォニープロバイダーに要求を送信するためのエラー処理が含まれる場合があります。
インラインフックを追加する前に、選択したテレフォニープロバイダーからの要求と応答のJSONオブジェクトを定義する外部Webサービスを作成する必要があります。「テレフォニーインラインフックのリファレンス」で、要求と応答のJSONオブジェクトwebを作成するための参考資料を確認できます。使用するテレフォニープロバイダー用に外部Webサービスの要求と応答のJSONオブジェクトを準備したら、Okta Admin Consoleからテレフォニーインラインフックを追加および管理できます。
Oktaインラインフックの概要については、「インラインフック」を参照してください。外部サービスエンドポイントをOktaに登録するためのAPIについては、「インラインフックの管理API」を参照してください。
テレフォニーインラインフックの追加
要求と応答のプレビュー
テレフォニープロバイダーの指標の表示
Oktaは、電話サービスプロバイダーのパフォーマンスを監視するのに役立つ基本的な指標を提供します。指標は、30日間でフックが実行された合計回数を追跡し、成功した実行数、失敗した実行数、および成功した実行の平均実行時間を示します。
テレフォニーサービスプロバイダーの指標を表示するには:
-
Okta Admin Consoleで、[Workflow(ワークフロー)]>[Inline Hooks(インラインフック)]の順に移動します。
-
現在[Active(アクティブ)]であるテレフォニーインラインフックを特定します。
-
[Actions(アクション)]をクリックし、[Metrics(指標)]を選択します。
テレフォニープロバイダーの無効化
1つのOrganizationに対してアクティブなテレフォニーサービスプロバイダーを1つだけ持つことができます。ただし、異なるテレフォニープロバイダーに対して複数のインラインフックを構成し、1つを非アクティブ化してもう一つをアクティブ化することでプロバイダーを変更できます。たとえば、利用可能なプロバイダーが2つあるが、現在アクティブなプロバイダーでサービスの遅延が発生している場合は、セカンダリプロバイダーに切り替えることができます。
テレフォニーサービスプロバイダーを無効にするには:
-
Okta Admin Consoleで、[Workflow(ワークフロー)]>[Inline Hooks(インラインフック)]の順に移動します。
-
現在[Active(アクティブ)]であるテレフォニーインラインフックを特定します。
-
[Actions(アクション)]をクリックし、[Deactivate(非アクティブ化)]を選択します。
-
現在非アクティブであるテレフォニーインラインフックを特定します。
-
[Actions(アクション)]をクリックし、[Activate(アクティブ化)]を選択します。