2.3 configuration/buttons/connection-method

GET

Since version 2.2

Get the buttons connection configuration for network integration feature.

Responses
200GET successful.
Response (application/json): object
MemberTypeDescription
externalAccessPoint
object

Buttons setting for Network Integration.

Since version: 2.2

  authentication
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

  ssid
string

The public name (SSID) for the wireless network of the Base Unit.

Example: Clickshare-0123456789

Since version: 2.2

operationMode
string

Button connection mode to Base unit.

Since version: 2.2

supportedOperationModes
array

Example: ['InternalAccessPoint', 'ExternalAccessPoint']

Since version: 2.2

read-only

PATCH

Since version 2.2

Change the buttons connection configuration for network integration feature.

Request body (application/json): object
MemberTypeDescription
externalAccessPoint
object

Buttons setting for Network Integration.

Since version: 2.2

  authentication
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

  ssid
string

The public name (SSID) for the wireless network of the Base Unit.

Example: Clickshare-0123456789

Since version: 2.2

operationMode
string

Button connection mode to Base unit.

Since version: 2.2

supportedOperationModes
array

Example: ['InternalAccessPoint', 'ExternalAccessPoint']

Since version: 2.2

read-only

Responses
200PATCH successful.