MTConnect.NET-AgentModule-HttpServer 6.4.4

MTConnect HTTP Server Agent Module

This Agent Module implements a MTConnect REST Protocol Http server

Configuration

modules:
  - http-server:
      hostname: localhost
      port: 5000
      allowPut: true
      indentOutput: true
      documentFormat: xml
      accept:
        text/xml: xml
        application/json: json-cppagent
      responseCompression:
      - gzip
      - br
      files:
      - path: schemas
        location: schemas
      - path: styles
        location: styles
      - path: styles/favicon.ico
        location: favicon.ico

• hostname - The server IP Address or Hostname to bind to.

• port - The port number the agent binds to for requests.

• accept - Maps HTTP Accept Headers to the corresponding Document Format ID

• responseCompression - Sets the List of Encodings (ex. gzip, br, deflate) to pass to the Accept-Encoding HTTP Header

• version - Sets the MTConnect Version to use for the response document. This can be used to request a document using an older version for legacy clients

• allowPut - Allow HTTP PUT or POST of data item values or assets.

• allowPutFrom - Allow HTTP PUT or POST from a specific host or list of hosts.

• indentOutput - Sets the indentation of the response document. True = Indent. False = Do not Indent

• outputComments - Sets the default response document comments output. Comments contain descriptions from the MTConnect standard

• outputValidationLevel - Sets the default response document validation level. 0 = Ignore, 1 = Warning, 2 = Strict

• files - Sets the configuration for Static Files that can be served from the Http Server.

  • path - The location of the files on the server (where the Agent is running)
  • location - The path to match in the requested URL

• tls - Sets the TLS settings

  • pfx - The PFX certificate settings

    • certificatePath - The path to the (.pfx) file
    • certificatePassword - The certificate password

  • pem - The PEM certificate settings

    • certificatePath - The path to the (.pem) file
    • privateKeyPath - The path to the key containing the private key
    • privateKeyPassword - The certificate password
    • certificateAuthority - The path to the (.pem) file containing the Certificate Authority

  • verifyClientCertificate - Toggles whether Client Certificate chains are verified ("true" or "false")

Example 1

Use defualt configuration

modules:
  - http-server:

Example 2

Specify the port

modules:
  - http-server:
      port: 5001

Example 3

Specify the port and hostname to an IP Address

modules:
  - http-server:
      hostname: 192.168.1.145
      port: 5001

Example 4

Specify the port and hostname

modules:
  - http-server:
      hostname: DESKTOP-HV74M4N
      port: 5001

Example 4

Specify the port and hostname with TLS (PFX Certificate)

modules:
  - http-server:
      hostname: DESKTOP-HV74M4N
      port: 5001
      tls:
        pfx:
          certificatePath: c:\certs\mtconnect-testing.pfx
          certificatePassword: mtconnect

Example 5

Specify the port and hostname with TLS (PEM Certificate)

modules:
  - http-server:
      hostname: DESKTOP-HV74M4N
      port: 5001
      tls:
        pem:
          certificateAuthority: c:\certs\rootCA.crt
          certificatePath: c:\certs\mtconnect-testing.crt
          privateKeyPath: c:\certs\mtconnect-testing.key
          privateKeyPassword: mtconnect

Example 6

Specify with custom Accept headers

modules:
  - http-server:
      accept:
        text/xml: xml
        application/json: json-cppagent

Contribution / Feedback

• Please use the Issues tab to create issues for specific problems that you may encounter
• Please feel free to use the Pull Requests tab for any suggested improvements to the source code
• For any other questions or feedback, please contact TrakHound directly at info@trakhound.com.

License

This application and it's source code is licensed under the MIT License and is free to use.