Know-How-Schutz per API

Know-How-Schutz im grossen Massstab automatisieren

Der Siemens TIA Portal Know-How-Schutz sperrt den Quellcode eines Bausteins hinter einem Passwort. Der Baustein bleibt im Projektbaum sichtbar (Name, Typ, oeffentliche Schnittstelle), aber seine interne Logik kann ohne das Passwort weder gelesen, exportiert noch geaendert werden. T-IA Connect ermoeglicht es Ihnen, diesen Schutz programmgesteuert ueber REST API, MCP-Tools fuer KI-Assistenten oder den integrierten Copilot anzuwenden - einschliesslich Stapelschutz fuer ganze Projekte in Sekunden.

Schritt 1: Ungeschuetzte Bausteine identifizieren

Listen Sie alle Bausteine Ihres SPS-Geraets auf. Jeder Baustein enthaelt ein Feld isKnowHowProtected, das seinen aktuellen Schutzstatus anzeigt.

curl http://localhost:9000/api/devices/PLC_1/blocks \
  -H "X-API-Key: your-api-key"

{
  "Success": true,
  "Data": [
    {
      "Name": "FB_Fill",
      "Type": "FB",
      "Number": 1,
      "Language": "SCL",
      "IsKnowHowProtected": false
    },
    {
      "Name": "FB_Drain",
      "Type": "FB",
      "Number": 2,
      "Language": "SCL",
      "IsKnowHowProtected": false
    },
    {
      "Name": "FC_Recipe_Manager",
      "Type": "FC",
      "Number": 10,
      "Language": "SCL",
      "IsKnowHowProtected": false
    },
    {
      "Name": "FB_SafetyMonitor",
      "Type": "FB",
      "Number": 3,
      "Language": "LAD",
      "IsKnowHowProtected": true
    }
  ]
}

Schritt 2: Geraet kompilieren

Bausteine muessen kompiliert werden, bevor sie geschuetzt werden koennen. Kompilieren Sie das gesamte Geraet, um sicherzustellen, dass alle Bausteine in einem gueltigen Zustand sind.

curl -X POST http://localhost:9000/api/devices/PLC_1/actions/compile \
  -H "X-API-Key: your-api-key"

{
  "Success": true,
  "Message": "Compilation completed.",
  "Data": {
    "Errors": 0,
    "Warnings": 2
  }
}

Schritt 3: Know-How-Schutz anwenden

Schuetzen Sie einen Baustein, indem Sie den Geraetenamen, den Bausteinnamen und ein Passwort angeben. Das Passwort wird sicher uebertragen und von T-IA Connect nie gespeichert.

curl -X POST http://localhost:9000/api/devices/PLC_1/blocks/FB_Fill/actions/protect \
  -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "password": "MySecretPassword123"
  }'

{
  "Success": true,
  "Message": "Block 'FB_Fill' is now know-how protected.",
  "Data": {
    "BlockName": "FB_Fill",
    "IsKnowHowProtected": true,
    "IsProtectable": true
  }
}

Schritt 4: Schutzstatus ueberpruefen

Bestaetigen Sie, dass der Schutz korrekt angewendet wurde, indem Sie den detaillierten Status des Bausteins ueberpruefen. Die Antwort zeigt an, ob der Baustein geschuetzt und schuetzbar ist.

curl http://localhost:9000/api/devices/PLC_1/blocks/FB_Fill/protection \
  -H "X-API-Key: your-api-key"

{
  "Success": true,
  "Data": {
    "BlockName": "FB_Fill",
    "IsKnowHowProtected": true,
    "IsProtectable": true,
    "Reason": null
  }
}

curl -X POST http://localhost:9000/api/devices/PLC_1/blocks/actions/protect-batch \
  -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "blockNames": ["FB_Fill", "FB_Drain", "FC_Recipe_Manager", "DB_Config"],
    "password": "MySecretPassword123"
  }'

{
  "Success": true,
  "Message": "3/4 blocks protected successfully.",
  "Data": {
    "TotalRequested": 4,
    "Succeeded": 3,
    "Failed": 1,
    "Details": [
      { "BlockName": "FB_Fill", "IsKnowHowProtected": true, "Reason": null },
      { "BlockName": "FB_Drain", "IsKnowHowProtected": true, "Reason": null },
      { "BlockName": "FC_Recipe_Manager", "IsKnowHowProtected": true, "Reason": null },
      { "BlockName": "DB_Config", "IsKnowHowProtected": true, "Reason": "Already protected." }
    ]
  }
}