セキュアなモバイルアクセス

このページでは、ZabbixモバイルアプリとZabbixブリッジアダプターを安全に保つためのベストプラクティスについて説明します。

モバイルデバイスの保護

モバイルデバイス上で他の人がアプリを開けないようにするには、アプリの 設定 でアプリロックを有効にします。

デバイスを紛失した場合や侵害された場合は、ZabbixのWebインターフェースから削除してください。 これによりアクセス認証情報が無効化および削除され、そのデバイスからZabbixにアクセスできなくなります。 ユーザーのロール 権限 に応じて、以下のセクションでデバイスを削除できます。

  • ユーザー設定 > デバイス - すべてのユーザーが自分のデバイスを削除できます(自分のデバイスの管理 権限が必要です)。
  • ユーザー > デバイス - Super admin は任意のユーザーのデバイスを削除できます(ユーザーデバイスの管理 権限が必要です)。

モバイルデバイスからアクセスできるZabbixの機能を制限することもできます。 そのためには、アプリに必要な権限のみを付与するユーザーロールをユーザーに割り当てます。 最小限必要な権限は次のとおりです。

セクション 設定
UI要素へのアクセス すべてのチェックボックスをオフにします。
サービスへのアクセス サービスへの読み書きアクセス と サービスへの読み取り専用アクセス を None に設定します。
モジュールへのアクセス すべてのチェックボックスをオフにします。
APIへのアクセス 有効 チェックボックスをオフにします。
アクションへのアクセス すべてのチェックボックスをオフにします。

アプリでユーザーが 障害を更新 できるようにするには、必要なアクションも選択します。
- 障害コメントの追加
- 深刻度の変更
- 障害の承認
- 障害の抑制
- 障害のクローズ

アプリでユーザーが表示できる障害は、ホストへのアクセス にも依存することに注意してください。

ユーザーが受信するプッシュ通知(深刻度や有効期間など)を変更できるようにするには、自分のメディアの作成と編集 も選択します。これにより、プッシュ通知以外のメディアを含め、自分のメディアを編集 できるようになります。
デバイス 有効 チェックボックスを選択します。

ユーザーが自分のモバイルデバイスを追加および削除できるようにするには、自分のデバイスの管理 チェックボックスも選択します。それ以外の場合は、Super admin が ユーザー > デバイス でデバイスを管理する必要があります。

Zabbixブリッジアダプターの保護

Zabbixブリッジアダプターは、データ(状態ファイルおよび暗号化キー)を、Zabbixブリッジアダプターの設定ファイルの DataDir パラメータで指定されたディレクトリに保存します。 ディレクトリのパーミッションが 0700 であり、その中に保存されるすべてのファイルのパーミッションが 0600 であることを確認してください。

Zabbixブリッジアダプターは、モバイルデバイスからのリクエストをZabbix APIに渡します。 Zabbixブリッジアダプター経由で呼び出せるAPIメソッドを制限するには、その AllowedAPIMethods パラメータを使用します。 例えば、モバイルアプリケーションに必要な最小限のメソッドのみを許可するか、モバイルアプリケーションの一部の機能を使用させたくない場合は、さらに少ないメソッドのみを許可します(例えば、モバイルアプリケーションのユーザーが障害を更新できないようにする場合は、event.acknowledge を許可しない)。

Zabbixブリッジアダプターは、ListenPort で指定されたポートでZabbixサーバーからの接続を受け付けます。 TLSConfig.Mode が mtls に設定されていない場合、Zabbixブリッジアダプターは、このポートに到達できるすべてのホストからの接続を受け付けます。 このポートへの接続はZabbixサーバーからのみ許可してください(例えば、ファイアウォールを使用するか、ZabbixブリッジアダプターとZabbixサーバーが同じシステム上で実行されている場合は ListenIP を 127.0.0.1 に設定します)。または、mTLS を使用してください。

ListenHealthPort 上のZabbixブリッジアダプターのヘルスチェックエンドポイントは、常に認証なしの暗号化されていないHTTPを使用し、エラーメッセージによって環境の詳細が明らかになる可能性があります。 このポートが信頼できないネットワークから到達可能な場合は、アクセスを制限してください(例えば、ファイアウォールを使用します)。

コンポーネント間の接続を暗号化する

Zabbixブリッジアダプター、Zabbixサーバー、Zabbix APIを提供するZabbix Webインターフェースが別々のシステムにインストールされている場合、それらの間のデータフローを暗号化することを推奨します。 このセクションでは、以下の接続を保護する方法について説明します。

  • ZabbixサーバーからZabbixブリッジアダプターへの接続
  • ZabbixブリッジアダプターからZabbix Webインターフェース(API)への接続

このセクションでは、証明書の管理方法については説明しません。 一般的なガイダンスについては、証明書を使用した暗号化を参照してください。

ZabbixサーバーからZabbixブリッジアダプターへのTLS

Zabbixサーバーは、BridgeAdapterURLパラメータで指定されたURLを使用してZabbixブリッジアダプターに接続します。 ブリッジアダプターは、受け入れる接続の種類をTLSConfig.Modeパラメータで決定します。

  • none(デフォルト) - 暗号化されていない接続のみ。BridgeAdapterURLにはhttp://を使用する必要があります。
  • tls - 暗号化された接続のみ。ブリッジアダプターはZabbixサーバーに証明書を提示します。BridgeAdapterURLにはhttps://を使用する必要があります。
  • mtls - tlsに加えて、ブリッジアダプターがZabbixサーバーのクライアント証明書を検証します。

tlsを設定するには:

1. Zabbixブリッジアダプターの証明書を発行する認証局(CA)を選択します。

  • Zabbixサーバーですでに使用している証明書を発行したCA - ZabbixサーバーがZabbixプロキシまたはエージェントとの通信に証明書ベースの暗号化を使用している場合に選択します(TLSCAFile、TLSCertFile、TLSKeyFileパラメータが設定されています)。
  • ZabbixサーバーがインストールされているオペレーティングシステムのCAストアに証明書があるCA(例:パブリックCA)。
  • その他のCA(例:組織のプライベートCA)。

2. 手順1でその他のCAを選択した場合は、Zabbixサーバーがインストールされているシステム上に、以下のファイルをすべてPEM形式で用意します。

  • 選択したCAの証明書を含むCAファイル。
  • 選択したCAによって発行されたサーバー用の証明書(または証明書チェーン)。
  • サーバー用の秘密鍵。実行ユーザー(通常はzabbix)だけが読み取れるようにしてください。

3. Zabbixサーバー設定ファイルを編集します。

BridgeAdapterURL=https://zabbix-bridge-adapter.example.com:10054/rpc

# 手順1でその他のCAを選択した場合(Zabbixサーバーですでに使用しているCAを選択した場合は設定済み):
TLSCAFile=/etc/zabbix/certs/zabbix_ca_file.crt
TLSCertFile=/etc/zabbix/certs/zabbix_server.crt
TLSKeyFile=/etc/zabbix/certs/zabbix_server.key

4. Zabbixブリッジアダプターがインストールされているシステム上に、以下のファイルをすべてPEM形式で用意します。

  • 選択したCAによって発行されたブリッジアダプター用の証明書(または証明書チェーン)。Subject Alternative Name(SAN)拡張に、ZabbixサーバーのBridgeAdapterURLに含まれるホスト名またはIPアドレスが含まれていることを確認してください。
  • ブリッジアダプター用の秘密鍵。実行ユーザー(通常はzabbix-bridge-adapter)だけが読み取れるようにしてください。

5. Zabbixブリッジアダプター設定ファイルを編集します。

TLSConfig.Mode=tls
TLSConfig.CertFile=/etc/zabbix/certs/zabbix_bridge_adapter.crt
TLSConfig.KeyFile=/etc/zabbix/certs/zabbix_bridge_adapter.key

6. Zabbixブリッジアダプターを再起動します。

systemctl restart zabbix-bridge-adapter

7. Zabbixサーバーを再起動します。 例(その他のオプションを参照):

systemctl restart zabbix-server

mtlsを設定するには:

1. ZabbixサーバーとZabbixブリッジアダプターの証明書を発行する認証局(CA)を選択します。

  • Zabbixサーバーですでに使用している証明書を発行したCA - ZabbixサーバーがZabbixプロキシまたはエージェントとの通信に証明書ベースの暗号化を使用している場合に選択します(TLSCAFile、TLSCertFile、TLSKeyFileパラメータが設定されています)。
  • その他のCA(例:組織のプライベートCA)。

2. 手順1でその他のCAを選択した場合は、Zabbixサーバーがインストールされているシステム上に、以下のファイルをすべてPEM形式で用意します。

  • 選択したCAの証明書を含むCAファイル。
  • 選択したCAによって発行されたサーバー用の証明書(または証明書チェーン)。
  • サーバー用の秘密鍵。実行ユーザー(通常はzabbix)だけが読み取れるようにしてください。

3. Zabbixサーバー設定ファイルを編集します。

BridgeAdapterURL=https://zabbix-bridge-adapter.example.com:10054/rpc

# Zabbixサーバーですでに使用しているCAを選択した場合は設定済み:
TLSCAFile=/etc/zabbix/certs/zabbix_ca_file.crt
TLSCertFile=/etc/zabbix/certs/zabbix_server.crt
TLSKeyFile=/etc/zabbix/certs/zabbix_server.key

4. Zabbixブリッジアダプターがインストールされているシステム上に、以下のファイルをすべてPEM形式で用意します。

  • 選択したCAの証明書を含むCAファイル(パブリックCAの場合でも必要です。ブリッジアダプターはオペレーティングシステムのCAストアを使用しないためです)。
  • 選択したCAによって発行されたブリッジアダプター用の証明書(または証明書チェーン)。Subject Alternative Name(SAN)拡張に、ZabbixサーバーのBridgeAdapterURLに含まれるホスト名またはIPアドレスが含まれていることを確認してください。
  • ブリッジアダプター用の秘密鍵。実行ユーザー(通常はzabbix-bridge-adapter)だけが読み取れるようにしてください。

5. Zabbixブリッジアダプター設定ファイルを編集します。

TLSConfig.Mode=mtls
TLSConfig.CertFile=/etc/zabbix/certs/zabbix_bridge_adapter.crt
TLSConfig.KeyFile=/etc/zabbix/certs/zabbix_bridge_adapter.key
TLSConfig.CAFile=/etc/zabbix/certs/zabbix_ca_file.crt

# Zabbixサーバー証明書のCommon Name(CN)(完全一致、大文字と小文字を区別。SANはチェックされません):
TLSConfig.AllowedCN=zabbix-server

6. Zabbixブリッジアダプターを再起動します。

systemctl restart zabbix-bridge-adapter

7. Zabbixサーバーを再起動します。 例(その他のオプションを参照):

systemctl restart zabbix-server

ZabbixブリッジアダプターからZabbix APIへのTLS

Zabbixブリッジアダプターは、ZabbixAPIURLパラメータで指定されたURLを使用してZabbix APIに接続します。 ブリッジアダプターは、ZabbixAPITLSConnectパラメータを使用して、Zabbix Webインターフェースの証明書をどの程度厳密に検証するかを決定します。

  • disabled - 接続は暗号化されません。このオプションを使用する場合のみ、ZabbixAPIURLにhttp://を指定する必要があります。
  • required(デフォルト) - 接続は暗号化されますが、ブリッジアダプターは任意の証明書を受け入れます。
  • verify_ca - 接続は暗号化され、証明書はZabbixAPITLSCAFileファイルに記載されたCAによって発行されている必要があります。
  • verify_full - 接続は暗号化され、証明書はZabbixAPITLSCAFileファイルに記載されたCAによって発行されている必要があり、ZabbixAPIURLのホスト名が証明書と一致している必要があります。

required、verify_ca、またはverify_fullを設定するには:

1. Zabbix Webインターフェースがインストールされているシステムで、次のことを確認します。

  • Zabbix WebインターフェースがHTTPS経由で提供されていること(Zabbix WebインターフェースのSSL設定を参照)。
  • verify_fullの場合、Zabbix Webインターフェースの証明書のSubject Alternative Name(SAN)拡張に、ブリッジアダプターのZabbixAPIURLに指定されたホスト名またはIPアドレスが含まれていること。

2. verify_caおよびverify_fullの場合、Zabbixブリッジアダプターがインストールされているシステムで、Zabbix Webインターフェースの証明書を発行したCAの証明書を含むPEMファイルを用意します。

  • Zabbix Webインターフェースの証明書が自己署名の場合、ファイルにはZabbix Webインターフェースの証明書自体を含めます。
  • Zabbix Webインターフェースの証明書がパブリックCAによって発行されている場合、オペレーティングシステムのCAバンドル(Ubuntuの/etc/ssl/certs/ca-certificates.crtなど)をファイルとして使用できます。 ブリッジアダプターは、このファイルに含まれるCA証明書のみを使用し、オペレーティングシステムのCAストアは使用しません。
  • PEMファイルが、ブリッジアダプターを実行するユーザー(通常はzabbix-bridge-adapter)によって読み取り可能であることを確認します。

3. Zabbixブリッジアダプター設定ファイルを編集します。

ZabbixAPIURL=https://zabbix.example.com/zabbix/api_jsonrpc.php

# required、verify_ca、またはverify_fullの場合:
ZabbixAPITLSConnect=verify_full

# verify_caまたはverify_fullの場合:
ZabbixAPITLSCAFile=/etc/zabbix/certs/zabbix_api_ca.crt

4. Zabbixブリッジアダプターを再起動します。

systemctl restart zabbix-bridge-adapter