Node Info Service¶
The Node Info Service is configured on a subpath of a Web transport and allows you to expose a HTML information page about the node.
The page is rendered dynamically by Crossbar.io and includes information such as:
Release
Crossbar.io COMMUNITY 17.4.1
Node Started
2017-04-15T22:33:13.578Z
Node Controller PID
31043
Running Workers
1
Node Public Key
42c1e06fb527d041ba5f9b14166153d95fcb6123353fad4265a7fd469b269f42
Served for
127.0.0.1:41788
from Crossbar.io router worker with PID31048
.
The node public key is useful eg for secure pairing with a management platform. The software release version and PID allows to verify basic operation.
While a node info page does not expose secure information per-se, it does expose software versions and public key material, which can expose the identity of the originator of information (though it will still preserve confidentiality).
Because of this, running this in production, listening on a public internet facing endpoint, is NOT recommended!
Configuration¶
To configure a node info service, attach a dictionary element to a path in your Web transport:
attribute |
description |
---|---|
``type`` |
must be |
Example¶
See `here <https://github.com/crossbario/crossbar-examples/tree/master/nodeinfo>`__ for the complete example.
A Web Transport configuration that includes a Node Info Service
on the subpath info
:
{
"type": "web",
"endpoint": {
"type": "tcp",
"port": 8080
},
"web": {
"paths": {
"/": {
"type": "static",
"directory": "../web"
},
"info": {
"type": "nodeinfo"
}
}
}
}
When you open http://localhost:8080/info in your browser, you should get a HTML node information page rendered with data like the node public key and software release string.