外部のテレフォニーサービスプロバイダーに接続する
ワンタイムパスワード(OTP)をSMSメッセージまたは音声通話でエンドユーザーに送信するには、テレフォニーインラインフックを使って外部のテレフォニーサービスプロバイダーに接続する必要があります。ここでは、テレフォニーインラインフックを追加および管理する方法について説明します。
仕組み
インラインフックを使用することで、Oktaから外部システムでホスティングされるWebサービスへのアウトバウンドコールを行うことができます。テレフォニーインラインフックを使用すると、SMSまたは音声通話認証要素が関与する登録、認証、復旧フローにテレフォニーサービスプロバイダーを統合できます。
外部のWebサービスに条件ロジックを構成することで、リクエストを各種テレフォニープロバイダーにリダイレクトできます。たとえば、発信元の国に基づいてリクエストをリダイレクトしたり、プライマリプロバイダーが失敗した場合にリクエストをセカンダリテレフォニープロバイダーにリダイレクトするエラー処理を含めたりできます。
ユーザーがOTPを要求すると、Oktaはインラインフックを使ってこのリクエストを外部のWebサービスに転送します。次に、サービスはテレフォニープロバイダーにメッセージの配信を要求します。テレフォニープロバイダーはこのリクエストを処理し、ユーザーのデバイスにOTPを送信します。また、応答としてOTP配信ステータスをOktaに送信します。この応答はSystem Logに登録されます。
テレフォニープロバイダーがOTPを配信できない場合、Oktaはフォールバックプロバイダーを使ってOTPを送信します。ただし、このフォールバックメカニズムではレートが大幅に制限されます。
開始する前に
次のいずれかの方法で、目的の外部テレフォニープロバイダーをOktaにセットアップします。
- Okta Workflowsを使用します。「外部テレフォニープロバイダー用のOkta Workflowsを構成する」を参照してください。[Invoke URL(呼び出しURL)]、[Alias(エイリアス)]、[Client Token(クライアントトークン)]をメモします。
- Okta APIを使用します。開発者ドキュメント「テレフォニーインラインフックリファレンス」を参照してください。
テレフォニーインラインフックを追加する
-
Admin Consoleで に移動します。
- [Add Inline Hook(インラインフックの追加)]をクリックし、[Telephony(テレフォニー)]を選択します。
-
次のオプションを構成します。
- [Name(名前)]:インラインフックのわかりやすい名前を入力します。
- [URL]:[Invoke URL(呼び出しURL)]を入力します。これは、OTPをエンドユーザーのデバイスに送信するエンドポイントを含むテレフォニープロバイダーのURLです。
- [Authentication field(認証フィールド)]:[Alias(エイリアス)]を入力します。
- [Authentication secret(認証シークレット)]:[Client Token(クライアントトークン)]を入力します。外部サービスは、認証シークレットを使用して、リクエストがサービスに対するOktaリクエストであることを検証する必要があります。
- 任意。[Cutom Headers(カスタムヘッダー)]を追加します。
- [Save(保存)]をクリックします。これにより、テレフォニーインラインフックがアクティブ化されます。
テレフォニーインラインフックをテストする
- [インラインフック]で、[Active(アクティブ)]なテレフォニーインラインフックを見つけ、 をクリックします。インラインフックの[プレビュー]タブが開きます。
- このタブで、[Configure inline hook request(インラインフックリクエストの構成)]に移動し、テストのためにユーザーの情報を入力します。
- [data.userProfile]:電話を有効なAuthenticatorとして使用しているユーザーの名前を入力します。
- [requestType]:ドロップダウンメニューから、MFA登録、MFA検証、アカウントのロック解除、またはパスワードリセットのいずれかのイベントを選択し、SMSテキストまたは音声通話をユーザーに送信します。
- [Preview example Inline Hook request(サンプルインラインフックリクエストのプレビュー)]セクションで、[Generate Request(リクエストを生成)]をクリックします。これにより、Oktaがテレフォニープロバイダーに送信するJSONリクエストが生成されます。
- 任意。[Edit(編集)]をクリックして生成されたリクエストを編集します。たとえば、リクエストを送信する前に、ユーザープロファイルや電話番号を編集できます。
- [View Response(サービス レスポンスの表示)]で、[View Response(レスポンスの表示)]をクリックします。これにより、サービスプロバイダーからのレスポンスが表示されます。
テスト中にテレフォニープロバイダーが失敗した場合、OTPは生成されません。
テレフォニーインラインフックの指標を表示する
Oktaでは、テレフォニーサービスプロバイダーのパフォーマンスの監視に役立つ基本的な指標が提供されます。指標は、過去30日間でフックが実行された合計回数、成功した実行数と失敗した実行数、および成功した実行の平均実行時間を追跡します。
- Admin Consoleで に移動します。
- [Active(アクティブ)]なテレフォニーインラインフックを見つけ、 をクリックします。
テレフォニープロバイダーを無効化する
orgが利用できるアクティブテレフォニーサービスプロバイダーは1つだけです。ただし、異なるテレフォニープロバイダーの複数のインラインフックを構成し、それを切り替えて使用することは可能です(たとえば、現在のプロバイダーでサービスの問題が発生した場合など)。
- Admin Consoleで に移動します。
- アクティブなテレフォニーインラインフックを見つけ、 をクリックします。
次の手順
SMS認証(MFA)を構成する
音声通話認証(MFA)を構成する