外部整合導入Integrations guide外部連携ガイド

每一套整合各一節：它讀進來什麼、帶來什麼管理效益、要準備什麼，以及限制在哪裡。資料來源一律唯讀拉取、不改動來源；只有明確開啟的 OPNsense 別名推送與憑證派送會寫回。One section per integration: what it reads, the management benefit, what to prepare and where its limits are. Data sources are read only and never changed; only OPNsense alias push and certificate delivery write back, and only when you turn them on.連携ごとに 1 節：何を読み込むか、管理上の効果、準備するもの、制限。データソースは読み取りのみで変更しません。書き戻すのは明示的に有効にした OPNsense エイリアスの反映と証明書の配布だけです。

防火牆與路由Firewalls & routersファイアウォールとルーターOPNsense pfSense FortiGate Palo Alto Check Point MikroTik RouterOS DNSDNSDNSPowerDNS BIND9 Unbound Windows DNS Univention UCS AdGuard Home DHCPDHCPDHCPWindows DHCP Kea DHCP ISC DHCP Technitium DHCP ISOinsight 監控Monitoring監視LibreNMS Zabbix SNMP 虛擬化Virtualization仮想化Proxmox VE VMware ESXi / vCenter Hyper-V / SCVMM CubeCOS / OpenStack 資安與資產Security & assetsセキュリティと資産Wazuh OCS Inventory NG RustDesk Server 參考資料Reference data参照データRIPE TWNIC MaxMind GeoIP IEEE OUI Recog 匯入與遷移Import & migrationインポートと移行phpIPAM CSV 提供給其他系統Feeding other systems他システムへの提供Graylog (Lookup Table)LLM Server MCP server REST API Email Webhook Telegram / Slack / Teams / Nextcloud Talk / Zulip 你開啟時才寫回Writes back only when you turn it on有効にしたときだけ書き戻すOPNsense 防火牆別名OPNsense firewall aliasesOPNsense ファイアウォールエイリアス憑證派送代理（nginx / Apache / Proxmox VE / IIS）Certificate delivery agent (nginx / Apache / Proxmox VE / IIS)証明書配布エージェント（nginx / Apache / Proxmox VE / IIS）憑證推送到防火牆（FortiGate / OPNsense / Palo Alto / pfSense）Certificate push to firewalls (FortiGate / OPNsense / Palo Alto / pfSense)ファイアウォールへの証明書プッシュ（FortiGate / OPNsense / Palo Alto / pfSense）

防火牆與路由Firewalls & routersファイアウォールとルーター

OPNsense

唯讀Read only読み取りのみREST API

透過 OPNsense REST API 讀取 ARP、DHCP、防火牆規則、別名、NAT 與 VPN，讓 IPAM 知道每個位址在防火牆上被誰看到、被哪些規則管到。Reads ARP, DHCP, firewall rules, aliases, NAT and VPN over the OPNsense REST API, so IPAM knows which addresses the firewall sees and which rules cover them.OPNsense REST API で ARP、DHCP、ファイアウォールルール、エイリアス、NAT、VPN を読み取り、各アドレスがファイアウォールでどう見えているか、どのルールが関わるかを IPAM で把握できます。

取得的資料What it reads取得するデータ

ARP 表與防火牆自己的介面位址ARP table and the firewall's own interface addressesARP テーブルとファイアウォール自身のインタフェースアドレス
DHCP 租約、發放範圍與固定分配（Kea、dnsmasq、ISC）DHCP leases, ranges and reservations (Kea, dnsmasq, ISC)DHCP リース、配布範囲、固定割り当て（Kea、dnsmasq、ISC）
篩選規則、別名，以及 NAT（Port Forward / 1:1 / Outbound）Filter rules, aliases and NAT (Port Forward / 1:1 / Outbound)フィルタールール、エイリアス、NAT（Port Forward / 1:1 / Outbound）
OpenVPN 連線，以及 WireGuard / IPsec 站對站通道OpenVPN sessions and WireGuard / IPsec site-to-site tunnelsOpenVPN 接続、WireGuard / IPsec のサイト間トンネル

管理效益Management benefit管理上の効果

位址的最後出現時間與 MAC 跟著防火牆更新，不必等掃描；租約主機名稱成為名稱來源之一Last seen and MAC follow the firewall without waiting for a scan; lease host names become a name source最終確認時刻と MAC がスキャンを待たずに更新され、リースのホスト名も名前の情報源になります
IP 詳細資料列出涵蓋這個位址的規則、別名與 NAT；IP 變更評估也會查到IP details list the rules, aliases and NAT covering the address; IP change assessment checks them tooIP 詳細にそのアドレスに関わるルール、エイリアス、NAT が表示され、IP 変更評価でも確認されます
規則異動偵測：規則一變就通知並附差異；懸空轉發、別名成員未登記列入異常偵測Rule-change detection notifies with a diff; dangling forwards and unregistered alias members show in anomaly detectionルール変更検知が差分付きで通知し、宙に浮いた転送や未登録のエイリアスメンバーは異常検知に出ます
VPN 通道畫在 IP 拓樸圖；防火牆被認定為已知 DHCP 伺服器，不會被報成非法 DHCPVPN tunnels appear on the IP topology map; the firewall counts as a known DHCP server, not a rogue oneVPN トンネルが IP トポロジーに描かれ、ファイアウォールは既知の DHCP サーバーとして扱われ不正 DHCP と誤報されません

需要準備What to prepare準備するもの

建議 OPNsense 24.1 以上；jt-ipam 伺服器要連得到它的 HTTPS 管理介面OPNsense 24.1 or later recommended; the jt-ipam server must reach its HTTPS management interfaceOPNsense 24.1 以降を推奨。jt-ipam サーバーから HTTPS 管理画面に到達できること
唯讀權限的 API key / secretAn API key / secret with read-only privileges読み取り権限のみの API key / secret
要讀舊式 Port Forward 與 ISC 固定分配時，帳號還要能下載設定備份（config.xml，內含敏感設定）For legacy Port Forward and ISC static mappings the account must also download the config backup (config.xml, which holds sensitive settings)旧式 Port Forward と ISC の固定割り当てを読むには、設定バックアップ（機密情報を含む config.xml）のダウンロード権限も必要
多台防火牆共用相同私有網段時，設定子網路關聯範圍與「介面 → 子網路對應」When several firewalls share the same private ranges, set the subnet scope and the "Interface → subnet map"複数のファイアウォールが同じプライベート網を使う場合は、サブネットの範囲と「インタフェース → サブネットの対応」を設定

限制與注意Limits and notes制限と注意

只讀得到 Firewall > Automation > Filter 建立的規則；傳統 Firewall > Rules 沒有 API（26.1 起有移轉工具）Only rules made under Firewall > Automation > Filter are readable; legacy Firewall > Rules has no API (26.1 adds a migration tool)読めるのは Firewall > Automation > Filter で作ったルールのみ。従来の Firewall > Rules には API がありません（26.1 から移行ツールあり）
WireGuard 要有 WireGuard API（舊版需 os-wireguard 外掛）；IPsec 需新版 swanctl API（約 24.x 起）WireGuard needs the WireGuard API (the os-wireguard plugin on older releases); IPsec needs the newer swanctl API (about 24.x onwards)WireGuard には WireGuard API（旧版では os-wireguard プラグイン）、IPsec には新しい swanctl API（おおむね 24.x 以降）が必要
租約裡 IPAM 沒有的位址預設略過；「自動建立 IPAM 沒有的位址」選用、預設關閉Lease addresses IPAM lacks are skipped by default; "Create addresses IPAM does not have" is optional and off by defaultIPAM に無いリースのアドレスは既定でスキップ。「IPAM に無いアドレスを作成する」は任意で既定オフ
寫回功能另外設定：防火牆別名推送、憑證推送；別名也可提供給 GraylogWrite-back is set up separately: alias push, certificate push; aliases can also feed Graylog書き戻しは別途設定：エイリアス反映、証明書の配信。エイリアスは Graylog にも提供できます

設定位置：管理 > 外部系統整合 > OPNsenseWhere: Admin > External integrations > OPNsense設定場所：管理 > 外部システム連携 > OPNsense

pfSense

唯讀Read only読み取りのみREST API

透過 pfSense-pkg-RESTAPI 套件讀取 ARP、DHCP、別名、規則與 NAT，pfSense 上的位址、租約與規則都能在 IPAM 對照。Reads ARP, DHCP, aliases, rules and NAT through the pfSense-pkg-RESTAPI package, so addresses, leases and rules on pfSense line up with IPAM.pfSense-pkg-RESTAPI パッケージ経由で ARP、DHCP、エイリアス、ルール、NAT を読み取り、pfSense 上のアドレス、リース、ルールを IPAM と突き合わせられます。

取得的資料What it reads取得するデータ

ARP 表與防火牆自己的介面位址ARP table and the firewall's own interface addressesARP テーブルとファイアウォール自身のインタフェースアドレス
DHCP 租約、發放範圍（含額外集區）與固定分配DHCP leases, ranges (including extra pools) and static mappingsDHCP リース、配布範囲（追加プールを含む）、固定割り当て
別名、防火牆規則、NAT（Port Forward / Outbound）Aliases, firewall rules, NAT (Port Forward / Outbound)エイリアス、ファイアウォールルール、NAT（Port Forward / Outbound）

管理效益Management benefit管理上の効果

位址的最後出現時間、MAC 與租約主機名稱跟著防火牆自動更新Last seen, MAC and lease host names update from the firewall automatically最終確認時刻、MAC、リースのホスト名がファイアウォールから自動更新されます
IP 詳細資料與 IP 變更評估列出涵蓋這個位址的規則與別名IP details and IP change assessment list the rules and aliases covering the addressIP 詳細と IP 変更評価に、そのアドレスに関わるルールとエイリアスが表示されます
規則異動偵測，加上規則劣化檢查：any 對 any 放行、WAN 對任意來源開管理埠、懸空轉發、別名成員未登記Rule-change detection plus rule-rot checks: any-to-any pass, management ports open to anyone on WAN, dangling forwards, unregistered alias membersルール変更検知に加え、any から any の許可、WAN で管理ポートを全開放、宙に浮いた転送、未登録のエイリアスメンバーを検出
埠轉發與 WAN 上指向單一內部位址的放行規則，列入「對外開放服務」Port forwards and WAN pass rules to a single internal address appear in "Exposed services"ポート転送と、WAN で単一の内部アドレス宛ての許可ルールが「公開されているサービス」に載ります

需要準備What to prepare準備するもの

在 pfSense 安裝 pfSense-pkg-RESTAPI（pfrest.org），把 API Key 加進認證方式並建立一把 keyInstall pfSense-pkg-RESTAPI (pfrest.org), add API Key to the auth methods and create a keypfSense-pkg-RESTAPI（pfrest.org）を導入し、認証方式に API Key を加えてキーを作成
建議用專用、權限最小的帳號建立 keyCreate the key under a dedicated account with the least privilegesキーは専用で最小権限のアカウントで作成することを推奨
jt-ipam 伺服器要連得到管理介面 HTTPS；自簽憑證要關閉「驗證 TLS」（頁面會持續警示）The jt-ipam server must reach the HTTPS management interface; turn off TLS verification for self-signed certificates (the page keeps warning)jt-ipam サーバーから HTTPS 管理画面に到達できること。自己署名証明書なら TLS 検証をオフ（画面に警告が出続けます）

限制與注意Limits and notes制限と注意

pfSense CE 2.8.x 沒有內建 REST API，一定要裝這個第三方套件pfSense CE 2.8.x has no built-in REST API; the third-party package is requiredpfSense CE 2.8.x には標準の REST API がなく、このサードパーティパッケージが必須
不讀 VPN 連線；NAT 跟著「規則」一起同步VPN sessions are not read; NAT is synced together with rulesVPN 接続は読みません。NAT はルールと一緒に同期されます
租約裡 IPAM 沒有的位址預設略過；自動建立選用、預設關閉Lease addresses IPAM lacks are skipped by default; auto-create is optional and off by defaultIPAM に無いリースのアドレスは既定でスキップ。自動作成は任意で既定オフ
寫回另外設定：憑證推送；別名可提供給 GraylogWrite-back is separate: certificate push; aliases can feed Graylog書き戻しは別途：証明書の配信。エイリアスは Graylog にも提供できます

設定位置：管理 > 外部系統整合 > pfSenseWhere: Admin > External integrations > pfSense設定場所：管理 > 外部システム連携 > pfSense

FortiGate

唯讀Read only読み取りのみREST API

透過 FortiOS REST API 唯讀同步（只發 GET，不更動任何設定），支援多 VDOM。Read-only sync over the FortiOS REST API (GET only, nothing on the firewall changes), with multi-VDOM support.FortiOS REST API による読み取り専用の同期（GET のみで設定は一切変更しません）。複数 VDOM に対応。

取得的資料What it reads取得するデータ

ARP 表與防火牆自己的介面位址ARP table and the firewall's own interface addressesARP テーブルとファイアウォール自身のインタフェースアドレス
DHCP 租約、發放範圍與固定分配DHCP leases, ranges and reservationsDHCP リース、配布範囲、固定割り当て
防火牆政策、位址物件與位址群組Firewall policies, address objects and address groupsファイアウォールポリシー、アドレスオブジェクト、アドレスグループ
NAT：VIP（埠轉發）與 IP poolNAT: VIPs (port forwards) and IP poolsNAT：VIP（ポート転送）と IP プール
IPsec 站對站通道，以及 SSL-VPN 使用者分到的位址IPsec site-to-site tunnels and the addresses given to SSL-VPN usersIPsec サイト間トンネルと、SSL-VPN ユーザーに割り当てられたアドレス

管理效益Management benefit管理上の効果

位址的上線時間、MAC 與租約主機名稱跟著防火牆更新Liveness, MAC and lease host names follow the firewall稼働確認、MAC、リースのホスト名がファイアウォールに追従します
IP 詳細資料找得到透過位址物件引用這個 IP 的政策；IP 變更評估一併檢查IP details find the policies that reference the IP through address objects; IP change assessment checks them tooアドレスオブジェクト経由でその IP を参照するポリシーが IP 詳細に出て、IP 変更評価でも確認されます
政策異動偵測；VIP 埠轉發列入「對外開放服務」與懸空轉發檢查Policy-change detection; VIP port forwards feed "Exposed services" and the dangling-forward checkポリシー変更検知。VIP のポート転送は「公開されているサービス」と宙に浮いた転送の検出に使われます
IPsec 通道畫在 IP 拓樸圖，可與其他廠牌的對端配對IPsec tunnels appear on the IP topology map and pair with peers from other vendorsIPsec トンネルが IP トポロジーに描かれ、他社製の対向とも対応付けられます

需要準備What to prepare準備するもの

唯讀的 REST API 管理員與 API token（以 Authorization 標頭傳送）A read-only REST API administrator and its API token (sent in the Authorization header)読み取り専用の REST API 管理者と API トークン（Authorization ヘッダーで送信）
jt-ipam 伺服器要連得到管理介面；REST API 管理員的信任主機要包含 jt-ipamThe jt-ipam server must reach the management interface; include it in the API administrator's trusted hostsjt-ipam サーバーから管理画面に到達でき、API 管理者の信頼済みホストに含まれること
VDOM 留空會自動探索全部；探索不到時可自行列出Leave VDOMs empty to discover them all, or list them yourselfVDOM は空欄で全自動検出。検出できなければ手動で列挙
先按「測試連線」看 10 支端點各自能不能讀Use "Test connection" to see which of the 10 endpoints are readable「接続をテスト」で 10 個のエンドポイントそれぞれの可否を確認

限制與注意Limits and notes制限と注意

FIPS-CC 模式不支援 API tokenAPI tokens are not supported in FIPS-CC modeFIPS-CC モードでは API トークンを使えません
某支端點讀不到只影響那一段；讀不到 VDOM 清單時該輪不清除任何資料An unreadable endpoint only affects its own section; if the VDOM list cannot be read, nothing is cleared that round読めないエンドポイントはその区画だけに影響。VDOM 一覧が読めない回はデータを一切消しません
IPAM 沒有的位址不會自動建立Addresses IPAM lacks are not createdIPAM に無いアドレスは作成しません
憑證推送是另外設定的寫回功能Certificate push is a separate write-back feature証明書の配信は別途設定する書き戻し機能です

設定位置：管理 > 外部系統整合 > FortiGateWhere: Admin > External integrations > FortiGate設定場所：管理 > 外部システム連携 > FortiGate

Palo Alto

唯讀Read only読み取りのみBetaPAN-OS API

透過 PAN-OS API 唯讀同步：XML API 讀 ARP、租約與 VPN 狀態，REST API 讀政策、NAT 與位址物件，支援多 vsys。Read-only sync over the PAN-OS API: the XML API for ARP, leases and VPN state, the REST API for policies, NAT and address objects, across every vsys.PAN-OS API による読み取り専用の同期。XML API で ARP、リース、VPN 状態を、REST API でポリシー、NAT、アドレスオブジェクトを取得し、複数 vsys に対応します。

取得的資料What it reads取得するデータ

ARP 表與 DHCP 租約ARP table and DHCP leasesARP テーブルと DHCP リース
安全政策（含 App-ID）與位址物件Security policies (with App-ID) and address objectsセキュリティポリシー（App-ID を含む）とアドレスオブジェクト
NAT 的目的地轉換（對外開放的部分）Destination NAT (what is opened to the outside)宛先 NAT（外部に公開している部分）
站對站 IPsec 通道Site-to-site IPsec tunnelsサイト間 IPsec トンネル

管理效益Management benefit管理上の効果

位址的上線時間、MAC 與租約主機名稱跟著防火牆更新Liveness, MAC and lease host names follow the firewall稼働確認、MAC、リースのホスト名がファイアウォールに追従します
IP 詳細資料與 IP 變更評估找得到引用這個位址物件的政策IP details and IP change assessment find the policies that reference the address objectsIP 詳細と IP 変更評価で、そのアドレスオブジェクトを参照するポリシーが分かります
政策異動偵測，與其他廠牌同一套通知與差異Policy-change detection with the same notices and diffs as other vendorsポリシー変更検知。他社製と同じ通知と差分で届きます
IPsec 通道畫在 IP 拓樸圖；目的地 NAT 列入「對外開放服務」IPsec tunnels appear on the IP topology map; destination NAT feeds "Exposed services"IPsec トンネルが IP トポロジーに描かれ、宛先 NAT は「公開されているサービス」に載ります

需要準備What to prepare準備するもの

唯讀角色的管理員，以 /api/?type=keygen 取得 API 金鑰（以 X-PAN-KEY 標頭傳送）A read-only admin and its API key from /api/?type=keygen (sent in the X-PAN-KEY header)読み取り専用ロールの管理者と、/api/?type=keygen で取得した API キー（X-PAN-KEY ヘッダーで送信）
jt-ipam 伺服器要連得到管理介面The jt-ipam server must reach the management interfacejt-ipam サーバーから管理画面に到達できること
REST 版本與 vsys 留空會自動偵測；偵測不到再手動填Leave the REST version and vsys empty to auto-detect; fill them in only if detection failsREST バージョンと vsys は空欄で自動検出。検出できない場合だけ手動入力

限制與注意Limits and notes制限と注意

Beta：依官方文件實作、尚未在實機驗證；先用「測試連線」看各端點能不能讀Beta: built from the official docs, not yet verified on an appliance; use "Test connection" to see what is readableBeta：公式ドキュメントに基づく実装で実機検証は未実施。「接続をテスト」で各エンドポイントを確認
不讀 DHCP 發放範圍與 GlobalProtect 連線DHCP ranges and GlobalProtect sessions are not readDHCP 配布範囲と GlobalProtect 接続は読みません
讀不到 vsys 清單時，該輪不刪除 NAT；IPAM 沒有的位址不會自動建立If the vsys list cannot be read, NAT is not pruned that round; addresses IPAM lacks are not createdvsys 一覧が読めない回は NAT を削除しません。IPAM に無いアドレスは作成しません
憑證推送是另外設定的寫回功能Certificate push is a separate write-back feature証明書の配信は別途設定する書き戻し機能です

設定位置：管理 > 外部系統整合 > Palo AltoWhere: Admin > External integrations > Palo Alto設定場所：管理 > 外部システム連携 > Palo Alto

Check Point

唯讀Read only読み取りのみBetaManagement APIGaia API

以唯讀工作階段讀取管理伺服器（Security Management Server / Multi-Domain）的 Management API；選用再替各閘道設定 Gaia API，讀閘道自己的 DHCP 與 ARP。Reads the management server's Management API (Security Management Server / Multi-Domain) in a read-only session; optionally, each gateway's Gaia API adds the gateway's own DHCP and ARP.管理サーバー（Security Management Server / Multi-Domain）の Management API を読み取り専用セッションで取得。任意でゲートウェイごとに Gaia API を設定し、ゲートウェイ自身の DHCP と ARP も読みます。

取得的資料What it reads取得するデータ

閘道清單與網路物件（主機、網路、位址範圍、群組）Gateway list and network objects (hosts, networks, ranges, groups)ゲートウェイ一覧とネットワークオブジェクト（ホスト、ネットワーク、範囲、グループ）
存取規則（含內嵌層與命中數）與 NAT 的目的地轉換Access rules (including inline layers and hit counts) and destination NATアクセスルール（インラインレイヤーとヒット数を含む）と宛先 NAT
閘道 DHCP 設定：發放範圍、發給用戶端的閘道與 DNS（Gaia API）Gateway DHCP settings: ranges, plus the gateway and DNS given to clients (Gaia API)ゲートウェイの DHCP 設定：配布範囲、クライアントへ渡すゲートウェイと DNS（Gaia API）
選用：閘道的 ARP 表與 DHCP 租約Optional: the gateway's ARP table and DHCP leases任意：ゲートウェイの ARP テーブルと DHCP リース

管理效益Management benefit管理上の効果

一台管理伺服器（含 Multi-Domain 各網域）管的閘道與政策套件一次看完All gateways and policy packages of one management server, including every Multi-Domain domain, in one place1 台の管理サーバー（Multi-Domain の各ドメインを含む）が管理するゲートウェイとポリシーパッケージを一度に確認
IP 詳細資料的防火牆反查列出涵蓋這個位址的物件與規則The firewall lookup on IP details lists the objects and rules covering the addressIP 詳細のファイアウォール逆引きに、そのアドレスに関わるオブジェクトとルールが表示されます
規則異動偵測與 IP 變更評估都涵蓋 Check Point；閘道 DHCP 給的閘道與 DNS 也納入評估Rule-change detection and IP change assessment cover Check Point, including the gateway and DNS handed out by gateway DHCPルール変更検知と IP 変更評価が Check Point に対応し、ゲートウェイ DHCP が渡すゲートウェイと DNS も評価に含まれます
閘道位址列入已知 DHCP 伺服器，不會被報成非法 DHCPGateway addresses count as known DHCP servers, not rogue onesゲートウェイのアドレスは既知の DHCP サーバーとして扱われ、不正 DHCP と誤報されません

需要準備What to prepare準備するもの

在 SmartConsole 建專用管理員：權限設定檔 Read Only All、驗證方式 API KeyA dedicated administrator in SmartConsole: profile Read Only All, authentication API KeySmartConsole で専用管理者を作成：権限プロファイル Read Only All、認証方式 API Key
Management API 的 Advanced Settings 允許 jt-ipam 主機連線，改完執行 api restartAllow the jt-ipam host in the Management API Advanced Settings, then run api restartManagement API の Advanced Settings で jt-ipam ホストからの接続を許可し、api restart を実行
Multi-Domain 填要同步的網域；政策套件留空＝全部For Multi-Domain, list the domains to sync; leave policy packages empty for allMulti-Domain は同期するドメインを入力。ポリシーパッケージは空欄で全部
要讀閘道 DHCP 時，在「閘道」頁籤替每台閘道設定 Gaia 帳號（唯讀角色即可）For gateway DHCP, set a Gaia account per gateway on the Gateways tab (a read-only role is enough)ゲートウェイの DHCP を読むには「ゲートウェイ」タブで各ゲートウェイの Gaia アカウントを設定（読み取り専用ロールで可）

限制與注意Limits and notes制限と注意

Beta：已在 R81.20 實機驗證Beta: verified on a real R81.20 systemBeta：R81.20 の実機で検証済み
ARP 與租約要在閘道上執行兩個寫死的讀取指令，需能執行指令的帳號；唯讀帳號會自動略過ARP and leases run two fixed read commands on the gateway and need an account that can run them; with a read-only account they are skippedARP とリースはゲートウェイ上で固定の読み取りコマンド 2 つを実行するため、実行権限のあるアカウントが必要。読み取り専用なら自動でスキップ
不讀 VPN 通道；NAT 只收目的地轉換VPN tunnels are not read; only destination NAT is collectedVPN トンネルは読みません。NAT は宛先変換のみ
每類資料有筆數上限，超過只取部分並在摘要標出，不清舊資料Each kind of data has a cap; beyond it only part is read, the summary says so and old data is keptデータ種別ごとに件数上限があり、超えた分は取得せず要約に表示し、既存データは消しません

設定位置：管理 > 外部系統整合 > Check PointWhere: Admin > External integrations > Check Point設定場所：管理 > 外部システム連携 > Check Point

MikroTik RouterOS

唯讀Read only読み取りのみBetaREST API

以 RouterOS v7 REST API 唯讀拉取 DHCP、防火牆、VPN、介面與鄰居；設計重點是不拖慢站台的主力路由器。Read-only pull of DHCP, firewall, VPN, interfaces and neighbors over the RouterOS v7 REST API, designed above all not to slow down a site's main router.RouterOS v7 REST API で DHCP、ファイアウォール、VPN、インタフェース、ネイバーを読み取り専用で取得。拠点の主力ルーターを遅くしないことを最優先に設計しています。

取得的資料What it reads取得するデータ

DHCP 租約、靜態租約與發放範圍DHCP leases, static leases and rangesDHCP リース、静的リース、配布範囲
防火牆 filter / mangle / NAT 規則與 address-listFirewall filter / mangle / NAT rules and address listsファイアウォールの filter / mangle / NAT ルールと address-list
介面（寫進裝置連接埠）與 LLDP / CDP / MNDP 鄰居Interfaces (written to device ports) and LLDP / CDP / MNDP neighborsインタフェース（デバイスのポートに反映）と LLDP / CDP / MNDP ネイバー
PPP 撥入連線與 WireGuard peer；ARP 表與 FDB（預設關閉）PPP dial-in sessions and WireGuard peers; ARP table and FDB (off by default)PPP ダイヤルイン接続と WireGuard ピア。ARP テーブルと FDB（既定オフ）

管理效益Management benefit管理上の効果

位址的上線時間、MAC 與租約主機名稱跟著路由器更新Liveness, MAC and lease host names follow the router稼働確認、MAC、リースのホスト名がルーターに追従します
IP 詳細資料與 IP 變更評估看得到涵蓋這個位址的規則與 address-list；規則異動也會通知IP details and IP change assessment show the rules and address lists covering the address; rule changes are notifiedIP 詳細と IP 変更評価でそのアドレスに関わるルールと address-list が分かり、ルール変更も通知されます
FDB 告訴你 MAC 是在哪個連接埠學到的；鄰居對到裝置時可直接點進去The FDB shows which port a MAC was learned on; neighbors matched to a device link straight to itFDB で MAC を学習したポートが分かり、デバイスに対応付いたネイバーはそのままリンクで開けます
WireGuard 站對站通道畫在 IP 拓樸圖上WireGuard site-to-site tunnels appear on the IP topology mapWireGuard のサイト間トンネルが IP トポロジーに描かれます

需要準備What to prepare準備するもの

RouterOS 7.1 以上，啟用 www-ssl 服務；jt-ipam 伺服器要連得到它RouterOS 7.1 or later with the www-ssl service enabled and reachable from the jt-ipam serverRouterOS 7.1 以降で www-ssl サービスを有効にし、jt-ipam サーバーから到達できること
專用帳號，群組只給 api + read，不要用 adminA dedicated account whose group has only api + read; do not use admin専用アカウント（グループ権限は api + read のみ）。admin は使わない
介面、FDB、鄰居要落在一台裝置上：指定對應裝置，或由 API 位址所屬的裝置自動對應Interfaces, FDB and neighbors land on one device: pick it, or let the device owning the API address be usedインタフェース、FDB、ネイバーは 1 台のデバイスに紐付きます。指定するか、API アドレスの所属デバイスを自動で使用
先按「測試連線」看每支端點的列數與耗時，再決定開哪些區段Use "Test connection" to see rows and seconds per endpoint before turning sections on「接続をテスト」でエンドポイントごとの行数と所要時間を見てから区画を有効化

限制與注意Limits and notes制限と注意

Beta；RouterOS 6.x 沒有 REST，無法支援Beta; RouterOS 6.x has no REST and is not supportedBeta。RouterOS 6.x は REST が無く非対応
序列執行、區段間停頓，CPU 超過門檻就停掉本輪剩下的區段；但仍會用到路由器 CPUSections run one at a time with pauses and stop when CPU passes a threshold; it still uses some router CPU区画は順番に間隔を空けて実行し、CPU がしきい値を超えると残りを中止。それでもルーターの CPU は多少使います
不讀路由表與連線追蹤；回應有大小上限（RouterOS REST 沒有分頁）Routing table and connection tracking are never read; responses have a size cap (RouterOS REST has no paging)ルーティングテーブルと接続追跡は読みません。応答にはサイズ上限あり（RouterOS REST にはページングが無い）
預設同步間隔 900 秒；ARP 與 FDB 在大型路由器可能上萬列Default sync interval is 900 seconds; ARP and FDB can be tens of thousands of rows on large routers既定の同期間隔は 900 秒。大型ルーターでは ARP と FDB が数万行になることも

設定位置：管理 > 外部系統整合 > MikroTikWhere: Admin > External integrations > MikroTik設定場所：管理 > 外部システム連携 > MikroTik

DNSDNSDNS

PowerDNS

唯讀Read only読み取りのみHTTP API

讀取 PowerDNS Authoritative 的 HTTP API，把每個 zone 的正解與反解紀錄拉回 IPAM 對照。Reads the PowerDNS Authoritative HTTP API and pulls each zone's forward and reverse records into IPAM.PowerDNS Authoritative の HTTP API から、各ゾーンの正引き・逆引きレコードを IPAM に取り込みます。

取得的資料What it reads取得するデータ

伺服器上的所有 zone（正解、反解）All zones on the server (forward and reverse)サーバー上の全ゾーン（正引き、逆引き）
A、AAAA、PTR 紀錄；比對群組有勾時另存 CNAME、MX、TXT 等A, AAAA and PTR records; CNAME, MX, TXT and others too when a comparison group asks for themA、AAAA、PTR レコード。比較グループで指定した場合は CNAME、MX、TXT なども保存

管理效益Management benefit管理上の効果

DNS 名稱成為 IP 的主機名稱來源之一；同一位址有多個名字時挑穩定的一個，不會反覆跳動DNS names become a host name source; with several names per address a stable one is chosen, so names do not flipDNS 名がホスト名の情報源になり、1 つのアドレスに複数の名前があっても安定した 1 つを選ぶので揺れません
A / AAAA 指向 IPAM 沒有的位址列為「懸空 DNS」；指向已離線主機的列入對外曝險A / AAAA pointing at addresses IPAM lacks show as "dangling DNS"; names pointing at offline hosts show under exposureIPAM に無いアドレスを指す A / AAAA は「宙に浮いた DNS」、オフラインのホストを指すものは外部露出として検出
IP 變更評估列出指向這個位址的 A / AAAA / PTR 與 CNAME 鏈IP change assessment lists the A / AAAA / PTR records and CNAME chains pointing at the addressIP 変更評価に、そのアドレスを指す A / AAAA / PTR と CNAME の連鎖が表示されます
主從伺服器放進比對群組，紀錄不一致時告警Put primary and secondary servers in a comparison group and get alerted when they differプライマリとセカンダリを比較グループに入れると、不一致時に通知されます

需要準備What to prepare準備するもの

開啟 PowerDNS 的 webserver 與 API，提供 API 位址與 X-API-KeyEnable the PowerDNS webserver and API; provide the API URL and X-API-KeyPowerDNS の webserver と API を有効にし、API の URL と X-API-Key を用意
jt-ipam 伺服器要連得到 API 埠；建議以 webserver-allow-from 只允許 jt-ipamThe jt-ipam server must reach the API port; restrict webserver-allow-from to jt-ipamjt-ipam サーバーから API ポートに到達できること。webserver-allow-from で jt-ipam のみ許可を推奨
重疊網段時設定「限定子網路範圍」For overlapping networks, set "Limit to subnets"重複するネットワークでは「対象サブネットを限定」を設定

限制與注意Limits and notes制限と注意

對象是 PowerDNS Authoritative（4.x 以上）的 HTTP APITargets the PowerDNS Authoritative (4.x or later) HTTP API対象は PowerDNS Authoritative（4.x 以降）の HTTP API
同步只讀取，不會改 PowerDNS 上的紀錄；DNS 紀錄不會自動建立 IPSync only reads and never changes PowerDNS records; DNS records do not create IP records同期は読み取りのみで PowerDNS のレコードは変更しません。DNS レコードから IP は作成しません
伺服器上刪掉的紀錄會跟著清；某個 zone 讀到 0 筆而本地原本不少筆時，視為讀取異常、不刪Records deleted on the server are removed too; a zone that suddenly reads empty is treated as a read problem and keptサーバーで削除されたレコードは追従して消えます。急に 0 件になったゾーンは読み取り異常とみなして保持

設定位置：管理 > 外部系統整合 > DNS（新增 DNS 服務，類型選「PowerDNS (HTTP API)」）Where: Admin > External integrations > DNS (Add DNS server, type "PowerDNS (HTTP API)")設定場所：管理 > 外部システム連携 > DNS（「DNS サーバーを追加」で種別「PowerDNS（HTTP API）」）

BIND9

唯讀Read only読み取りのみAXFR / TSIG

以區域轉送（AXFR）讀取 BIND 9 上指定的 zone，可用 TSIG 金鑰驗證。Reads the zones you name from BIND 9 by zone transfer (AXFR), optionally signed with a TSIG key.指定したゾーンを BIND 9 からゾーン転送（AXFR）で読み取ります。TSIG キーによる認証に対応。

取得的資料What it reads取得するデータ

「Zone 清單」裡列出的正解與反解 zoneThe forward and reverse zones listed under "Zones (BIND9)"「ゾーン（BIND9）」に列挙した正引き・逆引きゾーン
A、AAAA、PTR 紀錄；比對群組可另外加其他類型A, AAAA and PTR records; a comparison group can add other typesA、AAAA、PTR レコード。比較グループで他の種別も追加可能

管理效益Management benefit管理上の効果

DNS 名稱成為 IP 的主機名稱來源之一，紀錄列在「進階 > DNS 記錄」DNS names become a host name source; records are listed under Advanced Modules > DNS RecordsDNS 名がホスト名の情報源になり、レコードは「拡張モジュール > DNS レコード」に一覧表示
指向 IPAM 沒有的位址列為「懸空 DNS」，退役沒清乾淨的紀錄一眼看出Records pointing at addresses IPAM lacks show as "dangling DNS", exposing leftovers from retired hostsIPAM に無いアドレスを指すレコードは「宙に浮いた DNS」として検出され、廃止後の消し忘れが分かります
IP 變更評估列出指向這個位址的正解、反解與 CNAME 鏈IP change assessment lists forward, reverse and CNAME-chain records for the addressIP 変更評価に、そのアドレスの正引き、逆引き、CNAME の連鎖が表示されます
主從放進比對群組，複寫漏掉時告警Put primary and secondaries in a comparison group to catch missed transfersプライマリとセカンダリを比較グループに入れ、複製漏れを通知

需要準備What to prepare準備するもの

列出要同步的 zone（含反解 zone）The list of zones to sync, reverse zones included同期するゾーンの一覧（逆引きゾーンを含む）
BIND 端以 allow-transfer 允許 jt-ipam 對這些 zone 做 AXFRallow-transfer on BIND that lets jt-ipam do AXFR for those zonesBIND 側で allow-transfer により、jt-ipam からの AXFR を許可
TSIG 金鑰，格式 algorithm:keyname:base64keyA TSIG key in the form algorithm:keyname:base64keyTSIG キー（形式は algorithm:keyname:base64key）
jt-ipam 伺服器要能以 TCP 53 連到 BINDThe jt-ipam server must reach BIND on TCP 53jt-ipam サーバーから TCP 53 で BIND に到達できること

限制與注意Limits and notes制限と注意

DNS 協定無法列出所有 zone，沒列的 zone 不會同步；完全沒列時同步會失敗DNS cannot enumerate zones, so unlisted zones are not synced; with no zones listed the sync failsDNS にはゾーン列挙の手段が無いため、列挙していないゾーンは同期されず、1 つも無ければ同期は失敗します
只做 AXFR 讀取，不送動態更新；不使用 rndcOnly reads by AXFR; sends no dynamic updates and does not use rndcAXFR による読み取りのみで、動的更新は送らず rndc も使いません
DNS 紀錄不會自動建立 IP；重疊網段時設定「限定子網路範圍」DNS records do not create IP records; for overlapping networks set "Limit to subnets"DNS レコードから IP は作成しません。重複ネットワークでは「対象サブネットを限定」を設定

設定位置：管理 > 外部系統整合 > DNS（新增 DNS 服務，類型選「BIND 9 (rndc / TSIG)」）Where: Admin > External integrations > DNS (Add DNS server, type "BIND 9 (rndc / TSIG)")設定場所：管理 > 外部システム連携 > DNS（「DNS サーバーを追加」で種別「BIND 9（rndc / TSIG）」）

Unbound

唯讀Read only読み取りのみREST API

透過 OPNsense REST API 讀取 Unbound 的主機覆寫（Host Overrides），讓只寫在防火牆 DNS 裡的內部名稱也進到 IPAM。Reads Unbound host overrides through the OPNsense REST API, so internal names that only live in the firewall's DNS reach IPAM too.OPNsense REST API で Unbound のホストオーバーライドを読み取り、ファイアウォールの DNS にしかない内部名も IPAM に取り込みます。

取得的資料What it reads取得するデータ

啟用中的主機覆寫，每個網域當成一個 zoneEnabled host overrides, one zone per domain有効なホストオーバーライド（ドメインごとに 1 ゾーンとして扱う）
覆寫的 A、AAAA 等紀錄The overrides' A, AAAA and other recordsオーバーライドの A、AAAA などのレコード

管理效益Management benefit管理上の効果

只在 Unbound 覆寫裡的名稱也成為 IP 主機名稱來源Names that exist only as Unbound overrides become a host name sourceUnbound のオーバーライドにしかない名前もホスト名の情報源になります
指向 IPAM 沒有的位址列為「懸空 DNS」Overrides pointing at addresses IPAM lacks show as "dangling DNS"IPAM に無いアドレスを指すものは「宙に浮いた DNS」として検出
IP 變更評估會列出還指著這個位址的覆寫，改址時不會漏改IP change assessment lists overrides still pointing at the address, so none are missed when renumberingIP 変更評価にそのアドレスを指すオーバーライドが表示され、変更漏れを防げます

需要準備What to prepare準備するもの

在 OPNsense 建立 API key / secret，並給 Unbound 權限An OPNsense API key / secret with Unbound privilegesUnbound の権限を付けた OPNsense の API key / secret
jt-ipam 伺服器要連得到 OPNsense 的 HTTPS 管理介面The jt-ipam server must reach the OPNsense HTTPS management interfacejt-ipam サーバーから OPNsense の HTTPS 管理画面に到達できること
這是 DNS 設定，與 OPNsense 防火牆整合分開設定This is a DNS setting, configured apart from the OPNsense firewall integrationこれは DNS の設定で、OPNsense ファイアウォール連携とは別に設定します

限制與注意Limits and notes制限と注意

只有主機覆寫，不是完整 zone；比對群組只能和 Unbound 同組Host overrides only, not full zones; in comparison groups it can only sit with other Unbound serversホストオーバーライドのみで完全なゾーンではないため、比較グループは Unbound 同士でのみ組めます
停用的覆寫不讀；同步只讀取，不改 Unbound 設定Disabled overrides are skipped; sync only reads and never changes Unbound無効なオーバーライドは読みません。同期は読み取りのみで Unbound の設定は変更しません
只支援 OPNsense 上的 Unbound，不支援獨立安裝的 UnboundOnly Unbound on OPNsense is supported, not a standalone Unbound対応は OPNsense 上の Unbound のみで、単体の Unbound は非対応

設定位置：管理 > 外部系統整合 > DNS（新增 DNS 服務，類型選「OPNsense Unbound (REST)」）Where: Admin > External integrations > DNS (Add DNS server, type "OPNsense Unbound (REST)")設定場所：管理 > 外部システム連携 > DNS（「DNS サーバーを追加」で種別「OPNsense Unbound（REST）」）

Windows DNS

唯讀Read only読み取りのみWinRM

透過 WinRM 執行 PowerShell 的 DNS Server 指令讀取 Windows DNS，AD 網域裡電腦自己註冊的名稱也一併進到 IPAM。Reads Windows DNS by running DNS Server PowerShell cmdlets over WinRM, so names that computers register in AD DNS reach IPAM too.WinRM 経由で DNS Server の PowerShell コマンドを実行して Windows DNS を読み取り、AD でコンピューターが自動登録した名前も IPAM に取り込みます。

取得的資料What it reads取得するデータ

所有非自動建立的 zone（正解與反解）All zones that are not auto-created (forward and reverse)自動作成以外の全ゾーン（正引き、逆引き）
A、AAAA、PTR 紀錄；比對群組可加 CNAME、MX、TXTA, AAAA and PTR records; a comparison group can add CNAME, MX, TXTA、AAAA、PTR レコード。比較グループで CNAME、MX、TXT も追加可能

管理效益Management benefit管理上の効果

AD 電腦註冊的名稱成為 IP 主機名稱來源，不必手動填Names registered by AD computers become a host name source, with nothing typed by handAD コンピューターが登録した名前がホスト名の情報源になり、手入力が不要
多台 DC 放進比對群組：複寫落後或漏掉時告警（AD 服務定位資料不比對）Put your DCs in a comparison group to be alerted on lagging or missing replication (AD locator data is not compared)複数の DC を比較グループに入れ、複製の遅れや漏れを通知（AD のロケーター情報は比較対象外）
「懸空 DNS」與 IP 變更評估的 DNS 檢查都涵蓋 Windows DNS"Dangling DNS" and the DNS checks of IP change assessment cover Windows DNS「宙に浮いた DNS」と IP 変更評価の DNS 確認が Windows DNS に対応

需要準備What to prepare準備するもの

DNS 主機啟用 WinRM；預設 HTTP 5985（內容以 NTLM 加密），有憑證監聽才改 HTTPS 5986WinRM enabled on the DNS host; HTTP 5985 by default (content encrypted with NTLM), HTTPS 5986 only with a certificate listenerDNS ホストで WinRM を有効化。既定は HTTP 5985（NTLM で暗号化）、証明書リスナーがあれば HTTPS 5986
可經 WinRM 登入並讀取 DNS 伺服器的帳號（設定頁提示需 DNS 管理權限）An account that can sign in over WinRM and read the DNS server (the form asks for DNS admin rights)WinRM でログインして DNS サーバーを読めるアカウント（設定画面では DNS 管理権限を案内）
jt-ipam 伺服器要連得到 WinRM 埠，Windows 上不需安裝代理The jt-ipam server must reach the WinRM port; no agent is installed on Windowsjt-ipam サーバーから WinRM ポートに到達できること。Windows 側にエージェントは不要

限制與注意Limits and notes制限と注意

同步只執行 Get-DnsServerZone 與 Get-DnsServerResourceRecord，不改紀錄Sync only runs Get-DnsServerZone and Get-DnsServerResourceRecord and never changes records同期で実行するのは Get-DnsServerZone と Get-DnsServerResourceRecord だけで、レコードは変更しません
暫停或關閉的 zone 略過Paused or shut-down zones are skipped一時停止中または停止したゾーンはスキップ
HTTPS 用自簽憑證時要關閉「驗證 TLS 憑證」（仍走加密）With a self-signed HTTPS certificate, turn off TLS verification (traffic stays encrypted)HTTPS で自己署名証明書なら TLS 証明書の検証をオフ（通信は暗号化されたまま）

設定位置：管理 > 外部系統整合 > DNS（新增 DNS 服務，類型選「Microsoft Windows DNS (WinRM)」）Where: Admin > External integrations > DNS (Add DNS server, type "Microsoft Windows DNS (WinRM)")設定場所：管理 > 外部システム連携 > DNS（「DNS サーバーを追加」で種別「Microsoft Windows DNS（WinRM）」）

Univention UCS

唯讀Read only読み取りのみUDM REST API

直接呼叫 Univention UCS 的 UDM REST API 讀取 DNS 物件，不連 UCS 內的 BIND9。Reads DNS objects through the Univention UCS UDM REST API, without touching the BIND9 inside UCS.Univention UCS の UDM REST API から DNS オブジェクトを読み取ります。UCS 内の BIND9 には接続しません。

取得的資料What it reads取得するデータ

正解與反解 zoneForward and reverse zones正引き・逆引きゾーン
主機紀錄（A / AAAA）、PTR 與別名（CNAME）Host records (A / AAAA), PTR records and aliases (CNAME)ホストレコード（A / AAAA）、PTR、エイリアス（CNAME）

管理效益Management benefit管理上の効果

UCS 目錄裡登記的主機名稱進到 IP 的主機名稱來源Host names registered in the UCS directory become a host name sourceUCS ディレクトリに登録されたホスト名がホスト名の情報源になります
可和 Windows DNS 等其他軟體混搭放進同一個比對群組Can share a comparison group with other software such as Windows DNSWindows DNS など他のソフトと同じ比較グループに入れられます
「懸空 DNS」與 IP 變更評估的 DNS 檢查都涵蓋 UCS"Dangling DNS" and the DNS checks of IP change assessment cover UCS「宙に浮いた DNS」と IP 変更評価の DNS 確認が UCS に対応

需要準備What to prepare準備するもの

API URL 填 https://<UCS 主機>；那台要有 UDM REST API（Primary 與 Backup Directory Node 預設安裝）API URL https://<UCS host>; that node needs the UDM REST API (installed by default on Primary and Backup Directory Nodes)API URL は https://<UCS ホスト>。そのノードに UDM REST API が必要（Primary と Backup Directory Node には既定で導入）
帳號要在允許使用 UDM REST API 的群組裡（UCR 的 directory/manager/rest/authorized-groups）An account in a group allowed to use the UDM REST API (UCR directory/manager/rest/authorized-groups)UDM REST API の利用を許可されたグループ（UCR の directory/manager/rest/authorized-groups）に属するアカウント
jt-ipam 伺服器要連得到 UCS 的 HTTPS；自簽憑證可關閉「驗證 TLS 憑證」The jt-ipam server must reach UCS over HTTPS; turn off TLS verification for self-signed certificatesjt-ipam サーバーから UCS の HTTPS に到達できること。自己署名証明書なら TLS 証明書の検証をオフ

限制與注意Limits and notes制限と注意

Replica Directory Node 預設沒有 UDM REST API（測試連線回 404），可改填 PrimaryReplica Directory Nodes lack the UDM REST API by default (the test returns 404); use the Primary insteadReplica Directory Node には既定で UDM REST API が無く（テストで 404）、Primary を指定してください
回 403「Not in allowed groups」表示帳號不在允許的群組A 403 "Not in allowed groups" means the account is not in an allowed group403「Not in allowed groups」はアカウントが許可グループに無いことを示します
同步只讀取，不改 UCS 上的 DNS 物件Sync only reads and never changes DNS objects in UCS同期は読み取りのみで、UCS の DNS オブジェクトは変更しません

設定位置：管理 > 外部系統整合 > DNS（新增 DNS 服務，類型選「Univention UCS (UDM REST API)」）Where: Admin > External integrations > DNS (Add DNS server, type "Univention UCS (UDM REST API)")設定場所：管理 > 外部システム連携 > DNS（「DNS サーバーを追加」で種別「Univention UCS（UDM REST API）」）

AdGuard Home

唯讀Read only読み取りのみREST API

讀取 AdGuard Home 的用戶端設定與 DNS 改寫（rewrite），替 IP 補上名稱與 MAC。Reads AdGuard Home's client settings and DNS rewrites to fill in names and MACs for IP records.AdGuard Home のクライアント設定と DNS 書き換え（rewrite）を読み取り、IP に名前と MAC を補います。

取得的資料What it reads取得するデータ

手動設定的用戶端（名稱、IP、MAC）Configured clients (name, IP, MAC)手動設定したクライアント（名前、IP、MAC）
DNS 改寫：網域對應到 IPv4 位址的項目DNS rewrites that map a domain to an IPv4 addressDNS 書き換え：ドメインを IPv4 アドレスに対応付けた項目

管理效益Management benefit管理上の効果

在 AdGuard 幫裝置取的名字成為 IP 主機名稱來源Names you gave devices in AdGuard become a host name sourceAdGuard で付けたデバイス名がホスト名の情報源になります
用戶端的 MAC 依來源優先序補進 IP 紀錄Client MACs fill IP records according to the source priorityクライアントの MAC が情報源の優先順位に従って IP に補われます
IP 變更評估會提醒：這個位址還有 AdGuard 改寫或用戶端設定指著它IP change assessment warns when an AdGuard rewrite or client entry still points at the addressIP 変更評価で、そのアドレスを指す AdGuard の書き換えやクライアント設定が残っていれば警告されます

需要準備What to prepare準備するもの

AdGuard Home v0.107 以上，jt-ipam 伺服器要連得到它的網頁介面AdGuard Home v0.107 or later, reachable from the jt-ipam serverAdGuard Home v0.107 以降で、jt-ipam サーバーから Web 画面に到達できること
AdGuard Home 的登入帳號與密碼（Basic 認證）An AdGuard Home login and password (Basic auth)AdGuard Home のログインアカウントとパスワード（Basic 認証）
選擇要拉的資料（用戶端、DNS 改寫）；重疊網段時設定「限定子網路範圍」Choose what to pull (clients, rewrites); for overlapping networks set "Limit to subnets"取得するデータ（クライアント、書き換え）を選択。重複ネットワークでは「対象サブネットを限定」を設定

限制與注意Limits and notes制限と注意

不讀自動偵測的用戶端、查詢紀錄與 AdGuard 的 DHCPAuto-detected clients, the query log and AdGuard's DHCP are not read自動検出クライアント、クエリログ、AdGuard の DHCP は読みません
答案是 CNAME 或 IPv6 的改寫不使用；停用的改寫不讀Rewrites answering with a CNAME or IPv6 are not used; disabled rewrites are skipped応答が CNAME や IPv6 の書き換えは使わず、無効な書き換えも読みません
只對到 IPAM 已有的位址，不會自動建立；同步只送讀取請求Only matches addresses already in IPAM and creates none; sync sends read requests onlyIPAM に既にあるアドレスとだけ照合し、作成はしません。同期は読み取り要求のみ

設定位置：管理 > 外部系統整合 > AdGuardWhere: Admin > External integrations > AdGuard設定場所：管理 > 外部システム連携 > AdGuard

DHCPDHCPDHCP

Windows DHCP Server

唯讀Read only読み取りのみWinRMPowerShellBeta

經 WinRM 在 Windows DHCP Server 上執行唯讀的 PowerShell 查詢（只用 Get-* cmdlet），把 IPv4 範圍、排除區間、保留與租約帶進 jt-ipam；不會改動 DHCP 伺服器上的任何設定。Runs read-only PowerShell queries (Get-* cmdlets only) over WinRM on a Windows DHCP Server and brings IPv4 scopes, exclusions, reservations and leases into jt-ipam. Nothing on the DHCP server is changed.WinRM 経由で Windows DHCP Server 上の読み取り専用 PowerShell クエリ（Get-* コマンドレットのみ）を実行し、IPv4 スコープ、除外範囲、予約、リースを jt-ipam に取り込みます。DHCP サーバーの設定は一切変更しません。

取得的資料What it reads取得するデータ

IPv4 範圍：起訖位址、子網路遮罩、啟用狀態IPv4 scopes: start and end address, subnet mask, stateIPv4 スコープ：開始・終了アドレス、サブネットマスク、状態
每個範圍的排除區間Exclusion ranges of each scope各スコープの除外範囲
保留：IP、MAC、名稱、說明Reservations: IP, MAC, name, description予約：IP、MAC、名前、説明
租約：IP、MAC、用戶端登記的主機名稱、租約狀態Leases: IP, MAC, the host name the client registered, lease stateリース：IP、MAC、クライアントが登録したホスト名、リースの状態

管理效益Management benefit管理上の効果

範圍扣掉排除區間後成為子網路裡的 DHCP 範圍，顯示使用量，快滿時發出「DHCP 集區即將用盡」通知Scopes minus their exclusions become DHCP ranges in the subnet, with usage and a "DHCP pool nearly exhausted" notification除外範囲を差し引いたスコープがサブネット内の DHCP 範囲になり、使用量を表示し、残りわずかになると「DHCP プールの枯渇が近い」通知を出します
租約把既有 IP 標成 DHCP，並依來源順序補上 MAC 與主機名稱Leases mark existing IP records as DHCP and fill in MAC and host name by your source orderリースで既存の IP を DHCP として示し、ソース順に従って MAC とホスト名を補います
保留與排除的位址在 IP 清單與 IP 頁面上有標示，並註明是哪一台 DHCP 伺服器Reserved and excluded addresses are tagged in the IP list and on the IP page, naming the DHCP server予約・除外されたアドレスは IP 一覧と IP ページに表示され、どの DHCP サーバーかも示します
這台 DHCP 伺服器被視為已知，不會被當成非法 DHCP 伺服器The server counts as a known DHCP server, so it is not flagged as a rogue DHCP serverこのサーバーは既知の DHCP サーバーとして扱われ、不正な DHCP サーバーとして警告されません
IP 變更評估看得到某個位址被哪些保留與範圍引用IP change assessment sees which reservations and ranges refer to an addressIP 変更の評価で、アドレスを参照している予約と範囲がわかります

需要準備What to prepare準備するもの

jt-ipam 伺服器連得到 WinRM：預設 HTTP 5985（內容與帳密一律以 NTLM 加密）；HTTPS 5986 需另外建立憑證監聽WinRM reachable from the jt-ipam server: HTTP 5985 by default (content and credentials always NTLM-encrypted); HTTPS 5986 needs a certificate listenerjt-ipam サーバーから WinRM に接続できること：既定は HTTP 5985（内容と資格情報は常に NTLM で暗号化）。HTTPS 5986 には証明書付きリスナーが別途必要です
專用帳號：加入「DHCP Users」，並能使用 WinRM（「Remote Management Users」或管理員）A dedicated account in "DHCP Users" that may use WinRM ("Remote Management Users" or an administrator)専用アカウント：「DHCP Users」に所属し、WinRM を使えること（「Remote Management Users」または管理者）
DHCP 服務重疊網段時，設定「限定子網路範圍」"Limit to subnets" when the server serves overlapping ranges重複するネットワークに配布している場合は「対象サブネットを限定」を設定します

限制與注意Limits and notes制限と注意

Beta；只讀 IPv4（Get-DhcpServerv4*）Beta; IPv4 only (Get-DhcpServerv4*)Beta。IPv4 のみ（Get-DhcpServerv4*）
驗證方式只有 NTLM，沒有 Kerberos 選項Authentication is NTLM only; there is no Kerberos option認証は NTLM のみで、Kerberos は選べません
租約不會新建 IP，只標記既有紀錄；重疊網段對不到唯一一筆時不猜Leases never create IP records, only mark existing ones; no guessing when overlaps give no unique matchリースから IP は作成せず、既存のレコードに印を付けるだけです。重複により一意に決まらない場合は推測しません
停用的範圍不算；任何範圍的保留或排除讀不到時整次失敗，保留上一輪的資料Inactive scopes are ignored; if any scope's reservations or exclusions cannot be read, the sync fails and keeps the previous data無効なスコープは対象外です。どれかのスコープの予約や除外を読めなければ同期は失敗とし、前回のデータを残します

設定位置：管理 > 外部系統整合 > Windows DHCPWhere: Admin > External integrations > Windows DHCP設定場所：管理 > 外部システム連携 > Windows DHCP

Kea DHCP

唯讀Read only読み取りのみ控制 APIControl API制御 API

連接 Kea 的 JSON 控制 API，唯讀同步 IPv4 範圍、保留與租約。Kea 2.x 連控制代理（kea-ctrl-agent）；Kea 3.0 起也能直接連 DHCP 伺服器自己的 HTTP 控制通道，兩種會自動判別。Connects to Kea's JSON control API and syncs IPv4 pools, reservations and leases read only. Kea 2.x is reached through the Control Agent (kea-ctrl-agent); from Kea 3.0 the DHCP server's own HTTP control socket also works, and the two are told apart automatically.Kea の JSON 制御 API に接続し、IPv4 のプール、予約、リースを読み取り専用で同期します。Kea 2.x はコントロールエージェント（kea-ctrl-agent）経由で、Kea 3.0 以降は DHCP サーバー自身の HTTP 制御ソケットにも直接接続でき、どちらかは自動で判別します。

取得的資料What it reads取得するデータ

設定裡的子網路與發放範圍（含 shared-networks 底下的）Subnets and pools from the configuration (including those under shared networks)設定内のサブネットとプール（shared-networks 配下を含む）
設定裡的保留；有載入 host_cmds 時另讀存在資料庫的保留Reservations in the configuration, plus database reservations when host_cmds is loaded設定内の予約。host_cmds を読み込んでいればデータベースの予約も読みます
有效租約（分頁讀取，已到期的略過）：IP、MAC、主機名稱Active leases (paged, expired ones skipped): IP, MAC, host name有効なリース（ページ単位、期限切れは除外）：IP、MAC、ホスト名
Kea 版本與連線方式（測試連線時顯示）Kea version and connection mode (shown by the connection test)Kea のバージョンと接続方式（接続テストで表示）

管理效益Management benefit管理上の効果

發放範圍成為子網路裡的 DHCP 範圍，顯示使用量與快滿通知Pools become DHCP ranges in the subnet, with usage and the nearly-exhausted notificationプールがサブネット内の DHCP 範囲になり、使用量と枯渇間近の通知が使えます
租約把既有 IP 標成 DHCP，補上 MAC 與主機名稱Leases mark existing IP records as DHCP and fill in MAC and host nameリースで既存の IP を DHCP として示し、MAC とホスト名を補います
保留讓你看得出哪個位址綁定哪張網卡Reservations show which address is bound to which NIC予約から、どのアドレスがどの NIC に固定されているかがわかります
Kea 主機被視為已知的 DHCP 伺服器，不會被當成非法 DHCPThe Kea host counts as a known DHCP server, not a rogue oneKea のホストは既知の DHCP サーバーとして扱われ、不正 DHCP とはみなされません
租約沒讀完整（例如沒有 lease_cmds）時不清任何東西，不會把整台的租約標記洗掉When leases are not read completely (for example without lease_cmds), nothing is clearedリースを完全に読めなかったとき（lease_cmds が無い場合など）は何も消しません

需要準備What to prepare準備するもの

jt-ipam 伺服器連得到控制 API 網址（例如 http://kea.example.net:8000/）The control API URL reachable from the jt-ipam server (for example http://kea.example.net:8000/)jt-ipam サーバーから制御 API の URL に接続できること（例：http://kea.example.net:8000/）
Kea 有設 HTTP 驗證時，填入帳號與密碼User name and password if Kea uses HTTP authenticationKea で HTTP 認証を使っている場合はユーザー名とパスワード
要讀租約須在 kea-dhcp4 的 hooks-libraries 載入 libdhcp_lease_cmds.so；保留存在資料庫時另需 host_cmdsFor leases, load libdhcp_lease_cmds.so in the hooks-libraries of kea-dhcp4; host_cmds for reservations kept in a databaseリースには kea-dhcp4 の hooks-libraries に libdhcp_lease_cmds.so が必要です。予約をデータベースに置く場合は host_cmds も必要です
重疊網段時設定「限定子網路範圍」"Limit to subnets" for overlapping ranges重複するネットワークでは「対象サブネットを限定」を設定します

限制與注意Limits and notes制限と注意

只讀 IPv4（dhcp4）IPv4 (dhcp4) onlyIPv4（dhcp4）のみ
租約不會新建 IP，只標記既有紀錄Leases never create IP records, only mark existing onesリースから IP は作成せず、既存のレコードに印を付けるだけです
每輪最多讀 100,000 筆租約；超過時這一輪視為不完整，不清除Up to 100,000 leases per round; beyond that the round counts as incomplete and nothing is cleared1 回に読むリースは最大 100,000 件です。超えた回は不完全とみなし、何も消しません
jt-ipam 只送讀取指令（config-get、version-get、lease4-get-page、reservation-get-all）jt-ipam only sends read commands (config-get, version-get, lease4-get-page, reservation-get-all)jt-ipam が送るのは読み取りコマンド（config-get、version-get、lease4-get-page、reservation-get-all）だけです
跑在 OPNsense 或 pfSense 上的 Kea，改用該防火牆的整合For Kea on OPNsense or pfSense, use that firewall's integration insteadOPNsense や pfSense 上の Kea は、そのファイアウォールの連携を使ってください

設定位置：管理 > 外部系統整合 > Kea DHCPWhere: Admin > External integrations > Kea DHCP設定場所：管理 > 外部システム連携 > Kea DHCP

ISC DHCP

唯讀Read only読み取りのみ掃描代理Scan agentスキャンエージェント

isc-dhcp-server 沒有能列出全部租約的 API，所以由裝在 DHCP 主機上的掃描代理讀本機的設定檔與租約檔，只回報解析後的範圍、固定分配與有效租約。jt-ipam 不會連到 DHCP 主機。isc-dhcp-server has no API that lists every lease, so a scan agent on the DHCP host reads the local config and lease files and reports only the parsed pools, fixed addresses and active leases. jt-ipam never connects to the DHCP host.isc-dhcp-server にはすべてのリースを一覧できる API が無いため、DHCP ホストに入れたスキャンエージェントがローカルの設定ファイルとリースファイルを読み、解析したプール、固定割り当て、有効なリースだけを報告します。jt-ipam から DHCP ホストへは接続しません。

取得的資料What it reads取得するデータ

dhcpd.conf 裡各子網路的發放範圍Pools of each subnet in dhcpd.confdhcpd.conf 内の各サブネットのプール
固定分配（fixed-address）：IP、MAC、主機名稱Fixed addresses: IP, MAC, host name固定割り当て（fixed-address）：IP、MAC、ホスト名
dhcpd.leases 裡的有效租約Active leases in dhcpd.leasesdhcpd.leases 内の有効なリース
兩個檔案的狀態：路徑、讀不讀得到、大小、修改時間Status of both files: path, readable or not, size, modified time両ファイルの状態：パス、読めるかどうか、サイズ、更新日時

管理效益Management benefit管理上の効果

沒有 API 的 DHCP 也有同樣的畫面：範圍使用量、保留位址、租約標記，既有 IP 補上 MAC 與主機名稱A DHCP server without an API gets the same view: range usage, reserved addresses, lease flags, MAC and host name on existing IP recordsAPI の無い DHCP でも同じ表示が得られます：範囲の使用量、予約アドレス、リースの印、既存 IP の MAC とホスト名
檔案內容不離開主機：dhcpd.conf 常有的 DDNS / OMAPI 金鑰不會送出File contents never leave the host: DDNS / OMAPI keys often found in dhcpd.conf are not sentファイルの内容はホストから出ません。dhcpd.conf によくある DDNS / OMAPI の鍵は送られません
檔案讀不到會明講，不當成「沒有資料」而清掉範圍或租約An unreadable file is reported as such, never treated as "no data" that clears pools or leases読めないファイルはそのまま報告し、「データ無し」とみなしてプールやリースを消すことはしません
超過回報間隔 3 倍沒收到回報就標成錯誤，代理停了看得出來No report for three report intervals turns the source into an error, so a stopped agent shows up報告間隔の 3 倍を過ぎても報告が無ければエラーにするので、エージェントの停止に気付けます

需要準備What to prepare準備するもの

在 DHCP 主機上安裝掃描代理 1.12.0 以上（不必指派子網路；代理會自行更新）Scan agent 1.12.0 or later on the DHCP host (no subnets need to be assigned; agents update themselves)DHCP ホストにスキャンエージェント 1.12.0 以降を入れます（サブネットの割り当ては不要。エージェントは自動更新します）
代理預設以 root 執行；改用其他帳號時，要讀得到 /etc/dhcp/dhcpd.conf 與 /var/lib/dhcp/dhcpd.leasesThe agent runs as root by default; another account must be able to read /etc/dhcp/dhcpd.conf and /var/lib/dhcp/dhcpd.leasesエージェントは既定で root で動きます。別のアカウントにする場合は /etc/dhcp/dhcpd.conf と /var/lib/dhcp/dhcpd.leases を読める必要があります
路徑不同時，在該主機的 /etc/jt-ipam-agent.env 設定 JT_IPAM_DHCPD_CONF、JT_IPAM_DHCPD_LEASES 後重啟代理Other paths: set JT_IPAM_DHCPD_CONF and JT_IPAM_DHCPD_LEASES in /etc/jt-ipam-agent.env on that host and restart the agentパスが異なる場合は、そのホストの /etc/jt-ipam-agent.env に JT_IPAM_DHCPD_CONF と JT_IPAM_DHCPD_LEASES を設定し、エージェントを再起動します
在 jt-ipam 新增來源並選擇那個代理；下次輪詢就開始回報Add a source in jt-ipam and pick that agent; it reports on its next polljt-ipam でソースを追加してそのエージェントを選ぶと、次のポーリングから報告が始まります

限制與注意Limits and notes制限と注意

只處理 IPv4IPv4 onlyIPv4 のみ
租約不會新建 IP，只標記既有紀錄Leases never create IP records, only mark existing onesリースから IP は作成せず、既存のレコードに印を付けるだけです
一個代理只能服務一個來源；檔案路徑只能在 DHCP 主機上設定One agent serves one source; file paths can only be set on the DHCP host1 つのエージェントが担当できるソースは 1 つです。ファイルのパスは DHCP ホスト側でしか設定できません
OPNsense、pfSense 上的 DHCP 由防火牆整合讀取，不用這一項DHCP on OPNsense or pfSense comes through the firewall integration, not this oneOPNsense や pfSense の DHCP はファイアウォールの連携で読むので、これは使いません

設定位置：管理 > 外部系統整合 > ISC DHCPWhere: Admin > External integrations > ISC DHCP設定場所：管理 > 外部システム連携 > ISC DHCP

Technitium DNS + DHCP

唯讀Read only読み取りのみHTTP API

Technitium 同時提供 DNS 與 DHCP，jt-ipam 用 API token 經它的 HTTP API 兩邊都讀：DNS 區域與紀錄拿來和 IPAM 比對，DHCP 的範圍、保留、發給用戶端的選項與租約帶進來。不寫回任何東西。Technitium serves both DNS and DHCP, and jt-ipam reads both through its HTTP API with an API token: DNS zones and records are compared with IPAM, and DHCP scopes, reservations, client options and leases are brought in. Nothing is written back.Technitium は DNS と DHCP の両方を提供します。jt-ipam は API トークンで HTTP API から両方を読みます。DNS のゾーンとレコードは IPAM と照合し、DHCP のスコープ、予約、クライアントに渡すオプション、リースを取り込みます。何も書き戻しません。

取得的資料What it reads取得するデータ

DNS：有位址紀錄的區域（primary、secondary、forwarder）與其紀錄DNS: zones that hold address records (primary, secondary, forwarder) and their recordsDNS：アドレスレコードを持つゾーン（primary、secondary、forwarder）とそのレコード
DHCP 範圍：起訖、排除區間、啟用狀態DHCP scopes: range, exclusions, enabled stateDHCP スコープ：範囲、除外範囲、有効かどうか
保留，以及發給用戶端的預設閘道、DNS、NTP、WINSReservations and the default gateway, DNS, NTP and WINS handed to clients予約と、クライアントに渡すデフォルトゲートウェイ、DNS、NTP、WINS
租約：IP、MAC、主機名稱Leases: IP, MAC, host nameリース：IP、MAC、ホスト名

管理效益Management benefit管理上の効果

DNS 紀錄和 IP 紀錄逐筆比對，標出一致、僅 DNS 有、僅 IPAM 有、不一致；DNS 名稱也是主機名稱來源之一DNS records are compared with IP records and marked consistent, DNS only, IPAM only or mismatch; DNS names also act as a host name sourceDNS レコードを IP レコードと照合し、一致、DNS のみ、IPAM のみ、不一致を示します。DNS の名前はホスト名のソースにもなります
啟用的範圍扣掉排除區間後成為 DHCP 範圍，顯示使用量；保留顯示綁定的 MACEnabled scopes minus exclusions become DHCP ranges with usage; reservations show the bound MAC有効なスコープは除外範囲を差し引いて DHCP 範囲になり、使用量を表示します。予約には固定先の MAC が出ます
租約把既有 IP 標成 DHCP，補上 MAC 與主機名稱Leases mark existing IP records as DHCP and fill in MAC and host nameリースで既存の IP を DHCP として示し、MAC とホスト名を補います
IP 變更評估知道哪些範圍把某個位址當成閘道、DNS、NTP 或 WINS 發給用戶端（改了會影響整個範圍的用戶端）IP change assessment knows which scopes hand an address out as gateway, DNS, NTP or WINS (changing it affects every client of the scope)IP 変更の評価で、どのスコープがそのアドレスをゲートウェイ、DNS、NTP、WINS として配っているかがわかります（変えるとスコープ内の全クライアントに影響します）

需要準備What to prepare準備するもの

jt-ipam 伺服器連得到 Technitium 網頁主控台（預設 http://host:5380 或 https://host:53443）；HTTP 會轉到 HTTPS 時直接填 HTTPS 網址The Technitium web console reachable from the jt-ipam server (by default http://host:5380 or https://host:53443); if HTTP redirects to HTTPS, enter the HTTPS URLjt-ipam サーバーから Technitium の Web コンソールに接続できること（既定は http://host:5380 または https://host:53443）。HTTP が HTTPS に転送される場合は HTTPS の URL を入力します
建立專用使用者與群組，只給檢視權限（DNS 給 Zones，DHCP 給 DHCP），以該使用者登入建立 API token（不會過期）A dedicated user and group with view permission only (Zones for DNS, DHCP for DHCP); sign in as that user and create an API token (it does not expire)閲覧権限だけを持つ専用のユーザーとグループを作り（DNS は Zones、DHCP は DHCP）、そのユーザーでログインして API トークンを作成します（期限なし）
DNS 要在每個要同步的區域給該群組檢視權限；新建的區域預設只給管理員群組，記得補上For DNS, give the group view permission on every zone to sync; new zones only grant the administrator groups by defaultDNS は同期したい各ゾーンでそのグループに閲覧権限を与えます。新しいゾーンは既定で管理者グループにしか権限が無いので、忘れずに追加します
DNS 與 DHCP 分開新增：DNS 在「DNS」頁選 Technitium DNS Server 類型，DHCP 在「Technitium DHCP」頁DNS and DHCP are added separately: DNS on the "DNS" page with type Technitium DNS Server, DHCP on the "Technitium DHCP" pageDNS と DHCP は別々に追加します。DNS は「DNS」ページで種類 Technitium DNS Server を選び、DHCP は「Technitium DHCP」ページで設定します

限制與注意Limits and notes制限と注意

只讀：不寫區域也不改 DHCP；token 有修改權限時測試連線會提醒Read only: zones and DHCP are never changed; the connection test warns when the token can modify読み取りのみ：ゾーンも DHCP も変更しません。トークンに変更権限があると接続テストで警告します
帳號讀不到的區域根本不會列出，看起來像不存在；測試連線會列出讀不到的區域Zones the account cannot read are not listed at all, so they look missing; the connection test lists unreadable zonesアカウントが読めないゾーンは一覧に出ず、存在しないように見えます。接続テストで読めないゾーンを示します
停用的 DHCP 範圍不寫成發放範圍或保留Disabled DHCP scopes produce no ranges or reservations無効な DHCP スコープからは範囲も予約も作りません
DHCP 只處理 IPv4；租約不會新建 IPDHCP is IPv4 only; leases never create IP recordsDHCP は IPv4 のみで、リースから IP は作成しません
讀取失敗時不清任何既有資料（沒看到不等於刪除）A failed read clears nothing (not seen is not the same as deleted)読み取りに失敗したときは既存のデータを消しません（見えないことは削除を意味しません）

設定位置：管理 > 外部系統整合 > DNS（DNS 部分）；管理 > 外部系統整合 > Technitium DHCP（DHCP 部分）Where: Admin > External integrations > DNS (DNS part); Admin > External integrations > Technitium DHCP (DHCP part)設定場所：管理 > 外部システム連携 > DNS（DNS 部分）、管理 > 外部システム連携 > Technitium DHCP（DHCP 部分）

ISOinsight

唯讀Read only読み取りのみHTTP(S)Beta

定期登入 ISOinsight 的 HTTP(S) 介面讀取 DHCP 租約，合併進 IP、MAC、主機名稱與來源紀錄。只登入與讀取，不改動設備上的 DHCP 設定或租約。Logs in to the ISOinsight HTTP(S) interface on a schedule and reads its DHCP leases, merging them into IP, MAC, host name and source records. It only logs in and reads; DHCP settings and leases on the device are never changed.ISOinsight の HTTP(S) インターフェースに定期的にログインして DHCP リースを読み、IP、MAC、ホスト名、ソースの記録に取り込みます。ログインと読み取りだけで、機器上の DHCP 設定やリースは変更しません。

取得的資料What it reads取得するデータ

DHCP 租約：IP、MAC、主機名稱、租約起訖時間DHCP leases: IP, MAC, host name, lease start and endDHCP リース：IP、MAC、ホスト名、リースの開始・終了時刻
依起訖時間判斷的租約狀態（租期內、已過期、尚未開始）Lease state derived from the start and end times (within lease, expired, not started)開始・終了時刻から求めたリースの状態（期間内、期限切れ、未開始）
每筆的品質標記（MAC 空白或無效、時間解析不了、MAC 衝突、重複）Quality tags per row (empty or invalid MAC, unparsed time, MAC conflict, duplicate)行ごとの品質タグ（MAC が空・無効、時刻を解析できない、MAC の衝突、重複）

管理效益Management benefit管理上の効果

只在同一個客戶的允許子網路裡比對（最長首碼），重疊網段對不到唯一一個就不對應，不猜Matched only inside the allowed subnets of one customer (longest prefix); overlaps without a unique match stay unmatched, never guessed1 つの顧客の許可されたサブネット内だけで照合し（最長一致）、重複で一意に決まらなければ対応付けず、推測しません
租期內、沒有 MAC 衝突的租約才寫進 IP：設 DHCP 租約標記，MAC 與主機名稱照來源順序，人工維護的值不會被蓋掉Only leases within their period and without a MAC conflict touch IP records: the DHCP lease flag is set, MAC and host name follow the source order, and values people maintain are never overwritten期間内で MAC の衝突が無いリースだけが IP に反映されます。DHCP リースの印を付け、MAC とホスト名はソース順に従い、人が管理している値は上書きしません
符合上述條件且 IPAM 沒有的位址會新增 IP（可關閉）Such a lease for an address IPAM lacks creates an IP record (can be turned off)上記の条件を満たし IPAM に無いアドレスは IP レコードを作成します（無効にできます）
逐步的測試連線與不寫入任何資料的預覽，確認後才開始同步A step-by-step connection test and a preview that writes nothing, before anything is synced段階ごとの接続テストと、何も書き込まないプレビューで確認してから同期を始められます
租約連同起訖時間保留為來源觀察紀錄（含對不到 IP 的），IP 變更評估會用到，AI 工具也能列出Leases are kept as source observations with their own times (including ones that match no IP record); IP change assessment uses them and an AI tool can list themリースは開始・終了時刻とともにソースの観測記録として残り（IP に対応しないものも含む）、IP 変更の評価で使われ、AI ツールからも一覧できます

需要準備What to prepare準備するもの

jt-ipam 伺服器連得到 ISOinsight 的基礎網址，以及登入帳號密碼The ISOinsight base URL reachable from the jt-ipam server, and a login accountjt-ipam サーバーから ISOinsight のベース URL に接続できることと、ログイン用のアカウント
登入方式：新來源預設用原廠說明的方式；GET 與 POST 要明確選擇，不會自動切換Login method: new sources default to the vendor's documented method; GET and POST are explicit choices that never switch automaticallyログイン方式：新しいソースはメーカーが示す方式が既定です。GET と POST は明示的に選び、自動では切り替わりません
客戶與「允許同步的子網路」（預設為該客戶的全部子網路，含之後新增的）The customer and the "Subnets that may be synced" (by default every subnet of that customer, including later ones)顧客と「同期を許可するサブネット」（既定はその顧客の全サブネット。後から追加したものも含む）
「來源時區」：與設備確認後勾選；租約時間依它換算，不用 jt-ipam 主機的時區"Source time zone", confirmed against the device; lease times are converted from it, never from the jt-ipam host's time zone「ソースのタイムゾーン」を機器と確認して設定します。リース時刻はこれで換算し、jt-ipam ホストのタイムゾーンは使いません

限制與注意Limits and notes制限と注意

Beta：已在客戶的實機上讀到完整租約；IPv6 租約還沒有實機驗證Beta: full lease reads are verified on a customer unit; IPv6 leases are not yet verified on a real deviceBeta：お客様の実機でリース全件の読み取りを確認済み。IPv6 のリースは実機での検証がまだです
GET 登入會把帳密放在網址查詢字串，設備或反向代理可能記進存取紀錄；jt-ipam 自己的紀錄一律遮蔽GET login puts the credentials in the URL query, which the device or a reverse proxy may log; jt-ipam masks it in its own logsGET ログインでは資格情報が URL のクエリに入り、機器やリバースプロキシのアクセスログに残る可能性があります。jt-ipam 自身のログでは常に伏せます
登入失敗後排程自動暫停，避免一再送錯帳密；修改設定或測試成功後解除After a login failure the schedule pauses so wrong credentials are not sent again and again; editing the settings or a successful test releases itログインに失敗するとスケジュールを一時停止し、誤った資格情報を繰り返し送らないようにします。設定の変更かテストの成功で解除されます
IPv6 租約只保留為觀察，尚待驗證IPv6 leases are kept as observations only, pending verificationIPv6 のリースは観測としてのみ保持し、検証待ちです
租約不更新 IP 的「最後看到」時間，不算上線證據Leases do not update an IP's last-seen time and are not liveness evidenceリースでは IP の最終確認時刻を更新せず、死活の根拠にもしません

設定位置：管理 > 外部系統整合 > ISOinsightWhere: Admin > External integrations > ISOinsight設定場所：管理 > 外部システム連携 > ISOinsight

監控Monitoring監視

LibreNMS

唯讀Read only読み取りのみREST API

從 LibreNMS 的 REST API 讀取裝置、連接埠、ARP、交換器 MAC 表（FDB）、VLAN 與 LLDP / CDP 鄰居，讓監控系統早就在輪詢的資料直接補進 IP 紀錄、裝置與拓樸。jt-ipam 只送 GET 請求。Reads devices, ports, ARP, switch MAC tables (FDB), VLANs and LLDP / CDP neighbours from the LibreNMS REST API, so what your NMS already polls fills in IP records, devices and the topology. jt-ipam only sends GET requests.LibreNMS の REST API から機器、ポート、ARP、スイッチの MAC テーブル（FDB）、VLAN、LLDP / CDP ネイバーを読み、監視システムがすでに収集しているデータで IP レコード、機器、トポロジーを補います。jt-ipam が送るのは GET リクエストだけです。

取得的資料What it reads取得するデータ

裝置：主機名稱、sysName、作業系統、硬體、狀態、主 IPDevices: host name, sysName, OS, hardware, status, primary IP機器：ホスト名、sysName、OS、ハードウェア、状態、主 IP
每台裝置的連接埠與介面位址Ports and interface addresses of each device各機器のポートとインターフェースのアドレス
全站 ARP 表（IP 對 MAC）The site-wide ARP table (IP to MAC)全体の ARP テーブル（IP と MAC の対応）
交換器 MAC 表（FDB）與 VLANSwitch MAC tables (FDB) and VLANsスイッチの MAC テーブル（FDB）と VLAN
LLDP / CDP 鄰居連線LLDP / CDP neighbour linksLLDP / CDP のネイバー接続

管理效益Management benefit管理上の効果

裝置對應或建立成 jt-ipam 裝置並推斷類型；連接埠跟著 LibreNMS，可直接用於接線與 Cable TraceDevices are linked to or created as jt-ipam devices with an inferred type; their ports follow LibreNMS, ready for cabling and Cable Trace機器を jt-ipam の機器に対応付け、または作成し、種類を推定します。ポートは LibreNMS に追従し、配線や Cable Trace にそのまま使えます
ARP 補上既有 IP 的 MAC；FDB 找出每個 IP 接在哪台交換器的哪個埠，並畫進拓樸圖ARP fills in MACs of existing IP records; FDB finds the switch port behind each IP and feeds the topologyARP で既存 IP の MAC を補い、FDB で各 IP がどのスイッチのどのポートにつながるかを求め、トポロジーに反映します
裝置上下線納入 IP 的上線狀態判定，多 LAN 路由器的閘道介面位址也算Device up / down counts toward each IP's live status, including gateway interface addresses of multi-LAN routers機器の稼働状態を IP の死活判定に使います。複数 LAN を持つルーターのゲートウェイのアドレスも対象です
VLAN 寫進你指定的 VLAN 網域，並記錄哪些交換器承載它VLANs go into the VLAN domain you choose, with which switches carry themVLAN を指定した VLAN ドメインに書き込み、どのスイッチが運んでいるかも記録します
LLDP / CDP 鄰居由對端宣告，交換器之間的連線在拓樸上畫得準，補上 FDB 推論最弱的地方LLDP / CDP neighbours are declared by the far end, so switch-to-switch links come out right where FDB inference is weakestLLDP / CDP ネイバーは相手側が申告する情報なので、FDB からの推定が最も弱いスイッチ間の接続も正しく描けます

需要準備What to prepare準備するもの

jt-ipam 伺服器連得到 LibreNMS 的 API 網址，以及 LibreNMS 產生的 API tokenThe LibreNMS API URL reachable from the jt-ipam server, and an API token generated in LibreNMSjt-ipam サーバーから LibreNMS の API URL に接続できることと、LibreNMS で発行した API トークン
第一次同步前決定：「自動加入新裝置」與「自動建立裝置主 IP」預設開啟，「依 ARP 表自動建立 IP」預設關閉Decide before the first sync: "Auto-add new devices" and "Auto-create device primary IPs" are on by default, "Create IPs from the ARP table" is off初回の同期の前に決めておきます：「新しい機器を自動的に追加する」と「機器の主 IP を自動作成する」は既定で有効、「ARP テーブルから IP を作成する」は既定で無効です
重疊網段時設定「限定子網路範圍」"Limit to subnets" for overlapping ranges重複するネットワークでは「対象サブネットを限定」を設定します
要有鄰居連線，設備須開啟 LLDP / CDP，且 LibreNMS 的 xdp discovery 有執行For neighbour links, LLDP / CDP enabled on the devices and LibreNMS xdp discovery runningネイバー接続には、機器で LLDP / CDP を有効にし、LibreNMS の xdp discovery が動いている必要があります
LibreNMS 用自簽憑證或以 IP 連線時，關閉「驗證 TLS 憑證」Turn off "Verify TLS certificate" for a self-signed certificate or when connecting by IP自己署名証明書の場合や IP で接続する場合は「TLS 証明書を検証する」をオフにします

限制與注意Limits and notes制限と注意

LibreNMS 的 ARP 沒有時間欄位：預設只拿來補 MAC，不當上線證據LibreNMS ARP has no timestamps: by default it fills in MACs but is not liveness evidenceLibreNMS の ARP には時刻が無いため、既定では MAC の補完だけに使い、死活の根拠にはしません
停用輪詢的裝置仍列出，但不提供任何資料（不命名 IP、不提供 ARP、FDB、連接埠、VLAN、鄰居）Devices with polling disabled stay listed but supply nothing (no IP names, ARP, FDB, ports, VLANs or neighbours)ポーリングを無効にした機器は一覧に残りますが、何も提供しません（IP の名前、ARP、FDB、ポート、VLAN、ネイバー）
裝置主 IP 只建在既有子網路裡，重疊網段無法判定時略過Device primary IPs are only created inside existing subnets; ambiguous overlaps are skipped機器の主 IP は既存のサブネット内にだけ作成し、重複で判断できない場合は見送ります
開啟「依 ARP 表自動建立 IP」後，私接設備不再出現在「未授權 IP」；預設還要 24 小時內有 MAC 表紀錄，每輪最多 500 筆With "Create IPs from the ARP table" on, unauthorised devices no longer show under unauthorised IPs; by default a MAC table sighting within 24 hours is also required, at most 500 per round「ARP テーブルから IP を作成する」を有効にすると、無断接続の機器が「未許可 IP」に出なくなります。既定では 24 時間以内の MAC テーブルでの確認も必要で、1 回あたり最大 500 件です

設定位置：管理 > 外部系統整合 > LibreNMSWhere: Admin > External integrations > LibreNMS設定場所：管理 > 外部システム連携 > LibreNMS

Zabbix

唯讀Read only読み取りのみJSON-RPC API

監控面的唯讀補充：主機與 IP 的對應、可用性、維護狀態，以及監控涵蓋落差（IPAM 知道、Zabbix 卻沒在監控的位址）。不改動 Zabbix 的任何東西。A read-only complement on the monitoring side: host to IP mapping, availability, maintenance, and a monitoring coverage gap (addresses IPAM knows that Zabbix does not monitor). Nothing in Zabbix is changed.監視側を補う読み取り専用の連携です：ホストと IP の対応、可用性、メンテナンス状態、監視の抜け（IPAM は把握しているが Zabbix が監視していないアドレス）。Zabbix 側は一切変更しません。

取得的資料What it reads取得するデータ

主機：名稱、是否監控、介面位址與 DNS 名稱Hosts: name, monitored or not, interface address and DNS nameホスト：名前、監視中かどうか、インターフェースのアドレスと DNS 名
可用性（up / down / unknown）Availability (up / down / unknown)可用性（up / down / unknown）
維護狀態與維護類型Maintenance status and typeメンテナンスの状態と種類
主機群組、標籤與部分資產欄位（MAC、作業系統、位置、序號）Host groups, tags and some inventory fields (MAC, OS, location, serial number)ホストグループ、タグ、一部のインベントリ項目（MAC、OS、場所、シリアル番号）

管理效益Management benefit管理上の効果

既有 IP 取得 Zabbix 主機名稱，作為主機名稱來源之一Existing IP records get the Zabbix host name as one of the host name sources既存の IP に Zabbix のホスト名が入り、ホスト名のソースの 1 つになります
Zabbix 回報 up 才算上線證據；down 與 unknown 不會被當成「看到過」Only "up" from Zabbix counts as liveness evidence; down and unknown never count as seenZabbix の up だけを死活の根拠にし、down と unknown を「確認済み」とはみなしません
監控涵蓋落差：列出有主機名稱、卻沒被這套 Zabbix 監控的位址Coverage gap: lists addresses with a known host name that this Zabbix does not monitor監視の抜け：ホスト名がわかっているのに、この Zabbix で監視されていないアドレスを一覧します
維護中且不收資料的主機，可用性停在進維護前，不拿來判定上線For hosts in maintenance without data collection, the frozen availability is not used for livenessデータを収集しないメンテナンス中のホストは、可用性が直前の値で止まっているため死活判定に使いません

需要準備What to prepare準備するもの

jt-ipam 伺服器連得到 Zabbix 前端網址（自動補上 /api_jsonrpc.php）The Zabbix frontend URL reachable from the jt-ipam server (/api_jsonrpc.php is appended automatically)jt-ipam サーバーから Zabbix フロントエンドの URL に接続できること（/api_jsonrpc.php は自動で付加）
API token（Zabbix 5.4 以上），舊版用帳號密碼An API token (Zabbix 5.4 or newer), or user name and password on older versionsAPI トークン（Zabbix 5.4 以降）、古いバージョンではユーザー名とパスワード
專用帳號，對要涵蓋的主機群組有讀取權限（Zabbix 只回帳號讀得到的主機）A dedicated account with read permission on the host groups to cover (Zabbix only returns hosts the account may read)対象のホストグループに読み取り権限を持つ専用アカウント（Zabbix はアカウントが読めるホストだけを返します）
重疊網段時設定「限定子網路範圍」，落差清單也只算範圍內"Limit to subnets" for overlapping networks; the gap list then covers only that scope重複するネットワークでは「対象サブネットを限定」を設定します。抜けの一覧もその範囲だけになります

限制與注意Limits and notes制限と注意

不提供 ARP / FDB：那不在 Zabbix 的內建資料裡，請用 LibreNMS 或 SNMP 收集No ARP / FDB: they are not part of Zabbix's built-in data; use LibreNMS or SNMP collectionARP / FDB はありません。Zabbix の標準データに含まれないため、LibreNMS か SNMP 収集を使ってください
不新建 IP，只對應既有紀錄，而且要唯一命中Never creates IP records; it only matches existing ones, and only on a unique matchIP は作成せず、既存のレコードに一意に一致した場合だけ対応付けます
每台主機只取一個介面位址One interface address per host is used1 ホストにつき使うインターフェースのアドレスは 1 つです
不監控（停用）的主機只列出，不命名 IP、不算上線證據Unmonitored (disabled) hosts are listed only; they do not name IPs or count as liveness監視していない（無効な）ホストは一覧に出るだけで、IP の名前付けや死活の根拠には使いません

設定位置：管理 > 外部系統整合 > ZabbixWhere: Admin > External integrations > Zabbix設定場所：管理 > 外部システム連携 > Zabbix

SNMP 收集SNMP collectionSNMP 収集

唯讀Read only読み取りのみSNMP v2c / v3掃描代理Scan agentスキャンエージェント

給沒有 LibreNMS 的網路用：由掃描代理以唯讀 SNMP 讀取你指派的網路設備，包括路由器 ARP 表、交換器 MAC 表、LLDP / CDP 鄰居與介面。代理只送解析好的資料列，比對與寫入全在伺服器端。For networks without LibreNMS: scan agents read the network devices you assign over read-only SNMP, covering router ARP tables, switch MAC tables, LLDP / CDP neighbours and interfaces. The agent sends only parsed rows; the server does all matching and writing.LibreNMS の無いネットワーク向けです。スキャンエージェントが割り当てたネットワーク機器を読み取り専用の SNMP で読み、ルーターの ARP テーブル、スイッチの MAC テーブル、LLDP / CDP ネイバー、インターフェースを取得します。エージェントは解析済みの行だけを送り、照合と書き込みはすべてサーバー側で行います。

取得的資料What it reads取得するデータ

路由器與三層交換器的 ARP 表（預設每 5 分鐘）ARP tables of routers and layer-3 switches (every 5 minutes by default)ルーターと L3 スイッチの ARP テーブル（既定 5 分ごと）
交換器 MAC 表：Q-BRIDGE / BRIDGE-MIB，Cisco 逐 VLAN（預設每 15 分鐘）Switch MAC tables: Q-BRIDGE / BRIDGE-MIB, Cisco per VLAN (every 15 minutes by default)スイッチの MAC テーブル：Q-BRIDGE / BRIDGE-MIB、Cisco は VLAN ごと（既定 15 分ごと）
LLDP 與 CDP 鄰居（預設每 60 分鐘）LLDP and CDP neighbours (every 60 minutes by default)LLDP と CDP のネイバー（既定 60 分ごと）
介面與介面位址（預設每 60 分鐘）Interfaces and their addresses (every 60 minutes by default)インターフェースとそのアドレス（既定 60 分ごと）

管理效益Management benefit管理上の効果

補上路由器後方子網路的 MAC（掃描代理跨三層看不到 MAC）MACs for subnets behind a router, which a scan agent cannot see across layer 3ルーターの向こうのサブネットの MAC を補います（スキャンエージェントは L3 を越えて MAC を見られません）
沒有 LibreNMS 也有 IP 所在的交換器埠、MAC 歷程與拓樸連線Switch ports of IPs, MAC history and topology links, even without LibreNMSLibreNMS が無くても、IP がつながるスイッチのポート、MAC 履歴、トポロジーの接続が得られます
介面成為裝置的連接埠；運作中介面的位址、設備標為可達的 ARP 項目都算上線證據Interfaces become device ports; addresses on interfaces that are up, and ARP entries the device marks reachable, count as livenessインターフェースが機器のポートになります。稼働中のインターフェースのアドレスと、機器が到達可能とした ARP エントリは死活の根拠になります
community 與 SNMPv3 憑證集中在「憑證」頁籤管理，存檔後不再顯示，API 也不回傳Communities and SNMPv3 credentials are kept centrally in the Credentials tab, never shown again after saving and never returned by the APIcommunity と SNMPv3 の資格情報は「認証情報」タブでまとめて管理し、保存後は再表示せず、API からも返しません

需要準備What to prepare準備するもの

掃描代理 1.19.0 以上，且代理主機裝有 net-snmp 用戶端工具（例如 apt install snmp）Scan agent 1.19.0 or later, with the net-snmp client tools on the agent host (for example apt install snmp)スキャンエージェント 1.19.0 以降と、エージェントのホストに net-snmp クライアントツール（例：apt install snmp）
設備允許代理的位址以 SNMP（UDP 161）讀取The device accepts SNMP (UDP 161) from the agent's address機器がエージェントのアドレスからの SNMP（UDP 161）を受け付けること
SNMPv3 authPriv 帳號（建議），或 v2c communityAn SNMPv3 authPriv user (recommended) or a v2c communitySNMPv3 authPriv のユーザー（推奨）または v2c の community
收集目標是既有裝置；收集者可以選擇自動（管理位址所在子網路的代理）、指定代理或伺服器（jt-ipam 主機上的本機代理）The target is an existing device; the collector is Automatic (the agent of the management address's subnet), a specific agent, or Server (the local agent on the jt-ipam host)収集対象は既存の機器です。収集者は自動（管理アドレスのサブネットを担当するエージェント）、エージェント指定、サーバー（jt-ipam ホスト上のローカルエージェント）から選びます

限制與注意Limits and notes制限と注意

只讀：代理只用 snmpget / snmpbulkwalk 讀固定的 OID 清單Read only: the agent only runs snmpget / snmpbulkwalk on a fixed list of OIDs読み取りのみ：エージェントは決まった OID の一覧に対して snmpget / snmpbulkwalk を実行するだけです
v2c 的 community 以明文傳送；不提供 noAuthNoPrivA v2c community travels in plain text; noAuthNoPriv is not offeredv2c の community は平文で送られます。noAuthNoPriv は選べません
「依 ARP 自動建立 IP」預設關閉；位址存在於多個重疊子網路時不補 MAC"Create IPs from ARP" is off by default; no MAC is filled when the address exists in several overlapping subnets「ARP から IP を自動作成」は既定で無効です。アドレスが重複する複数のサブネットにある場合は MAC を補いません
只在完整讀到時才清掉不再出現的資料；部分失敗不刪任何東西Rows that disappear are removed only after a complete read; a partial read removes nothing消えた行を削除するのは完全に読めたときだけで、一部失敗した場合は何も削除しません
讀取間隔低於下限會自動調高，避免拖慢設備Intervals below the minimum are raised so the device is not slowed down下限より短い間隔は自動的に引き上げ、機器の負荷を抑えます

設定位置：管理 > 外部系統整合 > SNMPWhere: Admin > External integrations > SNMP設定場所：管理 > 外部システム連携 > SNMP

虛擬化Virtualization仮想化

Proxmox VE

唯讀Read only読み取りのみREST API

用 API token 從 Proxmox VE API 讀取叢集、節點、VM 與容器及其網路介面，把客體與節點的位址對應到 IP 紀錄；另外讀取 PVE 防火牆，算出每台客體實際的防護狀態。同步只送 GET。Reads clusters, nodes, VMs and containers with their network interfaces from the Proxmox VE API using an API token, and links guest and node addresses to IP records. It also reads the PVE firewall to work out each guest's effective posture. Sync only sends GET requests.API トークンで Proxmox VE API からクラスタ、ノード、VM、コンテナとそのネットワークインターフェースを読み、ゲストとノードのアドレスを IP レコードに対応付けます。PVE ファイアウォールも読み、ゲストごとの実際の防御状態を求めます。同期で送るのは GET だけです。

取得的資料What it reads取得するデータ

叢集、節點與節點網路介面（bridge、bond、NIC、VLAN）Cluster, nodes and node network interfaces (bridge, bond, NIC, VLAN)クラスタ、ノード、ノードのネットワークインターフェース（bridge、bond、NIC、VLAN）
VM（qemu）與容器（LXC）：狀態、CPU、記憶體、網卡與 MACVMs (qemu) and containers (LXC): status, CPU, memory, NICs and MACsVM（qemu）とコンテナ（LXC）：状態、CPU、メモリ、NIC と MAC
客體 IP：執行中 VM 的 guest agent、容器設定、cloud-init 的 ipconfigGuest IPs: the guest agent of running VMs, the container configuration, cloud-init ipconfigゲストの IP：稼働中 VM の guest agent、コンテナの設定、cloud-init の ipconfig
PVE 防火牆：各層開關、預設政策、規則、群組、IP setPVE firewall: switches at each level, default policies, rules, groups, IP setsPVE ファイアウォール：各階層のスイッチ、既定ポリシー、ルール、グループ、IP セット

管理效益Management benefit管理上の効果

客體與節點位址對到 IP 紀錄，依來源順序補上 MAC 與主機名稱；IP 頁面看得到是哪台 VMGuest and node addresses link to IP records with MAC and host name by your source order; the IP page shows which VM holds the addressゲストとノードのアドレスを IP レコードに対応付け、ソース順に従って MAC とホスト名を補います。IP ページでどの VM のアドレスかがわかります
沒裝 guest agent 的 VM 也能用網卡 MAC 對到 IPAM 已知的位址VMs without a guest agent are still matched by NIC MAC to addresses IPAM already knowsguest agent の無い VM も、NIC の MAC で IPAM が把握しているアドレスに対応付けます
節點網路介面成為該節點裝置的連接埠Node network interfaces become ports of the node's deviceノードのネットワークインターフェースがそのノード機器のポートになります
每台客體的防火牆實際狀態：規則未生效、預設放行、允許清單、全部封鎖Effective firewall posture per guest: rules inert, default allow, allow-list, all blockedゲストごとのファイアウォールの実際の状態：ルール無効、既定で許可、許可リスト、すべて遮断
從 IP 頁面開啟 VM 的 noVNC 或容器的 xterm 主控台Open a VM's noVNC or a container's xterm console from the IP pageIP ページから VM の noVNC やコンテナの xterm コンソールを開けます

需要準備What to prepare準備するもの

在 PVE 的「資料中心 > 權限 > API Token」建立 token，在路徑 / 指派 PVEAuditor 角色並勾選 PropagateCreate a token under Datacenter > Permissions > API Tokens and assign it the PVEAuditor role on path / with PropagatePVE の「データセンター > 権限 > API トークン」でトークンを作成し、パス / に PVEAuditor ロールを Propagate 付きで割り当てます
jt-ipam 伺服器連得到 PVE API 網址；可再填其他節點網址，主節點故障時自動換手The PVE API URL reachable from the jt-ipam server; other node URLs can be added for failoverjt-ipam サーバーから PVE API の URL に接続できること。他のノードの URL も入れておけば、障害時に切り替えます
VM 裡安裝 QEMU guest agent，才拿得到執行中的實際 IPThe QEMU guest agent inside VMs, for their live IPs稼働中の実際の IP を得るには、VM に QEMU guest agent を入れます
重疊網段時設定「限定子網路範圍」；要自動新增位址才開「信任虛擬化取得的 IP」（預設關閉）"Limit to subnets" for overlapping ranges; turn on "Trust addresses reported by virtualization" (off by default) only if addresses should be created重複するネットワークでは「対象サブネットを限定」を設定します。アドレスを自動作成したい場合だけ「仮想化から報告されたアドレスを信頼する」（既定で無効）を有効にします

限制與注意Limits and notes制限と注意

只有執行中、非範本的客體會認領 IP；範本一律不認領Only running guests that are not templates claim IP addresses; templates never doIP を受け持つのは稼働中でテンプレートではないゲストだけで、テンプレートは対象外です
IPAM 沒有的位址預設不建立；開啟信任選項後也只在落點唯一時才建Addresses IPAM lacks are not created by default; with the trust option on, only when the subnet is unambiguousIPAM に無いアドレスは既定では作成しません。信頼オプションを有効にしても、サブネットが一意に決まる場合だけです
節點與每個節點的客體清單都讀到時，才刪除已不存在的客體Deleted guests are removed only when the node list and every node's guest list were read削除されたゲストを消すのは、ノード一覧と各ノードのゲスト一覧をすべて読めたときだけです
主控台不能用 API token：要用具備該客體主控台權限（VM.Console）的 PVE 帳號登入The console cannot use the API token: it needs a PVE account with console permission (VM.Console) on that guestコンソールには API トークンを使えません。そのゲストのコンソール権限（VM.Console）を持つ PVE アカウントでログインします
防火牆狀態講的是 PVE 內部的東西向存取，不代表客體能否從外部連到The firewall posture covers east-west access inside PVE; it does not say whether a guest is reachable from outsideファイアウォールの状態は PVE 内部の東西方向のアクセスについてで、外部から到達できるかどうかを示すものではありません

設定位置：管理 > 外部系統整合 > Proxmox VEWhere: Admin > External integrations > Proxmox VE設定場所：管理 > 外部システム連携 > Proxmox VE

VMware ESXi / vCenter

唯讀Read only読み取りのみvSphere API (SOAP)Beta

經 vSphere API（/sdk 上的 SOAP）唯讀盤點單機 ESXi 或 vCenter 的 VM。jt-ipam 自己組 SOAP 呼叫，和其他整合一樣經過出站檢查，不使用會繞過檢查的 SDK。Takes a read-only inventory of the VMs on a standalone ESXi host or a vCenter over the vSphere API (SOAP at /sdk). jt-ipam builds its own SOAP calls so they pass the same outbound checks as every other integration, instead of an SDK that would bypass them.vSphere API（/sdk 上の SOAP）で単体の ESXi または vCenter の VM を読み取り専用で棚卸しします。jt-ipam は SOAP 呼び出しを自前で組み立て、他の連携と同じ送信先チェックを通します（チェックを迂回する SDK は使いません）。

取得的資料What it reads取得するデータ

VM：名稱、電源狀態、所在主機、vCPU、記憶體、是否為範本、備註VMs: name, power state, host, vCPU, memory, template flag, notesVM：名前、電源状態、所在ホスト、vCPU、メモリ、テンプレートかどうか、メモ
VMware Tools 回報的客體 IPGuest IP addresses reported by VMware ToolsVMware Tools が報告するゲストの IP
網卡：MAC、連接的網路、各網卡的 IPNICs: MAC, connected network, IPs per NICNIC：MAC、接続先ネットワーク、NIC ごとの IP

管理效益Management benefit管理上の効果

VM 出現在虛擬化清單，標出所在的 ESXi 主機；執行中 VM 的主要位址對到 IP 紀錄VMs appear in the virtualization list with their ESXi host; the main address of each running VM links to its IP recordVM が仮想化の一覧に所在 ESXi ホストとともに表示され、稼働中 VM の主なアドレスが IP レコードに対応付きます
IP 頁面、IP 變更評估、拓樸與 AI 對話都看得到某個位址屬於哪台 VMThe IP page, IP change assessment, the topology and AI chat can tell which VM holds an addressIP ページ、IP 変更の評価、トポロジー、AI チャットで、アドレスがどの VM のものかがわかります
VM 刪除後下一輪同步就從清單移除，不留過時資料Deleted VMs leave the list on the next sync, so no stale entries remain削除された VM は次の同期で一覧から消え、古い情報が残りません
可填多個位址，主要位址連不上時依序換手Several addresses can be listed; sync moves on in order when the primary is down複数のアドレスを登録でき、主アドレスに接続できないときは順に切り替えます

需要準備What to prepare準備するもの

jt-ipam 伺服器連得到 vCenter 或 ESXi 的 HTTPS（只填位址，/sdk 自動補上）HTTPS to vCenter or ESXi reachable from the jt-ipam server (enter the address only; /sdk is appended)jt-ipam サーバーから vCenter または ESXi の HTTPS に接続できること（アドレスだけを入力すれば /sdk は自動で付きます）
唯讀帳號（vSphere 內建的唯讀角色即可）A read-only account (the built-in read-only role is enough)読み取り専用アカウント（組み込みの read-only ロールで十分）
客體安裝 VMware Tools，才會回報 IPVMware Tools in the guests, so they report IPsIP を報告させるには、ゲストに VMware Tools を入れます
自簽憑證時關閉 TLS 驗證；重疊網段時設定「限定子網路範圍」Turn TLS verification off for a self-signed certificate; "Limit to subnets" for overlapping ranges自己署名証明書では TLS 検証をオフにします。重複するネットワークでは「対象サブネットを限定」を設定します

限制與注意Limits and notes制限と注意

Beta：尚未在實機驗證，欄位可能需要調整；「測試連線」會指出失敗在哪一步Beta: not yet verified against real hardware, fields may need adjusting; "Test connection" shows which step failsBeta：まだ実機で検証しておらず、項目の調整が必要な場合があります。「接続テスト」でどの段階で失敗したかがわかります
只有開機、非範本的 VM 會對應 IP；每台挑一個主要位址，IPv4 優先，不採用鏈路本地位址Only powered-on VMs that are not templates link addresses; one main address per VM, IPv4 first, never link-localIP に対応付けるのは電源オンでテンプレートではない VM だけです。VM ごとに主なアドレスを 1 つ選び、IPv4 を優先し、リンクローカルは使いません
不會補 IP 紀錄的 MAC 或主機名稱，只記錄 VM 關聯It does not fill MACs or host names on IP records; it only records the VM linkIP レコードの MAC やホスト名は補わず、VM との関連だけを記録します
IPAM 沒有的位址預設不建立（「信任虛擬化取得的 IP」預設關閉）Addresses IPAM lacks are not created by default ("Trust addresses reported by virtualization" is off)IPAM に無いアドレスは既定では作成しません（「仮想化から報告されたアドレスを信頼する」は既定で無効）

設定位置：管理 > 外部系統整合 > VMwareWhere: Admin > External integrations > VMware設定場所：管理 > 外部システム連携 > VMware

Microsoft Hyper-V / SCVMM

唯讀Read only読み取りのみWinRMPowerShellBeta

經 WinRM + PowerShell 讀取 Hyper-V 的 VM、網卡、VLAN、IP 與客體作業系統，可直連主機（容錯移轉叢集的每個節點），或經 System Center VMM 一次讀完。執行的腳本寫死在 jt-ipam 裡，只做查詢。Reads Hyper-V VMs, NICs, VLANs, IPs and guest OS over WinRM + PowerShell, either directly from the hosts (every node of a failover cluster) or through System Center VMM in one go. The scripts are fixed inside jt-ipam and only query.WinRM + PowerShell で Hyper-V の VM、NIC、VLAN、IP、ゲスト OS を読みます。ホストへの直接接続（フェールオーバークラスターの全ノード）と、System Center VMM 経由で一括取得の 2 通りがあります。実行するスクリプトは jt-ipam に固定で組み込まれ、照会だけを行います。

取得的資料What it reads取得するデータ

VM：名稱、狀態、CPU、記憶體、磁碟大小、所在主機與叢集VMs: name, state, CPU, memory, disk size, host and clusterVM：名前、状態、CPU、メモリ、ディスク容量、所在ホストとクラスタ
VM 網卡：MAC、虛擬交換器、VLAN、IPVM NICs: MAC, virtual switch, VLAN, IPsVM の NIC：MAC、仮想スイッチ、VLAN、IP
經 KVP 取得的客體資訊（FQDN、作業系統）Guest information through KVP (FQDN, OS)KVP で得るゲスト情報（FQDN、OS）
主機的實體網卡、虛擬交換器與 IPv4 位址Host physical adapters, virtual switches and IPv4 addressesホストの物理 NIC、仮想スイッチ、IPv4 アドレス

管理效益Management benefit管理上の効果

執行中 VM 的位址對到 IP 紀錄，補上 MAC 與主機名稱（有客體 FQDN 用它，否則用 VM 名稱）Addresses of running VMs link to IP records with MAC and host name (the guest FQDN when known, otherwise the VM name)稼働中 VM のアドレスを IP レコードに対応付け、MAC とホスト名を補います（ゲストの FQDN があればそれを、無ければ VM 名を使います）
沒有整合服務、回報不出 IP 的 VM，用網卡 MAC 對到 IPAM 已知的位址VMs that report no IP (no integration services) are matched by NIC MAC to addresses IPAM already knows統合サービスが無く IP を報告しない VM も、NIC の MAC で IPAM が把握しているアドレスに対応付けます
在節點之間移動的叢集 VM 以 VM GUID 去重，始終是同一台Cluster VMs that move between nodes are deduplicated by VM GUID and stay one VMノード間を移動するクラスタの VM は VM GUID で重複を除き、常に 1 台として扱います
IP 頁面與 IP 變更評估看得到位址屬於哪台 VMThe IP page and IP change assessment show which VM holds an addressIP ページと IP 変更の評価で、アドレスがどの VM のものかがわかります

需要準備What to prepare準備するもの

直連主機：網域帳號加入每台主機的「Hyper-V Administrators」與「Remote Management Users」，叢集的每個節點都要填Direct: a domain account in "Hyper-V Administrators" and "Remote Management Users" on every host, with every cluster node listed直接接続：各ホストの「Hyper-V Administrators」と「Remote Management Users」にドメインアカウントを追加し、クラスタの全ノードを入力します
經 SCVMM：在 VMM 給帳號唯讀角色（Read-Only Administrator），並加入 VMM 伺服器的「Remote Management Users」Through SCVMM: a read-only role in VMM (Read-Only Administrator) and "Remote Management Users" on the VMM serverSCVMM 経由：VMM で読み取り専用ロール（Read-Only Administrator）を付与し、VMM サーバーの「Remote Management Users」に追加します
jt-ipam 伺服器連得到 WinRM：預設 HTTP 5985（內容以 NTLM 或 Kerberos 加密），或 HTTPS 5986WinRM reachable from the jt-ipam server: HTTP 5985 by default (content encrypted with NTLM or Kerberos), or HTTPS 5986jt-ipam サーバーから WinRM に接続できること：既定は HTTP 5985（内容は NTLM か Kerberos で暗号化）、または HTTPS 5986
網域只開 Kerberos 時：帳號寫成 user@網域、主機寫 FQDN，要連得到網域控制站的 TCP 88，時間要準Kerberos-only domains: account as user@domain, hosts as FQDN, TCP 88 to the domain controllers, and correct timeKerberos のみのドメイン：アカウントは user@ドメイン、ホストは FQDN で入力し、ドメインコントローラーの TCP 88 への接続と正確な時刻が必要です

限制與注意Limits and notes制限と注意

Beta：開發時沒有在實機 Hyper-V 或 SCVMM 上驗證；欄位對不上時是空白，不會讓同步失敗Beta: not verified on real Hyper-V or SCVMM during development; fields that do not line up come back empty instead of failing the syncBeta：開発時に実機の Hyper-V や SCVMM では検証していません。項目が合わない場合は同期を失敗させず空欄になります
NTLM 不能在節點間轉連，直連模式下叢集每個節點都要列出NTLM cannot hop between nodes, so in direct mode every cluster node must be listedNTLM はノード間で転送できないため、直接接続ではクラスタの全ノードを列挙する必要があります
「Hyper-V Administrators」本身能變更 VM；jt-ipam 只執行固定的查詢腳本，請用專用帳號"Hyper-V Administrators" can change VMs; jt-ipam only runs its fixed query scripts, so use a dedicated account「Hyper-V Administrators」は VM を変更できる権限です。jt-ipam は固定の照会スクリプトしか実行しませんが、専用アカウントを使ってください
所有主機都讀成功才刪除不再出現的 VM；全部連不上時同步算失敗，不會顯示「成功、0 筆」VMs that disappear are removed only when every host was read; if no host answers, the sync fails rather than showing "success, 0"消えた VM を削除するのは全ホストを読めたときだけです。どのホストにも接続できなければ「成功、0 件」ではなく失敗とします

設定位置：管理 > 外部系統整合 > Hyper-VWhere: Admin > External integrations > Hyper-V設定場所：管理 > 外部システム連携 > Hyper-V

CubeCOS / OpenStack

唯讀Read only読み取りのみREST APIKeystone v3Beta

經 Keystone v3 認證後，從 Nova 與 Neutron 讀取 VM、port、子網路與浮動 IP；產品選 Bigstack CubeCOS 時再讀 CubeCOS 的節點清單。除了向 Keystone 取得 token 的那一個 POST，其餘全是 GET。Authenticates with Keystone v3, then reads VMs, ports, subnets and floating IPs from Nova and Neutron; with the product set to Bigstack CubeCOS it also reads the CubeCOS node list. Apart from the one POST that gets a Keystone token, every request is a GET.Keystone v3 で認証し、Nova と Neutron から VM、ポート、サブネット、Floating IP を読みます。製品に Bigstack CubeCOS を選ぶと CubeCOS のノード一覧も読みます。Keystone のトークンを取得する 1 回の POST を除き、すべて GET です。

取得的資料What it reads取得するデータ

Nova：VM 名稱、狀態、所屬專案、規格大小、所在主機（看得到時）Nova: VM name, status, project, flavor size, host (when visible)Nova：VM 名、状態、プロジェクト、フレーバーのサイズ、所在ホスト（見える場合）
Neutron：網路、子網路、port（固定 IP、MAC、綁定主機）與浮動 IPNeutron: networks, subnets, ports (fixed IPs, MAC, binding host) and floating IPsNeutron：ネットワーク、サブネット、ポート（固定 IP、MAC、バインド先ホスト）、Floating IP
專案名稱Project namesプロジェクト名
CubeCOS：節點清單（角色、管理 IP、Provider IP、Storage IP、序號）CubeCOS: node list (role, management IP, provider IP, storage IP, serial number)CubeCOS：ノード一覧（ロール、管理 IP、Provider IP、Storage IP、シリアル番号）

管理效益Management benefit管理上の効果

VM 與其網卡位址對到 IP 紀錄（MAC、主機名稱來源 openstack），虛擬化清單有所在主機與專案欄VMs and their NIC addresses link to IP records (MAC and host name source openstack), and the virtualization list shows host and projectVM とその NIC のアドレスを IP レコードに対応付け（MAC とホスト名のソースは openstack）、仮想化の一覧にはホストとプロジェクトが表示されます
IP 頁面顯示持有該位址的 Neutron port：VM、網路、專案、浮動 IPThe IP page shows the Neutron port holding the address: VM, network, project, floating IPsIP ページに、そのアドレスを持つ Neutron ポート（VM、ネットワーク、プロジェクト、Floating IP）を表示します
各專案重疊的網段不會被併進錯的子網路：CIDR 在雲端唯一、範圍內也剛好一個同 CIDR 子網路才自動對應，其餘在「子網路對應」手動指定，手動結果不會被覆寫Overlapping project networks are never merged into the wrong subnet: a Neutron subnet is mapped automatically only when its CIDR is unique in the cloud and exactly one subnet in scope has that CIDR; the rest are mapped by hand in "Subnet mapping", and manual mappings are never overwrittenプロジェクト間で重複するネットワークが誤ったサブネットに統合されることはありません。CIDR がクラウド内で一意で、範囲内に同じ CIDR のサブネットがちょうど 1 つの場合だけ自動で対応付け、それ以外は「サブネット対応」で手動指定します。手動の対応は上書きされません
只在完整同步後才刪除：清單有任何一頁失敗就不刪，port 與子網路要連續兩次完整同步都沒出現才刪Deletions only after complete syncs: any failed page means nothing is deleted, and ports and subnets must be missing from two complete syncs in a row削除は完全な同期の後だけです。一覧のどこかのページで失敗すれば削除せず、ポートとサブネットは 2 回連続で完全な同期に現れなかった場合だけ削除します
IP 變更評估知道受影響的是哪台 VM，也涵蓋 Keystone 與 CubeCOS 的連線位址IP change assessment knows which VM is affected, and also covers the Keystone and CubeCOS addressesIP 変更の評価で影響を受ける VM がわかり、Keystone と CubeCOS の接続先アドレスも対象になります

需要準備What to prepare準備するもの

jt-ipam 伺服器連得到 Keystone（通常 TCP 5000）與服務目錄裡的 Nova、Neutron 端點；端點介面可以選擇，內部 CA 時貼上 CA 憑證Keystone (usually TCP 5000) and the Nova and Neutron endpoints of the service catalog reachable from the jt-ipam server; the endpoint interface is selectable, and an internal CA certificate can be pastedjt-ipam サーバーから Keystone（通常 TCP 5000）とサービスカタログの Nova、Neutron エンドポイントに接続できること。エンドポイントのインターフェースを選べ、社内 CA の場合は CA 証明書を貼り付けます
專用的 Keystone 帳號或應用程式憑證（建議），給 reader 角色A dedicated Keystone account or application credential (recommended) with the reader rolereader ロールを持つ専用の Keystone アカウントまたはアプリケーション認証情報（推奨）
要盤點所有專案需要 admin 角色或雲端自訂 policy；否則只讀憑證所屬的專案A full inventory across projects needs the admin role or a custom policy; otherwise only the credential's own project is read全プロジェクトを棚卸しするには admin ロールかクラウド側のカスタムポリシーが必要です。無ければ認証情報自身のプロジェクトだけを読みます
CubeCOS：填 CubeCOS 網址（留空用 Keystone 主機的 https 網址）CubeCOS: the CubeCOS URL (blank uses the https URL of the Keystone host)CubeCOS：CubeCOS の URL（空欄なら Keystone ホストの https URL）
第一次同步後，到「子網路對應」頁籤處理待對應的 Neutron 子網路After the first sync, handle the pending Neutron subnets in the "Subnet mapping" tab初回の同期の後、「サブネット対応」タブで未対応の Neutron サブネットを処理します

限制與注意Limits and notes制限と注意

Beta：已在 DevStack 上驗證，尚未在正式的 OpenStack 或 CubeCOS 上長時間執行；CubeCOS 節點部分只對模擬器驗證過Beta: verified against DevStack, not yet run for long on a production OpenStack or CubeCOS; the CubeCOS node part is verified only against a simulatorBeta：DevStack で検証済みですが、本番の OpenStack や CubeCOS ではまだ長期間動かしていません。CubeCOS のノード部分はシミュレーターでのみ検証しています
只有 reader 角色時，Nova 拒絕列出所有專案（403）也不給 VM 所在主機：jt-ipam 退回只讀自己的專案，測試結果會標出來，主機欄留空不猜With only the reader role, Nova refuses the all-projects listing (403) and hides the VM host: jt-ipam falls back to its own project, the test result says so, and the host stays empty instead of guessedreader ロールだけでは Nova が全プロジェクトの一覧を拒否し（403）、VM のホストも返しません。jt-ipam は自身のプロジェクトだけを読み、テスト結果にその旨を表示し、ホストは推測せず空欄にします
CubeCOS API 沒有唯讀角色（任何 token 都能重開或排空節點）：請用權限最小的專用 Keystone 帳號The CubeCOS API has no read-only role (any token can reboot or drain nodes): use a dedicated Keystone account with the least privilegeCubeCOS API には読み取り専用ロールがありません（どのトークンでもノードの再起動や退避ができます）。権限を最小限にした専用の Keystone アカウントを使ってください
位址只透過已對應的 Neutron 子網路連到 IPAM；浮動 IP 只顯示在 port 上，不當成客體位址Addresses link to IPAM only through mapped Neutron subnets; floating IPs are shown on their port but never treated as guest addressesアドレスが IPAM に対応付くのは対応済みの Neutron サブネットを通じてだけです。Floating IP はポートに表示するだけで、ゲストのアドレスとはみなしません
IPAM 沒有的位址預設不建立（自動建立為選用，預設關閉）Addresses IPAM lacks are not created by default (auto-create is optional and off by default)IPAM に無いアドレスは既定では作成しません（自動作成は任意で、既定で無効）

設定位置：管理 > 外部系統整合 > CubeCOS / OpenStackWhere: Admin > External integrations > CubeCOS / OpenStack設定場所：管理 > 外部システム連携 > CubeCOS / OpenStack

資安與資產Security & assetsセキュリティと資産

Wazuh

唯讀Read only読み取りのみ REST API

從 Wazuh 管理端 API 讀取代理清單、作業系統與資安組態評估（SCA），對應到 jt-ipam 既有的 IP 記錄，並列出應該有代理卻沒有的主機。不會改動 Wazuh。Reads the agent list, operating systems and Security Configuration Assessment (SCA) results from the Wazuh manager API, maps them to existing IP records, and lists the hosts that should have an agent but do not. Nothing in Wazuh is changed.Wazuh マネージャー API からエージェント一覧、OS、セキュリティ構成評価（SCA）の結果を取得し、jt-ipam の既存 IP レコードに対応付けます。エージェントが入っているべきなのに入っていないホストも一覧にします。Wazuh 側は一切変更しません。

取得的資料What it reads取得するデータ

代理：名稱、IP、登記 IP、狀態、群組、代理版本、最後 keep-aliveAgents: name, IP, registered IP, status, group, agent version, last keep-aliveエージェント：名前、IP、登録 IP、状態、グループ、エージェントのバージョン、最終 keep-alive
作業系統：平台、版本與產品名稱（例如 Windows 11 Pro）Operating system: platform, version and product name (for example Windows 11 Pro)OS：プラットフォーム、バージョン、製品名（例：Windows 11 Pro）
每個代理的 SCA 政策結果：分數、通過與未通過數SCA policy results per agent: score, passed and failed checksエージェントごとの SCA ポリシー結果：スコア、合格数と不合格数

管理效益Management benefit管理上の効果

代理回報的主機名稱與作業系統成為 IP 記錄的來源，設備類型可據此自動判斷（例如工作站）Host names and operating systems reported by agents become sources for IP records, and the device type follows from them (for example Workstation)エージェントが報告するホスト名と OS が IP レコードの情報源になり、機器タイプも自動で判定されます（例：ワークステーション）
keep-alive 可列入上線判斷：沒有掃描代理、也沒接監控的主機，一樣知道在不在線Keep-alives can count toward liveness, so hosts without a scan agent or monitoring still show whether they are upkeep-alive を稼働判定に含められるため、スキャンエージェントや監視がないホストでも稼働状況がわかります
「未裝 Agent 的 IP」列出有主機名稱卻沒有上線代理的位址，可依上線狀態篩選、匯出"IPs missing Wazuh agent" lists addresses that have a host name but no active agent, filterable by online status and exportable「Wazuh エージェントが無い IP」に、ホスト名があるのに稼働中のエージェントがないアドレスを一覧表示します。稼働状態で絞り込み、エクスポートできます
裝置頁顯示 SCA 分數；對外服務清單會標出沒有 Wazuh 代理的目標The device page shows the SCA score; the exposed services list flags targets without a Wazuh agent機器ページに SCA スコアを表示し、公開サービス一覧では Wazuh エージェントのない対象を示します
IP 變更評估會列出以固定位址登記的代理：改 IP 後要重新註冊IP change assessment lists agents registered with a fixed address, which must be re-registered after renumberingIP 変更評価では固定アドレスで登録されたエージェントを示します。IP 変更後は再登録が必要です

需要準備What to prepare準備するもの

Wazuh 管理端 API 網址（預設埠 55000），jt-ipam 伺服器要能連出The Wazuh manager API URL (default port 55000), reachable outbound from the jt-ipam serverWazuh マネージャー API の URL（既定ポート 55000）。jt-ipam サーバーから接続できること
API 帳號與密碼（加密儲存）：可用 wazuh-wui 或自建帳號，建議只給讀取代理與 SCA 的權限An API user and password (stored encrypted): wazuh-wui or your own user; we suggest one that can only read agents and SCAAPI ユーザーとパスワード（暗号化して保存）。wazuh-wui か独自ユーザーを使用し、エージェントと SCA の読み取り権限だけを付与することをおすすめします
重疊網段（不同單位用同一段私有位址）時，設定「限定子網路範圍」With overlapping networks (several tenants using the same private range), set "Limit to subnets"ネットワークが重複する場合（複数の組織が同じプライベート帯域を使う場合）は「対象サブネットを限定」を設定します

限制與注意Limits and notes制限と注意

只對應既有 IP、不會建立 IP；同一個 IP 在多個子網路都有記錄時不對應Only matches existing IPs and never creates them; an IP recorded in several subnets is not matched既存の IP にのみ対応付け、IP は作成しません。同じ IP が複数のサブネットに記録されている場合は対応付けません
不讀取漏洞（CVE）資料：Wazuh 4.8 起管理端 API 已沒有漏洞端點，資料在 Wazuh Indexer，需要能讀整個 SIEM 的憑證，因此不接No vulnerability (CVE) data: since Wazuh 4.8 the manager API has no vulnerability endpoint; the data lives in the Wazuh Indexer, which needs credentials that read the whole SIEM, so it is not used脆弱性（CVE）データは取得しません。Wazuh 4.8 以降はマネージャー API に脆弱性のエンドポイントがなく、データは Wazuh Indexer にあり SIEM 全体を読める認証情報が必要になるためです
斷線超過 30 天的代理不再代表它登記的 IP；位址換給別台設備後，舊代理的資料不再採用An agent disconnected for more than 30 days no longer represents its IP; after the address moves to another device, the old agent's data is ignored30 日を超えて切断されたエージェントは、その IP を代表しなくなります。アドレスが別の機器に移った後は、古いエージェントのデータは使いません
SCA 每個代理約 12 小時查一次，每輪有數量上限，避免撞到 Wazuh API 的限流SCA is fetched about every 12 hours per agent, with a cap per run to stay under the Wazuh API rate limitSCA はエージェントごとに約 12 時間に 1 回取得し、1 回あたりの件数に上限を設けて Wazuh API のレート制限を避けます

設定位置：管理 > 外部系統整合 > WazuhWhere: Admin > External integrations > Wazuh設定場所：管理 > 外部システム連携 > Wazuh

OCS Inventory NG

唯讀Read only読み取りのみ REST API

從 OCS Inventory 拉端點與伺服器的資產盤點（主機名稱、作業系統、網卡、序號與型號），以網卡 MAC 對應到既有 IP。只用 GET 讀取，不會更動 OCS。Pulls the asset inventory of endpoints and servers from OCS Inventory (host name, operating system, network cards, serial number and model) and matches it to existing IPs by NIC MAC address. It only reads (GET) and never changes OCS.OCS Inventory から端末とサーバーの資産棚卸し（ホスト名、OS、NIC、シリアル番号と型番）を取得し、NIC の MAC アドレスで既存 IP に対応付けます。GET による読み取りのみで、OCS 側は変更しません。

取得的資料What it reads取得するデータ

電腦名稱、作業系統、代理版本與最後盤點時間Computer name, operating system, agent version and last inventory timeコンピューター名、OS、エージェントのバージョン、最終棚卸し日時
實體網卡的 MAC 與 IPMAC and IP of the physical network cards物理 NIC の MAC と IP
系統、主機板與 BIOS 的廠牌、型號、序號；CPU、記憶體模組、磁碟、顯示卡System, motherboard and BIOS vendor, model and serial; CPUs, memory modules, disks, graphics cardsシステム、マザーボード、BIOS のメーカー・型番・シリアル、CPU、メモリモジュール、ディスク、グラフィックカード
資產標籤與最新幾筆 OCS 備註Asset tag and the latest OCS notes資産タグと最新の OCS メモ

管理效益Management benefit管理上の効果

裝置頁直接看到硬體摘要、資產標籤與備註，不必再開 OCS 查The device page shows the hardware summary, asset tag and notes, without opening OCS機器ページでハードウェア概要、資産タグ、メモを確認でき、OCS を開く必要がありません
裝置的序號、型號、廠牌是空白時自動補上，不覆寫手填的值Fills in a device's serial, model and vendor when they are empty, without overwriting values typed by hand機器のシリアル、型番、メーカーが空欄のときに自動で補完し、手入力の値は上書きしません
主機名稱與作業系統成為 IP 記錄的來源之一，依名稱順序決定是否採用Host name and operating system become sources for the IP record, applied according to the host name precedenceホスト名と OS が IP レコードの情報源の 1 つになり、優先順位に従って採用されます
「未裝 Agent 的 IP」列出沒有 OCS 盤點的主機，可依上線狀態篩選"IPs without an agent" lists hosts with no OCS inventory, filterable by online status「エージェント未導入の IP」で OCS の棚卸しがないホストを一覧表示し、稼働状態で絞り込めます
電腦換了位址時，舊位址上的盤點資料在同一輪同步就清掉When a computer moves to another address, the inventory on its old address is cleared in the same syncコンピューターのアドレスが変わると、旧アドレスの棚卸しデータは同じ同期で消去されます

需要準備What to prepare準備するもの

OCS 站台網址（REST 掛在 /ocsapi），jt-ipam 伺服器要能連出The OCS site URL (the REST API lives under /ocsapi), reachable outbound from the jt-ipam serverOCS サイトの URL（REST API は /ocsapi 配下）。jt-ipam サーバーから接続できること
帳號密碼選用：OCS REST 預設無驗證，建議在 OCS 端（Apache）為 /ocsapi 加上驗證或以反向代理限制，「測試連線」會提醒Credentials are optional: the OCS REST API has no authentication by default; we suggest adding it for /ocsapi in Apache or restricting it with a reverse proxy ("Test connection" warns you)認証情報は任意です。OCS の REST API は既定で認証がないため、OCS 側（Apache）で /ocsapi に認証を設定するか、リバースプロキシで制限することをおすすめします（「接続テスト」で警告されます）
選擇 OCS 主機的時區：最後盤點時間沒有時區，選對才換算正確Pick the OCS host's time zone: the last inventory time carries no zone, so it must be set to convert correctlyOCS ホストのタイムゾーンを選択します。最終棚卸し日時にはタイムゾーンがないため、正しく換算するのに必要です
重疊網段時設定「限定子網路範圍」With overlapping networks, set "Limit to subnets"ネットワークが重複する場合は「対象サブネットを限定」を設定します

限制與注意Limits and notes制限と注意

只比對既有 IP 的 MAC，不會建立 IP；一個 MAC 對到多筆時不猜Only matches MACs of existing IPs and never creates IPs; a MAC that matches several records is not guessed既存 IP の MAC と照合するだけで IP は作成しません。1 つの MAC が複数のレコードに該当する場合は推測しません
支援 OCS 2.x 的 /ocsapi/v1：2.10 全量同步，2.11 起自動改為增量；OCS 3.x 的 API 不同，尚未支援Supports the OCS 2.x /ocsapi/v1: full sync on 2.10, incremental from 2.11 automatically; OCS 3.x has a different API and is not supported yetOCS 2.x の /ocsapi/v1 に対応します。2.10 は全件同期、2.11 以降は自動で差分同期になります。OCS 3.x は API が異なるため未対応です
虛擬網卡、全零 MAC 與 BMC 介面不拿來比對Virtual NICs, all-zero MACs and BMC interfaces are not used for matching仮想 NIC、すべてゼロの MAC、BMC インターフェースは照合に使いません
超過「盤點過期天數」的機器不算上線證據，也不覆寫裝置序號Machines past "Inventory stale after (days)" do not count as liveness evidence and do not overwrite device serials「インベントリの失効日数」を過ぎたマシンは稼働の根拠にならず、機器のシリアルも上書きしません
軟體清單目前不儲存The software list is not stored for nowソフトウェア一覧は現在保存しません

設定位置：管理 > 外部系統整合 > OCSWhere: Admin > External integrations > OCS設定場所：管理 > 外部システム連携 > OCS

RustDesk Server OSS

預設唯讀Read only by default既定は読み取りのみ專用代理Dedicated agent専用エージェント

在執行 hbbs 的 RustDesk 主機上安裝專用的「RustDesk 代理」（不是掃描代理），由它讀取已註冊的裝置與線上狀態、接收客戶端回報，再主動送回 jt-ipam。裝置對應到 IP 記錄後，可以在 IP 頁直接用 RustDesk 連線。A dedicated "RustDesk agent" (not the scan agent) runs on the host running hbbs. It reads the registered devices and their online state, receives client reports, and pushes them to jt-ipam. Once a device is mapped to an IP record, you can connect with RustDesk straight from the IP page.hbbs が動く RustDesk ホストに専用の「RustDesk エージェント」（スキャンエージェントとは別物）を導入します。登録済みデバイスとオンライン状態を読み取り、クライアントからの報告を受け取って jt-ipam に送ります。デバイスが IP レコードに対応付けられると、IP ページから直接 RustDesk で接続できます。

取得的資料What it reads取得するデータ

hbbs 資料庫（唯讀開啟）：RustDesk ID、首次註冊時間、登記 IP；加上線上狀態、hbbs 版本與公鑰The hbbs database (opened read only): RustDesk ID, first registration time, registered IP; plus online state, hbbs version and public keyhbbs データベース（読み取り専用で開く）：RustDesk ID、初回登録日時、登録 IP。加えてオンライン状態、hbbs のバージョンと公開鍵
客戶端回報（選用，TCP 21114）：主機名稱、作業系統、登入帳號，以及連線、檔案傳輸與告警稽核Client reports (optional, TCP 21114): host name, operating system, signed-in user, and connection, file transfer and alarm auditsクライアントの報告（任意、TCP 21114）：ホスト名、OS、ログインユーザー、接続・ファイル転送・アラームの監査
hbbr / hbbs 日誌中因 Key 不符被拒、通過中繼的 IP、時間與次數（不送日誌原文）From the hbbr / hbbs logs, which IPs were refused for a wrong key or passed through the relay, with time and count (not the log text)hbbr / hbbs のログから、Key 不一致で拒否された IP や中継を通った IP、その日時と回数（ログ本文は送りません）
私鑰檔絕不讀取；客戶端的 uuid 只在 RustDesk 主機上比對，不送到 jt-ipamThe private key file is never read; client uuids are only compared on the RustDesk host and never sent to jt-ipam秘密鍵ファイルは読み取りません。クライアントの uuid は RustDesk ホスト上で照合するだけで、jt-ipam には送りません

管理效益Management benefit管理上の効果

每個 RustDesk ID 對到哪個 IP、哪台電腦一目了然；對不上的會說明原因（太久沒上線、多台共用、不在管理網段等）See which IP and computer each RustDesk ID belongs to; unmapped ones say why (offline too long, shared by several IDs, outside managed networks and so on)各 RustDesk ID がどの IP、どのコンピューターかがひと目でわかります。対応付けできないものは理由を表示します（長期間オフライン、複数で共有、管理対象外のネットワークなど）
在 IP 頁直接連線：網頁內操作（另可開啟檔案傳輸），或叫出本機的 RustDesk 客戶端Connect from the IP page: in the browser (with optional file transfer) or by opening the RustDesk client installed on your computerIP ページから接続：ブラウザー内で操作（ファイル転送も有効化可能）するか、手元の RustDesk クライアントを起動します
連線、檔案傳輸與告警的稽核集中在 jt-ipam 查詢Connection, file transfer and alarm audits are searchable in one place in jt-ipam接続、ファイル転送、アラームの監査を jt-ipam でまとめて検索できます
找出 Key 設錯的客戶端（它們的網頁連線與外網連線會失敗）Finds clients with a wrong key (their browser and remote connections fail)Key の設定を誤ったクライアントを見つけます（ブラウザー接続や外部からの接続が失敗するもの）
主機名稱與作業系統成為 IP 記錄的來源；hbbs 累積的舊註冊可以從畫面清掉Host names and operating systems become sources for IP records; old registrations piling up in hbbs can be removed from the UIホスト名と OS が IP レコードの情報源になり、hbbs にたまった古い登録を画面から削除できます

需要準備What to prepare準備するもの

在 jt-ipam 新增伺服器取得代理金鑰與一行安裝指令，在執行 hbbs 的 Linux 主機上以 root 執行Add the server in jt-ipam to get its agent key and one-line install command, then run it as root on the Linux host running hbbsjt-ipam でサーバーを追加するとエージェントキーと 1 行のインストールコマンドが表示されます。hbbs が動く Linux ホストで root として実行します
RustDesk 主機要能連出到 jt-ipam 的 HTTPS（代理主動連線，jt-ipam 不必連進去讀資料）The RustDesk host must reach jt-ipam over HTTPS (the agent connects out; jt-ipam does not connect in to read data)RustDesk ホストから jt-ipam へ HTTPS で接続できること（エージェントから接続するため、データ取得のために jt-ipam から接続する必要はありません）
網頁連線要讓 jt-ipam 伺服器連得到 hbbs / hbbr（TCP 21116 / 21117，或 WebSocket 21118 / 21119），且 hbbs 要用金鑰檔啟動For browser connections, the jt-ipam server must reach hbbs / hbbr (TCP 21116 / 21117, or WebSocket 21118 / 21119), and hbbs must start with its key fileブラウザー接続には、jt-ipam サーバーから hbbs / hbbr（TCP 21116 / 21117、または WebSocket 21118 / 21119）に接続でき、hbbs が鍵ファイルを使って起動している必要があります
hbbs 工作目錄不是 /var/lib/rustdesk-server 時，安裝時指定 JT_IPAM_RUSTDESK_DIRIf the hbbs working directory is not /var/lib/rustdesk-server, set JT_IPAM_RUSTDESK_DIR when installinghbbs の作業ディレクトリが /var/lib/rustdesk-server でない場合は、インストール時に JT_IPAM_RUSTDESK_DIR を指定します

限制與注意Limits and notes制限と注意

對象是開源版 RustDesk Server（hbbs / hbbr）Built for the open source RustDesk Server (hbbs / hbbr)対象はオープンソース版 RustDesk Server（hbbs / hbbr）です
對應很保守：登記 IP 只落在一筆 IP 記錄、7 天內上線過才對應，不確定就不對應Mapping is conservative: the registered IP must match exactly one IP record and the ID must have been online within 7 days; when unsure, it is not mapped対応付けは慎重です。登録 IP が 1 件の IP レコードだけに該当し、7 日以内にオンラインだった場合のみ対応付け、不確かなら対応付けません
TCP 21114 收回報不需要登入，不可對網際網路開放；只開給內網，外部客戶端走 VPN 或限定來源 IPTCP 21114 accepts reports without sign-in, so never expose it to the internet; open it to the internal network only, and use a VPN or source IP limits for outside clientsTCP 21114 はログインなしで報告を受け付けるため、インターネットに公開しないでください。社内ネットワークのみに開放し、外部のクライアントは VPN または送信元 IP の制限で対応します
預設唯讀；「刪除舊註冊」要 jt-ipam 與 RustDesk 主機（--allow-delete）兩邊都開啟，而且只刪離線的裝置Read only by default; "Delete old registrations" needs both jt-ipam and the RustDesk host (--allow-delete) to allow it, and only offline devices are deleted既定は読み取りのみです。「古い登録を削除」は jt-ipam と RustDesk ホスト（--allow-delete）の両方で許可が必要で、削除対象はオフラインのデバイスだけです
代理會自動更新（可用 JT_IPAM_AUTO_UPDATE=0 關閉）The agent updates itself (turn it off with JT_IPAM_AUTO_UPDATE=0)エージェントは自動更新します（JT_IPAM_AUTO_UPDATE=0 で無効化できます）

設定位置：管理 > 外部系統整合 > RustDeskWhere: Admin > External integrations > RustDesk設定場所：管理 > 外部システム連携 > RustDesk

參考資料Reference data参照データ

RIPE

唯讀Read only読み取りのみ RDAP whois

向 RIPE 資料庫（歐洲、中東、中亞的網段註冊管理機構）查詢網段的登記資料，預覽確認後建立為子網路。Looks up network registration data in the RIPE database (the registry for Europe, the Middle East and Central Asia) and, after a preview, creates the networks as subnets.RIPE データベース（欧州、中東、中央アジアのアドレス登録機関）でネットワークの登録情報を照会し、プレビューで確認してからサブネットとして作成します。

取得的資料What it reads取得するデータ

線上查詢：輸入 IP 或 CIDR，透過 RDAP（rdap.db.ripe.net）查出所屬的登記網段Online lookup: enter an IP or CIDR and RDAP (rdap.db.ripe.net) returns the registered network it belongs toオンライン照会：IP または CIDR を入力すると、RDAP（rdap.db.ripe.net）で所属する登録ネットワークを調べます
網段名稱、國別、配發類型、狀態、備註與聯絡人Network name, country, allocation type, status, remarks and contactsネットワーク名、国、割り振り種別、状態、備考、連絡先
也可以貼上 whois 文字（inetnum、inet6num、route 等物件），解析出其中的網段Or paste whois output (inetnum, inet6num, route and similar objects) and the networks in it are parsedwhois の出力（inetnum、inet6num、route などのオブジェクト）を貼り付けて、含まれるネットワークを解析することもできます

管理效益Management benefit管理上の効果

對外網段不必手抄：登記範圍直接建成子網路，說明欄帶入網段名稱No retyping of public networks: registered ranges become subnets, with the network name in the description外部向けネットワークを手で書き写す必要がありません。登録範囲をそのままサブネットにし、説明欄にネットワーク名を入れます
位址範圍自動拆成 CIDR，並放到既有的上層子網路之下Address ranges are split into CIDRs and placed under an existing parent subnetアドレス範囲は自動で CIDR に分割され、既存の上位サブネットの下に配置されます
與現有子網路重疊的會略過，重複執行不會產生重複資料Networks that overlap existing subnets are skipped, so running it again creates no duplicates既存のサブネットと重複するものはスキップするため、繰り返し実行しても重複しません
先預覽再匯入，預覽不寫入任何資料；匯入留有稽核紀錄Preview first (nothing is written); the import is recorded in the audit log先にプレビューし（何も書き込みません）、取り込みは監査ログに記録されます

需要準備What to prepare準備するもの

管理員帳號（這個選單只對管理員顯示）An admin account (the menu is shown to admins only)管理者アカウント（このメニューは管理者にのみ表示されます）
jt-ipam 伺服器能連出 HTTPS 到 rdap.db.ripe.net；只貼 whois 文字則不需要連線Outbound HTTPS from the jt-ipam server to rdap.db.ripe.net; pasting whois text needs no connectionjt-ipam サーバーから rdap.db.ripe.net への HTTPS 接続。whois テキストを貼り付けるだけなら接続は不要です
先建好要放入的區段The section the subnets go into取り込み先のセクションを先に作成しておきます

限制與注意Limits and notes制限と注意

線上查詢只能用 IP / CIDR 找網段；用 handle、公司名稱等條件查時，請自行執行 whois 後把輸出貼上The online lookup only finds networks by IP / CIDR; to search by handle or organisation name, run whois yourself and paste the outputオンライン照会は IP / CIDR からのみネットワークを検索できます。ハンドルや組織名で探す場合は、自分で whois を実行して出力を貼り付けてください
只在匯入當下讀一次，不會定期同步登記資料的變更It reads once at import time and does not keep registration changes in sync取り込み時に 1 回読むだけで、登録情報の変更は定期同期しません
子網路建在全域（不指定 VRF）Subnets are created in the global table (no VRF)サブネットはグローバル（VRF 指定なし）に作成されます

設定位置：進階 > RIPE / TWNIC 匯入Where: Advanced Modules > RIPE / TWNIC import設定場所：拡張モジュール > RIPE / TWNIC 取り込み

TWNIC

唯讀Read only読み取りのみ RDAP whois

查詢台灣網段的登記資料並建立為子網路。台灣網段的權威來源是 APNIC，TWNIC 是其下的國家級註冊管理機構（NIR），查詢會自動導向 TWNIC 的資料庫。Looks up registration data for Taiwanese networks and creates them as subnets. The authoritative source for Taiwan is APNIC, with TWNIC as its national registry (NIR); queries are forwarded to TWNIC's database automatically.台湾のネットワークの登録情報を照会し、サブネットとして作成します。台湾のアドレスの権威ある情報源は APNIC で、TWNIC はその配下の国別登録機関（NIR）です。照会は自動的に TWNIC のデータベースへ転送されます。

取得的資料What it reads取得するデータ

線上查詢：輸入 IP 或 CIDR，透過 RDAP 向 rdap.apnic.net 查詢，台灣網段自動轉到 TWNICOnline lookup: enter an IP or CIDR; RDAP queries rdap.apnic.net, which forwards Taiwanese networks to TWNICオンライン照会：IP または CIDR を入力すると RDAP で rdap.apnic.net に照会し、台湾のネットワークは自動で TWNIC に転送されます
網段名稱、國別、配發類型、狀態、備註與聯絡人Network name, country, allocation type, status, remarks and contactsネットワーク名、国、割り振り種別、状態、備考、連絡先
也可以貼上 TWNIC 的 whois 輸出，CIDR 寫法與位址範圍寫法都能解析Or paste TWNIC whois output; both CIDR and address-range notation are parsedTWNIC の whois 出力を貼り付けることもでき、CIDR 表記とアドレス範囲表記のどちらも解析できます

管理效益Management benefit管理上の効果

向 TWNIC 申請的網段直接建成子網路，說明欄帶入網段名稱，不必手抄Networks allocated by TWNIC become subnets directly, with the network name in the description, no retypingTWNIC から割り振られたネットワークをそのままサブネットにし、説明欄にネットワーク名を入れます。手で書き写す必要はありません
位址範圍自動拆成 CIDR，並放到既有的上層子網路之下Address ranges are split into CIDRs and placed under an existing parent subnetアドレス範囲は自動で CIDR に分割され、既存の上位サブネットの下に配置されます
與現有子網路重疊的會略過，重複執行不會產生重複資料Networks that overlap existing subnets are skipped, so running it again creates no duplicates既存のサブネットと重複するものはスキップするため、繰り返し実行しても重複しません
先預覽再匯入，預覽不寫入任何資料；匯入留有稽核紀錄Preview first (nothing is written); the import is recorded in the audit log先にプレビューし（何も書き込みません）、取り込みは監査ログに記録されます

需要準備What to prepare準備するもの

管理員帳號（這個選單只對管理員顯示）An admin account (the menu is shown to admins only)管理者アカウント（このメニューは管理者にのみ表示されます）
jt-ipam 伺服器能連出 HTTPS 到 rdap.apnic.net 與 twnic.rdap.apnic.net；只貼 whois 文字則不需要連線Outbound HTTPS from the jt-ipam server to rdap.apnic.net and twnic.rdap.apnic.net; pasting whois text needs no connectionjt-ipam サーバーから rdap.apnic.net と twnic.rdap.apnic.net への HTTPS 接続。whois テキストを貼り付けるだけなら接続は不要です
先建好要放入的區段The section the subnets go into取り込み先のセクションを先に作成しておきます

限制與注意Limits and notes制限と注意

防火牆要放行的是 APNIC 的 RDAP 網址；rdap.twnic.net.tw 並不存在Allow APNIC's RDAP host in your firewall; rdap.twnic.net.tw does not existファイアウォールで許可するのは APNIC の RDAP ホストです。rdap.twnic.net.tw は存在しません
線上查詢只能用 IP / CIDR 找網段；用 handle、公司名稱等條件查時，請自行執行 whois 後把輸出貼上The online lookup only finds networks by IP / CIDR; to search by handle or organisation name, run whois yourself and paste the outputオンライン照会は IP / CIDR からのみネットワークを検索できます。ハンドルや組織名で探す場合は、自分で whois を実行して出力を貼り付けてください
只在匯入當下讀一次，不會定期同步；子網路建在全域（不指定 VRF）It reads once at import time with no ongoing sync; subnets are created in the global table (no VRF)取り込み時に 1 回読むだけで定期同期はしません。サブネットはグローバル（VRF 指定なし）に作成されます

設定位置：進階 > RIPE / TWNIC 匯入Where: Advanced Modules > RIPE / TWNIC import設定場所：拡張モジュール > RIPE / TWNIC 取り込み

MaxMind GeoIP

唯讀Read only読み取りのみ mmdb

用 MaxMind 的資料庫查詢公網 IP 的國家、城市與 ASN。下載本地 mmdb 後在 jt-ipam 伺服器上離線查詢；沒有本地檔時退回 GeoLite2 web service。Looks up the country, city and ASN of public IPs with MaxMind databases. With a local mmdb downloaded, lookups run offline on the jt-ipam server; without one, they fall back to the GeoLite2 web service.MaxMind のデータベースでパブリック IP の国、都市、ASN を調べます。ローカルの mmdb をダウンロードすれば jt-ipam サーバー上でオフラインで検索し、無い場合は GeoLite2 の Web サービスにフォールバックします。

取得的資料What it reads取得するデータ

GeoLite2（免費）或 GeoIP2（付費）的 City、Country、ASN 資料庫GeoLite2 (free) or GeoIP2 (paid) City, Country and ASN databasesGeoLite2（無料）または GeoIP2（有料）の City、Country、ASN データベース
國家、城市、行政區、經緯度、時區、ASN 與組織名稱Country, city, subdivision, coordinates, time zone, ASN and organisation国、都市、地域区分、緯度経度、タイムゾーン、ASN、組織名
依設定頻率自動下載新版（每日、每週兩次、每週、每月），也可以立即更新New releases download automatically at the chosen frequency (daily, twice weekly, weekly, monthly), or on demand設定した頻度（毎日、週 2 回、毎週、毎月）で新版を自動ダウンロードし、すぐに更新することもできます

管理效益Management benefit管理上の効果

看到陌生的外部 IP 時，在工具頁馬上查出來自哪個國家、哪個 ASNWhen an unfamiliar outside IP shows up, the Tools page tells you its country and ASN right away見慣れない外部 IP が現れたとき、ツールページですぐに国と ASN を確認できます
AI 助理與 MCP 工具也能用同一份資料回答 IP 的地理位置The AI assistant and MCP tools answer location questions from the same dataAI アシスタントと MCP ツールも同じデータで IP の位置を回答します
本地資料庫查詢不必連外，速度快，查詢的 IP 也不會送出Local lookups need no outside connection, are fast, and do not send the queried IP anywhereローカルデータベースでの検索は外部接続が不要で高速、検索した IP を外部に送りません

需要準備What to prepare準備するもの

MaxMind 帳號的 Account ID 與 License Key（加密儲存）；GeoLite2 可免費註冊The Account ID and License Key of a MaxMind account (stored encrypted); GeoLite2 accounts are freeMaxMind アカウントの Account ID と License Key（暗号化して保存）。GeoLite2 は無料で登録できます
選擇資料庫版本與更新頻率：GeoLite2 每週二、週五發佈，選「每週兩次」即可Choose editions and frequency: GeoLite2 is published on Tuesdays and Fridays, so twice weekly is enoughデータベースのエディションと更新頻度を選びます。GeoLite2 は毎週火曜と金曜に公開されるため「週 2 回」で十分です
jt-ipam 伺服器能連出 HTTPS 到 download.maxmind.com（web service 用 geolite.info）Outbound HTTPS from the jt-ipam server to download.maxmind.com (geolite.info for the web service)jt-ipam サーバーから download.maxmind.com（Web サービスは geolite.info）への HTTPS 接続

限制與注意Limits and notes制限と注意

只用在查詢（工具頁、AI 助理），不會自動標註 IP 清單或子網路Used for lookups only (Tools page, AI assistant); it does not tag IP lists or subnets検索（ツールページ、AI アシスタント）にのみ使い、IP 一覧やサブネットには自動で付与しません
沒有本地資料庫時，每次查詢都會把 IP 送到 MaxMind 的 web serviceWithout a local database, each lookup sends the IP to MaxMind's web serviceローカルデータベースが無い場合、検索のたびに IP を MaxMind の Web サービスへ送ります
部分免費帳號要先在 MaxMind 確認已訂閱 GeoLite2 ASN，否則 ASN 會下載失敗Some free accounts must enable GeoLite2 ASN at MaxMind first, or the ASN download fails一部の無料アカウントは MaxMind で GeoLite2 ASN を有効にしておかないと、ASN のダウンロードに失敗します

設定位置：管理 > 系統設定 > GeoIP（MaxMind）；查詢：工具 > GeoIP 地理位置查詢Where: Admin > System Settings > GeoIP (MaxMind); lookups: Tools > GeoIP location lookup設定場所：管理 > システム設定 > GeoIP（MaxMind）。検索：ツール > GeoIP による位置の検索

IEEE OUI

唯讀Read only読み取りのみ HTTPS

MAC 製造商資料庫：IP 清單、詳細資料頁與各處 MAC 旁自動顯示網卡廠牌。資料取自 Wireshark 依 IEEE OUI 登記整理的 manuf 檔。The MAC vendor database: the NIC vendor appears next to MAC addresses in IP lists, detail pages and elsewhere. The data comes from Wireshark's manuf file, compiled from the IEEE OUI registry.MAC ベンダーデータベース：IP 一覧や詳細ページなどで MAC アドレスの横に NIC のメーカーを自動表示します。データは Wireshark が IEEE の OUI 登録をもとにまとめた manuf ファイルです。

取得的資料What it reads取得するデータ

Wireshark 的 manuf 檔（wireshark.org，失敗時改用 GitLab 鏡像）Wireshark's manuf file (wireshark.org, with a GitLab mirror as fallback)Wireshark の manuf ファイル（wireshark.org、失敗時は GitLab のミラー）
每個前綴（MAC 前 3 個位元組）的廠牌簡稱與全名Short and full vendor name for each prefix (first 3 bytes of the MAC)プレフィックス（MAC の先頭 3 バイト）ごとのメーカーの略称と正式名
安裝後自動下載，之後每月 1 號更新一次（systemd timer），也可以手動立即更新Downloaded after install, then refreshed on the 1st of each month (systemd timer), or on demandインストール後に自動でダウンロードし、以後は毎月 1 日に更新します（systemd timer）。手動ですぐに更新することもできます

管理效益Management benefit管理上の効果

看到不認得的 MAC 就知道是哪家的網卡，追查未登記的設備更快An unfamiliar MAC shows its maker at once, which speeds up tracking down unregistered devices見慣れない MAC でもメーカーがすぐわかり、未登録機器の追跡が速くなります
MAC 歷程、IP 探測、異常偵測與調查報告都帶出廠牌MAC history, IP probe, anomaly detection and investigation reports all show the vendorMAC 履歴、IP プローブ、異常検知、調査レポートにもメーカーを表示します
設備類型判讀的線索之一：主機名稱裡的型號字要與網卡廠牌相符才採用A clue for device type: a model hint in the host name is used only when it matches the NIC vendor機器タイプ判定の手がかりの 1 つです。ホスト名に含まれる型番は NIC のメーカーと一致する場合のみ採用します
工具頁可以查單一 MAC 的製造商；AI 助理也能查The Tools page looks up the vendor of a single MAC; the AI assistant can tooツールページで個別の MAC のメーカーを調べられ、AI アシスタントも検索できます

需要準備What to prepare準備するもの

不需要帳號或金鑰No account or key neededアカウントやキーは不要です
jt-ipam 伺服器能連出 HTTPS 到 www.wireshark.org 或 gitlab.comOutbound HTTPS from the jt-ipam server to www.wireshark.org or gitlab.comjt-ipam サーバーから www.wireshark.org または gitlab.com への HTTPS 接続

限制與注意Limits and notes制限と注意

只看 24 位元前綴；MA-M（28 位元）、MA-S（36 位元）的細分區段以上層登記者顯示Only 24-bit prefixes are used; MA-M (28-bit) and MA-S (36-bit) blocks show the holder of the parent block24 ビットのプレフィックスのみを使います。MA-M（28 ビット）、MA-S（36 ビット）の細分ブロックは上位ブロックの登録者で表示されます
手機等裝置使用的隨機化 MAC 通常查不到廠牌Randomised MACs, such as those used by phones, usually have no vendorスマートフォンなどが使うランダム化 MAC は、通常メーカーがわかりません
主機無法連外時資料庫不會更新The database is not updated if the host cannot reach the internetホストが外部に接続できない場合、データベースは更新されません

設定位置：管理 > MAC 製造商 (OUI)Where: Admin > MAC Vendors (OUI)設定場所：管理 > MAC ベンダー（OUI）

Recog

唯讀Read only読み取りのみ GitHub

Rapid7 的開源指紋資料庫（BSD-2-Clause）：由服務 banner、網頁標題、伺服器標頭與憑證認出設備類型、廠牌型號與作業系統。只在 jt-ipam 伺服器上比對，不會把被掃主機的資料送到外部。Rapid7's open source fingerprint database (BSD-2-Clause): it recognises device type, make and model, and operating system from service banners, web page titles, server headers and certificates. Matching runs on the jt-ipam server only; nothing from scanned hosts is sent out.Rapid7 のオープンソースのフィンガープリントデータベース（BSD-2-Clause）です。サービスのバナー、Web ページのタイトル、サーバーヘッダー、証明書から機器タイプ、メーカーと型番、OS を識別します。照合は jt-ipam サーバー上だけで行い、スキャン対象のデータを外部に送りません。

取得的資料What it reads取得するデータ

GitHub 上 rapid7/recog 的發佈檔（recog-content-<版本>.zip），存進資料庫The rapid7/recog release file on GitHub (recog-content-<version>.zip), stored in the databaseGitHub の rapid7/recog のリリースファイル（recog-content-<バージョン>.zip）をデータベースに保存します
四千多條指紋，每條要通過自己附的範例才收Over four thousand fingerprints, each accepted only if it passes its own examples4,000 件以上のフィンガープリント。各フィンガープリントは付属の例に合格したものだけを取り込みます
安裝與升級時下載，之後每週檢查一次，有新版才下載；也可以在頁面立即檢查Downloaded at install and upgrade, then checked weekly and downloaded only when newer; you can also check now from the pageインストール時とアップグレード時にダウンロードし、以後は毎週確認して新版があるときだけダウンロードします。画面からすぐに確認することもできます

管理效益Management benefit管理上の効果

IP 探測的結果摘要更準：認得 nmap 認不出的特徵，例如 NAS 的管理頁標題、防火牆的預設憑證More accurate IP probe summaries: it recognises what nmap misses, such as a NAS admin page title or a firewall's default certificateIP プローブの結果概要がより正確になります。NAS の管理画面のタイトルやファイアウォールの既定の証明書など、nmap が識別できない特徴を認識します
掃描代理定期 OS 偵測用同一套判讀，自動填寫 IP 的作業系統、設備類型與型號The scan agent's periodic OS detection uses the same rules to fill in each IP's operating system, device type and modelスキャンエージェントの定期 OS 検出も同じ判定を使い、IP の OS、機器タイプ、型番を自動で入力します
判讀出的設備類型或 OS 家族變了，異常偵測會提示（可能是位址被別台使用或設備被換掉）When the detected device type or OS family changes, anomaly detection flags it (the address may be used by another machine, or the device was replaced)判定された機器タイプや OS ファミリーが変わると異常検知で通知します（アドレスが別のマシンに使われた、または機器が交換された可能性）

需要準備What to prepare準備するもの

jt-ipam 伺服器能連出 HTTPS 到 api.github.com 與 github.comOutbound HTTPS from the jt-ipam server to api.github.com and github.comjt-ipam サーバーから api.github.com と github.com への HTTPS 接続
離線主機：自行下載 recog-content-<版本>.zip，用安裝腳本的 --recog-zip 或 python -m app.cli.recog update --file 匯入Offline hosts: download recog-content-<version>.zip yourself and load it with the installer's --recog-zip or python -m app.cli.recog update --fileオフラインのホスト：recog-content-<バージョン>.zip を自分でダウンロードし、インストールスクリプトの --recog-zip または python -m app.cli.recog update --file で取り込みます
定期偵測需要掃描代理，代理主機上要有 nmapPeriodic detection needs a scan agent with nmap on its host定期検出にはスキャンエージェントが必要で、エージェントのホストに nmap が入っている必要があります

限制與注意Limits and notes制限と注意

選用元件：沒有安裝時探測照常運作，只是少了這一層判斷Optional: without it, probing still works, just without this layer任意のコンポーネントです。未導入でもプローブは動作し、この判定が加わらないだけです
靠目標自己開出的服務辨識：沒有開服務或 banner 被改掉的主機認不出來It relies on what the target's services say: hosts with no open services or altered banners are not recognised対象が公開するサービスの情報に頼るため、サービスを開いていないホストやバナーを変更したホストは識別できません
可能被惡意 banner 拖慢的規則在匯入時就剔除；Recog 標明「不下結論」的條目會遵守Rules a hostile banner could slow down are dropped at import; entries Recog marks as asserting nothing are respected悪意あるバナーで処理が遅くなりうるルールは取り込み時に除外し、Recog が「何も断定しない」と示すエントリーはそのとおりに扱います

設定位置：管理 > Recog 指紋庫Where: Admin > Recog fingerprints設定場所：管理 > Recog フィンガープリント

匯入與遷移Import & migrationインポートと移行

phpIPAM

唯讀Read only読み取りのみ MySQL SSH 相容 APICompatible API互換 API

從現有 phpIPAM 的 MySQL 資料庫把資料搬進 jt-ipam，可以在平行使用期間反覆執行。另外提供 phpIPAM 風格的相容 API（/api/phpipam/），讓原本接 phpIPAM 的腳本改接 jt-ipam。Moves data from an existing phpIPAM MySQL database into jt-ipam, and can be re-run while both systems are in use. A phpIPAM-style compatible API (/api/phpipam/) lets scripts written for phpIPAM talk to jt-ipam.既存の phpIPAM の MySQL データベースからデータを jt-ipam に移行します。並行運用中に何度でも実行できます。さらに phpIPAM 形式の互換 API（/api/phpipam/）により、phpIPAM 向けに作ったスクリプトを jt-ipam に接続できます。

取得的資料What it reads取得するデータ

客戶、區段、VLAN 網域與 VLAN、VRF、子網路、IP 位址Customers, sections, VLAN domains and VLANs, VRFs, subnets, IP addresses顧客、セクション、VLAN ドメインと VLAN、VRF、サブネット、IP アドレス
地點、機櫃、裝置（含裝置類型）與 NAT 規則Locations, racks, devices (with device types) and NAT rulesロケーション、ラック、機器（機器タイプを含む）、NAT ルール
只對 phpIPAM 資料庫執行 SELECT，不會改動 phpIPAMRuns only SELECT queries against the phpIPAM database and never changes phpIPAMphpIPAM のデータベースには SELECT のみを実行し、phpIPAM 側は変更しません

管理效益Management benefit管理上の効果

區段、子網路與 IP 的結構一次搬完，不必手動重建Sections, subnets and IPs move over in one go, with no manual rebuildingセクション、サブネット、IP の構成を一度に移行でき、手作業で作り直す必要がありません
可以重複執行：以 phpIPAM 原始編號與內容雜湊比對，只動真正有變的列，切換前兩邊可以平行使用Repeatable: rows are matched by their phpIPAM ID and a content hash, so only real changes are applied and both systems can run side by side before the switch繰り返し実行できます。phpIPAM の元の ID と内容のハッシュで照合し、実際に変わった行だけを反映するため、切り替え前は両方を並行運用できます
先 dry-run 預覽每張表的新增、更新、略過、失敗數，再正式執行A dry run previews inserted, updated, skipped and failed counts per table before the real rundry-run でテーブルごとの追加、更新、スキップ、失敗の件数を確認してから本実行できます
衝突處理二選一：skip 保留 jt-ipam 已改過的資料，overwrite 以 phpIPAM 為準Two conflict modes: skip keeps what was changed in jt-ipam, overwrite takes phpIPAM's version競合時の処理は 2 種類です。skip は jt-ipam で変更したデータを残し、overwrite は phpIPAM の内容で上書きします
相容 API 讓用 phpIPAM API 寫的腳本只要換網址與權杖就能接 jt-ipamWith the compatible API, scripts written for the phpIPAM API only need a new URL and token互換 API により、phpIPAM API 向けのスクリプトは URL とトークンを変えるだけで jt-ipam に接続できます

需要準備What to prepare準備するもの

管理員帳號An admin account管理者アカウント
能讀 phpIPAM 資料庫的連線：建議走 SSH tunnel，以 Unix socket（auth_socket，免 MySQL 密碼）或 TCP（MySQL 帳密）連線A connection that can read the phpIPAM database: an SSH tunnel is recommended, using the Unix socket (auth_socket, no MySQL password) or TCP (MySQL user and password)phpIPAM のデータベースを読める接続。SSH トンネルを推奨し、Unix ソケット（auth_socket、MySQL のパスワード不要）または TCP（MySQL のユーザーとパスワード）で接続します
SSH 私鑰與主機指紋：第一次連線要確認 fingerprint 以防中間人，匯入後可以移除臨時加上的金鑰An SSH private key and the host fingerprint: confirm the fingerprint on first connect to prevent man-in-the-middle attacks, and remove the temporary key afterwardsSSH 秘密鍵とホストのフィンガープリント。初回接続時にフィンガープリントを確認して中間者攻撃を防ぎ、移行後は一時的に追加した鍵を削除できます
相容 API：在右上角帳號選單的「API 權杖」建立權杖，以 token 標頭呼叫 /api/phpipam/<app_id>/Compatible API: create a token under "API tokens" in the account menu (top right) and send it in the token header to /api/phpipam/<app_id>/互換 API：右上のアカウントメニューの「API トークン」でトークンを作成し、token ヘッダーに入れて /api/phpipam/<app_id>/ を呼び出します

限制與注意Limits and notes制限と注意

使用者、群組權限與自訂欄位不會搬過來Users, group permissions and custom fields are not migratedユーザー、グループ権限、カスタムフィールドは移行されません
不會自動排程同步，每次都要手動執行；正式執行在背景作業中進行There is no scheduled sync; each run is started by hand, and the real run executes as a background job自動の定期同期はなく、毎回手動で実行します。本実行はバックグラウンドジョブとして動きます
相容 API 目前只涵蓋 user、sections、subnets、addresses；VLAN、VRF、裝置等尚未提供The compatible API covers user, sections, subnets and addresses only; VLANs, VRFs, devices and others are not available yet互換 API が対応するのは現在 user、sections、subnets、addresses のみで、VLAN、VRF、機器などは未提供です
部分外掛會用到的端點（例如 addresses 的 search_mac、POST first_free）尚未支援，接 Proxmox VE SDN 等整合前請先確認Some endpoints that plugins use (such as addresses search_mac and POST first_free) are not supported yet; check before connecting integrations such as Proxmox VE SDNプラグインが使う一部のエンドポイント（addresses の search_mac、POST first_free など）は未対応です。Proxmox VE SDN などと接続する前に確認してください
權限與 jt-ipam 的 REST API 相同；唯讀權杖不能用會改資料的方法Permissions are the same as jt-ipam's REST API; read-only tokens cannot use methods that change data権限は jt-ipam の REST API と同じで、読み取り専用トークンではデータを変更するメソッドを使えません

設定位置：管理 > phpIPAM 匯入；相容 API 權杖：右上角帳號選單 > API 權杖Where: Admin > phpIPAM Migration; compatible API tokens: account menu (top right) > API tokens設定場所：管理 > phpIPAM 移行。互換 API のトークン：右上のアカウントメニュー > API トークン

CSV

CSV Excel (.xlsx)

兩種檔案匯入：把 IP 清單匯入某個子網路（CSV），以及匯入裝置清單（CSV 或 Excel）。兩者都可以先預覽，確認後才寫入。Two file imports: an IP list into one subnet (CSV), and a device list (CSV or Excel). Both can be previewed before anything is written.2 種類のファイル取り込みがあります。IP 一覧を特定のサブネットに取り込む（CSV）ものと、機器一覧を取り込む（CSV または Excel）ものです。どちらも書き込む前にプレビューできます。

取得的資料What it reads取得するデータ

IP 清單：表頭必須有 ip；選用欄位 hostname、mac、state、description、owner、switch_port、noteIP list: the header must include ip; optional columns hostname, mac, state, description, owner, switch_port, noteIP 一覧：ヘッダーに ip が必須。任意の列は hostname、mac、state、description、owner、switch_port、note
裝置清單（CSV 或 .xlsx 第一張工作表）：名稱（必填）、FQDN、IP、類型、製造商、型號、序號、地點、機櫃、U 位、佔用 U 數、安裝方向、單位、說明Device list (CSV or the first sheet of an .xlsx): name (required), FQDN, IP, type, vendor, model, serial, location, rack, U position, U size, mounting side, unit, description機器一覧（CSV または .xlsx の最初のシート）：名前（必須）、FQDN、IP、タイプ、メーカー、型番、シリアル、ロケーション、ラック、U 位置、占有 U 数、取り付け面、単位、説明
欄位看表頭、順序不重要；容忍 UTF-8 BOM，自動判斷分隔符號Columns are read by header in any order; UTF-8 BOM is tolerated and the delimiter is detected列はヘッダーで判断し順序は問いません。UTF-8 の BOM を許容し、区切り文字は自動判定します
裝置清單匯出的中、英、日表頭都認得，匯出改完可以直接匯回Device list exports are recognised in Chinese, English or Japanese headers, so an edited export can be imported back as is機器一覧のエクスポートは中国語、英語、日本語のどのヘッダーでも認識するため、編集したエクスポートをそのまま取り込めます

管理效益Management benefit管理上の効果

從試算表搬到 jt-ipam 不必逐筆輸入Move from spreadsheets to jt-ipam without typing records one by oneスプレッドシートから jt-ipam へ 1 件ずつ入力せずに移行できます
可以重複匯入：子網路內已存在的 IP 會略過；已存在的裝置（名稱相同）可以選擇略過，或只更新有填的欄位Safe to re-import: IPs already in the subnet are skipped; existing devices (same name) can be skipped or updated with only the filled-in columns繰り返し取り込めます。サブネット内に既にある IP はスキップし、既存の機器（同じ名前）はスキップするか、入力された列だけを更新するかを選べます
裝置匯入的預覽跑完整驗證（例如機櫃 U 位重疊），預覽說可以的實際匯入就可以The device preview runs the full validation (such as overlapping rack units), so what the preview accepts will import機器のプレビューは完全な検証（ラックの U 位置の重複など）を行うため、プレビューで問題がなければ実際の取り込みも成功します
逐列回報錯誤，不因一列錯誤整批失敗；正式匯入在背景作業中進行並留稽核紀錄Errors are reported per row and one bad row does not fail the batch; the real import runs as a background job and is auditedエラーは行ごとに報告し、1 行のエラーで全体が失敗することはありません。本番の取り込みはバックグラウンドジョブで実行され、監査ログに記録されます

需要準備What to prepare準備するもの

IP 匯入：先建立子網路，並具備該子網路的寫入權限IP import: create the subnet first and have write permission on itIP の取り込み：先にサブネットを作成し、そのサブネットへの書き込み権限が必要です
裝置匯入：管理員帳號；可以先下載空白範本，或含現有裝置的範本Device import: an admin account; download a blank template or one with the existing devices機器の取り込み：管理者アカウント。空のテンプレート、または既存の機器入りのテンプレートをダウンロードできます
地點、機櫃、單位要先建好（以名稱對應）Locations, racks and units must exist first (matched by name)ロケーション、ラック、単位は先に作成しておきます（名前で対応付け）
檔案用 UTF-8 編碼，大小上限 16 MB；裝置一次最多 5000 列Files must be UTF-8, up to 16 MB; up to 5,000 device rows per importファイルは UTF-8、上限 16 MB。機器は 1 回あたり最大 5,000 行です

限制與注意Limits and notes制限と注意

IP 匯入一次只進一個子網路，不在該子網路範圍內的列會報錯An IP import goes into one subnet; rows outside that subnet are reported as errorsIP の取り込み先は 1 回につき 1 つのサブネットで、範囲外の行はエラーになります
裝置的 IP 只對應 jt-ipam 已有的位址，不會新建，也不會搶走已屬於別台裝置的 IPDevice IPs only link to addresses already in jt-ipam; none are created, and IPs that belong to another device are not taken over機器の IP は jt-ipam に既にあるアドレスにだけ対応付け、新規作成はせず、別の機器に属する IP を奪うこともありません
有錯誤的裝置列整列不寫，不會只寫一半；同名機櫃在不同地點時要寫明地點A device row with errors is not written at all (never half-written); when rack names repeat across locations, give the locationエラーのある機器の行は一切書き込まず、途中まで書くことはありません。同名のラックが複数のロケーションにある場合はロケーションを明記します
子網路、VLAN 沒有 CSV 匯入：外部網段用 RIPE / TWNIC 匯入，整套搬家用 phpIPAM 匯入There is no CSV import for subnets or VLANs: use the RIPE / TWNIC import for registered networks and the phpIPAM migration for a full moveサブネットと VLAN の CSV 取り込みはありません。登録ネットワークは RIPE / TWNIC 取り込み、全体の移行は phpIPAM 移行を使います

設定位置：子網路 > 選擇子網路 > 匯入 CSV；裝置 > 匯入Where: Subnets > pick a subnet > Import CSV; Devices > Import設定場所：サブネット > サブネットを選択 > CSV を取り込む。機器 > インポート

提供給其他系統Feeding other systems他システムへの提供

Graylog (Lookup Table)

唯讀Read only読み取りのみ HTTP (DSV)

jt-ipam 提供以權杖保護的 DSV 對照表網址，Graylog 用「DSV File from HTTP」資料配接器定期抓取，把記錄裡只有 IP、規則編號或 VMID 的欄位查成看得懂的名稱。jt-ipam serves token-protected DSV lookup URLs. Graylog fetches them with a "DSV File from HTTP" data adapter and turns bare IPs, rule IDs or VMIDs in your logs into readable names.jt-ipam はトークンで保護された DSV 対照表の URL を提供します。Graylog は「DSV File from HTTP」データアダプターで定期的に取得し、ログ中の IP、ルール番号、VMID を読める名前に置き換えます。

提供的資料What it provides提供するデータ

IP → 主機名稱 / FQDN（只含有主機名稱的位址，CSV 或 TSV）IP → hostname / FQDN (only addresses that have a hostname, CSV or TSV)IP → ホスト名 / FQDN（ホスト名のあるアドレスのみ、CSV または TSV）
OPNsense：規則 label → 引用的別名，以及別名 → 成員OPNsense: rule label → aliases it uses, and alias → membersOPNsense：ルールの label → 参照するエイリアス、エイリアス → メンバー
pfSense：規則追蹤 ID → 規則說明，以及別名 → 成員pfSense: rule tracker ID → rule description, and alias → memberspfSense：ルールのトラッカー ID → ルール説明、エイリアス → メンバー
Proxmox VE：VMID → VM 名稱（全部叢集或單一叢集）Proxmox VE: VMID → VM name (all clusters or one cluster)Proxmox VE：VMID → VM 名（全クラスターまたは単一クラスター）

管理效益Management benefit管理上の効果

防火牆、交換器的記錄直接看到主機名稱，不必再拿 IP 回 IPAM 查Firewall and switch logs show hostnames, so nobody has to look IPs up in the IPAM by handファイアウォールやスイッチのログにホスト名が出るので、IP を IPAM で手作業で調べる必要がありません
filterlog 只有規則編號時，也能知道命中的是哪個別名When filterlog only carries a rule number, you still see which alias it hitfilterlog にルール番号しかなくても、どのエイリアスに一致したか分かります
IPAM 改了主機名稱，Graylog 下次抓取就跟上，不用另外維護對照檔Hostname changes in the IPAM reach Graylog on its next fetch; no separate mapping file to maintainIPAM でホスト名を変えると Graylog の次回取得で反映され、別の対照ファイルを保守する必要がありません

需要準備What to prepare準備するもの

在 jt-ipam 啟用端點並產生權杖（所有 DSV 共用一把，預設 365 天到期）Turn the endpoint on in jt-ipam and generate the token (one token for all DSV URLs, 365 days by default)jt-ipam でエンドポイントを有効にしてトークンを生成（全 DSV で共通、既定 365 日で期限切れ）
Graylog 要能連到 jt-ipam 的 HTTPS；建議在「允許的來源」填 Graylog 的網段Graylog must reach jt-ipam over HTTPS; set "allowed sources" to the Graylog networkGraylog から jt-ipam の HTTPS に到達できること。「許可する送信元」に Graylog のネットワークを指定することを推奨
Graylog 端建立 Data Adapter、Cache、Lookup Table，再用 Extractor 或 Pipeline 套用（設定頁附逐步教學）In Graylog, create a data adapter, cache and lookup table, then apply it with an extractor or pipeline (the settings page walks you through it)Graylog 側で Data Adapter、Cache、Lookup Table を作成し、Extractor か Pipeline で適用（設定画面に手順あり）
防火牆查表要在該台 OPNsense / pfSense 的設定勾選「提供防火牆 DSV」For the firewall tables, tick "expose firewall DSV" on that OPNsense / pfSense entryファイアウォールの表は、その OPNsense / pfSense の設定で DSV 提供を有効にします

限制與注意Limits and notes制限と注意

權杖放在網址上；明文 HTTP（專用埠 8088）預設不服務，要明確打開，僅限信任內網The token sits in the URL; plain HTTP (dedicated port 8088) is off until you turn it on, and is for trusted LANs onlyトークンは URL に含まれます。平文 HTTP（専用ポート 8088）は明示的に有効にするまで応答せず、信頼できる LAN 専用です
重疊網段裡的同一個 IP 只輸出一筆；含換行或分隔符號的值會略過An IP that exists in overlapping subnets is listed once; values containing line breaks or the separator are skipped重複するサブネット内の同じ IP は 1 行だけ出力。改行や区切り文字を含む値は省略
權杖外洩時按「重新產生權杖」立即失效；檢視權杖會留稽核，到期前會通知If the token leaks, regenerate it and the old one stops working at once; revealing it is audited and you are notified before it expiresトークンが漏れたら再生成すれば即時に無効化。表示操作は監査に記録され、期限前に通知されます
稽核事件轉送到 Graylog（syslog / CEF / GELF）是另一項設定，在「管理 > 系統設定」Forwarding audit events to Graylog (syslog / CEF / GELF) is a separate setting under Admin > System Settings監査イベントの Graylog 転送（syslog / CEF / GELF）は別設定で、「管理 > システム設定」にあります

設定位置：管理 > 外部系統整合 > GraylogWhere: Admin > External integrations > Graylog設定場所：管理 > 外部システム連携 > Graylog

LLM Server (Ollama / llama.cpp / OpenAI-compatible)

Ollama API OpenAI API

接上自架或外部的 LLM 伺服器後，提供 AI 對話、語意搜尋、AI 巡檢與 AI 判讀。事實一律由 jt-ipam 的確定性查詢取得，模型只負責理解問題與敘述結果。Connect a self-hosted or external LLM server to get AI chat, semantic search, AI review and AI interpretation. Facts always come from deterministic jt-ipam queries; the model only understands the question and writes up the result.自前または外部の LLM サーバーを接続すると、AI 対話、意味検索、AI 点検、AI 判読が使えます。事実は常に jt-ipam の決定的なクエリから取得し、モデルは質問の理解と結果の説明だけを担います。

提供的資料What it provides提供するデータ

AI 對話：模型呼叫 jt-ipam 工具查詢，結果依提問者的權限過濾AI chat: the model calls jt-ipam tools, and results are filtered by the asking user's permissionsAI 対話：モデルが jt-ipam のツールで照会し、結果は質問者の権限で絞り込まれます
AI 巡檢：只把你勾選的子網路的位址、主機名稱、狀態、最後出現時間等送給模型AI review: only the subnets you select are sent (addresses, hostnames, status, last seen and similar fields)AI 点検：選択したサブネットのアドレス、ホスト名、状態、最終確認時刻などだけをモデルに送ります
AI 判讀：未授權 IP、IP 調查、防火牆規則異動的證據包AI interpretation: evidence bundles for unauthorized IPs, IP investigation and firewall rule changesAI 判読：未許可 IP、IP 調査、ファイアウォールルール変更の証拠一式
語意搜尋：子網路、IP、裝置的說明文字轉成向量（pgvector）Semantic search: descriptions of subnets, IPs and devices are embedded into vectors (pgvector)意味検索：サブネット、IP、デバイスの説明文をベクトル化（pgvector）

管理效益Management benefit管理上の効果

用一句話問「某網段還有哪些空 IP」「這台在哪個交換器埠」，不必翻好幾頁Ask "which IPs are free in this subnet" or "which switch port is this on" in one sentence instead of clicking through pages「このサブネットの空き IP は」「このホストはどのスイッチポートか」を一文で聞け、何ページも探す必要がありません
AI 巡檢依排程找出可疑或有資安疑慮之處，每筆附依據，方便人工覆核AI review runs on a schedule and flags suspicious or risky spots, each with its basis so a person can check itAI 点検がスケジュールで不審点やセキュリティ上の懸念を挙げ、各項目に根拠が付くので人が確認できます
會改資料的操作在 AI 對話中先停下來等你按「確認」In AI chat, anything that changes data stops and waits for you to confirmAI 対話でデータを変更する操作は、確認ボタンを押すまで止まります

需要準備What to prepare準備するもの

一台 LLM 伺服器：Ollama，或 OpenAI 相容端點（llama.cpp、vLLM、LM Studio、LiteLLM 等）An LLM server: Ollama, or an OpenAI-compatible endpoint (llama.cpp, vLLM, LM Studio, LiteLLM and others)LLM サーバー：Ollama、または OpenAI 互換エンドポイント（llama.cpp、vLLM、LM Studio、LiteLLM など）
jt-ipam 伺服器要能連出到該伺服器；外部服務才需要 API 金鑰The jt-ipam server must reach it outbound; an API key is only needed for external servicesjt-ipam サーバーからその LLM サーバーへ接続できること。API キーは外部サービスの場合のみ必要
對話模型；要用語意搜尋時再加嵌入模型，換模型後按「檢查維度」並重建索引A chat model; add an embedding model for semantic search, then run the dimension check and rebuild the index after changing it対話モデル。意味検索には埋め込みモデルも必要で、変更後は次元チェックと索引の再構築を行います
要跑 AI 巡檢時，設定排程時間並選擇巡檢範圍（子網路）For AI review, set the schedule times and choose which subnets are in scopeAI 点検にはスケジュール時刻と対象サブネットを設定します

限制與注意Limits and notes制限と注意

選外部服務時，網段、主機名稱與拓樸會送出去；要求資料不出網請用自架伺服器With an external service, subnets, hostnames and topology leave your network; keep a self-hosted server if data must stay in-house外部サービスではサブネット、ホスト名、トポロジーが外部に送られます。データを外に出せない場合は自前のサーバーを使います
上下文長度（num_ctx）太小時資料會被截斷，對話、巡檢、判讀可各自調整If the context length (num_ctx) is too small, data gets cut off; chat, review and interpretation can each be tunedコンテキスト長（num_ctx）が小さいとデータが切り捨てられます。対話、点検、判読で個別に調整可能
AI 巡檢與 AI 判讀一律關閉思考；頁面有「思考檢查」確認模型有沒有照做AI review and interpretation always turn thinking off; a "thinking check" on the page shows whether the model obeysAI 点検と AI 判読は常に思考を無効化。画面の「思考チェック」でモデルが従っているか確認できます
AI 對話會保存歷程，管理員可在「管理 > AI 對話歷程」檢視AI chats are kept; admins can review them under Admin > AI chat historyAI 対話は履歴として保存され、管理者は「管理 > AI 対話履歴」で確認できます

設定位置：管理 > LLM / AI（巡檢結果在「管理 > AI 巡檢」）Where: Admin > LLM / AI (review results under Admin > AI review)設定場所：管理 > LLM / AI（点検結果は「管理 > AI 点検」）

MCP server

Streamable HTTP stdio

jt-ipam 內建 MCP（Model Context Protocol）伺服器，讓外部的 LLM 用戶端與自動化腳本用同一組工具查詢 IPAM，每個工具都經過同一道權限閘。jt-ipam has a built-in MCP (Model Context Protocol) server, so external LLM clients and automation can query the IPAM through the same tools, each behind the same permission gate.jt-ipam は MCP（Model Context Protocol）サーバーを内蔵し、外部の LLM クライアントや自動化スクリプトが同じツール群で IPAM を照会できます。各ツールは同じ権限チェックを通ります。

提供的資料What it provides提供するデータ

計算與查詢工具（CIDR、DNS、GeoIP、OUI、畫面位置），任何帳號都可用Calculation and lookup tools (CIDR, DNS, GeoIP, OUI, where things are in the UI), open to any account計算・照会ツール（CIDR、DNS、GeoIP、OUI、画面上の場所）はどのアカウントでも利用可
逐物件資料（IP、子網路、裝置），依呼叫者的可見範圍過濾Per-object data (IPs, subnets, devices), filtered by what the caller can seeオブジェクト単位のデータ（IP、サブネット、デバイス）は呼び出し元の可視範囲で絞り込み
全域基礎設施（VLAN、NAT、防火牆、DNS、拓樸）要管理員或萬用讀取授權Global infrastructure (VLANs, NAT, firewalls, DNS, topology) needs admin or global read全体インフラ（VLAN、NAT、ファイアウォール、DNS、トポロジー）は管理者または全体読み取り権限が必要
管理資料（AI 巡檢、異常、代理、憑證等）只給管理員；會異動資料的工具要管理員且憑證不是唯讀Admin data (AI review, anomalies, agents, certificates and more) is admin only; tools that change data need admin and a non-read-only credential管理データ（AI 点検、異常、エージェント、証明書など）は管理者のみ。変更系ツールは管理者かつ読み取り専用でない資格情報が必要

管理效益Management benefit管理上の効果

Claude Desktop、opencode、mcpo 等用戶端直接查 IPAM，不必另寫 API 串接Clients such as Claude Desktop, opencode and mcpo query the IPAM directly, with no custom API glueClaude Desktop、opencode、mcpo などのクライアントが直接 IPAM を照会でき、API 連携を自作する必要がありません
權限與網頁、REST 一致：看不到的資料在 MCP 上也問不到Permissions match the web UI and REST: data you cannot see there cannot be asked for here either権限は画面や REST と同じで、見えないデータは MCP でも取得できません
設定頁一鍵產生用戶端設定，金鑰自動帶入The settings page generates client configs in one click, with the key filled in設定画面でクライアント設定をワンクリック生成、キーも自動で入ります

需要準備What to prepare準備するもの

在設定頁打開「提供 MCP 給外部系統」（預設關閉，沒打開時所有 HTTP MCP 請求都回 403）Turn on external MCP in the settings (off by default; until then every HTTP MCP request gets 403)設定画面で外部向け MCP を有効化（既定は無効で、無効の間は HTTP の MCP 要求はすべて 403）
憑證二擇一：唯讀的對外 MCP 金鑰（jtmcp_，30 至 365 天），或 API 權杖（jt_）One credential: the read-only external MCP key (jtmcp_, 30 to 365 days) or an API token (jt_)資格情報はどちらか：読み取り専用の外部 MCP キー（jtmcp_、30〜365 日）または API トークン（jt_）
用戶端選 HTTP / Streamable 傳輸（不要選 SSE），端點為 /api/mcpPick the HTTP / Streamable transport in the client (not SSE); the endpoint is /api/mcpクライアントは HTTP / Streamable を選択（SSE は不可）、エンドポイントは /api/mcp

限制與注意Limits and notes制限と注意

走 MCP 的異動不經確認、呼叫即生效（事後寫入稽核）；給外部代理請用唯讀憑證Changes made over MCP take effect immediately with no confirm step (they are audited); give external agents a read-only credentialMCP 経由の変更は確認なしで即時に反映（監査には記録）。外部エージェントには読み取り専用の資格情報を渡します
對外 MCP 金鑰以最後產生它的管理員身分執行，該帳號停用即失效；到期前 14、7、1 天通知The external key runs as the admin who last rotated it and dies if that account is disabled; you are notified 14, 7 and 1 day before expiry外部 MCP キーは最後に再生成した管理者として動作し、そのアカウントを無効化すると失効。期限の 14・7・1 日前に通知
stdio 模式只能在 jt-ipam 主機上執行，只收 API 權杖stdio mode runs only on the jt-ipam host and accepts only API tokensstdio モードは jt-ipam ホスト上でのみ動作し、API トークンのみ受け付けます
設定頁顯示金鑰最後使用的時間與來源 IP；外洩時立即重新產生The settings page shows when and from which IP the key was last used; rotate it at once if it leaks設定画面にキーの最終使用時刻と送信元 IP を表示。漏えい時はすぐ再生成します

設定位置：管理 > LLM / AI（對外提供 MCP）Where: Admin > LLM / AI (external MCP)設定場所：管理 > LLM / AI（外部向け MCP）

REST API

REST API JSON

網頁上能做的事大多有對應的 REST API。外部程式用 API 權杖呼叫，權限沿用權杖擁有者；完整說明見 API 使用手冊（docs/api.html）。Most of what the web UI does has a REST API. External programs call it with an API token that carries its owner's permissions; the API manual (docs/api.html) covers the details.画面でできることの大半に REST API があります。外部プログラムは API トークンで呼び出し、権限はトークン所有者のものを引き継ぎます。詳細は API マニュアル（docs/api.html）を参照してください。

提供的資料What it provides提供するデータ

區段、子網路、IP、裝置、VLAN、VRF 的查詢與異動Read and change sections, subnets, IPs, devices, VLANs and VRFsセクション、サブネット、IP、デバイス、VLAN、VRF の照会と変更
搜尋、IP 工具、IP 變更評估、整合與系統管理端點Search, IP tools, IP change assessment, integration and system admin endpoints検索、IP ツール、IP 変更評価、連携やシステム管理のエンドポイント
phpIPAM 相容 API（/api/phpipam/<app_id>/），舊腳本換網址與權杖即可沿用A phpIPAM-compatible API (/api/phpipam/<app_id>/) so old scripts keep working with a new URL and tokenphpIPAM 互換 API（/api/phpipam/<app_id>/）。既存スクリプトは URL とトークンの変更だけで使えます

管理效益Management benefit管理上の効果

佈署流程、CMDB、監控系統可以自動配 IP、查位址，不用人工填表Provisioning pipelines, CMDBs and monitoring can allocate and look up addresses without manual forms構築パイプライン、CMDB、監視システムが IP の払い出しや照会を自動化でき、手作業の申請が不要
唯讀權杖給報表或監控用，就算外洩也改不了資料Read-only tokens for reports or monitoring cannot change data even if leakedレポートや監視には読み取り専用トークンを使い、漏えいしてもデータは変更されません
每把權杖有到期日，到期前 14、7、1 天與當天通知擁有者Every token expires, and its owner is notified 14, 7 and 1 day before and on the dayトークンには期限があり、14・7・1 日前と当日に所有者へ通知

需要準備What to prepare準備するもの

建立權杖：名稱、有效天數（1 至 365，預設 90）、範圍（不限制或唯讀）Create a token: name, lifetime (1 to 365 days, default 90), scope (unrestricted or read only)トークン作成：名前、有効日数（1〜365、既定 90）、範囲（制限なしまたは読み取り専用）
要限制存取範圍時，另建低權限帳號並授權所需物件，再用那個帳號建立權杖To limit what a token can reach, create a low-privilege user, grant it the objects it needs, and create the token as that userアクセス範囲を絞るには、低権限ユーザーを作成して必要なオブジェクトだけ許可し、そのユーザーでトークンを作成
以 Authorization: Bearer jt_… 標頭呼叫 HTTPSCall over HTTPS with an Authorization: Bearer jt_… headerHTTPS で Authorization: Bearer jt_… ヘッダーを付けて呼び出し

限制與注意Limits and notes制限と注意

權杖明文只顯示一次（資料庫只存雜湊）；用管理員帳號建的權杖就是管理員全權The token is shown once (only a hash is stored); a token created by an admin has full admin rightsトークンの平文は一度だけ表示（DB にはハッシュのみ）。管理者が作成したトークンは管理者権限そのもの
唯讀只看 HTTP 方法，少數只查不改的 POST 端點（例如 AI 對話）唯讀權杖也用不了Read only is judged by HTTP method, so a few query-only POST endpoints (such as AI chat) are blocked for read-only tokens読み取り専用は HTTP メソッドで判定するため、照会のみの一部 POST エンドポイント（AI 対話など）も使えません
帳號停用時它的權杖全部撤銷；正式環境關閉 /docs 與 /openapi.jsonDisabling an account revokes all its tokens; production turns off /docs and /openapi.jsonアカウントを無効化するとトークンはすべて失効。本番環境では /docs と /openapi.json を無効化
CORS 只允許明確列出的 HTTPS 來源，第三方整合請走伺服器對伺服器CORS only allows explicitly listed HTTPS origins; integrate server to serverCORS は明示した HTTPS オリジンのみ許可。外部連携はサーバー間で行います

設定位置：右上角使用者選單 > API 權杖（手冊：docs/api.html）Where: User menu (top right) > API tokens (manual: docs/api.html)設定場所：右上のユーザーメニュー > API トークン（マニュアル：docs/api.html）

Email

SMTP

jt-ipam 透過你的 SMTP 伺服器寄出通知信，每個事件要不要寄 Email 在通知矩陣逐項勾選。jt-ipam sends notification email through your SMTP server; the notification matrix decides, event by event, which ones go out by email.jt-ipam は自社の SMTP サーバー経由で通知メールを送ります。どのイベントをメールで送るかは通知マトリクスで個別に選びます。

提供的資料What it provides提供するデータ

IP 申請待審核、核准、拒絕（寄給審核者或申請人）IP requests pending, approved or rejected (to approvers or the requester)IP 申請の承認待ち、承認、却下（承認者または申請者宛て）
憑證到期、飄移、推送失敗，代理失聯，整合同步失敗Certificate expiry, drift and push failures, agents going offline, integration sync failures証明書の期限、ドリフト、配布失敗、エージェントの切断、連携同期の失敗
異常偵測、防火牆規則異動、系統檢查與安全事件Anomaly detection, firewall rule changes, system checks and security events異常検知、ファイアウォールルール変更、システムチェック、セキュリティイベント
信末附「前往檢視」完整網址Each mail ends with a full link to the itemメール末尾に対象への完全な URL を記載

管理效益Management benefit管理上の効果

沒開著網頁也知道有 IP 申請要審、有憑證快到期You learn about pending IP requests and expiring certificates without keeping the web UI open画面を開いていなくても、承認待ちの IP 申請や期限が近い証明書に気付けます
逐事件決定站內通知或 Email，重要的寄信、瑣碎的留在站內Choose in-app or email per event: important ones by mail, minor ones stay in-appイベントごとにアプリ内通知かメールかを選べ、重要なものだけメールにできます

需要準備What to prepare準備するもの

SMTP 主機、埠號、加密方式（STARTTLS 或 SSL/TLS）、寄件者，帳密選用SMTP host, port, encryption (STARTTLS or SSL/TLS) and sender; username and password are optionalSMTP ホスト、ポート、暗号化方式（STARTTLS または SSL/TLS）、差出人。認証情報は任意
jt-ipam 伺服器要能連出到 SMTP 主機The jt-ipam server must reach the SMTP host outboundjt-ipam サーバーから SMTP ホストへ接続できること
收件帳號要填有效的 Email；設定頁可先寄測試信Recipient accounts need a valid email address; the page can send a test mail first受信するアカウントに有効なメールアドレスを設定。設定画面からテストメールを送れます

限制與注意Limits and notes制限と注意

系統事件寄給全部啟用中的管理員，不能指定其他收件群組System events go to all active admins; you cannot pick another recipient groupシステムイベントは有効な管理者全員に送られ、別の宛先グループは指定できません
信件內容目前以繁體中文產生Mail content is currently generated in Traditional Chineseメール本文は現在、繁体字中国語で生成されます
寄信失敗不重送、不影響主流程；「不加密」只限信任內網A failed send is not retried and does not block anything; "no encryption" is for trusted LANs only送信失敗は再送せず、処理も止めません。「暗号化なし」は信頼できる LAN 専用

設定位置：管理 > 通知發送設定Where: Admin > Notification Channels設定場所：管理 > 通知チャネル

Webhook

HTTPS POST JSON

兩種出站 Webhook：一是帶 HMAC 簽章的事件訂閱，給要驗證來源的系統；二是通知用的通用 Webhook，把通知以簡單 JSON 送到 n8n 或自寫端點。Two kinds of outbound webhook: HMAC-signed event subscriptions for systems that verify the sender, and a generic notification webhook that posts simple JSON to n8n or your own endpoint.送信 Webhook は 2 種類：送信元を検証したいシステム向けの HMAC 署名付きイベント購読と、通知を簡単な JSON で n8n や自作エンドポイントへ送る汎用 Webhook です。

提供的資料What it provides提供するデータ

事件訂閱：subnet.created、ip_request.created / fulfilled / rejected、anomaly.detected，或「*」全部Event subscriptions: subnet.created, ip_request.created / fulfilled / rejected, anomaly.detected, or "*" for allイベント購読：subnet.created、ip_request.created / fulfilled / rejected、anomaly.detected、または「*」で全部
內容為 {event, data, delivered_at}，標頭帶 X-Jt-Signature、X-Jt-Timestamp、X-Jt-EventBody is {event, data, delivered_at}, with X-Jt-Signature, X-Jt-Timestamp and X-Jt-Event headers本文は {event, data, delivered_at}、ヘッダーに X-Jt-Signature、X-Jt-Timestamp、X-Jt-Event
通用 Webhook：{app, subject, text, url, severity}，與聊天管道收到同一批通知Generic webhook: {app, subject, text, url, severity}, carrying the same notifications as the chat channels汎用 Webhook：{app, subject, text, url, severity}。チャット系チャネルと同じ通知を送ります

管理效益Management benefit管理上の効果

IP 申請通過就觸發後續自動化，例如建 DNS 記錄或開工單An approved IP request can kick off automation, such as creating a DNS record or a ticketIP 申請の承認を契機に、DNS レコード作成やチケット起票などを自動化できます
接收端用簽章確認訊息真的來自 jt-ipam、沒有被竄改The receiver uses the signature to confirm the message came from jt-ipam unaltered受信側は署名で jt-ipam からの改ざんされていない送信か確認できます
事件規則可加條件，再把符合的事件送到指定的 WebhookEvent rules can add conditions and send matching events to a chosen webhookイベントルールで条件を付け、一致したイベントを特定の Webhook に送れます

需要準備What to prepare準備するもの

一個接收 POST JSON 的 HTTPS 端點，jt-ipam 伺服器要能連得到An HTTPS endpoint that accepts POSTed JSON and that the jt-ipam server can reachPOST の JSON を受け取る HTTPS エンドポイント（jt-ipam サーバーから到達可能）
事件訂閱：建立後抄下只顯示一次的 secret，以 HMAC-SHA256 驗「時間戳.內容」Event subscriptions: copy the secret shown once at creation and verify HMAC-SHA256 over "timestamp.body"イベント購読：作成時に一度だけ表示される secret を控え、「タイムスタンプ.本文」の HMAC-SHA256 を検証
通用 Webhook：選填 Bearer token，以 Authorization 標頭帶上Generic webhook: an optional Bearer token sent in the Authorization header汎用 Webhook：任意の Bearer トークンを Authorization ヘッダーで送信

限制與注意Limits and notes制限と注意

失敗不重送；畫面記錄失敗次數與最後錯誤Failed deliveries are not retried; the page records the failure count and last error失敗しても再送しません。画面に失敗回数と最後のエラーを記録
事件訂閱的目標不可是本機、link-local 或 CGNAT 位址（SSRF 防護）Event subscription targets cannot be loopback, link-local or CGNAT addresses (SSRF protection)イベント購読の宛先にループバック、リンクローカル、CGNAT のアドレスは使えません（SSRF 対策）
可訂閱的事件目前只有上列五種；其他通知請用通用 Webhook 或聊天管道Only the five events above can be subscribed today; for other notifications use the generic webhook or a chat channel購読できるイベントは現在上記 5 種類のみ。その他の通知は汎用 Webhook かチャット系チャネルを使います

設定位置：管理 > Webhook（事件訂閱）；管理 > 通知發送設定（通用 Webhook）；管理 > 事件規則Where: Admin > Webhooks (event subscriptions); Admin > Notification Channels (generic webhook); Admin > Event rules設定場所：管理 > Webhook（イベント購読）、管理 > 通知チャネル（汎用 Webhook）、管理 > イベントルール

Telegram / Slack / Teams / Nextcloud Talk / Zulip

HTTPS Bot API

把通知推到團隊的聊天頻道：一則事件推一次，標題依嚴重度加上圖示，最後附「前往檢視」連結（Slack、Teams 是按鈕）。Push notifications to your team's chat channels: one message per event, a severity icon in the title, and a "view" link at the end (a button in Slack and Teams).通知をチームのチャットチャネルへ送ります。1 イベントにつき 1 件、タイトルに重要度のアイコン、末尾に閲覧リンク（Slack と Teams はボタン）を付けます。

提供的資料What it provides提供するデータ

通知矩陣中有開啟的管理員事件：異常、憑證、代理、整合同步、系統檢查、安全事件等Admin events enabled in the notification matrix: anomalies, certificates, agents, integration sync, system checks, security events and more通知マトリクスで有効な管理者向けイベント：異常、証明書、エージェント、連携同期、システムチェック、セキュリティイベントなど
IP 申請與 IP 變更評估的審核通知Review notices for IP requests and IP change assessmentsIP 申請と IP 変更評価の承認通知
多筆事項以條列呈現，每列可點回 jt-ipamMultiple items are listed as bullets, each linking back to jt-ipam複数の項目は箇条書きで、各行から jt-ipam に戻れます

管理效益Management benefit管理上の効果

IP 衝突、憑證到期、代理失聯在值班群組就看得到，不必等人登入IP conflicts, expiring certificates and offline agents show up in the on-call group without anyone logging inIP 競合、証明書の期限、エージェント切断が当番グループに届き、ログインを待つ必要がありません
自架 Nextcloud Talk、Zulip 可留在內網，訊息不經外部服務Self-hosted Nextcloud Talk or Zulip can stay inside your network, so messages never touch an outside service自前の Nextcloud Talk や Zulip なら社内ネットワーク内で完結し、外部サービスを経由しません
各管道獨立，可同時開多個；每個管道都能先送測試訊息Channels are independent and several can be on at once; each can send a test messageチャネルは独立しており複数同時に使えます。各チャネルでテスト送信が可能

需要準備What to prepare準備するもの

Telegram：@BotFather 建立的 bot token 與 Chat ID；Slack：Incoming Webhook 網址Telegram: a bot token from @BotFather and the chat ID; Slack: an Incoming Webhook URLTelegram：@BotFather で作成した bot トークンと Chat ID。Slack：Incoming Webhook の URL
Teams：頻道的 Workflows（或舊版連接器）Incoming Webhook 網址Teams: the channel's Workflows (or legacy connector) incoming webhook URLTeams：チャネルの Workflows（または旧コネクタ）の Incoming Webhook URL
Nextcloud Talk：網址、對話 Token、bot 密鑰（occ talk:bot:install）；Zulip：網址、bot Email、API key、頻道與主題Nextcloud Talk: URL, conversation token and bot secret (occ talk:bot:install); Zulip: URL, bot email, API key, channel and topicNextcloud Talk：URL、会話トークン、bot シークレット（occ talk:bot:install）。Zulip：URL、bot のメール、API キー、チャネルとトピック
jt-ipam 伺服器要能連出到該服務（Telegram、Slack、Teams 需要網際網路）The jt-ipam server must reach the service outbound (Telegram, Slack and Teams need internet access)jt-ipam サーバーからそのサービスへ接続できること（Telegram、Slack、Teams はインターネット接続が必要）

限制與注意Limits and notes制限と注意

只推送不收指令，不能在聊天室裡操作 jt-ipamPush only; you cannot run jt-ipam commands from the chat送信のみで、チャットから jt-ipam を操作することはできません
不能逐管道挑事件：有開的管道都收到同一批通知Events cannot be picked per channel: every enabled channel gets the same notificationsチャネルごとにイベントは選べず、有効なチャネルすべてに同じ通知が届きます
訊息內容目前以繁體中文產生；送失敗不重送、不影響主流程Message text is currently generated in Traditional Chinese; failures are not retried and do not block anythingメッセージ本文は現在、繁体字中国語で生成されます。送信失敗は再送せず、処理も止めません

設定位置：管理 > 通知發送設定Where: Admin > Notification Channels設定場所：管理 > 通知チャネル

你開啟時才寫回Writes back only when you turn it on有効にしたときだけ書き戻す

OPNsense 防火牆別名推送

會寫回Writes back書き戻しあり REST API

把 IPAM 裡某個範圍的 IP 自動寫成 OPNsense 防火牆別名（alias），規則引用這個別名，名單就跟著 IPAM 走。只有你建立方向為「push」或「both」的別名對應時才會寫入。Writes the IPs of an IPAM scope into an OPNsense firewall alias, so rules that use the alias follow the IPAM. Nothing is written unless you create an alias mapping with direction "push" or "both".IPAM の特定範囲の IP を OPNsense のファイアウォールエイリアスに書き込み、そのエイリアスを使うルールが IPAM に追従します。方向が「push」または「both」のエイリアス対応付けを作成した場合だけ書き込みます。

讀取與寫回的資料What it reads and writes読み取りと書き戻すデータ

來源範圍：一個區段、一個子網路、標籤，或自訂欄位的值Source scope: a section, a subnet, a tag, or a custom field value対象範囲：セクション、サブネット、タグ、またはカスタムフィールドの値
寫入：該範圍內的 IP（單一位址、去重排序）成為別名的全部內容，並套用設定Writes: the IPs in that scope (single addresses, de-duplicated and sorted) become the alias's entire content, then the change is applied書き込み：範囲内の IP（単一アドレス、重複除去・並べ替え済み）をエイリアスの全内容とし、設定を適用
別名不存在就新建，存在就更新；「pull」只讀回成員做紀錄、不寫入Creates the alias if missing, updates it if present; "pull" only reads the members back for reference and writes nothingエイリアスが無ければ作成、あれば更新。「pull」はメンバーを読み戻して記録するだけで書き込みません

管理效益Management benefit管理上の効果

新增或移除 IP 後，防火牆名單在下一輪同步自動更新，不必登入防火牆手改After IPs are added or removed, the firewall list updates on the next sync; no logging in to the firewall to edit itIP を追加・削除すると次回同期でファイアウォールの一覧が更新され、手作業の編集が不要
IPAM 與防火牆名單不會越走越遠，稽核時兩邊一致The IPAM and the firewall list cannot drift apart, so they agree at audit timeIPAM とファイアウォールの一覧がずれず、監査時にも一致します
每條對應可按「立即同步」，畫面顯示推送筆數與最後錯誤Each mapping has a "sync now" button and shows how many entries were pushed and the last error対応付けごとに今すぐ同期でき、送信件数と最後のエラーを表示

需要準備What to prepare準備するもの

已設定好的 OPNsense 整合（jt-ipam 伺服器能連到防火牆的 API）A working OPNsense integration (the jt-ipam server can reach the firewall API)設定済みの OPNsense 連携（jt-ipam サーバーからファイアウォールの API に到達可能）
API 金鑰所屬使用者要有編輯防火牆別名的權限（唯讀金鑰寫不進去）The API key's user needs permission to edit firewall aliases (a read-only key cannot write)API キーのユーザーにファイアウォールエイリアスの編集権限が必要（読み取り専用キーでは書き込めません）
一個專給 jt-ipam 管理的別名名稱，再讓防火牆規則引用它An alias name reserved for jt-ipam, referenced by your firewall rulesjt-ipam 専用のエイリアス名を決め、ファイアウォールルールから参照します

限制與注意Limits and notes制限と注意

推送會整份覆蓋別名內容，在 OPNsense 上手動加的項目會被換掉A push replaces the whole alias content; entries added by hand on OPNsense are overwritten送信はエイリアスの内容を丸ごと置き換え、OPNsense 上で手動追加した項目は上書きされます
範圍內的每一筆 IP 記錄都會寫入，不依狀態篩選Every IP record in the scope is written, regardless of its status範囲内の IP レコードは状態に関係なくすべて書き込まれます
在 jt-ipam 刪除對應不會刪掉 OPNsense 上的別名Deleting the mapping in jt-ipam does not delete the alias on OPNsensejt-ipam で対応付けを削除しても OPNsense 上のエイリアスは削除されません
只支援 OPNsense；pfSense、FortiGate 等的別名只讀取不寫入OPNsense only; aliases on pfSense, FortiGate and others are read, never writtenOPNsense のみ対応。pfSense や FortiGate などのエイリアスは読み取りのみ

設定位置：管理 > 外部系統整合 > OPNsense > 別名對應Where: Admin > External integrations > OPNsense > Alias mappings設定場所：管理 > 外部システム連携 > OPNsense > エイリアスの対応付け

憑證派送代理（nginx / Apache / Proxmox VE / IIS）

會寫回Writes back書き戻しあり代理agentエージェント HTTPS

在目標主機裝一支小代理，定期向 jt-ipam 詢問負責的憑證有沒有新版，有就換上、測試、重載，失敗自動還原，再回報結果。Linux 用純 bash，Windows 用 PowerShell。A small agent on the target host regularly asks jt-ipam whether its certificates have a new version; if so it installs, tests and reloads, rolls back on failure, and reports the result. Pure bash on Linux, PowerShell on Windows.対象ホストに小さなエージェントを入れ、担当する証明書に新版があるか定期的に jt-ipam へ問い合わせます。新版があれば配置、テスト、再読み込みを行い、失敗時は自動で元に戻して結果を報告します。Linux は純粋な bash、Windows は PowerShell です。

讀取與寫回的資料What it reads and writes読み取りと書き戻すデータ

代理只拿得到指派給它的憑證（憑證、中繼鏈、私鑰），每次下載都留稽核An agent only gets the certificates assigned to it (cert, chain, private key), and every download is auditedエージェントが取得できるのは割り当てられた証明書（証明書、中間チェーン、秘密鍵）のみで、毎回監査に記録
Linux：內建 nginx、Apache、HAProxy、Postfix、Dovecot、Proxmox VE / PMG / PBS / PDM、Zimbra 等設定檔，其他服務用手動模式指定路徑Linux: built-in profiles for nginx, Apache, HAProxy, Postfix, Dovecot, Proxmox VE / PMG / PBS / PDM, Zimbra and more; other services use manual mode with your own pathsLinux：nginx、Apache、HAProxy、Postfix、Dovecot、Proxmox VE / PMG / PBS / PDM、Zimbra などのプロファイルを内蔵。その他は手動モードでパスを指定
Windows：匯入 LocalMachine\My 並換上 IIS 的 HTTPS 繫結（含 SNI），或只匯入、或寫成檔案Windows: imports into LocalMachine\My and repoints the IIS HTTPS binding (SNI included), or imports only, or writes filesWindows：LocalMachine\My にインポートして IIS の HTTPS バインドを切り替え（SNI 含む）、またはインポートのみ、ファイル出力
回報套用結果、代理版本與來源 IPReports the result, agent version and source IP適用結果、エージェントのバージョン、送信元 IP を報告

管理效益Management benefit管理上の効果

換一張萬用憑證不必逐台登入，所有站台在下一次排程自動換好Renewing a wildcard certificate no longer means logging in to every host; each one switches on its next runワイルドカード証明書の更新で各ホストにログインする必要がなく、次回の実行で自動的に切り替わります
設定測試不過或換上後連線確認失敗就還原，服務不會因換憑證中斷If the config test or the post-switch check fails, it rolls back, so a certificate change does not take a service down設定テストや切り替え後の接続確認に失敗すると元に戻すため、証明書更新でサービスが止まりません
哪台還沒換到最新版（飄移）、哪台代理失聯，都會通知You are notified when a host is not on the latest version (drift) or an agent goes silent最新版に切り替わっていないホスト（ドリフト）や応答しないエージェントを通知します

需要準備What to prepare準備するもの

在 jt-ipam 建立代理、指派憑證，抄下只顯示一次的註冊金鑰Create the agent in jt-ipam, assign certificates, and copy the enrollment key shown oncejt-ipam でエージェントを作成して証明書を割り当て、一度だけ表示される登録キーを控えます
Linux：root 執行安裝程式，只需 curl，以 systemd timer 排程（預設每天）Linux: run the installer as root; only curl is needed; a systemd timer schedules it (daily by default)Linux：インストーラーを root で実行。curl のみ必要で、systemd timer で定期実行（既定は毎日）
Windows：Server 2019 以上、PowerShell 5.1、以系統管理員執行安裝程式，由工作排程器以 SYSTEM 執行，不裝額外模組Windows: Server 2019 or later with PowerShell 5.1; run the installer as Administrator; Task Scheduler runs it as SYSTEM, no extra modulesWindows：Server 2019 以降と PowerShell 5.1。インストーラーを管理者として実行し、タスクスケジューラが SYSTEM で実行。追加モジュール不要
目標主機要能以 HTTPS 連出到 jt-ipam（jt-ipam 不需要連進目標主機）The target host must reach jt-ipam outbound over HTTPS (jt-ipam never connects in to it)対象ホストから jt-ipam へ HTTPS で接続できること（jt-ipam から対象ホストへは接続しません）

限制與注意Limits and notes制限と注意

私鑰在請求當下解密送出，代理金鑰等同取得私鑰的權限，外洩時請立即輪替Private keys are decrypted on request, so an agent key is effectively access to those keys; rotate it at once if it leaks秘密鍵は要求時に復号して送るため、エージェントキーは秘密鍵へのアクセス権に等しく、漏えい時は即座にローテーション
同一把代理金鑰近期出現多個來源 IP 時，畫面會標示The page flags an agent key that recently reported from more than one source IP同じエージェントキーが最近複数の送信元 IP から報告すると画面で表示
IIS 的 HTTPS 繫結要先存在，代理只換憑證、不建立站台設定The IIS HTTPS binding must already exist; the agent swaps the certificate and does not create site configurationIIS の HTTPS バインドは事前に必要。エージェントは証明書を差し替えるだけでサイト設定は作りません
防火牆裝不了代理，請改用「憑證推送到防火牆」Firewalls cannot run the agent; use certificate push to firewalls insteadファイアウォールにはエージェントを入れられないため、「ファイアウォールへの証明書配布」を使います

設定位置：管理 > 憑證派送 > 派送代理Where: Admin > Certificates > Distribution Agents設定場所：管理 > 証明書 > 配布エージェント

憑證推送到防火牆（FortiGate / OPNsense / Palo Alto / pfSense）

會寫回Writes back書き戻しあり Beta REST API PAN-OS XML API

防火牆裝不了代理，改由 jt-ipam 透過設備的管理 API 把憑證推過去並換上，推完連過去確認對方出示的就是新憑證，確認不到就自動換回原本的。Firewalls cannot run an agent, so jt-ipam pushes the certificate through the device's management API, switches it in, connects back to confirm the device now presents the new certificate, and switches back automatically if it cannot confirm.ファイアウォールにはエージェントを入れられないため、jt-ipam が機器の管理 API で証明書を送って切り替え、接続して新しい証明書が提示されているか確認し、確認できなければ自動で元に戻します。

讀取與寫回的資料What it reads and writes読み取りと書き戻すデータ

FortiGate：匯入憑證，選擇換上管理介面、SSL VPN，或只匯入FortiGate: imports the certificate and optionally binds it to the admin GUI and SSL VPN, or imports onlyFortiGate：証明書をインポートし、管理画面と SSL VPN に割り当て、またはインポートのみ
OPNsense：直接替換一張既有憑證的內容，引用它的服務一起換，可選擇重啟網頁管理介面OPNsense: replaces the content of an existing certificate so every service using it switches too; can restart the web GUIOPNsense：既存の証明書の内容を置き換え、それを参照するサービスも一緒に切り替え。Web 管理画面の再起動も選択可
Palo Alto：匯入憑證與中繼鏈，改 SSL/TLS 服務設定檔並 commitPalo Alto: imports the certificate and chain, updates the SSL/TLS service profile and commitsPalo Alto：証明書と中間チェーンをインポートし、SSL/TLS サービスプロファイルを変更して commit
pfSense：建立憑證，選擇換成網頁管理介面的憑證pfSense: creates the certificate and optionally makes it the web GUI certificatepfSense：証明書を作成し、Web 管理画面の証明書に切り替え（任意）

管理效益Management benefit管理上の効果

防火牆管理介面與 SSL VPN 的憑證跟著 jt-ipam 的版本走，不再過期才發現Firewall admin GUI and SSL VPN certificates follow the version in jt-ipam, instead of being found expiredファイアウォールの管理画面や SSL VPN の証明書が jt-ipam の版に追従し、期限切れで気付くことがなくなります
開啟自動推送後，憑證有新版就推（設備上不是目前版本才推）With auto push on, a new certificate version is pushed automatically (only when the device is not already on it)自動配布を有効にすると、新しい版が出たときに配布（機器が現行版でない場合のみ）
每一步記錄做了什麼、在哪一步失敗；失敗會通知，每次推送都留稽核Each step is recorded with where it failed; failures notify you and every push is audited各ステップの内容と失敗箇所を記録し、失敗は通知、配布ごとに監査に記録
設備憑證選擇器：OPNsense 存檔前就能讀出設備上的憑證來選要替換哪一張；pfSense 可看哪張在用、何時到期Device certificate picker: on OPNsense, read the device's certificates before saving and pick the one to replace; on pfSense, see which is in use and when it expires機器証明書の選択：OPNsense では保存前に機器上の証明書を読み出して置き換える 1 枚を選択。pfSense では使用中の証明書と期限を確認

需要準備What to prepare準備するもの

另建一組只給換憑證用的帳號或金鑰（既有的整合帳號多半是唯讀）A separate account or key used only for certificate changes (existing integration accounts are usually read only)証明書の切り替え専用のアカウントまたはキーを別途作成（既存の連携用は多くが読み取り専用）
權限：FortiGate 要 system 與 VPN 寫入；OPNsense 要憑證管理與重啟服務；Palo Alto 要匯入憑證、改設定、commit；pfSense 要裝 REST API 套件 v2Rights: FortiGate needs system and VPN write; OPNsense needs certificate management and service restart; Palo Alto needs certificate import, config change and commit; pfSense needs the REST API package v2権限：FortiGate は system と VPN の書き込み、OPNsense は証明書管理とサービス再起動、Palo Alto は証明書インポート・設定変更・commit、pfSense は REST API パッケージ v2 が必要
jt-ipam 伺服器要能以 https:// 連到設備的管理 APIThe jt-ipam server must reach the device's management API over https://jt-ipam サーバーから機器の管理 API へ https:// で接続できること
要確認的服務不在 API 位址上時（例如 SSL VPN），填「確認位址（主機:埠）」If the service to check is not on the API address (SSL VPN, for example), fill in the verify address (host:port)確認するサービスが API のアドレスと異なる場合（SSL VPN など）は確認先（ホスト:ポート）を入力

限制與注意Limits and notes制限と注意

Beta：尚未在每一家的真機上驗證過Beta: not yet verified on real hardware from every vendorBeta：すべてのベンダーの実機ではまだ検証していません
推之前就連不到確認位址時只標「未確認」、不會換回；只匯入不換上也算未確認If the verify address was unreachable before the push, the result is "unverified" and nothing is rolled back; import-only also counts as unverified配布前から確認先に接続できない場合は「未確認」となり元に戻しません。インポートのみも未確認扱い
不支援 Check Point；設備上舊的憑證不會自動刪除Check Point is not supported; old certificates on the device are not deleted automaticallyCheck Point は非対応。機器上の古い証明書は自動削除しません
OPNsense 重啟網頁管理介面時，管理連線可能短暫中斷Restarting the OPNsense web GUI can briefly cut management sessionsOPNsense の Web 管理画面を再起動すると管理接続が一時的に切れることがあります

設定位置：管理 > 憑證派送 > 推送到設備Where: Admin > Certificates > Push to devices設定場所：管理 > 証明書 > デバイスへ配布