|  Developer
Updated on June 20, 2022

cloud.access_keys_controller_sync

Hub type:

  • 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
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
    }
}