Device Gateway Service Version 2

The Device2 gateway public API provides method for managing device identities and state, configure provisioning settings, and defining the gateway resources.

Operations

Events

Operations


addGatewayResource

Create the definition of resource {alias}.

Arguments
parameters - object - Object containing service call parameters.
Name Type Description
alias ^[^.$]+$ The name of this resource.
unit string The unit of measure for this resource. Examples units include °C, mb,
and rpm.
format "number", "string", "boolean" The format that published data must adhere to.

There are three possible formats:

"boolean": either be "true" or "false"
"number": whole (integers) or real numbers (floating point numbers)
* "string": any UTF-8 encode string up to 2^16 bytes (64KB) in length.
allowed [ nil ] A rule describing allowable values for the resource.

If the value to write does not match a rule, it is not allowed and
will be rejected.
initial nil An inital "set" value to initialize each identity's state with.

Only valid when "settable" is "true".
settable boolean Indicate whether this resource's "set" value can be assigned via the
setIdentityState method.

If true, the setIdentityState method may be used to update the
identity's state for the resource. Each resource has two assignable
values, "reported" and "set". When a device publishes data, both
"reported" and "set" are assigned the reported value; when calling
the setIdentityState method, only the "set" value is assigned.
Responses
The resource was successfully added. - nil

The resource was successfully added.

The error object - object
Name Type Description
code integer(int32) The error code for this error
message string The error message for this error
The error object - object
Name Type Description
code integer(int32) The error code for this error
message string The error message for this error
The error object - object
Name Type Description
code integer(int32) The error code for this error
message string The error message for this error

addIdentity

Adds {identity} to the gateway.

A device must have both an identity and be able to authenticate against the gateway before it can send updates, receive control requests, and download files. Such devices are considered "provisioned". These settings determine how the device is expected to authenticate.

If the gateway settings allow provisioning and accepts the device "presented" identity, whitelisting is unnecessary. In this case the device presents its identity (e.g. serial number, public certificate) and the gateway associates credentials used in subsequent connections.

The addIdentity operation establishes a new device identity. It may also assign the authentication credentials for the identity and set the "locked" value to temporarily prevent an identity from connecting.

Arguments
parameters - object - Object containing service call parameters.
Name Type Description
identity string The identifier of a given device.
auth object The authentication object for identities connecting to the gateway.
auth.key string The credential used to authenticate the identity.

The value and format of this "key" is dependent on the "type" field.
auth.type "certificate", "cik", "hash", "password", "signature", "token" The type of credential used to authenticate the identity.
auth.expire integer The expiration timestamp of this authentication object.

If the "expire" timestamp is surpassed, the status of a "whitelisted" identity
becomes "expired" and a "provisioned" identity becomes "reprovision".
locked boolean Setting "locked" property of an identity to "true" will prevent the device
from communicating with the gateway.

The default value is "false".
Responses
Identity sucessfully added to the gateway with the provided properties. - nil

Identity sucessfully added to the gateway with the provided properties.

The error object - object
Name Type Description
code integer(int32) The error code for this error
message string The error message for this error
The error object - object
Name Type Description
code integer(int32) The error code for this error
message string The error message for this error
The error object - object
Name Type Description
code integer(int32) The error code for this error
message string The error message for this error

getGatewayResource

Retrieve the definition of resource {alias}.

Arguments
parameters - object - Object containing service call parameters.
Name Type Description
alias ^[^.$]+$ The name of this resource.
Responses
The definition of a property that can be written to by devices and may beset from the cloud.Resources are formally defined properties whose published values are explicitlystored by the gateway as per identity state. Devices may however publish withany alias regardless of the existence of a resource definition for that alias. Allpublished data will be sent to the event mechanism (where they may be storedin a timeseries database or acted on in whatever manner is appropriate).For aliases with an associated resource defintion the last-published, or "reported",value can be queried via the getIdentityState method. A "cloud modifiable" resourcecan also be "set" via the setIdentityState method to push data to a device. - object
Name Type Description
unit string The unit of measure for this resource. Examples units include °C, mb,
and rpm.
format "number", "string", "boolean" The format that published data must adhere to.

There are three possible formats:

"boolean": either be "true" or "false"
"number": whole (integers) or real numbers (floating point numbers)
* "string": any UTF-8 encode string up to 2^16 bytes (64KB) in length.
allowed [ nil ] A rule describing allowable values for the resource.

If the value to write does not match a rule, it is not allowed and
will be rejected.
initial nil An inital "set" value to initialize each identity's state with.

Only valid when "settable" is "true".
settable boolean Indicate whether this resource's "set" value can be assigned via the
setIdentityState method.

If true, the setIdentityState method may be used to update the
identity's state for the resource. Each resource has two assignable
values, "reported" and "set". When a device publishes data, both
"reported" and "set" are assigned the reported value; when calling
the setIdentityState method, only the "set" value is assigned.
The error object - object
Name Type Description
code integer(int32) The error code for this error
message string The error message for this error
The error object - object
Name Type Description
code integer(int32) The error code for this error
message string The error message for this error

getGatewaySettings

Returns the current settings for the gateway.

The settings used to establish connectivity between devices and Murano. It includes the fully-qualified domain name used to establish a connection as well as the means by which devices are provisioned and authenticate.

Responses
The gateway settings. - object
Name Type Description
fqdn string The fully-qualified domain name to be used by devices connecting to the
gateway.

Devices will connect to the gateway using this domain, typically
securely over port 443 using TLS.

Example:

A device uses this when using the HTTP Device API to write data
to the "temp" resource:

POST /onep:v1/stack/alias HTTP/1.1
Host:
Content-Type: application/x-www-form-urlencoded; charset=utf-8
Content-Length:

temp=451

NOTE: Devices connecting to Murano with the "devmode" property enabled
would use port 80 on the "devmode" specific domain.
protocol object The protocol specification for devices connecting to the gateway.
protocol.name "onep" The protocol used by devices connecting to the gateway.

Supported protocols:

* onep: The HTTP Device API.
protocol.devmode boolean Enables/disables "development mode". When set to "true", devices
connecting to the gateway may do so unencrypted (i.e. using HTTP instead of
HTTPS).

NOTE: enabling "devmode" is highly discouraged as all
communication -- including that which is used to authenticate -- will
be sent, unencrypted, in plain text.

This property defaults to "false".
resources object The resources of this device gateway
provisioning object The provisioning rules used to create and provision devices to the gateway.

If enabled devices maybe connect and provision with the gateway associating
its identity and credentials for use in subsequent connections. Once
provisioned a device credentials are securely one-way hashed and can
not be retrieved from the gateway.
provisioning.enabled boolean Enables/disabling provisioning for this gateway context.

If "true", devices are allowed to connect for provisioning. If "false",
devices cannot provision.

This property defaults to "true".
provisioning.auth_type "certificate", "cik", "token", "hash", "password", "signature" The authentication method used when provisioning credentials for a device.

Devices must authenticate when connecting to the gateway. This property
specifies the expected authentication scheme devices must use when
connecting. Supported schemes are:

certificate: an X.509 keypair in which the device authenticates by
presenting the public component of its cert and proving it possesses
the private component when challenged. The certificate must encode
its identity in the CN component
of the certificate (i.e. public
component. The public component alone is not sufficient to grant
access, and the private component never leaves the device (that is,
is never exchanged over-the-wire); consequently this is considered the
most secure authentication mechanism and is preferred.
token: a string representing both the identity and the password of a
device. This token is granted to the device when it is activated as
part of the provisioning process and presented by the device when it
connects.
provisioning.ip_whitelisting object Settings to manage allowed IP addresses of provisioning devices.

These settings apply to devices requesting to provision. Once provisioned,
devices may connect from any IP address regardless of these settings.
provisioning.ip_whitelisting.allowed [ string ] An array of IPv4 addresses devices may connect from when provisioning.

Devices must connect from an IP address in this list (assuming
ip_whitelisting is enabled).

Example:

["10.1.1.81","10.1.1.82"]
provisioning.ip_whitelisting.enabled boolean Enables/disables restricting IP addresses that a device may connect
from when provisioning.

If "true", only devices connecting from the specified IP addresses
will be allowed to provision (all others will be rejected). If "false",
devices may provision from any IP address.

This property defaults to "false".
provisioning.generate_identity boolean Enables/disables the gateway to generate the identity for a device connecting
without one.

If "true", the gateway will generate an identity for the connecting device
if it doesn't have one. If "false", devices are expected to connect with
an identity.

This property defaults to "false".
provisioning.presenter_identity boolean Enables/disables the acceptance of device-presented identities.

This property is useful when identities are not whitelisted in advance,
thereby allowing the connecting device to present its own identity at
the time of connection. If "true", devices need not be whitelisted prior
to connecting. The device, instead, connects with an identity and if the
presented identity is not known to the gateway, the identity is added. If
"false", only known (whitelisted) identities are allowed to connect
to the gateway.

This property defaults to true.
identity_format object The format specification for a device's identity.

Device identities must adhere to the specified format. Any
device identity not matching the format specification is rejected.
identity_format.type "mac:48", "mac-48", "mac.48", "uuidv4", "base10", "base16", "opaque" The principle format for the identity.

Murano supports MAC addresses in the following forms:

mac:48, a MAC address format using colons (MM:MM:MM:SS:SS:SS)
mac-48, a MAC address format using dashes (MM-MM-MM-SS-SS-SS)
mac.48, a MAC address format using dots (MMM.MMM.SSS.SSS)
uuidv4, a universally unique identifier format (with results akin to
e5fa76f8-1220-45c9-b972-3e2345851677)
base10, a base-10 number format (0123456789)
base16, a base-16 (hexadecimal) number format (0123456789abcdef)
* opaque, a free-form "format". Any UTF-8 encoded string.
identity_format.prefix string An optional prefix that should be present at the beginning of the
device's identity.

The prefix is applicable only when the type is either "base10" or
"base16". The prefix must conform to the "casing"'s value, but is
not included when validating the length.
identity_format.options object Additional identity format options.
identity_format.options.casing "lower", "upper", "mixed" The string case.

Applies to all types and validates against the entire identity
(including the prefix).

If unspecified, casing is assigned to "mixed".
identity_format.options.length number The number of required digits when using base10 and base16.
identity_format.options.mac_base string The first 3 octets of the MAC address of the device connecting to
Murano. This can also be referred to as the Manufacturer ID.

In the MAC address examples (mac:48, mac-48, and mac.48), the MAC base
corresponds to the digits represented using the letter "M", whereas
the letter "S" represents the unique ID of the connecting device.
The error object - object
Name Type Description
code integer(int32) The error code for this error
message string The error message for this error

getIdentity

Retrieves the properties of the given {identity}.

Arguments
parameters - object - Object containing service call parameters.
Name Type Description
identity string The identifier of a given device.
Responses
The representation of an identity.Every device known to the gateway has a identity object entry. Use the "listIdentities"method to query for a listing of all known identities and the "getIdentity" method toget the details for a specific identity. - object
Name Type Description
auth object The authentication object for identities connecting to the gateway.
auth.key string The credential used to authenticate the identity.

The value and format of this "key" is dependent on the "type" field.
auth.type "certificate", "cik", "hash", "password", "signature", "token" The type of credential used to authenticate the identity.
auth.expire integer The expiration timestamp of this authentication object.

If the "expire" timestamp is surpassed, the status of a "whitelisted" identity
becomes "expired" and a "provisioned" identity becomes "reprovision".
state object The current state of the device as represented by assigned resources.

For any resource with either a device-published ("reported") or
cloud-assigned ("set") value, the value will appear here. Note that a
device publishes to both the "reported" and the "set" value. An example
follows:

{
"temp": {
"timestamp": 1490392562583312,
"set": 1591,
"reported": 1591
}
}
lastip string The most recent IP address from which this device connected.
locked boolean The "locked" value for this device.

If set to "true", connection requests from this device are refused.
online boolean Indicates whether the device is currently connected to the gateway.
status "locked", "reprovision", "devmode", "provisioned", "whitelisted", "expired" The device's current status.

The following status values are recognized:

A "locked" identity may not connect, even with valid authentication.
A "reprovision" status indicates the device must reprovision because
its authentication key has expired.
An "expired" status indicates that the identity provisioning window
has expired and must be reset.
A "provisioned" identity has associated authentication credentials.
A "whitelisted" is an identity known to the gateway, but does not have
authentication credentials associated and must be provisioned.
A "devmode" status indicates that the device that has authenticated
over a non secure (unencrypted) transport. Its credentials have
been flagged and are no longer considered secure.
devmode boolean Indicates whether this device is a "development" device.

By definitions, development devices have connected insecurely using
HTTP rather than HTTPS. All communication -- including that which is
necessary to authenticate the device -- has been sent "in the clear",
interceptible by any third party.
identity string The device's identity.

Only one device with this identity may exist in a given gateway context.
lastseen number The most recent timestamp at which this device connected or published data.
The error object - object
Name Type Description
code integer(int32) The error code for this error
message string The error message for this error

getIdentityState

Retrieves the state of resource(s) for the provided {identity}.

The state consists of the 'set' and 'report' values associated with the identity for all defined resources.

Arguments
parameters - object - Object containing service call parameters.
Name Type Description
identity string The device's identifier
Responses
The current state of the identity.A device-published ("reported") or cloud-assigned ("set") value willappear here. Note that a device publishes to both the "reported" andthe "set" value.Example:{ "temp": { "timestamp": 1490392562583312, "set": 1591, "reported": 1591 }} - object
Name Type Description
The error object - object
Name Type Description
code integer(int32) The error code for this error
message string The error message for this error

listIdentities

Gets a list of the device identities associated with the gateway.

The returned device list is sorted (descending) by "lastseen" timestamp.

Arguments
parameters - object - Object containing service call parameters.
Name Type Description
limit integer Limit the number of returned identities to indicated value (default 50).
Default: 50
offset integer When set the query returns 'limit' number of devices but skip
'offset' number of devices at the beginning. This is useful in
combination with the 'before' field when more than 'limit' of
identities "lastseen" are all the same.
before number Returns device identities whose "lastseen" before timestamp.
status string Restrict the list of identities to only those with provided statuses.

The following states are recognized:

a "locked" identity may not connect, even with valid authentication
a "reprovision" status indicates the device must reprovision because
its authentication key has expired
an "expired" status indicates that the identity provisioning window
has expired and must be reset.
a "provisioned" identity has associated authentication credentials
a "whitelisted" identity does not have authentication credentials
associated and must be provisioned
a "devmode" status indicates that the device that has authenticated
over a non secure (unencrypted) transport. Its credentials have
been flagged and are no longer considered secure.
identity string Returns only device identities that matches given regex.

To restrict the list to only those devices beginning with the letter
"a", for example, use the following regular expression: "^a.*".
ipaddress string Returns only device identities whose "lastip" matches given IP address.
version string Not implemented.
Responses
Result object - object
Name Type Description
devices [ object ] A list of identities and their state.
devices[].auth object The authentication object for identities connecting to the gateway.
devices[].auth.key string The credential used to authenticate the identity.

The value and format of this "key" is dependent on the "type" field.
devices[].auth.type "certificate", "cik", "hash", "password", "signature", "token" The type of credential used to authenticate the identity.
devices[].auth.expire integer The expiration timestamp of this authentication object.

If the "expire" timestamp is surpassed, the status of a "whitelisted" identity
becomes "expired" and a "provisioned" identity becomes "reprovision".
devices[].state object The current state of the device as represented by assigned resources.

For any resource with either a device-published ("reported") or
cloud-assigned ("set") value, the value will appear here. Note that a
device publishes to both the "reported" and the "set" value. An example
follows:

{
"temp": {
"timestamp": 1490392562583312,
"set": 1591,
"reported": 1591
}
}
devices[].lastip string The most recent IP address from which this device connected.
devices[].locked boolean The "locked" value for this device.

If set to "true", connection requests from this device are refused.
devices[].online boolean Indicates whether the device is currently connected to the gateway.
devices[].status "locked", "reprovision", "devmode", "provisioned", "whitelisted", "expired" The device's current status.

The following status values are recognized:

A "locked" identity may not connect, even with valid authentication.
A "reprovision" status indicates the device must reprovision because
its authentication key has expired.
An "expired" status indicates that the identity provisioning window
has expired and must be reset.
A "provisioned" identity has associated authentication credentials.
A "whitelisted" is an identity known to the gateway, but does not have
authentication credentials associated and must be provisioned.
A "devmode" status indicates that the device that has authenticated
over a non secure (unencrypted) transport. Its credentials have
been flagged and are no longer considered secure.
devices[].devmode boolean Indicates whether this device is a "development" device.

By definitions, development devices have connected insecurely using
HTTP rather than HTTPS. All communication -- including that which is
necessary to authenticate the device -- has been sent "in the clear",
interceptible by any third party.
devices[].identity string The device's identity.

Only one device with this identity may exist in a given gateway context.
devices[].lastseen number The most recent timestamp at which this device connected or published data.
mayLoadMore boolean Additional, matching identities exist but were not returned.

If "true", the query would have returned more devices, but
the "limit" settings precluded it from doing so. Make
additional queries with the "lastseen" timestamp set to the
timestamp of the last identity in the result list.
The error object - object
Name Type Description
code integer(int32) The error code for this error
message string The error message for this error
The error object - object
Name Type Description
code integer(int32) The error code for this error
message string The error message for this error

removeGatewayResource

Remove the resource {alias}.

Arguments
parameters - object - Object containing service call parameters.
Name Type Description
alias ^[^.$]+$ The name of this resource.
Responses
The resource was successfully removed. - nil

The resource was successfully removed.

The error object - object
Name Type Description
code integer(int32) The error code for this error
message string The error message for this error
The error object - object
Name Type Description
code integer(int32) The error code for this error
message string The error message for this error

removeIdentity

Delete the given {identity}.

Remove everything that is known about the given {identity} including its state, authentication, and status. Future queries for this identity will return a 404 (not found).

Arguments
parameters - object - Object containing service call parameters.
Name Type Description
identity string The identifier of a given device.
Responses
The device was successfully deleted. - nil

The device was successfully deleted.

The error object - object
Name Type Description
code integer(int32) The error code for this error
message string The error message for this error

setIdentityState

Assign the "set" value of a resource or set of resources for a device.

Note that when a device reports a new value to the resource, the effect is to assign both the "reported" and the "set" value; if the device reports a new value prior to reading the requested "set" value, the "set" value will be discarded in favor of the new "reported" value.

Arguments
parameters - object - Object containing service call parameters.
Name Type Description
identity string The device's identifier
Responses
The new value was successfully "set". - nil

The new value was successfully "set".

The error object - object
Name Type Description
code integer(int32) The error code for this error
message string The error message for this error
The error object - object
Name Type Description
code integer(int32) The error code for this error
message string The error message for this error
The error object - object
Name Type Description
code integer(int32) The error code for this error
message string The error message for this error
Example
return Device2.setIdentityState({
  identity="xxxxxxxxxxxxx",
  temp=123,
  humidity=456
})

updateGatewayResource

Update the definition of resource {alias}.

Arguments
parameters - object - Object containing service call parameters.
Name Type Description
alias ^[^.$]+$ The name of this resource.
unit string The unit of measure for this resource. Examples units include °C, mb,
and rpm.
format "number", "string", "boolean" The format that published data must adhere to.

There are three possible formats:

"boolean": either be "true" or "false"
"number": whole (integers) or real numbers (floating point numbers)
* "string": any UTF-8 encode string up to 2^16 bytes (64KB) in length.
allowed [ nil ] A rule describing allowable values for the resource.

If the value to write does not match a rule, it is not allowed and
will be rejected.
initial nil An inital "set" value to initialize each identity's state with.

Only valid when "settable" is "true".
settable boolean Indicate whether this resource's "set" value can be assigned via the
setIdentityState method.

If true, the setIdentityState method may be used to update the
identity's state for the resource. Each resource has two assignable
values, "reported" and "set". When a device publishes data, both
"reported" and "set" are assigned the reported value; when calling
the setIdentityState method, only the "set" value is assigned.
Responses
The resource was successfully updated. - nil

The resource was successfully updated.

The error object - object
Name Type Description
code integer(int32) The error code for this error
message string The error message for this error
The error object - object
Name Type Description
code integer(int32) The error code for this error
message string The error message for this error

updateGatewaySettings

Update the gateway settings.

Arguments
parameters - object - Object containing service call parameters.
Name Type Description
protocol object The protocol specification for devices connecting to the gateway.
protocol.name "onep" The protocol used by devices connecting to the gateway.

Supported protocols:

* onep: The HTTP Device API.
protocol.devmode boolean Enables/disables "development mode". When set to "true", devices
connecting to the gateway may do so unencrypted (i.e. using HTTP instead of
HTTPS).

NOTE: enabling "devmode" is highly discouraged as all
communication -- including that which is used to authenticate -- will
be sent, unencrypted, in plain text.

This property defaults to "false".
resources object When devices publish data or read and subscribe to data, they do so
using a resource alias.

Resources are used by devices (HTTP Device API) and by Murano (Device2
Lua API) to exchange information, respond to events and otherwise serve
as the inputs and outputs between devices and Murano.
provisioning object The provisioning rules used to create and provision devices to the gateway.

If enabled devices maybe connect and provision with the gateway associating
its identity and credentials for use in subsequent connections. Once
provisioned a device credentials are securely one-way hashed and can
not be retrieved from the gateway.
provisioning.enabled boolean Enables/disabling provisioning for this gateway context.

If "true", devices are allowed to connect for provisioning. If "false",
devices cannot provision.

This property defaults to "true".
provisioning.auth_type "certificate", "cik", "token", "hash", "password", "signature" The authentication method used when provisioning credentials for a device.

Devices must authenticate when connecting to the gateway. This property
specifies the expected authentication scheme devices must use when
connecting. Supported schemes are:

certificate: an X.509 keypair in which the device authenticates by
presenting the public component of its cert and proving it possesses
the private component when challenged. The certificate must encode
its identity in the CN component
of the certificate (i.e. public
component. The public component alone is not sufficient to grant
access, and the private component never leaves the device (that is,
is never exchanged over-the-wire); consequently this is considered the
most secure authentication mechanism and is preferred.
token: a string representing both the identity and the password of a
device. This token is granted to the device when it is activated as
part of the provisioning process and presented by the device when it
connects.
provisioning.ip_whitelisting object Settings to manage allowed IP addresses of provisioning devices.

These settings apply to devices requesting to provision. Once provisioned,
devices may connect from any IP address regardless of these settings.
provisioning.ip_whitelisting.allowed [ string ] An array of IPv4 addresses devices may connect from when provisioning.

Devices must connect from an IP address in this list (assuming
ip_whitelisting is enabled).

Example:

["10.1.1.81","10.1.1.82"]
provisioning.ip_whitelisting.enabled boolean Enables/disables restricting IP addresses that a device may connect
from when provisioning.

If "true", only devices connecting from the specified IP addresses
will be allowed to provision (all others will be rejected). If "false",
devices may provision from any IP address.

This property defaults to "false".
provisioning.generate_identity boolean Enables/disables the gateway to generate the identity for a device connecting
without one.

If "true", the gateway will generate an identity for the connecting device
if it doesn't have one. If "false", devices are expected to connect with
an identity.

This property defaults to "false".
provisioning.presenter_identity boolean Enables/disables the acceptance of device-presented identities.

This property is useful when identities are not whitelisted in advance,
thereby allowing the connecting device to present its own identity at
the time of connection. If "true", devices need not be whitelisted prior
to connecting. The device, instead, connects with an identity and if the
presented identity is not known to the gateway, the identity is added. If
"false", only known (whitelisted) identities are allowed to connect
to the gateway.

This property defaults to true.
identity_format object The format specification for a device's identity.

Device identities must adhere to the specified format. Any
device identity not matching the format specification is rejected.
identity_format.type "mac:48", "mac-48", "mac.48", "uuidv4", "base10", "base16", "opaque" The principle format for the identity.

Murano supports MAC addresses in the following forms:

mac:48, a MAC address format using colons (MM:MM:MM:SS:SS:SS)
mac-48, a MAC address format using dashes (MM-MM-MM-SS-SS-SS)
mac.48, a MAC address format using dots (MMM.MMM.SSS.SSS)
uuidv4, a universally unique identifier format (with results akin to
e5fa76f8-1220-45c9-b972-3e2345851677)
base10, a base-10 number format (0123456789)
base16, a base-16 (hexadecimal) number format (0123456789abcdef)
* opaque, a free-form "format". Any UTF-8 encoded string.
identity_format.prefix string An optional prefix that should be present at the beginning of the
device's identity.

The prefix is applicable only when the type is either "base10" or
"base16". The prefix must conform to the "casing"'s value, but is
not included when validating the length.
identity_format.options object Additional identity format options.
identity_format.options.casing "lower", "upper", "mixed" The string case.

Applies to all types and validates against the entire identity
(including the prefix).

If unspecified, casing is assigned to "mixed".
identity_format.options.length number The number of required digits when using base10 and base16.
identity_format.options.mac_base string The first 3 octets of the MAC address of the device connecting to
Murano. This can also be referred to as the Manufacturer ID.

In the MAC address examples (mac:48, mac-48, and mac.48), the MAC base
corresponds to the digits represented using the letter "M", whereas
the letter "S" represents the unique ID of the connecting device.
Responses
The gateway settings were updated successfully. - nil

The gateway settings were updated successfully.

The error object - object
Name Type Description
code integer(int32) The error code for this error
message string The error message for this error
The error object - object
Name Type Description
code integer(int32) The error code for this error
message string The error message for this error

updateIdentity

Update {identity} properties.

Arguments
parameters - object - Object containing service call parameters.
Name Type Description
identity string The identifier of a given device.
auth object The authentication object for identities connecting to the gateway.
auth.key string The credential used to authenticate the identity.

The value and format of this "key" is dependent on the "type" field.
auth.type "certificate", "cik", "hash", "password", "signature", "token" The type of credential used to authenticate the identity.
auth.expire integer The expiration timestamp of this authentication object.

If the "expire" timestamp is surpassed, the status of a "whitelisted" identity
becomes "expired" and a "provisioned" identity becomes "reprovision".
locked boolean Setting "locked" property of an identity to "true" will prevent the device
from communicating with the gateway.

The default value is "false".
Responses
The identity properties were sucessfully updated in the device gateway - nil

The identity properties were sucessfully updated in the device gateway

The error object - object
Name Type Description
code integer(int32) The error code for this error
message string The error message for this error
The error object - object
Name Type Description
code integer(int32) The error code for this error
message string The error message for this error

Events


event

Specific transactions cause the Device2 gateway to emit events with the event.type field set to one of the following:

Arguments
event - object - The event table
Name Type Description
ip string Ip Address that the device connected to the gateway from
type "connect", "disconnect", "data_in", "provisioned", "expired" The event type
payload object Contains the data payload for the 'data_in' event type
identity string The authenticated identity of the connected device
protocol string Specifies the protocol that the device connected with.
timestamp integer The UNIX timestamp at which the event was generated
connection_id string A unique id shared across all events generated from the same network
connection
Example
function handle_device2_event (event)

 -- Your logic comes here 

end