Skip to Content

セキュリティ

アプライアンスは、お客様が運用するハードウェアとネットワーク上で動作します。IronFlock はソフトウェアとその既定の設定を提供しますが、アプライアンスがどの程度保護されるかは、選択したモード、周囲のネットワーク、そしてアプライアンスが動作するホストにも左右されます。このページは、その部分のためのチェックリストです。

各モードで保護される範囲

アプライアンスは、HTTPS と証明書 で説明している 3 つのモードのいずれかで動作します。モードによって、暗号化・検証される対象が異なります。

プレーン HTTP(デフォルト)自己発行 CA による HTTPS企業証明書による HTTPS
ブラウザからアプライアンスへ暗号化なしHTTPSHTTPS
ログイン CookieSecure 属性なしSecure 属性ありSecure 属性あり
デバイスリンク(ポート 18080)暗号化なし暗号化なし443 上の HTTPS
デバイス向けのアプリイメージとエージェントの更新暗号化なし暗号化なし443 上の HTTPS
デバイスのリモートアクセストンネル暗号化、サーバーは未検証暗号化、サーバーは未検証暗号化、検証済み
パスキーとセキュリティキーアプライアンス本体からのみ利用可利用可

アプライアンスが他のシステムとネットワークを共有する場所では、企業証明書による HTTPS を使用してください。接続されたデバイスが通信相手を検証できるのは、このモードだけです。他の 2 つのモードは、アプライアンス、そのデバイス、そのオペレーターだけが到達できるネットワークセグメントに適しています。

暗号化されない通信

HTTPS を使用していても、一部のトラフィックは暗号化されません。これを前提にネットワークを計画してください。

  • ポート 18080 のデバイスリンクは、どのモードでもすべてのネットワークインターフェースで公開されます。アプライアンス自身のデバイスエージェントとアプライアンス上で動作するアプリがこれに接続し、プレーンモードと自己発行 CA のモードでは、接続されたすべてのデバイスも接続します。
  • アプライアンスへのリモートアクセストンネル(ポート 7000)は、プレーンモードと自己発行 CA のモードでも暗号化されますが、デバイスはアプライアンスの証明書を確認できません。ネットワーク経路にアクセスできる者が、アプライアンスのトンネルサーバーになりすますおそれがあります。この方法で接続すると、デバイスエージェントは警告をログに記録します。
  • アプライアンス内部のサービス間の接続(データベースへの接続など)は暗号化されません。これらの接続はホストの外に出ません。
  • アプライアンスは保存データを暗号化しません。アプライアンスが機密データを保存する場合や、敷地外に持ち出される可能性がある場合は、ホストのオペレーティングシステムまたはディスクの暗号化を使用してください。

セキュリティ強化チェックリスト

  • ネットワークに合ったモードを選択します(各モードで保護される範囲 を参照)。
  • アプライアンスのポートに到達できる相手を制限します。インストールはお使いのファイアウォールで何も開放しません。また Docker は、アプライアンスのポートをホストファイアウォールの通常の入力ルール(ufw、firewalld)を経由せずに公開します。DOCKER-USER チェーンまたはネットワークファイアウォールでフィルタリングしてください。インストールは /opt/ironflock/docker-user-firewall.sh.example にテンプレートを用意しています。デバイス用のポート(18080、15001、15002、7000、30000–30049)は、デバイスネットワークからのみ許可してください — アプライアンスに接続するデバイス を参照してください。
  • ホストのオペレーティングシステムを最新の状態に保ち、ホスト上にアカウントを持つ人を限定します。ホストの root 権限を持つ者は、アプライアンスのすべてのシークレットを読み取れます。
  • ホストへの管理アクセスには、パスワードではなく SSH 鍵を使用します。
  • 時刻同期を設定します — 時刻同期(NTP) を参照してください。
  • 初回ログイン後に admin パスワードを変更し、admin アカウントに二要素認証を設定します。
  • すべてのアカウントで二要素認証の設定が済んだら、全員に二要素認証を必須にします(アカウントとアクセス を参照)。
  • インスタンスを所有する ironflock.com アカウントを二要素認証で保護します。このアカウントは、クラウドからアプライアンスへの管理者アクセス権を持っています。
  • ironflock.com からアプライアンスで作業する必要がない場合は、クラウド接続をオフにします(クラウド接続 を参照)。
  • 信頼できるアプリのみをインストールします。アプリはアプライアンスとデバイス上で、アプライアンスの設定ファイルを含め、ホストへの広範なアクセス権を持って動作します。
  • アプライアンスを最新の状態に保ちます(アップデート を参照)。
  • 初回インストールの前に ironflock を検証します(初回インストール前に ironflock を検証する を参照)。

アカウントとアクセス

  • admin アカウント:すべてのアプライアンスは、インストール時に固有の admin パスワードを受け取ります。ironflock appliance install はそれを一度だけ表示します。紛失した場合は、ローカル運用 の説明に従って新しいパスワードを設定してください — これにより、すべての admin セッションもサインアウトされます。
  • 新規ユーザーは、アプライアンス上のプロジェクトからの招待がある場合にのみサインアップできます。招待がなければ、ソーシャルログイン経由であってもサインアップは拒否されます。
  • 二要素認証:ユーザーは認証アプリ(TOTP)、パスキーまたはセキュリティキー、リカバリーコードを設定できます。パスキーとセキュリティキーには HTTPS が必要です。ポリシーは ironflock appliance install または ironflock appliance configure のオプション --2fa で設定し、その設定はアップデート後も維持されます。
    • available — ユーザーは二要素認証を設定できますが、入力を求められることはありません。
    • effective(デフォルト) — 二要素認証を設定済みのユーザーは、それを使用する必要があります。
    • required — すべてのユーザーが二要素認証を使用する必要があります。事前に、すべてのアカウントで設定が済んでいることを確認してください。設定していないユーザーはサインインできなくなります。
  • セッションの有効期間は 24 時間です。
  • ironflock.com からのアクセス:Instance Key を作成した ironflock.com アカウントは、アプライアンスの admin アカウントに接続されます。招待したユーザーは、各自の ironflock.com アカウントを接続します — アカウントの連携 を参照してください。ユーザーはこの接続をいつでも解除できます。ironflock.com からのすべてのアクセスを停止するには、管理者がクラウド接続をオフにします。

ホスト上のシークレット

ironflock appliance install は、アプライアンスのシークレットをインストール時に一度だけ生成し、アップデート後も保持します。シークレットは /opt/ironflock/ 配下にあります。

ファイル内容アクセス
.env全サービスのパスワードとキー、初期 admin パスワード、プロキシと SMTP の認証情報root のみ(0600)
license.envInstance Key と、ライセンス検証がそれとともに保存する情報root と IronFlock のサービス(0640)
certs/HTTPS 証明書とその鍵。自己発行 CA の場合は CA の鍵も秘密鍵は root のみ(0600)
registry-token-certs/アプリイメージのプルトークンに署名する鍵レジストリサービスのみ(0600)
.env.prev、rotation.log前回のローテーション前の .env。どのシークレットをいつローテーションしたかの記録(値は含みません)root のみ(0600)

インストールは Instance Key を使って Docker を IronFlock レジストリにログインさせるため、root の Docker 設定にもそのキーが保存されています。

これらのファイルをバックアップに含め、バックアップもアプライアンス本体と同様に保護してください。.env を削除したり、インストールに再生成させたりしないでください。データベースと暗号化されたデータは、その値に依存しています。シークレットを置き換えるには、ローテーションしてください。

お客様自身で置き換えられるもの:

  • admin パスワード:プロフィールから、または sudo ironflock appliance reset-admin-password で変更します(ローカル運用 を参照)。
  • HTTPS 証明書:自社の証明書は sudo ironflock appliance configure --tls-cert <file> --tls-key <file> で設定します(HTTPS と証明書 を参照)。アプライアンス自身の CA による証明書は自動的に更新されます。毎週のチェックで、残り期間が 30 日を切ると新しい証明書に署名します。
  • Instance Key:admin プロフィールのライセンスセクションで、または新しいキーを含むファイルを指定した sudo ironflock appliance configure --license-file <file> で変更します。新しいキーは、書き込まれる前に IronFlock レジストリを開けることが確認されます。
  • SMTP の認証情報:.env で変更し、sudo ironflock appliance restart で再起動します。
  • プロキシ:sudo ironflock appliance configure で変更します(後からプロキシを変更または削除する を参照)。
  • 内部サービスのシークレット:sudo ironflock appliance rotate <NAME> を使います。下記を参照してください。

内部シークレットのローテーション

sudo ironflock appliance rotate <NAME> は、アプライアンスの稼働中に .env のシークレットを 1 つ新しい値にします。新しい値は、まず古い値が保持されている場所(データベースロール、エージェントのデバイスファイル、レジストリのトークン鍵ペア)に設定され、次に .env に書き込まれます。そのシークレットを読み取るサービスだけが再作成され、コマンドはそれらが正常であることを確認します。変更前の .env は .env.prev として残り、rotation.log には各ローテーションが記録されます(値は記録されません)。ローテーションできる名前は ironflock appliance rotate --help で一覧表示されます。ironflock appliance rotate を参照してください。

ローテーションは、IronFlock 上のアプライアンス自身のデバイスのターミナルではなく、SSH 経由またはアプライアンスのコンソールで実行してください。このターミナルが依存するサービスを再起動するローテーションでは、ターミナルが切断されます。

シークレットローテーションの効果
WAMP_SECRET_SVC_*、WAMP_SYSTEM_SECRET、その他のサービスシークレットそれを使うサービスが再起動します。接続は数秒以内に復旧します。
KRATOS_SECRETS_COOKIE新しいサインインには新しい鍵が使われます。以前の鍵は次のローテーションまで保持されるため、それ以前にサインインしたセッションも有効なままです。
POSTGRES_PASSWORD、PGPASSWORD_*、DATASERVICE_PASSWORDデータベースロールに新しいパスワードが設定され、その後そのサービスが再起動します。先に質問します。--yes で答えられます。
REGISTRY_TOKEN_KEYアプリイメージのプルトークンが新しい鍵で署名されます。それ以前に署名されたトークンは、次のローテーションまで有効です。先に質問します。--yes で答えられます。
APPLIANCE_DEVICE_SECRETアプライアンス自身のデバイスに新しい認証情報が設定されます。そのエージェントが再起動し、1 分以内にオンラインに戻ります。先に質問します。--yes で答えられます。
FILE_CRED_KEYアプリのファイルはそのまま残り、ストレージへのアクセスは新しい鍵に切り替わります。アプリの直接S3資格情報について、--keep-direct-access か --revoke-direct-access を選びます。維持した資格情報は引き続き使えるため、定期的なローテーションに向いています。ただし以前の鍵を知っている人はそれらを導出できるので、各アプリのストレージ設定で置き換え対象として表示され、後から sudo ironflock appliance revoke-direct-access を実行すると残りが削除されます。失効させた資格情報はすぐに使えなくなり、削除されます。漏えいの疑いがある場合などに使います。先に質問し(--yes で答えられます)、アプライアンスのバージョン 1.6.23 以降が必要です。
APPLIANCE_ADMIN_PASSWORDironflock appliance reset-admin-password と同じく、新しい初期 admin パスワードが設定されます。

FLEETDB_SECRET_KEYS、KRATOS_SECRETS_CIPHER、および 2 つの OBJECTSTORE_ADMIN_* キーは、必ず IronFlock チームと一緒にローテーションしてください。これらで保存されたデータは、これらのキーに依存しています。Instance Key は rotate ではなく、admin プロフィールまたは ironflock appliance configure で変更します。

アウトバウンド接続とテレメトリー

アプライアンスの接続先は ファイアウォールの設定 に記載されています。これらの接続はすべて暗号化されています。

  • ライセンス検証では、ライセンスキー、ハードウェアのフィンガープリント、およびオンライン App Store へのアプライアンスの接続に使われるアクセストークンが送信されます。
  • AI アシスタントは、独自のゲートウェイを設定しない限り、プロンプトを IronFlock の LLM ゲートウェイ経由で送信します。
  • テレメトリーはありません。アプライアンスは利用状況の分析データを送信しません。アプライアンスの UI もそのサービスも、IronFlock や第三者に利用状況を報告しません。
  • ユーザーのブラウザから:地図タイルは Mapbox から読み込まれ、音声入力には音声認識サービス Deepgram が使用されます。これらの接続はアプライアンスではなく、ブラウザが行います。

アップデート

  • アプライアンスのアップデートは admin が開始し(メンテナンス を参照)、IronFlock によって署名されています。ironflock は、利用可能なバージョンの一覧と新しいバージョンのリリースマニフェストを、自身に含まれるアプライアンスのリリース鍵で検証し、続いて新しいバージョンのすべてのファイルとすべてのコンテナイメージを、そのマニフェストと照合します。変更されたファイルや署名のないファイル、あるいはリリースされたもの以外のイメージが 1 つでもあれば、アプライアンス上で何かが変更される前にアップデートは停止します。アップデートがアプライアンスを自動的に古いバージョンへ戻すことはありません。また、アップデートが失敗した場合、アプライアンスはそれまで動作していたバージョンに戻ります。
  • デバイスエージェントの更新には署名が付いています。すべてのエージェントは更新を適用する前に署名を確認し、新しいバージョンが起動しない場合はロールバックします — デバイスエージェントの更新 を参照してください。
  • ホストのオペレーティングシステムは、Docker を含めてお客様の責任範囲です。

初回インストール前に ironflock を検証する

アプライアンスは、すべてのアップデートを自ら確認します。ironflock は、アプライアンスの各リリースをインストールする前に、自身に含まれる IronFlock アプライアンスのリリース鍵で検証します。信頼に頼るのは、root として実行される ironflock のインストールスクリプトです。インストールスクリプトを事前に検証する の説明に従い、実行前に確認してください。gpg が、フィンガープリント F6C9 4D96 CE31 5377 ACA7 C8EA 4990 5433 7321 2788 を持つ IronFlock Bootstrap 鍵による正しい署名を報告する必要があります。スクリプトは次に、ironflock をインストールする前に、この鍵で ironflock を検証します。両方の鍵は 署名鍵 に記載されています。

バックアップと復元

アプライアンス全体をバックアップするには、sudo ironflock appliance stop でアプライアンスを停止し、次のものをコピーします。

  • /opt/ironflock/ フォルダー(.env、license.env、certs/、registry-token-certs/ を含む)
  • アプライアンスの Docker ボリューム(docker volume ls)。データベース、ファイル、local App Store、ユーザーファイルが格納されています。

その後、sudo ironflock appliance start で再び起動します。.env は、同じ時点のボリュームとセットで保管してください。ボリューム内の暗号化されたデータは、その .env に含まれる鍵でしか読み取れません。

シークレットだけなら、アプライアンスの稼働中に保存できます:

sudo ironflock appliance backup -o /root/appliance-secrets.tar.gz

アーカイブには、.env、license.env、CA、レジストリトークンの鍵、シークレットの台帳、rotation.log が含まれます。ファイルは root だけが読み取れます。失われた FLEETDB_SECRET_KEYS や FILE_CRED_KEY は、ほかの方法では復元できません。アーカイブを暗号化し、ボリュームのバックアップと一緒に保管してください。

インストール済みのアプライアンスにシークレットを戻すには、稼働中に --force を付けて復元し、すべてのサービスが復元したファイルを読み込むようにアプライアンスを再起動します:

sudo ironflock appliance restore appliance-secrets.tar.gz --force sudo ironflock appliance restart

復元前のアプライアンスの .env は .env.prev として残ります。新しいマシンでは、ironflock をインストールし、sudo ironflock appliance restore appliance-secrets.tar.gz を実行してから、Instance Key と以前と同じオプション(例:--tls)で通常どおりアプライアンスをインストールします。ironflock appliance backup と ironflock appliance restore を参照してください。

廃止

  1. アプライアンスがまだオンラインのうちにライセンスを移行または解放します — ライセンスを新しいハードウェアへ移行する を参照してください。

  2. ソフトウェアを削除します:

    sudo ironflock appliance remove --purge sudo ironflock agent remove

    ironflock appliance remove --purge は、アプライアンスのサービス、コンテナ、ネットワーク、IronFlock レジストリへの Docker のログイン、インストールがホストに加えた変更を削除し、--purge によってデータも削除します。インストールディレクトリ /opt/ironflock(.env と license.env を含む)、Docker ボリューム、イメージです。続いて ironflock agent remove が、アプライアンス自身のデバイスエージェントを削除します。各コマンドは削除するものを一覧表示し、先に質問します。--yes で答えられます。Docker 自体はインストールされたまま残り、/usr/local/bin の ironflock も残ります。ironflock appliance remove と ironflock agent remove を参照してください。

  3. ハードウェアを敷地外に持ち出す場合は、ディスクを消去してください — 上記のコマンドはファイルを削除しますが、上書きはしません。

セキュリティを弱める設定

一部の設定はトラブルシューティング専用です。本番環境では設定しないでください。

  • AGENT_UPDATE_ALLOW_UNSIGNED — デバイスエージェントが署名のない更新を適用できるようにします。until=<time> として最大 24 時間先までしか有効にならず、その後は自動的に失効します。
  • TUNNEL_AUTHZ_ENFORCE=false — デバイスが自身の ID を証明せずにトンネルを開けるようにします。
  • SMTP_CONNECTION_URI 内の ?tls.rejectUnauthorized=false — メールサーバーからのあらゆる証明書を受け入れます。
  • --2fa available — 二要素認証の入力が一切求められなくなります。
Last updated on