Skip to contentSkip to conversation

RFC: Support full profile sharing via DPP 3rd party attributes

PATCH In review James Prestwood 2 participants 3 messages Nov 13, 2023 – Nov 16, 2023

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 RFC: Support full profile sharing via DPP 3rd party attributes

If an IWD profile contains network-specific settings which are required to utilize the network correctly configuring via DPP will not carry over those settings to the enrollee. The DPP configuration object only contains the SSID/PSK to connect and anything else set in the configurators profile is not included.

This is likely something that the majority of users will not need (most networks don't need additional settings) but if the network does it would be convenient for the configurator to send over its exact configuration to the enrollee. This is useful for an automated use case where a configuration should be consistent across all devices.

DPP allows for arbitrary 3rd party attributes in the configuration object (section 4.5.2) which can be used to communicate additional settings.

The plan is to define a new object within the overall configuration object who's keys are IWD profile groups and values are objects containing settings for those groups:

{
"ssid": "my_ssid",
... main configuration object ...

... The IWD profile, converted to JSON ...

  "/net/connman/iwd": {
    "Network": {
      "MutlicastDNS": "true"
    },
    "IPv4": {
      "SendHostname": "true"
    },
    ... etc ...

}
}

The "/net/connman/iwd" object could then be parsed by the enrollee (potentially if the feature is enable in main.conf?) and set to the profile as it is now with the passphrase/psk.

Several profile values don't apply here like MAC/IP address overrides. Mainly the settings that do matter would be:

[IPv4].SendHostname
[Network].MulticastDNS
[Settings] (most values here, except AddressOverride)

The other IPv4/v6 settings likely aren't useful since they pertain mostly to static configurations and are obtained from DHCP. The [Security] group would be omitted entirely since its already set by the main configuration and contains generated values like SAE-PT-Group's.

---
 src/iwd.network.rst | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)
src/iwd.network.rst +19 -0
index 719853fa..8f4e54f9 100644
@@ -440,6 +440,25 @@ network configuration.
        value obtained from the DHCPv6 server or via Router Advertisements.
 
 
+The group ``[DeviceProvisioning]`` contains settings for device provisioning
+credential sharing.
+
+.. list-table::
+   :header-rows: 0
+   :stub-columns: 0
+   :widths: 20 80
+   :align: left
+
+   * - ShareFullConfig
+     - Values: true, **false**
+
+       When configuring an enrollee, include all additional network profile
+       settings except those that are device specific (e.g. MAC/IP address
+       overrides). This uses 3rd party attributes in the DPP configuration
+       response and will only be compatible with IWD-based enrollees that can
+       parse those attributes.
+
+
 Embedded PEMs
 -------------
 
Signature · 1 line
2.25.1
#1 lore raw

Hi James,

Quoted 37 lines · James Prestwood

If an IWD profile contains network-specific settings which are required to utilize the network correctly configuring via DPP will not carry over those settings to the enrollee. The DPP configuration object only contains the SSID/PSK to connect and anything else set in the configurators profile is not included.

This is likely something that the majority of users will not need (most networks don't need additional settings) but if the network does it would be convenient for the configurator to send over its exact configuration to the enrollee. This is useful for an automated use case where a configuration should be consistent across all devices.

DPP allows for arbitrary 3rd party attributes in the configuration object (section 4.5.2) which can be used to communicate additional settings.

The plan is to define a new object within the overall configuration object who's keys are IWD profile groups and values are objects containing settings for those groups:

{
   "ssid": "my_ssid",
   ... main configuration object ...

   ... The IWD profile, converted to JSON ...
   "/net/connman/iwd": {
     "Network": {
       "MutlicastDNS": "true"
     },
     "IPv4": {
       "SendHostname": "true"
     },
     ... etc ...
   }
}
Quoted 8 lines

The "/net/connman/iwd" object could then be parsed by the enrollee (potentially if the feature is enable in main.conf?) and set to the profile as it is now with the passphrase/psk.

Several profile values don't apply here like MAC/IP address overrides. Mainly the settings that do matter would be:

[IPv4].SendHostname

Yeah I can see this one since this might be a network-wide DHCP server quirk...

Quoted 1 line

[Network].MulticastDNS

But why would you want this one?

Quoted 1 line

[Settings] (most values here, except AddressOverride)

What settings do you want from here besides Hidden? Transition disable settings would be automagically restored as soon as the transition network is connected to.

You may want to drop the IPv4/Network hierarchy and make these more generic.

Regards,
-Denis

#2 lore raw

Hi Denis,

Quoted 44 lines · Denis Kenzior

Hi James,

Quoted 41 lines · James Prestwood

If an IWD profile contains network-specific settings which are required to utilize the network correctly configuring via DPP will not carry over those settings to the enrollee. The DPP configuration object only contains the SSID/PSK to connect and anything else set in the configurators profile is not included.

This is likely something that the majority of users will not need (most networks don't need additional settings) but if the network does it would be convenient for the configurator to send over its exact configuration to the enrollee. This is useful for an automated use case where a configuration should be consistent across all devices.

DPP allows for arbitrary 3rd party attributes in the configuration object (section 4.5.2) which can be used to communicate additional settings.

The plan is to define a new object within the overall configuration object who's keys are IWD profile groups and values are objects containing settings for those groups:

{
   "ssid": "my_ssid",
   ... main configuration object ...

   ... The IWD profile, converted to JSON ...
   "/net/connman/iwd": {
     "Network": {
       "MutlicastDNS": "true"
     },
     "IPv4": {
       "SendHostname": "true"
     },
     ... etc ...
   }
}

The "/net/connman/iwd" object could then be parsed by the enrollee (potentially if the feature is enable in main.conf?) and set to the profile as it is now with the passphrase/psk.

Quoted 6 lines
Quoted 4 lines

Several profile values don't apply here like MAC/IP address overrides. Mainly the settings that do matter would be:

[IPv4].SendHostname

Yeah I can see this one since this might be a network-wide DHCP server quirk...

To be completely honest SendHostname is all I actually needed. I was trying to make it more generic and allow any setting but it certainly simplifies the implementation if we just pick individual settings we want.

Thanks,

James