2.36 configuration/system/network/wired/{index}

GET

Get settings for the LAN with the specified ID.

Responses
200GET successful.
404Resource does not exist.
Response (application/json): object
MemberTypeDescription
802dot1xAuthentication
objectSettings for 802.1X authentication.
  anonymousIdentity
stringUsed to select the correct authentication server to process the credentials.
  authenticationErrorCode
string

Wired Authentication error code.

read-only

  authenticationMode
stringThe 802.1X mode that is used.
  authenticationState
string

Wired Authentication State.

read-only

  caCertificate
string 
  certificates
object

Since version: 2.8

read-only

    ca
object

Retrieve information about the ca certificate.

Since version: 2.8

      commonName
string

Common name of the active certificate.

Example: ClickShare-1862300136

Since version: 2.8

      country
string

Country of the active certificate.

Example: BE

Since version: 2.8

      locality
string

Locality of the active certificate.

Since version: 2.8

      notAfter
string (date-time)

Indicate the end of the validity period of the certificate.

Example: 2021-04-29 10:00:24

Since version: 2.8

      notBefore
string (date-time)

Indicate the start of the validity period of the certificate.

Example: 2020-04-29 10:00:24

Since version: 2.8

      organization
string

Organization of the active certificate.

Since version: 2.8

      organizationalUnit
string

OrganizationalUnit of the active certificate.

Since version: 2.8

      serialNumber
string

SerialNumber of the active certificate.

Since version: 2.8

      state
string

State of the active certificate.

Since version: 2.8

    client
object

Retrieve information about the client certificate.

Since version: 2.8

      commonName
string

Common name of the active certificate.

Example: ClickShare-1862300136

Since version: 2.8

      country
string

Country of the active certificate.

Example: BE

Since version: 2.8

      locality
string

Locality of the active certificate.

Since version: 2.8

      notAfter
string (date-time)

Indicate the end of the validity period of the certificate.

Example: 2021-04-29 10:00:24

Since version: 2.8

      notBefore
string (date-time)

Indicate the start of the validity period of the certificate.

Example: 2020-04-29 10:00:24

Since version: 2.8

      organization
string

Organization of the active certificate.

Since version: 2.8

      organizationalUnit
string

OrganizationalUnit of the active certificate.

Since version: 2.8

      serialNumber
string

SerialNumber of the active certificate.

Since version: 2.8

      state
string

State of the active certificate.

Since version: 2.8

  clientCertificate
string 
  clientCertificatePassword
string (password)

The password for the client certificate.

Since version: 2.2

write-only

  domain
string

The domain used for connections in PEAP and EAP-TTLS mode.

Example: barco.com

  eapIdentity
stringThe identity used for connections in PEAP and EAP-TTLS mode.
  eapPassword
string (password)

The password used for connections in PEAP and EAP-TTLS mode.

write-only

  enabled
booleanIndicates if the 802.1X Authentication is enabled.
  passPhrase
string

Pass Phrase for WPA2-PSK authentication

Example: passphrase

Since version: 2.2

write-only

  scep
objectThe SCEP settings that are used for EAP_TLS mode with automatic enrollment.
    challenge
string

Challenge token to prevent revocation by user without token. This token is only used when type is SCEP.

Since version: 2.8

write-only

    city
string

Additional information about the city. This parameter is optional.

Since version: 2.8

    commonName
string

Optional custom common name for the client certificate. By default the BaseUnit's hostname will be used.

Example: ClickShare-3083543628.barco.com

Since version: 2.8

    country
string

Additional information about the country. This parameter is optional.

Since version: 2.8

    department
string

Additional information about the department. This parameter is optional.

Since version: 2.8

    enabled
boolean 
    organisation
string

Additional information about the organisation. This parameter is optional.

Since version: 2.8

    password
string

Password parameter is needed for NDES.

write-only

    serverType
string

SCEP RFC is an open source Linux certificate protocol. NDES is a certificate protocol developed by Microsoft. Before REST API v2.8 NDES was referred to as SCEP enrollment

Since version: 2.8

    serverUrl
string

The SCEP server to contact. Only http is currently supported. For NDES, you can omit the default /CertSrv/mscep/ path.

Example: http://barco.com/scep

    state
string

Additional information about the state. This parameter is optional.

Since version: 2.8

    supportedServerTypes
array

Since version: 2.8

read-only

    username
stringUsername parameter is needed for NDES.
  supportedAuthenticationModes
array

The different supported authentication modes.

Example: ['None', 'PEAP', 'WPA2-PSK']

read-only

addressing
stringIf this parameter is set to 'DHCP', the network connection is configured automatically through DHCP. If it is set to 'Static', a fixed IP address should be specified using the 'ipAddress' parameter.
defaultGateway
string (ipv4)

The default gateway. This parameter should only be changed if addressing is set to Static.

Example: 10.0.18.1

dnsServers
array

The DNS servers used for resolving domain names. The children of this node should only be set if addressing is set to Static.

Example: ['195.130.130.5', '195.130.131.5']

domain
stringExample: barco.com
id
integer

The ID for this LAN.

read-only

ipAddress
string (ipv4)

The IP address of the Base Unit. This parameter should only be changed if addressing is set to Static.

Example: 10.0.18.25

macAddress
string (mac-address)

MAC address of the wired ethernet adapter of the Base Unit.

Example: 99:88:77:66:55:44

read-only

status
string

Indicates the status of the ethernet port.

read-only

subnetMask
string (ipv4)

The subnet mask appropriate for the local subnet. This parameter should only be changed if addressing is set to Static.

Example: 255.255.255.0

PATCH

Change individual LAN settings.

Request body (application/json): object
MemberTypeDescription
802dot1xAuthentication
objectSettings for 802.1X authentication.
  anonymousIdentity
stringUsed to select the correct authentication server to process the credentials.
  authenticationErrorCode
string

Wired Authentication error code.

read-only

  authenticationMode
stringThe 802.1X mode that is used.
  authenticationState
string

Wired Authentication State.

read-only

  caCertificate
string 
  certificates
object

Since version: 2.8

read-only

    ca
object

Retrieve information about the ca certificate.

Since version: 2.8

      commonName
string

Common name of the active certificate.

Example: ClickShare-1862300136

Since version: 2.8

      country
string

Country of the active certificate.

Example: BE

Since version: 2.8

      locality
string

Locality of the active certificate.

Since version: 2.8

      notAfter
string (date-time)

Indicate the end of the validity period of the certificate.

Example: 2021-04-29 10:00:24

Since version: 2.8

      notBefore
string (date-time)

Indicate the start of the validity period of the certificate.

Example: 2020-04-29 10:00:24

Since version: 2.8

      organization
string

Organization of the active certificate.

Since version: 2.8

      organizationalUnit
string

OrganizationalUnit of the active certificate.

Since version: 2.8

      serialNumber
string

SerialNumber of the active certificate.

Since version: 2.8

      state
string

State of the active certificate.

Since version: 2.8

    client
object

Retrieve information about the client certificate.

Since version: 2.8

      commonName
string

Common name of the active certificate.

Example: ClickShare-1862300136

Since version: 2.8

      country
string

Country of the active certificate.

Example: BE

Since version: 2.8

      locality
string

Locality of the active certificate.

Since version: 2.8

      notAfter
string (date-time)

Indicate the end of the validity period of the certificate.

Example: 2021-04-29 10:00:24

Since version: 2.8

      notBefore
string (date-time)

Indicate the start of the validity period of the certificate.

Example: 2020-04-29 10:00:24

Since version: 2.8

      organization
string

Organization of the active certificate.

Since version: 2.8

      organizationalUnit
string

OrganizationalUnit of the active certificate.

Since version: 2.8

      serialNumber
string

SerialNumber of the active certificate.

Since version: 2.8

      state
string

State of the active certificate.

Since version: 2.8

  clientCertificate
string 
  clientCertificatePassword
string (password)

The password for the client certificate.

Since version: 2.2

write-only

  domain
string

The domain used for connections in PEAP and EAP-TTLS mode.

Example: barco.com

  eapIdentity
stringThe identity used for connections in PEAP and EAP-TTLS mode.
  eapPassword
string (password)

The password used for connections in PEAP and EAP-TTLS mode.

write-only

  enabled
booleanIndicates if the 802.1X Authentication is enabled.
  passPhrase
string

Pass Phrase for WPA2-PSK authentication

Example: passphrase

Since version: 2.2

write-only

  scep
objectThe SCEP settings that are used for EAP_TLS mode with automatic enrollment.
    challenge
string

Challenge token to prevent revocation by user without token. This token is only used when type is SCEP.

Since version: 2.8

write-only

    city
string

Additional information about the city. This parameter is optional.

Since version: 2.8

    commonName
string

Optional custom common name for the client certificate. By default the BaseUnit's hostname will be used.

Example: ClickShare-3083543628.barco.com

Since version: 2.8

    country
string

Additional information about the country. This parameter is optional.

Since version: 2.8

    department
string

Additional information about the department. This parameter is optional.

Since version: 2.8

    enabled
boolean 
    organisation
string

Additional information about the organisation. This parameter is optional.

Since version: 2.8

    password
string

Password parameter is needed for NDES.

write-only

    serverType
string

SCEP RFC is an open source Linux certificate protocol. NDES is a certificate protocol developed by Microsoft. Before REST API v2.8 NDES was referred to as SCEP enrollment

Since version: 2.8

    serverUrl
string

The SCEP server to contact. Only http is currently supported. For NDES, you can omit the default /CertSrv/mscep/ path.

Example: http://barco.com/scep

    state
string

Additional information about the state. This parameter is optional.

Since version: 2.8

    supportedServerTypes
array

Since version: 2.8

read-only

    username
stringUsername parameter is needed for NDES.
  supportedAuthenticationModes
array

The different supported authentication modes.

Example: ['None', 'PEAP', 'WPA2-PSK']

read-only

addressing
stringIf this parameter is set to 'DHCP', the network connection is configured automatically through DHCP. If it is set to 'Static', a fixed IP address should be specified using the 'ipAddress' parameter.
defaultGateway
string (ipv4)

The default gateway. This parameter should only be changed if addressing is set to Static.

Example: 10.0.18.1

dnsServers
array

The DNS servers used for resolving domain names. The children of this node should only be set if addressing is set to Static.

Example: ['195.130.130.5', '195.130.131.5']

domain
stringExample: barco.com
id
integer

The ID for this LAN.

read-only

ipAddress
string (ipv4)

The IP address of the Base Unit. This parameter should only be changed if addressing is set to Static.

Example: 10.0.18.25

macAddress
string (mac-address)

MAC address of the wired ethernet adapter of the Base Unit.

Example: 99:88:77:66:55:44

read-only

status
string

Indicates the status of the ethernet port.

read-only

subnetMask
string (ipv4)

The subnet mask appropriate for the local subnet. This parameter should only be changed if addressing is set to Static.

Example: 255.255.255.0

Responses
200PATCH successful.
404Resource does not exist.