On-Prem MFAエージェントをインストールする
On-Prem MFAエージェントは、RSA SecurID向けRSA認証マネージャーをはじめとするRADIUS対応On-Prem MFAサーバーを使ったプロキシ構成をサポートします。
開始する前の確認事項
共通UDPポートと秘密鍵の値が使用可能で、Okta RADIUSエージェントのポート1812が開いていることを確認します。
エージェントをインストールする
On-Prem MFAエージェントをインストールするには、次のタスクを完了します。
インスタンスIDを特定する
On-Prem MFAエージェントのインストーラーにはインスタンスIDが必要です。
- Okta orgに管理者としてサインインします。
- を選択します。
- 要素タイプ(Factor Types)タブを選択します。
- On-Prem MFA/RSA SecurIDの追加と構成で選択したものと同じ要素を選択します。
- 新規エージェントを追加(Add new Agent)をクリックします。
- インスタンスIDをコピーします。
インストーラーを実行する
- On-Prem MFAエージェント(On-Prem MFA Agent)インストーラーを保存したディレクトリに移動します。管理者としてインストーラーを実行します。
- 次へ(Next)をクリックします。
- 重要情報(Next)およびライセンス情報(Important Information)ページの次へ(Next)(License Information)をクリックします。
- デフォルトのインストールフォルダーを受け入れるか、別のフォルダーを参照してインストール(Install)をクリックします。プロキシサーバーを使用するときは、インストールパスをメモしておきます。プロキシを有効化する際に必要になります。
- Okta On-Premエージェントの構成(Okta On-Prem Agent Configuration)ページにインスタンスIDを入力します。この値は、 Okta orgのアプリの設定( Settings)ページで確認できます。
- Okta On-Prem MFAエージェントの登録(Register Okta On-Prem MFA Agent)ダイアログにorgの完全修飾URLを入力します。
- 次へ(Next)をクリックします。
- プロキシサーバーを使用するときは、設定を変更してプロキシを含めます。
- ファイルエクスプローラー(File Explorer)ウィンドウを開きます。
config.propertiesファイルを探します(例:<AGENT_INSTALL_PATH>\current\user\config\rsa-securid\config.properties)。- 任意のテキストエディターでファイルを開きます。
- ファイルの末尾にプロキシ構成のキー/値ペアを追加します。すべてのプロパティが1つの行にあるときは、その下にキー/値ペアを追加します。プロキシには次のキー/値ペアが含まれます。
proxyAddress = http://<ipaddress:[port]> proxyUsername = <username> proxyPassword = <password of proxyUsername> - ファイルを保存します。
- [インターネットオプション]を開きます。
- 接続(Connect)(Connections)をクリックします。
- LANをクリックします。
- プロキシ(Proxy)をクリックします。
- プロキシ設定を入力します。
- インターネットオプション(Save)ダイアログが表示されるまで各ダイアログの保存(Save)(Internet Options)をクリックします。
- [インターネットオプション]ダイアログを閉じます。
-
任意。クライアントセッションのタイムアウト期間を延長します。プッシュを使用するときは、デフォルト値より大きくしなければならない場合があります。
- テキストエディターで
config.propertiesファイルを開きます。 radiusSocketTimeoutMsフィールドの値を1~30000ミリ秒の範囲で編集します。このパラメーターがないときは、ファイルの末尾に追加します。
- テキストエディターで
- スーパー管理者、アプリ管理者、またはAPIアクセス管理管理者の権限でOktaにサインインします。標準的な管理者ロールと権限を参照してください。
- アクセスを許可(Allow Access)をクリックします。
- インストーラーを前面に表示し、インストールが完了するまで待機します。
- インストール完了(Installation Completed)ページが表示されます。
- 終了(Finish)をクリックします。
- インストールを完了するには、Windowsを再起動します。
既存MFAエージェント用のプロキシを指定する
- 任意のテキストエディターで
C:\Program Files (x86)\....\Okta On-Prem MFA Agent\current\user\config\rsa-securid\config.propertiesファイルを開きます。 - このファイルの一番下にプロキシの構成を追加します。キーの例は、
proxyAddress、proxyUsername、proxyPasswordです。すべてのプロパティが1つの行にあるときは、その下にプロキシ設定を追加します。 - このファイルを保存し、On-Prem MFAエージェントのインストーラーを実行します。
- インストールが完了すると、成功メッセージが表示されます。
インストールのトラブルシューティングとアップグレードの問題
On-Prem MFAエージェントのインストールまたはアップグレード時に問題が生じるときは、次の手順に従います。
新規インストール
インストール中に問題が生じるときは、プロキシ設定を確認します。sslPinningEnabled = falseという設定でインストールをやり直すこともできます。このオプションは、過去に使用経験がある場合にのみ使用してください。
アップグレード(プロキシのみ)
入力したプロキシのプロパティに誤りがあると、インストーラーは成功したように見えても、最終的にはOn-Prem MFAエージェントは失敗します。これらのプロパティを確認するには、管理者ダッシュボードのエージェントリストで最後の接続のタイムスタンプを調べます。
次の手順