Skip to Content
IoT デバイス管理デバイスの接続

デバイスの接続

IronFlock は、ハードウェアやオペレーティングシステムに応じて、複数のデバイス接続方法をサポートしています。手元にハードウェアがない場合でも、数分でラップトップ上でデバイスをシミュレートできます。

前提条件

デバイスを接続する前に、以下を確認してください:

  1. IronFlock 上にプロジェクトが作成されていること
  2. プロジェクト内にデバイスエントリが作成されていること(プロジェクトの Settings -> Devices パネルで NEW DEVICE をクリック)
  3. デバイス設定ファイル(.flock)がダウンロード済みであること

.flock ファイルを紛失しましたか? いつでも再ダウンロードできます。プロジェクトのサイドバーでデバイスを開き、メンテナンス に移動して 設定ファイルをダウンロード をクリックします。新しいデバイスではなく、同じ設定です。デバイスに対する maintain 権限が必要です。デバイスメンテナンスを参照してください。

制限のある企業ネットワーク上のデバイスですか? ネットワークの設定はインストールの前に計画してください — インストールしたばかりのデバイスがオフラインのままになる、最も一般的な原因です:

  • ID 認識型ファイアウォールまたはプロキシ: デバイスを許可するルールは、ログイン中のユーザーではなく、必ずデバイス自体に紐づけてください — そうしないと、そのユーザーのセッションが切れるたびにデバイスがネットワークから切り離されます。ID 認識型ファイアウォールとプロキシ を参照してください。
  • 企業の HTTP プロキシ: エージェントと Docker に、プロキシを明示的に設定する必要があります — 企業プロキシの背後で → エッジデバイス を参照してください。
  • オンプレミスのアプライアンスへの接続: デバイスはアプライアンスのサービスポートに直接到達できる必要があります。アプライアンスが 企業証明書による HTTPS で動作している場合はポート 443 のみで済みますが、その場合はデバイス上で企業のルート CA を信頼させてください。アプライアンスガイドの デバイス接続 を参照してください。
  • クロックのずれ: 企業のファイアウォールは、インストール直後の OS に同梱された公開の時刻サーバーを通常ブロックするため、デバイスのクロックは気づかないうちにずれていきます。社内の NTP サーバーを設定してください。時刻同期(NTP) を参照してください。

ID 認識型ファイアウォールとプロキシ

すべてのエッジデバイスは、IronFlock エージェントを無人のシステムサービスとして実行します。エージェントは起動時に開始し、常時接続を維持しながら、アプリのインストール、イメージのプル、自身の更新を続けます — デバイスに誰かがサインインしているかどうかには関係ありません。これはプラットフォームがどこで稼働していても同じで、IronFlock クラウド、お客様のプライベートクラウド、オンプレミスのアプライアンスのいずれにも当てはまります。

OT ネットワークは、ネットワークアドレスではなくディレクトリ上の ID に基づいてアクセスを許可する ID 認識型ファイアウォールおよびプロキシ(identity-aware firewall / proxy)によって保護されることが増えています。エッジデバイスを許可するルールが、そのデバイスにログインしているユーザーに紐づいていると、そのユーザーのセッションが切れた時点でデバイスはネットワークへのアクセスを失います:

  • すでに開いている接続は動作し続けるため、デバイスは引き続きオンラインと表示されます。
  • 新しい接続はすべて通知なく破棄されます — アプリのインストール、イメージのプル、エージェントの更新、再接続が失敗します。
  • 次にエージェントまたはデバイスを再起動すると、まったく再接続できなくなり、誰かがデバイスに再びサインインするか、ルールが変更されるまでオフラインのままになります。

ルールは人ではなく、必ずデバイスに紐づけるよう、ネットワークチームに依頼してください:

デバイスルールで使用する ID
ドメインに参加している Windows デバイスそのコンピューターアカウント — コンピューターオブジェクト、または IronFlock Edge Devices のようなグループ
Linux または IronFlockOS のデバイス、あるいはドメイン外の Windows予約済み IP アドレスを持つ名前付きホストオブジェクト、またはネットワークアクセス制御(802.1X または MAC 認証)が割り当てる ID

主な製品では、次のように対応します。

  • Check Point Identity Awareness: Access Role で、ユーザーではなくマシン(コンピューターオブジェクトまたはグループ)を選択します。マシン ID はコンピューター自身のドメイン上のアクティビティによって更新されます。ゲートウェイ上でマシン ID が失効する可能性がある場合は、代わりにネットワークオブジェクトを使用してください。
  • Palo Alto Networks User-ID: コンピューターアカウントからは IP とユーザーのマッピングが生成されないため、アドレスオブジェクト、タグ、または Device-ID を使用してください。
  • Fortinet FSSO および同様のディレクトリベースのファイアウォール: デバイスのアドレスオブジェクト、またはネットワークアクセス制御が割り当てるダイナミックアドレスを使用してください。
  • Zscaler、Prisma Access などのクラウドセキュリティゲートウェイ: デバイスのネットワークを IoT またはサーバーのロケーション(信頼できる送信元)として登録し、デバイスのトラフィックがユーザーではなくロケーションによって識別されるようにしてください。

これは ID ポリシーの適用除外ではありません — デバイスを、そのデバイスが実際に持っている ID で識別するということです。オンプレミスのアプライアンスを運用している場合は、アプライアンスホストにも同じことが当てはまります:IronFlock ホストのネットワーク ID を参照してください。

障害の見分け方。 デバイスはオンラインのままなのに、アプリのインストール、イメージのプル、エージェントの更新がタイムアウトで失敗し、それでも ping は成功する場合、原因はデバイスではなく、期限切れになった ID ルールにあります。デバイスからの新しい接続が再び成功するまでは、エージェントもデバイスも再起動しないでください。まだ開いているセッションが唯一機能している接続であり、その間もこのセッションによってデバイスをリモートから管理できるからです。

まずはテスト:ラップトップでデバイスをシミュレート

IronFlock を試すために物理的なハードウェアは必要ありません。FlockFlasher アプリは IronFlock エージェントをラップトップ上で直接実行できるため、ラップトップがプロジェクト内で実際のデバイスになりすまします。実機に展開する前にアプリやダッシュボードをテストするのに最適です。

  1. Docker Desktop(Linux の場合は Docker Engine)をインストールし、起動していることを確認します。
  2. お使いの OS 用の FlockFlasher アプリをダウンロードしてインストールします。
  3. ダウンロード済みのデバイスの .flock ファイルをダブルクリックします。FlockFlasher が開き、デバイスがリストに表示されます。(または、FlockFlasher を開いて + ボタンからファイルを追加することもできます。)
  4. デバイスエントリの Test Device(▶)ボタンをクリックします。FlockFlasher は初回使用時に IronFlock エージェントを自動的にダウンロードし、お使いのデバイス設定で起動します。

これで、ラップトップは IronFlock プロジェクト内でこのデバイスとして動作します。デバイスはオンラインとして表示され、実際のデバイスとまったく同じようにアプリをインストールして実行できます。アプリはラップトップ上で Docker コンテナとして実行されます。

テストが終わったら、FlockFlasher でテストを停止してください。同じ .flock ファイルは、後で実機のプロビジョニングにも使用できます。ただし、同じデバイス設定を実行するマシンは、常に 1 台のみにしてください。

方法1:SD カードのフラッシュ

SD カードからブートする Raspberry Pi やその他の ARM デバイスに最適です。

  1. お使いの OS 用の FlockFlasher アプリをダウンロードします。
  2. SD カード(最低 16 GB)をコンピュータに挿入します。
  3. FlockFlasher を開き、+ ボタンをクリックして .flock ファイルを読み込みます。
  4. SD カードドライブを選択します(FlockFlasher は外部ドライブを自動検出します)。
  5. デバイスに適したイメージを選択します(Raspberry Pi 3/4、Zero など)。
  6. 必要に応じて WiFi を設定し、設置先でデバイスが接続できるようにします。
  7. Flash をクリックし、書き込み、検証、設定の完了を待ちます。
  8. SD カードをデバイスに挿入して電源を入れます。

デバイスは 20分以内にオンラインになるはずです。

警告:フラッシュ処理により、選択したドライブのすべてのデータが消去されます。FlockFlasher はデフォルトで内蔵ドライブを非表示にしますが、選択内容を必ず確認してください。

方法2:産業用 PC 向け USB インストーラー

EFI ブート対応の AMD64 デバイス(例:Siemens SIMATIC Box IPC)向け。

  1. USB スティック(最低 16 GB)を挿入し、FlockFlasher を開きます。
  2. .flock ファイルを読み込み、USB ドライブを選択します。
  3. Industrial PC x86_64 (EFI) イメージを選択します。
  4. Flash をクリックし、完了を待ちます。
  5. 必要に応じて、デバイスの BIOS でブート順序を USB ブートに変更します。
  6. USB スティックを挿入してデバイスの電源を入れます。

デバイスは 60分以内にオンラインになるはずです。

コマンドラインからフラッシュする

IronFlock CLI を使うと、デスクトップアプリなしで方法1と方法2のドライブを準備できます。Linux、macOS、Windows で動作し、Raspberry Pi 4、400、5、CM4、CM5 用、および UEFI を備えた PC と ARM マシン用の IronFlockOS を書き込みます。以下の手順は Linux と macOS 向けです。Windows では、PowerShell でインストールし、ドライブは ironflock os drives がそこで表示するとおりに指定します(インストール、IronFlockOS をドライブに書き込む)。

  1. お使いのコンピューターに ironflock コマンドをインストールします:
    curl -fsSL https://instance-registry.ironflock.com/dl/cli/install.sh | sudo bash
  2. SD カードまたは USB スティックを挿入し、そのドライブ名を確認します:
    ironflock os drives
  3. IronFlockOS と .flock ファイルをドライブに書き込みます。/dev/sdb はお使いのドライブに置き換えてください:
    sudo ironflock os flash -c mydevice.flock -d /dev/sdb
    産業用 PC の場合は --installer を追加します。このスティックから起動した PC の内蔵ディスクに、スティックが IronFlockOS をインストールします:
    sudo ironflock os flash -c mydevice.flock -d /dev/sdb --installer

このコマンドは、.flock ファイルに記載されたハードウェア用のイメージをダウンロードして検証します。書き込む内容を表示し、ドライブを消去する前に質問します。その後、ドライブに書き込み、読み戻して確認します。.flock ファイルとは別の WiFi ネットワークをデバイスに設定するには、--wifi-ssid と --wifi-password-file を追加します。すべてのオプションについては IronFlockOS をドライブに書き込む を参照してください。

すでに Linux が動作していて、スティックから起動できないマシンですか? ironflock os install は、動作中の Linux を同じディスク上の IronFlockOS に置き換えます。SSH 経由でリモートマシンにも使えます。そのディスク上のデータはすべて失われます。Linux を IronFlockOS に置き換える を参照してください。

方法3:カスタムインストール

既存の Linux OS を維持するデバイス向け。NVIDIA Jetson やカスタムハードウェアに最適です。

注意:この手動インストール方法は、産業用 PC、ゲートウェイ、組み込みデバイスなどの実際の本番ハードウェアを対象としており、ラップトップ向けではありません。ラップトップで IronFlock を試したいだけの場合は、代わりにまずはテスト:ラップトップでデバイスをシミュレートに従ってください。手動でのエージェントインストールは不要です。

Linux / Unix デバイス

  1. デバイスに SSH 接続します。
  2. .flock ファイルをコンピュータからデバイスにコピーします:
    scp mydevice.flock user@device-ip:/home/user/
  3. インストーラーをダウンロードして実行します。
    curl -fsSL https://instance-registry.ironflock.com/dl/cli/install.sh | sudo bash -s -- agent install -c mydevice.flock

    IronFlock アプライアンスをお使いですか? コマンドは同じです。ironflock agent install は、.flock ファイルが指定するアプライアンスのダウンロードミラーからデバイスエージェントを取得し、ミラーにないものはインターネットから取得します。インストールスクリプト、ironflock、ディストリビューションのパッケージ、Docker は引き続きインターネットから取得するため、インストール中は、デバイスがインターネットに接続できる必要があります。その後は、アプライアンスに到達できれば十分です(エッジデバイス を参照)。

  4. インストーラーの質問に答えます。完了するとエージェントが動作し、1 分以内にデバイスが IronFlock 上でオンラインと表示されます。再起動は不要です。

デバイスでは、systemd を備えた Debian または Ubuntu ベースの Linux が動作している必要があります。

install.sh は、デバイスの CPU に合わせて、IronFlock のコマンドラインツール ironflock をダウンロードします。スクリプトに組み込まれた IronFlock の鍵でダウンロードの署名を確認し、ツールを /usr/local/bin/ironflock としてインストールして、渡された引数を付けて実行します。引数なしの場合はツールをインストールするだけです。その後 sudo ironflock agent install -c mydevice.flock でデバイスを接続します。

ironflock agent install は、まずインストールが成功するかどうかをチェックします。その後、Docker(未インストールの場合)とデバイスエージェントをインストールし、次の設定を行います。

  • プロジェクトオーナー用の SSH ユーザー — ログインは鍵(デバイスキー)のみ、sudo はパスワードなし
  • .flock ファイルの内容による WiFi 設定(NetworkManager 経由)
  • ログインバナー

インストールする内容を示し、実行する前に質問します。無人セキュリティアップグレードには手を加えず、--reboot を指定しない限りデバイスを再起動しません。変更内容はすべて /opt/ironflock/device-init/installed.json に記録されるため、agent remove でその変更だけを正確に元に戻せます。

sudo ironflock agent remove

ironflock agent install のその他のオプション:

  • --yes — 質問せずに既定値を採用する
  • --disable-suspend — デバイスがスリープしないようにする
  • --reboot — インストール完了後にデバイスを再起動する
  • --http-proxy、--https-proxy、--no-proxy、--proxy-password-file — インストール、Docker、エージェントをプロキシ経由にする
  • --download-base — 別のサーバーからダウンロードする(ダウンロードベース を参照)

インストール済みのデバイスに別の .flock ファイルを与えるには、sudo ironflock agent configure -c new.flock を実行します。すべてのコマンドとオプションは デバイスエージェントのコマンド で説明しています。

デバイス上では、エージェントは /opt/ironflock/device-agent にあり、systemd サービス ironflock-device-agent として動作します。状態は sudo ironflock status または systemctl status ironflock-device-agent で確認できます。ログは sudo ironflock agent logs で読めるほか、journalctl -u ironflock-device-agent と /var/log/ironflock/device-agent.log にもあります。設定は /opt/ironflock/device-agent/device-config.flock(root のみ読み取り可能で、/boot にはコピーがなくなりました)、Docker のデータは /opt/ironflock/device-agent/docker-apps に、アプリのデータは引き続き /apps にあります。

エージェントは自分自身を更新します。別個の更新マネージャーはありません。更新は署名され検証されており、失敗した更新は自動的にロールバックされます。更新が適用されるのは、エージェントの起動時、ユーザーが Studio で更新を開始したとき、またはデバイス上で sudo ironflock agent update を実行したときだけです。

2026 年 10 月より前にインストールされたデバイスでは /opt/reagent とサービス reagent.service が使われていました。そのようなデバイスがエージェント 1.3.x を実行すると、自動的に上記の構成へ移行し(Docker とアプリは一度再起動します)、/opt/reagent はリンクとして残ります。

企業プロキシの背後で運用していますか? インストーラーのダウンロードにもプロキシを指定し、ステップ 3 の引数に --http-proxy / --https-proxy を追加すると、ironflock agent install が Docker とエージェントを自動で設定します。完全なコマンドと企業 CA の手順は 企業プロキシの背後で を参照してください。

お使いのコンピューターから SSH 経由でインストールする

お使いの Linux または macOS コンピューターに ironflock をインストールしておけば、デバイスに先にログインしなくてもデバイスを接続できます。--host はデバイス上で SSH 経由でコマンドを実行し、.flock ファイルも一緒に送るため、コピーするものはありません:

ironflock --host user@device-ip agent install -c mydevice.flock

ログインユーザーは root であるか、デバイス上で sudo を使える必要があります。--host は、お使いのコンピューターの ssh を、お使いの鍵と ~/.ssh/config とともに使います。デバイスに ironflock コマンドは残りません。以降のコマンドも、同じ方法でコンピューターから実行します(例:ironflock --host user@device-ip status)。SSH 経由のリモートマシン を参照してください。

任意:先にインストーラーを検証する

root で実行される前にスクリプトを確認したい場合は、署名と一緒にダウンロードし、IronFlock のブートストラップ鍵で検証します。

curl -fsSLO https://instance-registry.ironflock.com/dl/cli/install.sh curl -fsSLO https://instance-registry.ironflock.com/dl/cli/install.sh.asc curl -fsSL https://instance-registry.ironflock.com/dl/cli/ironflock-bootstrap.asc | gpg --import gpg --verify install.sh.asc install.sh

gpg が、IronFlock Bootstrap <[email protected]> による有効な署名で、フィンガープリントが F6C9 4D96 CE31 5377 ACA7 C8EA 4990 5433 7321 2788 であると報告する必要があります。確認できたら、検証済みのスクリプトを実行します。

sudo bash install.sh agent install -c mydevice.flock

Windows デバイス

  1. デバイスに Docker Desktop をインストールし、Docker Desktop の設定で Start Docker Desktop when you sign in を有効にします。無人運用のデバイスでは、再起動後に誰もサインインしなくても Docker が利用できるよう、Windows の自動サインインも設定してください。

  2. デバイスで device-agent.exe をダウンロードします。ブラウザーはファイルを ダウンロード フォルダーに保存します。

  3. .flock ファイルをデバイスにコピーし、同じ ダウンロード フォルダーに置きます。

  4. 管理者権限で PowerShell を開きます。スタート メニューを開き、PowerShell と入力して 管理者として実行 を選び、ユーザー アカウント制御の確認で はい をクリックします。ウィンドウのタイトルは「管理者:」で始まっている必要があります。通常の PowerShell ウィンドウでは、インストールは this command must be run from an elevated (Administrator) prompt というメッセージで中断します。

  5. 管理者の PowerShell は C:\Windows\System32 で起動します。ダウンロード フォルダーに移動し、両方のファイルがあることを確認します:

    cd $env:USERPROFILE\Downloads dir device-agent.exe, *.flock
  6. エージェントを Windows サービスとしてインストールして起動します:

    .\device-agent.exe service install -config .\myaccount_myproject_mydevice.flock

    myaccount_myproject_mydevice.flock はお使いのファイル名に置き換えてください。Studio はプロジェクトの所有者、プロジェクト、デバイスの名前からファイル名を付けます。名前の最初の数文字を入力して Tab キーを押すと補完されます。device-agent.exe の前の .\ は省略しないでください。これがないと、PowerShell は現在のフォルダーにあるプログラムを実行しません。

    サービス ironflock-device-agent はすぐに開始され、以降はシステム起動時にも自動的に開始されます。障害時には自動的に再起動し、エージェントを常に最新の状態に保ちます。起動せずにインストールするには -noStart を追加してください。インストーラーは device-agent.exe と .flock ファイルをエージェントのフォルダーにコピーするため、後でダウンロード フォルダーから両方を削除してかまいません。

デバイス上では、エージェントは %ProgramData%\IronFlock\DeviceAgent に配置されます。ここには device-agent.exe、設定ファイル device.flock、ログ device-agent.log、そしてアプリのデータ(apps\ 配下)があります。アップデートは署名され検証されます。失敗したアップデートは自動的にロールバックされ、アップデートはエージェントの起動時、またはユーザーが Studio でアップデートを開始したときにのみ適用されます。

エージェントの確認とログの表示

エージェントのフォルダーは管理者しか読み取れないため、これらのコマンドも管理者の PowerShell で実行してください。サービスが実行中かどうかを表示します:

Get-Service ironflock-device-agent

Status が Running になっている必要があります。エージェントのログの最後の 100 行を表示し、エージェントが書き込む新しい行を続けて表示します:

Get-Content "$env:ProgramData\IronFlock\DeviceAgent\device-agent.log" -Tail 100 -Wait

ログの追跡を止めるには Ctrl+C を押します。ログからエラーだけを検索するには:

Select-String -Path "$env:ProgramData\IronFlock\DeviceAgent\device-agent.log" -Pattern "error" | Select-Object -Last 20

エージェントを再起動するには、エージェント自身のコマンドを使います。エージェントが再び実行されるまで、デバイスはオフラインになります:

& "$env:ProgramData\IronFlock\DeviceAgent\device-agent.exe" service stop & "$env:ProgramData\IronFlock\DeviceAgent\device-agent.exe" service start

エージェントには Restart-Service を使わないでください。エージェントの停止には最大 15 秒かかることがあり、Restart-Service はそれより前に諦めて、サービスを停止したままにしてしまうことがあります。

エージェント 1.4.0 より前にインストールされた Windows デバイスは、%ProgramData%\IronFlock\Reagent とサービス reagent を使用していました。エージェント 1.4.0 は、そのようなデバイスを上記のレイアウトへ移行します — エージェントとそのアプリは一度再起動します。

企業プロキシの背後にいる場合は? service install コマンドに -proxy http://proxy.example.com:3128 を追加し、Docker Desktop のプロキシは Settings → Resources → Proxies で設定してください。詳細と企業 CA の手順は 企業プロキシの背後で をご覧ください。

ドメインに参加している Windows デバイスの場合は? エージェントサービスは、誰かがサインインしているかどうかに関係なく LocalSystem として実行されるため、ログイン中のユーザーに紐づいたファイアウォールルールではカバーされません。ルールをデバイスのコンピューターアカウントに紐づけてもらってください — ID 認識型ファイアウォールとプロキシ を参照してください。

時刻同期(NTP)

デバイスエージェントには正確なクロックが必要です。プラットフォームとの TLS ハンドシェイク、イメージの取得を認可するトークン、そしてデバイスが publish するすべてのデータポイントのタイムスタンプが、これに依存します。クロックが 15 分以上ずれているデバイスは、ファイルストレージ からも CLOCK_SKEW で拒否されます。

企業ネットワークでは、これは当たり前に整っているものではなく、セットアップの一手順です。UDP ポート 123 の外向き NTP はしばしばブロックされており、OS に同梱された公開の時刻サーバーには到達できず、クロックは目に見えるエラーもないままずれていきます。社内の時刻サーバーを情報システム部門に確認してデバイスに設定するか、デバイス用ネットワークについて外向きの UDP 123 を許可してもらってください。

Linux

systemd-timesyncd の場合(Debian と Ubuntu の既定):

sudo mkdir -p /etc/systemd/timesyncd.conf.d sudo tee /etc/systemd/timesyncd.conf.d/corporate.conf > /dev/null <<'EOF' [Time] NTP=ntp.your-company.com EOF sudo systemctl restart systemd-timesyncd timedatectl status

chrony の場合:

echo "server ntp.your-company.com iburst" | sudo tee -a /etc/chrony/chrony.conf sudo systemctl restart chrony chronyc sources

timedatectl status が System clock synchronized: yes と表示する必要があります。

Windows

管理者権限のプロンプトから:

w32tm /config /manualpeerlist:"ntp.your-company.com" /syncfromflags:manual /update w32tm /resync w32tm /query /status

出来合いの IronFlock イメージで書き込んだデバイス(方法1 と方法2)は、既定で公開の時刻サーバーと同期します。それがブロックされているネットワークでは、デバイスのサブネットに対して外向きの UDP 123 を許可するか、初回起動後に SSH で上記の Linux と同じ手順で社内の時刻サーバーを設定してください。

接続の確認

接続後、プロジェクトでデバイスのステータスを確認します:

  • 緑のインジケーター — デバイスはオンラインで、IronFlock と通信中です。
  • 赤のインジケーター — デバイスはオフラインです。ネットワーク接続を確認し、エージェントが実行中であることを確認してください。
  • 緑のインジケーターなのに、アプリのインストール、イメージのプル、またはエージェントの更新がタイムアウトする — ファイアウォールのルールが、デバイスからの新しい接続を許可しなくなっている可能性があります。何かを再起動する前に、ID 認識型ファイアウォールとプロキシ をお読みください。

デバイスマップビューには、プロジェクト内のすべてのデバイスの地理的な位置が表示されます。

Last updated on