Admin Consoleでテレフォニープロバイダーを構成する
Admin Consoleで外部のテレフォニープロバイダーに接続して、ユーザーにワンタイムパスコード（OTP）を送信します。このトピックでは、Admin Consoleでテレフォニーサービスプロバイダーを追加し管理する方法について説明します。
仕組み
TwilioとTelesignのいずれか、または両方をテレフォニーサービスプロバイダーとして構成できます。Okta Admin Consoleで構成する場合、Oktaはorgとテレフォニープロバイダーの間の通信を処理します。テレフォニープロバイダーをカスタマイズするには、テレフォニーサービスプロバイダーに移動して、そこでさまざまな設定を調整します。
テレフォニーインラインフックの使用など、その他のテレフォニー方式が有効な場合は、外部のテレフォニープロバイダーを有効にする前に、それらの方式を無効にする必要があります。
Admin Consoleでは最大2つのテレフォニーサービスプロバイダーを構成でき、一方をプライマリプロバイダーとして、もう一方をセカンダリプロバイダーとして割り当てることができます。プライマリプロバイダーで障害やサービス中断が発生した場合、Oktaはワンタイムパスコード（OTP）をセカンダリプロバイダーに自動的にルーティングし、継続的な認証サービスを提供できるようにします。
テレフォニープロバイダーで障害が発生した場合でも、Oktaが管理するテレフォニーに自動的にフェイルオーバーすることはありません。ベンダーの障害発生時に認証の中断やロックアウトを防ぐため、プライマリプロバイダーとセカンダリプロバイダーの両方（フェイルオーバー用）を設定して有効にするか、ユーザーが利用できる代替認証があることを確認してください。
開始する前の確認事項
テレフォニーサービスプロバイダーとしてTwilioまたはTelesignを選択します。その後、そのアカウントを作成し、テレフォニーの設定を構成します。
プロバイダーから次の詳細を収集します。
-
アカウント文字列識別子（SID）
Telesignの場合、SIDは顧客IDです。
-
認証トークン
-
所有している電話番号。SMSメッセージ送信や音声通話用の電話番号を使用します。
テレフォニープロバイダーを作成する
テレフォニープロバイダーでテレフォニーをセットアップするにはさまざまな方法があります。異なるSMSや音声（Voice） オプションを選択する際は、プロバイダーのドキュメントを参照してください。
-
管理コンソールでカスタマイズ（Customizations）> テレフォニープロバイダー（Telephony Providers）に移動します。
-
追加するプロバイダーの横にある追加（Add）をクリックします。
-
以下のオプションを構成して保存（Save）をクリックします。
| フィールド | 説明 |
|---|---|
|
アカウントSID |
テレフォニープロバイダーアカウントの一意な識別子を入力します。 |
|
Authトークン |
テレフォニープロバイダーへのリクエストの認証に使用される認証トークンを入力します。Telesignでは、認証トークンをAPIキーとみなします。 |
|
SMS |
構成しているテレフォニープロバイダーに応じて、 SMSメッセージをユーザーに送信する方法を2つか3つのオプションから選択できます。 Twilioの場合、3つのオプションがあります。
Telesignには、次の2つのオプションがあります。
テレフォニープロバイダーの設定を構成してから、それらの設定に対応するSMSオプションを選択する必要があります。テレフォニープロバイダーのドキュメントを参照してください。 |
|
電話番号またはSID |
SMSメッセージの送信に使用する電話番号を入力します。テレフォニープロバイダーから電話番号を購入して、 SMSメッセージの送信に使用できます。 |
|
音声 |
構成しているテレフォニープロバイダーに応じて、 音声通話をユーザーに送信する方法を2つか3つのオプションから選択できます。 Twilioの場合、3つのオプションがあります。
Telesignには、次の2つのオプションがあります。
テレフォニープロバイダーの設定を構成してから、それらの設定に対応する音声オプションを選択する必要があります。テレフォニープロバイダーのドキュメントを参照してください。 |
|
電話番号、SID、または発信者ID |
音声通話に使用する電話番号を入力します。テレフォニープロバイダーから電話番号を購入して、 音声通話に使用できます。 |
ステータスコールバック
カスタムテレフォニープロバイダーを使用している場合、Oktaはプロバイダーから到達率ステータスの更新を受け取り、それをシステムログに記録します。これらのイベントを使用して、 SMSメッセージと音声通話がユーザーに届くかどうかを確認できます。「SMSメッセージまたは音声通話イベントを表示または照会する」を参照してください。
Oktaは、カスタムテレフォニープロバイダーから到達率ステータスの更新を受信したときに、次のイベントを記録します。
system.sms.receive_status：OktaがSMSメッセージのステータス更新を受信したときに記録されます。system.voice.receive_status：Oktaが音声通話のステータス更新を受信したときに記録されます。
Oktaは、カスタムテレフォニープロバイダーを介して送信された実際のSMSおよび音声メッセージの受信ステータスイベント（たとえば、 MFAチャレンジ、登録、アカウントの復旧、ロック解除など）を記録します。テストメッセージ または音声通話を送信（Send a test message or call）機能から送信されたテストメッセージと音声通話では、受信ステータスイベントは生成されません。Oktaがステータスコールバックを検証できない場合（たとえば、認証情報の不一致が原因で）、そのコールバックをログに記録せずに破棄します。これは、Oktaが常に失敗ステータスでログに記録するStandardメッセージ配信失敗とは異なります。
Oktaは、次のプロバイダーサービスを介してメッセージを送信する際に、必要なコールバックURLを自動的に挿入します。これらのサービスを手動で構成する必要はありません。
- Twilio Programmable Messaging
- Twilio Voice
- Telesign Messaging
- Telesign Voice
- Telesign Verify
Twilio Verify SIDオプションを使用する場合は、TwilioコンソールでイベントWebhookを手動で構成し、そのTwilio Verifyサービスの検証からイベントストリームサブスクリプションへのイベント送信を有効にする必要があります。これにより、 SMS配信ステータスのコールバックを受信できます。WebhookはSMSのみを対象とします。Twilioは、Twilio Verify通話の配信ステータスイベントを送信しません。
Twilio Verify Webhookを構成する
SMSにTwilio Verifyを使用する場合は、TwilioコンソールでイベントWebhookを構成し、到達率ステータスをOktaに返送する必要があります。 「Twilio VerifyイベントのWebhookオンボーディングガイド」を参照してください。
TwilioでWebhookを構成する場合は、次のOkta固有の設定を使用します。
- Webhook URL：
https://<your-okta-domain>/api/v1/internal/telephonystatus/customtwilioの形式を使用してWebhookをOktaドメインに向けます。 - イベントサブスクリプション（Event subscriptions）：次のイベントを選択します。
com.twilio.accountsecurity.verify.message.deliveredcom.twilio.accountsecurity.verify.message.undeliveredcom.twilio.accountsecurity.verify.message.failed
テストメッセージまたは音声通話を送信する
テレフォニープロバイダーでテレフォニーをセットアップするにはさまざまな方法があります。異なるSMSや音声（Voice） オプションを選択する際は、プロバイダーのドキュメントを参照してください。
-
管理コンソールでカスタマイズ（Customizations）> テレフォニープロバイダー（Telephony Providers）に移動します。
-
テストするテレフォニープロバイダーの下で、テストを送信（Send test）をクリックします。
-
テスト使用（Test using）で、テストするテレフォニー方式を選択します。
-
国（Country）で、テストに使用している電話番号の国コードを選択します。
-
電話番号（Telephone number）で、テストに使用する電話番号を入力します。音声テストを送信する場合、使用している電話番号の内線番号を入力できます（該当する場合）。
-
SMSテストの場合は、SMS経由でテストを送信（Send test via SMS）をクリックします。音声通話テストの場合、通話でテストを送信（Send test via voice call）をクリックします。
テレフォニープロバイダーを有効にする
テレフォニープロバイダーを構成したら、テレフォニーで使用できるように有効にします。
-
管理コンソールでカスタマイズ（Customizations）> テレフォニープロバイダー（Telephony Providers）に移動します。
-
有効にするテレフォニープロバイダーの隣で、アクション（Actions）>アクティブ化（Activate）をクリックします。
注:テレフォニープロバイダーでテレフォニーをセットアップするにはさまざまな方法があります。異なるSMSや音声（Voice） オプションを選択する際は、プロバイダーのドキュメントを参照してください。
テレフォニープロバイダーを無効化する
プロバイダーを非アクティブ化する前に、以下の要件と制限事項を確認してください。
- 2つのテレフォニープロバイダーを構成して、両方がアクティブな場合、非アクティブ化できるのはセカンダリプロバイダーだけです。プライマリ（Primary）プロバイダーを非アクティブ化することはできません。
- アクティブなテレフォニーインラインフックがない状態で電話Authenticatorがアクティブになっている場合、テレフォニープロバイダーを非アクティブ化することはできません。プロバイダーを非アクティブ化するには、まず次のいずれかの操作を実行してください。
-
管理コンソールでカスタマイズ（Customizations）> テレフォニープロバイダー（Telephony Providers）に移動します。
-
無効にするテレフォニープロバイダーの隣で、アクション（Actions）>非アクティブ化（Deactivate）をクリックします。
プライマリテレフォニープロバイダーを設定する
-
管理コンソールでカスタマイズ（Customizations）> テレフォニープロバイダー（Telephony Providers）に移動します。
-
プライマリプロバイダーとして設定するテレフォニープロバイダーの隣で、アクション（Actions）>プライマリとして設定（Set as primary）をクリックします。
テレフォニープロバイダーを削除する
テレフォニープロバイダーを削除する前に、準備が整っていることを確認します。新しいテレフォニープロバイダーをセットアップするか、新しいテレフォニー方式を構成するか、認証に電話Authenticatorを使用しないように計画します。orgでテレフォニーをセットアップさまざまな方法については、「外部のテレフォニープロバイダーをセットアップする」を参照してください。
認証や復旧のオプションからテレフォニーを完全に削除する場合は、アプリのサインインポリシーを更新してください。
削除するテレフォニープロバイダーがアクティブな場合は、非アクティブ化しないと削除できません。
-
管理コンソールでカスタマイズ（Customizations）> テレフォニープロバイダー（Telephony Providers）に移動します。
-
削除するプロバイダーの隣で、アクション（Actions）>削除（Delete）をクリックします。
-
チェックボックスの警告を確認し、それをオンにします。
-
削除（Remove）をクリックします。
テレフォニープロバイダーを編集する
-
管理コンソールでカスタマイズ（Customizations）> テレフォニープロバイダー（Telephony Providers）に移動します。
-
編集するプロバイダーの隣で、アクション（Actions）>編集（Edit）をクリックします。
-
テレフォニープロバイダーの設定に必要な変更を加えます。
-
保存（Save）をクリックします。
プロバイダー資格情報のトラブルシューティング
受信ステータスイベントがシステムログに表示されないときは、プロバイダー資格情報の検証に失敗している可能性があります。
-
Telesign：アカウントに複数のAPIキーがある場合、Telesignは有効期限が最新のキーを使用してコールバックを認証します。有効期限のないキーは、最新のキーとしてカウントされます。複数のキーに有効期限がない場合、Telesignはがどのキーを選択するかは予期できません。Oktaで入力したキーがTelesignのアクティブなキーと一致することを確認します。そうしないと、Oktaはコールバックを確認できず、配信ステータスイベントは表示されません。
-
Twilio：アカウントSIDと認証トークンを使用する必要があります。Twilio APIキーは使用しないでください。Twilioは、 APIキーとシークレットのペアではなく、常にアカウントのプライマリ認証トークンを使用してコールバックを認証します。