Register Connector
In order to start using the platform with any specific technology, we must register the Connector.
We would like to discover certificates and keys, and such Connector must therefore implement the Discovery Provider.
The Network Discovery Provider implements both generations of the Discovery Provider. Registered as v2, it discovers certificates and the public keys they carry, and its discoveries can be stopped, resumed and cancelled. Registered as v1, it discovers certificates. See Discovery Provider v1 and v2.
Register Connector using the API
The connector can be registered as v2 using the Connector API:
curl -X POST \
--cacert [ca-cert] \
--cert [client-cert] \
--cert-type [type] \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
--data '
{
"name": "Network Discovery Provider",
"version": "v2",
"url": "http://network-discovery-provider-service:8080",
"authType": "none"
}' \
https://[domain]:[port]/api/v2/connectors
When there is no error, Connector is successfully registered, and its details are sent back, including its uuid and the interfaces it implements:
{
"uuid": "ef092b12-e181-4734-8e34-73152612a945",
"name": "Network Discovery Provider",
"version": "v2",
"url": "http://network-discovery-provider-service:8080",
"interfaces": [
{
"uuid": "5d1f0c7e-3b2a-4e8f-9c6d-7a1b2c3d4e5f",
"code": "discovery",
"version": "v2",
"features": ["discoveryStopResume"]
},
...
],
...
}
To register it as v1 instead, send "version": "v1". An installation may already have registered it as v1, as the Helm chart does when it deploys the provider. A second registration with the same URL and version is refused, so register it as v2 alongside the existing one.
We can use the uuid to get details about the Connector in the future API calls:
curl -X GET \
--cacert [ca-cert] \
--cert [client-cert] \
--cert-type [type] \
-H "Accept: application/json" \
https://[domain]:[port]/api/v2/connectors/ef092b12-e181-4734-8e34-73152612a945
#https://[domain]:[port]/api/v2/connectors/{uuid}
Register Connector using the Web Interface
Follow these steps for register new Network Discovery Provider.
- Log in to the Administration Interface
https://[domain]:[port]/administrator - Click Connectors in the left menu
- Click Create (plus symbol ) to open Create Connector
- Fill in the columns with the attributes:
- URL:
http://network-discovery-provider-service:8080 - Authentication Type:
None
- URL:
- Click Connect
Now you can see the details of the connected Connector under Connection Detected. The v2 tab is selected and lists the interfaces the Connector implements, including discovery at version v2. Select the v1 tab instead to register it as v1.
- Fill in the
Connectorname:Network Discovery Provider - Click Create to make the
Connectoravailable to other components
You have registered Network Discovery Provider Connector.