cloud.access_keys_controller_sync

Hub type: CLOUD

Title: ask cloud for new local access data
Description: Controller will ask for local access data when it have no (first start, after reset), or after cloud notified controller about new local access data with hub.offline.credentials.updated command

Edit

Field	Type	Required	Description
version	int	–	Current local access data version on controller (omitted if controller have no local access data)

Edit

Field	Type	Required	Description
clients	object	+	Credentials for users/controllers/etc that connect to current controller
clients.{UUID}	array of strings	–	Array of SHA256 hashed keys (access tokens) for user specified by UUID
peers	object	+	Credentials for controllers or devices you can both connect to and receive connections from
peers.{UUID}	object	–	Controller info
peers.{UUID}.id	string	+	Controller serial
peers.{UUID}.tokens	array of strings	+	Array of plain text keys (access tokens) for peer specified by UUID
current	array	+	Data for the controller doing the sync API call
current[].certificate	string	+	Certificate in PEM format for secure websocket connection
current[].private	string	+	Private key in PEM format for secure websocket connection
current[].public_parent	string	+	SSL Certificates Chain file to verify all controller’s certificates (during controller-to-controller connection controller-client will use it to verify controller-server’s certificate)

Edit

Request
Response

Edit

				
					{
    "id": "_ID_",
    "api": "3",
    "method": "cloud.access_keys_controller_sync",
    "params": {
       "version": 1
     }
}

Edit

				
					{
    "error": null,
    "method": "cloud.access_keys_controller_sync",
    "id": "_ID_",
    "result": {
        "clients": {
            "95d8cd00-5bba-46e5-ae33-f1e4b2d65e6e": [
                "eb7a599e4a991e61809ff9f0883e5801cb33e96ea165350b90a1a210023596e7",
                "1b191ccc8ca77590a28a48067f875047556a890acd29ec50fb046d718175bec7"
            ],
            "708e3376-5cb1-4fa8-923f-cda75b9e9e33": [
                "bf7d0763877fe1d39308176e991a187b6f8c25d2c5617ea6d2b71e03400eae6e"
            ]
        },
        "peers": {
             "c89723f7-03a3-423d-a556-7eba4270d064" : {
                 "id": "70010111",
                 "tokens": [
                     "c89723f7-03a3-423d-a556-7eba4270d064-key-12-02",
                     "c89723f7-03a3-423d-a556-7eba4270d064-key-01-03"
                 ]
             }
        },
        "current": [
            {
                "certificate": "-----BEGIN CERTIFICATE-----\nMIIE...\n-----END CERTIFICATE-----",
                "private": "-----BEGIN PRIVATE KEY-----\nMIIE...\n-----END PRIVATE KEY-----",
                "public_parent": "-----BEGIN CERTIFICATE-----\nMIIE...\n-----END CERTIFICATE-----"
            },
            {
                "certificate": "-----BEGIN CERTIFICATE-----\nMIIE...\n-----END CERTIFICATE-----",
                "private": "-----BEGIN PRIVATE KEY-----\nMIIE...\n-----END PRIVATE KEY-----",
                "public_parent": "-----BEGIN CERTIFICATE-----\nMIIE...\n-----END CERTIFICATE-----"
            }
        ],
        "version": 12
    }
}