diff --git a/content/en/docs/services/device-provisioning-service/client-library.md b/content/en/docs/services/device-provisioning-service/client-library.md index d7cd53bb..46cf347a 100644 --- a/content/en/docs/services/device-provisioning-service/client-library.md +++ b/content/en/docs/services/device-provisioning-service/client-library.md @@ -155,7 +155,7 @@ The resource type of the DPS configuration resource is `x.plgd.dps.conf` and the | Property Title | Property Name | Type | Access Mode | Mandatory | Description | | -------------- | ------------- | -----| ----------- | --------- | ----------- | | Endpoint | endpoint | string | RW | No | Selected device provisioning server endpoint in format `coaps+tcp://{domain}:{port}` | -| Endpoint name | endpointName | string | RW | No | Name associated with the selected device provisioning server endpoint (currently unused) | +| Endpoint name | endpointName | string | RW | No | Name associated with the selected device provisioning server endpoint (currently unused by DPS). | | Endpoints | endpoints | array of objects | RW | No | Array of device provisioning server endpoints. Each item is a pair of (`uri`, `name`) values, where `uri` is the endpoint address in the format `coaps+tcp://{domain}:{port}` and `name` is a string name associated with the endpoint. (Note: the property is generated only if there are at least 2 endpoints set) | | Last error code | lastErrorCode | string | R | No | Provides last error code when provision status is in `failed` state (see list below for possible values). | | Force reprovision | forceReprovision | bool | RW | No | Connect to dps service and reprovision time, owner, cloud configuration, credentials and acls. | diff --git a/content/en/docs/services/device-provisioning-service/features.md b/content/en/docs/services/device-provisioning-service/features.md index d6bd082e..71f7254a 100644 --- a/content/en/docs/services/device-provisioning-service/features.md +++ b/content/en/docs/services/device-provisioning-service/features.md @@ -23,3 +23,4 @@ weight: 2 - **☐ Initial device configuration:** This planned feature aims to provide users with a mechanism to perform the initial configuration of devices during the provisioning process. - **☐ Blacklisting and whitelisting devices:** With this feature, users will have the ability to blacklist or whitelist specific devices for enhanced access control. - **☐ Manual approval for device configuration:** This planned feature enables a mechanism where devices require manual approval from the user in order to receive configuration settings. Instead of automatic configuration, users will have control over granting permission for device configuration. +- **☐ Verify Common Name:** Verify that the Common Name of DPS endpoint certificate matches the name of the selected endpoint. diff --git a/content/en/docs/services/device-provisioning-service/static/retry-mechanism.drawio.svg b/content/en/docs/services/device-provisioning-service/static/retry-mechanism.drawio.svg index 090eabd9..c2c9b275 100755 --- a/content/en/docs/services/device-provisioning-service/static/retry-mechanism.drawio.svg +++ b/content/en/docs/services/device-provisioning-service/static/retry-mechanism.drawio.svg @@ -1,885 +1,4 @@ - - - - - - - - - - - - - - -
-
-
- connect -
- to DPS -
-
-
-
- - connect... - -
-
- - - - -
-
-
- DPS manager initialized -
-
-
-
-
- - DPS manager initialized - -
-
- - - - - -
-
-
- disconnect from DPS and -
- start cloud manager -
-
-
-
- - disconnect from DPS and... - -
-
- - - - -
-
-
- Stored -
- cloud configuration -
-
-
-
- - Stored... - -
-
- - - - - -
-
-
- process received -
- certificates -
-
-
-
- - process received... - -
-
- - - - - -
-
-
- retry on transient -
- error or timeout -
-
-
-
- - retry on transient... - -
-
- - - - - -
-
-
- reprovision on -
- error -
-
-
-
- - reprovision on... - -
-
- - - - -
-
-
- Requesting certificates -
-
-
-
- - Requesting certificates - -
-
- - - - - -
-
-
- process received -
- cloud configuration -
-
-
-
- - process received... - -
-
- - - - - -
-
-
- - retry on transient - -
- - error or timeout - -
-
-
-
- - retry on transient... - -
-
- - - - - -
-
-
- reprovision on -
- error -
-
-
-
- - reprovision on... - -
-
- - - - -
-
-
- Requesting -
- cloud configuration -
-
-
-
- - Requesting... - -
-
- - - - - -
-
-
- schedule certificate -
- renewal -
-
-
-
- - schedule certificate... - -
-
- - - - - -
-
-
- request ACLs -
- from DPS -
-
-
-
- - request ACLs... - -
-
- - - - -
-
-
- Stored - - certificates - -
-
-
-
- - Stored certificates - -
-
- - - - - -
-
-
- process received -
- ACLs -
-
-
-
- - process received... - -
-
- - - - - -
-
-
- - retry on transient - -
- - error or timeout - -
-
-
-
- - retry on transient... - -
-
- - - - - -
-
-
- reprovision on -
- error -
-
-
-
- - reprovision on... - -
-
- - - - -
-
-
- Requesting ACLs -
-
-
-
- - Requesting ACLs - -
-
- - - - - -
-
-
- request cloud -
- configuration from DPS -
-
-
-
- - request cloud... - -
-
- - - - -
-
-
- Stored ACLs -
-
-
-
- - Stored ACLs - -
-
- - - - - - -
-
-
- Cloud manager -
- started -
-
-
-
- - Cloud manager... - -
-
- - - - - - -
-
-
- Monitoring -
- certificates -
-
-
-
- - Monitoring... - -
-
- - - - - -
-
-
- yes -
-
-
-
- - yes - -
-
- - - - - -
-
-
- no -
-
-
-
- - no - -
-
- - - - -
-
-
- Are certificates valid? -
-
-
-
- - Are certifica... - -
-
- - - - - -
-
-
- yes -
-
-
-
- - yes - -
-
- - - - - -
-
-
- no -
-
-
-
- - no - -
-
- - - - -
-
-
- Did device -
- sign in -
- to cloud? -
-
-
-
- - Did device... - -
-
- - - - - - - - -
-
-
- Cloud connected -
- and authorized -
-
-
-
- - Cloud connected... - -
-
- - - - - - - -
-
-
- reprovision -
-
-
-
- - reprovision - -
-
- - - - -
-
-
- Cloud disconnected -
- and unauthorized -
-
-
-
- - Cloud disconnected... - -
-
- - - - - -
-
-
- request certificates -
- from DPS -
-
-
-
- - request certificates... - -
-
- - - - - -
-
-
- request owner -
- from DPS -
-
-
-
- - request owner... - -
-
- - - - -
-
-
- DPS connected -
-
-
-
- - DPS connected - -
-
- - - - - -
-
-
- no -
-
-
-
- - no - -
-
- - - - - -
-
-
- yes -
-
-
-
- - yes - -
-
- - - - -
-
-
- Are certificates expired? -
-
-
-
- - Are certifica... - -
-
- - - - - -
-
-
- no -
-
-
-
- - no - -
-
- - - - - -
-
-
- yes -
-
-
-
- - yes - -
-
- - - - -
-
-
- Was cloud connection irrevocably -
- lost? -
-
-
-
- - Was cloud connec... - -
-
- - - - -
-
-
- Owned device -
-
-
-
- - Owned device - -
-
- - - - - -
-
-
- own device -
-
-
-
- - own device - -
-
- - - - -
-
-
- Requesting owner -
-
-
-
- - Requesting owner - -
-
- - - - - -
-
-
- retry on transient -
- error or timeout -
-
-
-
- - retry on transient... - -
-
-
- - - - - Text is not SVG - cannot display - - - -
\ No newline at end of file + + + +
connect
to DPS
DPS manager initialized
DPS connected
Requesting time
request time
from DPS
Device time synchronized
set time
Requesting owner
request owner
from DPS
Owned device
own device
Requesting certificates
Are certificates valid?
Stored certificates
yes
Monitoring
certificates
no
Are
certificates expired?
yes
Requesting
cloud configuration
Stored
cloud configuration
reprovision on
error
reprovision on
error
Requesting ACLs
Stored ACLs
Cloud manager
started
reprovision on
error
Did device
sign in
to cloud?
Cloud connected
and authorized 
Cloud disconnected
and unauthorized
Was cloud connection irrevocably
lost?
no
reprovision
yes
retry on transient
error or timeout
reprovision on
error
no
request cloud
configuration from DPS
process received
cloud configuration
retry on transient
error or timeout
retry on transient
error or timeout
request certificates
from DPS
process received
certificates
retry on transient
error or timeout
schedule certificate
renewal
request ACLs 
from DPS
process received
ACLs
no
retry on transient
error or timeout
disconnect from DPS
and start cloud 
manager
\ No newline at end of file