# 장비를 연결하세요. 장비 데이터를 유지보수 서비스로 전환하세요.

> 자동화 기술과 고객에 대한 이해는 여러분이 제공합니다. Wertek AI는 자산 모니터링, 관찰 기록, 작업지시서 관리, 정기 서비스 제공을 위한 플랫폼을 제공합니다.

통합업체를 위한 안내 · Wertek AI · https://wertek.ai/ko/integrators/

**입력:** Modbus RTU/TCP · MQTT · OPC UA · HTTP → Wertek AI → **출력 대상:** SCADA / HMI · 공정 데이터 이력 시스템

**읽기 전용: Wertek AI는 여러분의 PLC에 쓰지 않습니다.**

## 사용 중인 프로토콜로 데이터를 수신합니다. SCADA는 읽기 전용 API 키로 상태를 읽습니다.

선을 클릭하면 무엇인지, 어떻게 연결되는지, 현재 상태를 확인할 수 있습니다.

**Wertek AI:** 자산 · 상태 · 알림 · 작업지시서 · 보고서

### 입력

#### OT · 생산 현장

- **[Wertek AI 게이트웨이](https://wertek.ai/energy/gateway/)** — Modbus RTU/TCP, 17개 브랜드의 32개 장치(Eastron, Schneider, Siemens, Circutor, ABB, Janitza, Carlo Gavazzi…)와 커패시터 뱅크용 레지스터 맵 제공. 장비가 이미 이 방식으로 데이터를 보고하고 있습니다.
- **MQTT로 게시하는 장치** *(프로비저닝 포함)* — Banner DXM(무선 진동, 4G 모뎀 포함), Acrel 키트 및 전력량계. 장비가 이미 이 방식으로 데이터를 보고하고 있습니다.
- **키를 사용하는 자체 HTTP 흐름** *(Node-RED / Ignition / 게이트웨이 경유)* — Node-RED, Ignition, n8n, Python 또는 JavaScript/TypeScript. 시뮬레이션 값으로 검증한 Modbus TCP, MQTT 및 OPC UA 레시피.
- **Bently Nevada System 1의 OPC UA** *(Beta)* — 읽기 커넥터.
- **[현장에서 휴대전화로](https://wertek.ai/ko/mobile/)** — 사진을 첨부한 관찰 기록, VibeDiag 동영상, 음향 분석 및 수동 측정값(시간, 사이클, kWh…).

> S7, EtherNet/IP 및 범용 OPC UA: 자체 드라이버는 없습니다. Node-RED, Ignition 또는 게이트웨이를 통해 접근합니다.

#### IT · 업무 시스템

- **유지보수 및 ERP** — 자체 작업지시서를 가져옵니다: SAP PM (Pilot-ready), Odoo (Pilot-ready), SAP B1 (In development).
- **파일** — 적용 전에 검토하는 CSV 또는 Excel 자산, WAV, UFF58 및 CSV 신호.

### 출력

#### OT · 생산 현장

- **공장 공정 데이터 이력 시스템** — Wertek AI는 자체 측정값과 자산 건전성을 공정 데이터 이력 시스템에 공정 데이터와 나란히 기록합니다: AVEVA PI (Validated), AVEVA Data Hub (Pilot-ready).
- **읽기 키를 사용하는 SCADA, HMI 또는 Node-RED** — Ignition, Node-RED 또는 스크립트가 자산, 결과와 권장 사항을 포함한 측정값, 에너지를 읽어 공정 태그 옆에 상태를 표시합니다. 읽기 키는 Monitoring 요금제부터 생성합니다.

> Wertek AI는 PLC에 쓰지 않습니다. 사실과 상태를 게시하며, 어떤 태그를 변경할지는 여러분이 결정합니다.

#### IT · 업무 시스템

- **키를 사용하는 API** — 자산, 측정값, 신호 및 FFT, 에너지. JSON으로 내보냅니다. 읽기 키는 Monitoring 요금제부터 생성합니다.
- **다운로드** — CSV, XLSX, Parquet, WAV 및 PDF: 측정값, 관찰 기록, 작업지시서, 소비량 및 전력 계통 규정 준수 보고서.
- **알림** — 푸시와 이메일, 앱에서 실시간 제공.
- **이메일 정기 보고서** — 에너지 및 전력 계통 규정 준수, 상태, 소비 센터의 월간 요약.
- **[유지보수 및 ERP](https://wertek.ai/ko/integrations/)** — 각각 감사된 상태를 갖춘 커넥터: MaintainX (Pilot-ready), Odoo (Pilot-ready), Fracttal (Pilot-ready), SAP B1 (In development).

## 키를 사용하는 HTTP: 모든 장치를 위한 경로

1. **무료 계정 만들기.** app.wertek.ai에서 만드세요. 수집 권한만 있는 키는 모든 요금제에서 사용할 수 있습니다. [계정 만들기](https://app.wertek.ai/signup)
2. **자산을 만들고 측정점을 지정하세요.** 앱에서 자산을 등록하고 데이터를 공급할 위치를 지정하세요. 위치 코드, UCUM 단위가 있는 변수, 전송 주기를 설정합니다. 키를 사용해 지정할 수도 있습니다: POST /iaes/assets/{asset_id}/measurement-points. 지정하면 측정점 하나가 사용됩니다. 전송할 때마다 하지 말고 위치당 한 번만 하세요.
3. **수집 키 만들기.** 설정 → API 키 (Settings → API Keys)에서 수집 권한으로 만드세요. 비밀로 보관하세요. 코드나 태그가 아닌 환경 변수에 보관하세요.
4. **측정값 보내기.** 측정값마다 asset.measurement 이벤트 하나를 단독으로 또는 최대 100개 목록으로 POST https://api.wertek.ai/iaes/ingest에 보냅니다. 응답에는 이벤트마다 코드 하나가 포함됩니다. 저장된 데이터는 자산 이력의 지정된 위치 아래에 표시됩니다.

### 측정점 지정 방법

1. **Measurement points(또는 자산)에서 «Designate position»을 클릭하세요.** 지정하면 조직의 풀에서 측정점 하나가 사용됩니다. 전송할 때마다가 아니라 위치당 한 번만 지정합니다.
2. **코드, 템플릿, 전송 주기를 입력하세요.** 코드는 통합에서 전송할 `location`입니다(소문자, 공백 없음). 템플릿은 해당 계열의 변수와 UCUM 단위를 제공하며, 사용자 지정 변수를 추가할 수 있습니다. 계약된 전송 주기는 측정값을 얼마나 자주 전송할지를 초 단위로 나타냅니다.

   ![«Designate a measurement position» 대화 상자: 코드, 템플릿, 변수, 전송 주기](https://wertek.ai/assets/images/integrators/designar-dialogo-en.webp)

3. **위치가 목록에 나타나고 측정값을 받기 시작합니다.** 해당 코드와 수집 키로 보내는 모든 이벤트는 자산 이력의 해당 위치에 저장됩니다.

### 이벤트 (reading.json)

```json
{
  "spec_version": "2.0",
  "event_id": "6f1c2b7e-3d4a-4e8b-9a10-5c2d7e9f1a34",
  "correlation_id": "0b8e4c21-7f3a-4d6e-8c95-1a2b3c4d5e6f",
  "event_type": "asset.measurement",
  "timestamp": "2026-11-11T14:32:00Z",
  "source": "plant_x.plc_12",
  "dataschema": "https://iaes.dev/schema/v2/asset.measurement",
  "asset": {
    "asset_id": "PUMP-07"
  },
  "data": {
    "measurement_type": "temperature",
    "value": 23.5,
    "unit": "Cel",
    "location": "zona_1"
  }
}
```

수집 서비스가 사용하는 버전인 공개된 IAES 2.0.2 SDK로 검증되었습니다.

- `data.location` — 지정된 위치의 코드
- `data.measurement_type` — 변수의 키
- `data.unit` — 계약의 단위 (비교만 하며 변환하지 않음)
- `data.value` — 숫자. 불리언은 0 또는 1로 전송
- `timestamp` — 측정 시각, UTC 기준 — 전송 시각이 아님
- `event_id` — 측정값마다 새로 생성. 멱등성 키로 사용

### curl

```bash
curl -X POST https://api.wertek.ai/iaes/ingest \
  -H "X-API-Key: $WERTEK_API_KEY" \
  -H "Content-Type: application/json" \
  -d @reading.json
```

### Python

```python
# pip install requests          (the validator: pip install "iaes[validate]==2.0.2")
import json, os, uuid
from datetime import datetime, timezone
import requests

event = json.load(open("reading.json"))
event["event_id"] = str(uuid.uuid4())         # new for each reading
event["correlation_id"] = str(uuid.uuid4())   # one per batch
event["timestamp"] = datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ")  # when it was measured

r = requests.post(
    "https://api.wertek.ai/iaes/ingest",
    json=[event],
    headers={"X-API-Key": os.environ["WERTEK_API_KEY"]},
    timeout=30,
)
print(r.status_code, r.json())
```

### Node-RED

```bash
cd ~/.node-red
npm install node-red-contrib-iaes@2.0.2
```

구성 예제의 플로우(pump-process-to-wertek.flow.json)를 가져오세요. iaes-publish 노드는 같은 키를 사용합니다.

### 구성 예제

- **Node-RED.** 소프트웨어에서 검증된 구성 예제입니다. 인수 테스트 스크립트는 모의 값으로 API에 대해 실행됩니다. IAES 노드 2.0.2를 실제 Node-RED 5.0.6에 가져와 실행했습니다(Docker, 2026-11-12): 이벤트 5/5 유효. [구성 예제, 플로우 및 인수 테스트 스크립트](https://github.com/wertek-ai/wertek-integrations/tree/main/ot/_tools/node-red)
- **n8n.** 2026-10-05에 API에 대해 확인한 구성 예제입니다. 자동 인수 테스트 스크립트는 없습니다. IAES 노드 2.0.2를 실제 n8n 2.8.4에 가져와 실행했습니다(2026-11-12): 이벤트 5/5 유효. [구성 예제 및 워크플로](https://github.com/wertek-ai/wertek-integrations/tree/main/ot/_tools/n8n)
- **모든 HTTP 클라이언트.** 기본 구성 예제입니다. 자산의 계약을 읽고, 위치를 지정하고, 전송한 뒤 이벤트별로 응답을 읽으세요. [구성 예제 및 인수 테스트 스크립트](https://github.com/wertek-ai/wertek-integrations/tree/main/ot/iaes)

### MQTT는요?

현재 MQTT는 특정 장비용 채널을 뜻합니다 — Banner DXM, Acrel 키트 및 전력량계 — 각각 고유한 토픽과 자격 증명이 있으며 프로비저닝으로 설정됩니다. 범용 토픽은 없습니다. 다른 모든 장치의 경로는 키를 사용하는 HTTP입니다.

## 데이터가 들어올 때 데이터를 보호하는 요소와 사용자가 제어하는 항목

코드가 현재 수행하는 내용이며, 그 이상은 없습니다.

- **수집 키.** 키는 wk_로 시작하며 생성할 때 한 번만 표시됩니다. Wertek AI는 키를 식별하기 위해 SHA-256 해시와 12자 접두사만 저장합니다.
- **권한, 만료 및 폐기.** 각 키에는 권한 (telemetry.view, telemetry.export, iaes.ingest)이 있으며, 특정 자산으로 제한할 수 있고, 1일부터 365일 사이에 만료되도록 할 수 있으며, 폐기할 수 있습니다. 소유자 또는 관리자만 키를 관리합니다.
- **조직에 연결.** 이벤트는 키가 속한 조직의 자산에 대해서만 수락됩니다. 키는 다른 조직의 자산에 쓸 수 없습니다.
- **전송 중.** API는 HTTPS를 통해 제공됩니다. MQTT에는 TLS와 함께 포트 8883을 사용하세요.
- **서명된 링크를 통한 파일.** 캡처와 문서는 만료되는 HMAC-SHA256 서명 링크를 통해 전달됩니다.
- **저장된 데이터.** 당사의 제공업체 (데이터베이스용 Supabase 및 파일용 Cloudflare R2)는 저장하는 데이터를 암호화합니다.
- **제한 및 사용량.** 머신 자격 증명당 분당 최대 300개 요청 (초과 시 429) 및 배치당 100개 이벤트입니다. 텔레메트리 API는 각 키의 사용량과 마지막 사용을 기록합니다.

### 통합업체를 위한 권장 사항

- MQTT: TLS와 함께 포트 8883 사용.
- 암호화되지 않은 데이터 전송은 권장하지 않습니다. 장치가 TLS를 지원하지 않는 경우 문의하세요. 다른 보호 조치와 함께 평가할 수 있습니다.
- 사이트마다 최소 권한 (데이터 전송용 iaes.ingest)과 만료 기한을 설정한 키 하나를 사용하세요.
- 키는 환경 변수나 비밀 저장소에 보관하고 코드나 흐름에는 절대 넣지 마세요.
- 장치나 사이트가 서비스를 떠나면 키를 폐기하세요.

## 공개 소스 코드와 함께 배포된 패키지

- **Node-RED** — `npm install node-red-contrib-iaes@2.0.2`. 노드 7개: measurement, health, work-order, validate, sparkplug, publish, route. 공개 버전: 2.0.2 · [소스 코드](https://github.com/wertek-ai/iaes/tree/nodered-v2.0.2/node-red) · [npm](https://www.npmjs.com/package/node-red-contrib-iaes)
- **n8n** — `npm install n8n-nodes-iaes@2.0.2`. n8n용 커뮤니티 노드. 공개 버전: 2.0.2 · [소스 코드](https://github.com/wertek-ai/iaes/tree/n8n-v2.0.2/n8n-nodes) · [npm](https://www.npmjs.com/package/n8n-nodes-iaes)
- **JavaScript / TypeScript** — `npm install @iaes/sdk@2.0.2`. 클라이언트, 모델 및 이벤트 검증 (검증에 ajv 사용). 공개 버전: 2.0.2 · [소스 코드](https://github.com/wertek-ai/iaes/tree/sdk-v2.0.2/npm) · [npm](https://www.npmjs.com/package/@iaes/sdk)
- **Python** — `pip install "iaes[validate]==2.0.2"`. 모델 및 검증: Wertek AI 수집 서비스가 사용하는 것과 같은 검증기. 공개 버전: 2.0.2 · [소스 코드](https://github.com/wertek-ai/iaes/tree/py-v2.0.2/src/iaes) · [PyPI](https://pypi.org/project/iaes/)

**미리 보기.** Arduino Opta: iaes-opta-runtime은 IAES 1.4를 내보내며 Wertek AI 수집 서비스는 2.x를 요구합니다. 미리 보기이며 운영용이 아닙니다. [iaes-opta-runtime](https://github.com/wertek-ai/iaes-opta-runtime)

**IAES: 한 번만 구축하는 플로우.** 모든 고객에게 재사용 가능한 단일 개방형 이벤트 포맷, 그리고 고객이 Wertek AI를 통해 제공받는 기능. [인티그레이터를 위한 IAES 보기](https://wertek.ai/ko/integrators/iaes/index.md)

표준: IAES 2.0, 공개 (CC BY 4.0). [iaes.dev](https://iaes.dev/) · [DOI 10.5281/zenodo.22663498](https://doi.org/10.5281/zenodo.22663498)

## 단순한 데이터 저장 공간 그 이상

- **자산과 이력.** 모든 측정값은 지정한 위치 아래 자산 이력에 남습니다.
- **관찰 기록.** 고객 팀은 웹이나 휴대전화로 현장에서 확인한 내용을 사진과 함께 기록합니다.
- **작업지시서.** 확인한 사항에 조치하고 각 작업의 기록을 남깁니다. Technical부터 제공됩니다.
- **모바일 앱.** Android와 iPhone에서 현장 작업에 사용합니다.

## 데이터 수신은 무료입니다. 모니터링은 유료입니다.

비용은 자산이 아닌 모니터링하는 측정점에 부과됩니다.

- 측정점 1개: 연간 USD 36
- 측정점 5개 묶음: 연간 USD 120

이 페이지가 게시될 때 확인한 현행 Wertek AI 카탈로그 가격입니다. [모든 요금제 보기](https://wertek.ai/pricing.html)

## 고객이 자산을 관리하며, 여러분은 고객이 허용한 내용을 봅니다

- 자산과 이력은 이를 관리하는 고객의 소유입니다. 여러분이 기록한 내용에는 작성자 정보가 유지됩니다.
- 고객이 허용한 내용을 공장, 구역 또는 자산별로 지정된 시간 범위 내에서 봅니다.
- 기본적으로 고객이 측정점 비용을 지불합니다.
- 협업을 종료해도 자산과 기술 이력은 고객에게 남습니다. 여러분의 접근 권한은 철회 시 종료됩니다.

[Growth Program 안내](https://wertek.ai/growth-program.html)

## 수집 서비스가 허용하는 것

| | |
|---|---|
| 경로 | POST https://api.wertek.ai/iaes/ingest |
| 헤더 | X-API-Key, iaes.ingest 권한 필요 |
| 이벤트 | IAES, spec_version 2.x |
| 배치 | 요청당 최대 100개 이벤트 |
| 제한 | 키당 분당 300개 요청 |
| 주기 | 계약된 주기의 90 %가 지나기 전에 도착한 측정값은 버립니다 (코드 504) |
| 자산 계약 | GET /iaes/assets/{asset_id}/measurement-points, 키 사용 |
| 스키마 및 코드 | GET /iaes/schema 및 /iaes/schema/codes, 키 사용 |
| 응답 | 이벤트당 코드 하나: 1xx 저장됨 · 2xx 경고와 함께 저장됨 · 4xx 메시지 수정 · 5xx 재시도 |

## 자주 묻는 질문

**요금제가 필요한가요?** 데이터 전송에는 요금제가 필요하지 않습니다. 모니터링하는 각 측정점은 카탈로그에 따라 과금됩니다. 요금제를 사용하면 담당자에게 전달되는 알림, 작업지시서, 더 긴 이력이 활성화됩니다.

**어디에서 실행되나요?** 수집 서비스는 Wertek AI 클라우드 서비스입니다. Wertek AI 게이트웨이는 여러분의 네트워크에서 실행되며 장비를 읽고 측정값을 보냅니다.

**수집 서비스가 제 PLC에 쓰기를 하나요?** 아니요. 수집 서비스는 데이터만 수신합니다.

**주기보다 빠르게 전송하면 어떻게 되나요?** 계약된 주기의 90 %가 지나기 전에 도착한 측정값은 코드 504로 버립니다. 측정점의 주기에 맞춰 전송하세요.

