Skip to content
GitLab
Explore
Sign in
Primary navigation
Search or go to…
Project
M
map-agent
Manage
Activity
Members
Labels
Plan
Issues
Issue boards
Milestones
Wiki
Code
Merge requests
Repository
Branches
Commits
Tags
Repository graph
Compare revisions
Snippets
Build
Pipelines
Jobs
Pipeline schedules
Artifacts
Deploy
Releases
Container registry
Model registry
Operate
Environments
Monitor
Incidents
Analyze
Value stream analytics
Contributor analytics
CI/CD analytics
Repository analytics
Issue analytics
Model experiments
Help
Help
Support
GitLab documentation
Compare GitLab plans
Community forum
Contribute to GitLab
Provide feedback
Terms and privacy
Keyboard shortcuts
?
Snippets
Groups
Projects
Show more breadcrumbs
Multi-AP
map-agent
Commits
6b1347b3
Commit
6b1347b3
authored
2 years ago
by
Jakob Olsson
Browse files
Options
Downloads
Patches
Plain Diff
dpp: update README and other docs
parent
3c8dad94
Branches
Branches containing commit
No related tags found
1 merge request
!379
Dpp cleanup
Pipeline
#99184
passed
2 years ago
Stage: static_code_analysis
Stage: compile_test
Changes
3
Pipelines
2
Expand all
Hide whitespace changes
Inline
Side-by-side
Showing
3 changed files
README.md
+100
-2
100 additions, 2 deletions
README.md
docs/api/mapagent.md
+1
-1
1 addition, 1 deletion
docs/api/mapagent.md
schemas/uci/mapagent.json
+49
-0
49 additions, 0 deletions
schemas/uci/mapagent.json
with
150 additions
and
3 deletions
README.md
+
100
−
2
View file @
6b1347b3
...
...
@@ -1217,6 +1217,100 @@ For guest-to-guest isolation see [here](./docs/README-Traffic_Separation.md#wi-f
For layer 3 setup guide see
[
here
](
./docs/layer3_ts.md
)
.
## DPP Easy Connect
To enable URI generation and DPP chirping map-agent must have
`dpp_uri`
UCI
configuration sections provided.
```
config dpp_uri
option device 'wl1'
option band '2'
option ifname 'wl1'
list chan '81/1'
option type 'qrcode'
option chirp_interval '10'
config dpp_uri
option device 'wl0'
option band '5'
option ifname 'wl0'
list chan '128/36'
option type 'qrcode'
option chirp_interval '10'
```
Map-agent will accordingly generate URIs for the respective bands and start
chirping.
The URI's can be retreived from the UBUS API
`ubus call map.agent dpp_enrollee_uri`
:
```
root@eagle-44d43771bb20:~# ubus call map.agent dpp_enrollee_uri
{
"enrollees": [
{
"ifname": "wl0",
"band": 2,
"device": "wl0",
"uri": "DPP:C:128/36;M:44d43771bb2f;V:2;K:MDkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDIgAD/ebYNHPhud+3C/t47dLffnPCzKAI3RYsr7z0zz5pSHQ=;;",
"type": "qrcode",
"chirp_interval": 10,
"num_chan": 1,
"chan": [
{
"channel": 36,
"opclass": 128,
"freq": 0
}
]
},
{
"ifname": "wl1",
"band": 1,
"device": "wl1",
"uri": "DPP:C:81/1;M:44d43771bb2e;V:2;K:MDkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDIgAD5ANLCEXDDO7vnLVgSDoiJJ5H2Mo7aPXVriSVZ0ygP7M=;;",
"type": "qrcode",
"chirp_interval": 10,
"num_chan": 1,
"chan": [
{
"channel": 1,
"opclass": 81,
"freq": 0
}
]
}
]
}
```
Once DPP onboarding is complete, credentials are provided as ubus events that
are picked up by map-agent and written to its configuration and used for future
connections.
```
{ "wifi.bsta": {"ifname":"wl1","event":"dpp-confobj-akm","data":"sae"} }
{ "wifi.bsta": {"ifname":"wl1","event":"dpp-confobj-ssid","data":"MAP-44D43771BF50-BH-2.4GHz"} }
{ "wifi.bsta": {"ifname":"wl1","event":"dpp-connector","data":"eyJ0eXAiOiJkcHBDb24iLCJraWQiOiI4MUNrdEdFNW5qTXBRSVJaUFVRT2M2dUNzZDd0MUd0ZHc5bGFFaHlETU5RIiwiYWxnIjoiRVMyNTYifQ.eyJncm91cHMiOlt7Imdyb3VwSWQiOiIqIiwibmV0Um9sZSI6Im1hcEFnZW50In1dLCJuZXRBY2Nlc3NLZXkiOnsia3R5IjoiRUMiLCJjcnYiOiJQLTI1NiIsIngiOiJNN1BOaG5xZnZRNzlJQl9vRXpXcGx6dldKXzJVR3l5SUxhSjVWYWdaUGlzIiwieSI6IkJrM0d6ZXkyQU5XWXdNOThZdGZIeUdVR2ZYR2NqZU9hUzRTYk50bXFrRWsifX0.1V96nYzO2TAl8CSEI7AwQE9C2Wybf-zgnaZVifzIATbCcAaPEmMbxUqdlIT754PXwoCKgdN8iTeJL7Siw6GVtQ"} }
{ "wifi.bsta": {"ifname":"wl1","event":"dpp-confobj-pass","data":"313231356330393634303739386239346262303164656663653964656537376139396666386163366137643738313162366362653133626336653931653565"} }
{ "wifi.bsta": {"ifname":"wl1","event":"dpp-c-sign-key","data":"3039301306072a8648ce3d020106082a8648ce3d030107032200031ae7f42438e80a1b3a65df7855eb945125afe371182aa5f052a43859707089c9"} }
{ "wifi.bsta": {"ifname":"wl1","event":"dpp-net-access-key","data":"307702010104205b06ffdcfb8af6c7904731ec74c84a2789c0c37c86f111499451781ed99c1b66a00a06082a8648ce3d030107a1440342000433b3cd867a9fbd0efd201fe81335a9973bd627fd941b2c882da27955a8193e2b064dc6cdecb600d598c0cf7c62d7c7c865067d719c8de39a4b849b36d9aa9049"} }
```
Today, BSS Configuration Request, Response and Result are not implemented. Thus,
while it is possible to onboard and use dpp AKM, it is effectively not
supported due to the lack of possibility to set dpp as exclusive AKM on the bbss.
Additionally, this means legacy akms (i.e. sae, sae-mixed, psk2) will be the
preferred connection type used by map-agent.
NOTE: Currently,
`wpa_supplicant`
will prioritize scanning over chirping. This
means 5GHz is much less reliable as it will scan a larger number of channels and
DPP chirp may get aborted.
**
For this reason is strongly recommended to use
2.
4GHz for DPP onboarding.
**
## Misc
### Netdev Format
...
...
@@ -1274,8 +1368,8 @@ config agent 'agent'
## UBUS
```
root@
iopsys
-44d43771b
73
0:~# ubus -v list map.agent
'map.agent' @
1237706b
root@
eagle
-44d43771b
b2
0:~# ubus -v list map.agent
'map.agent' @
822ee9c6
"apconfig":{"band":"Integer"}
"steer_policy":{"vif":"String","rule":"String"}
"steer":{"vif":"String","type":"String","sta":"String","to_bss":"Array","optime":"Integer"}
...
...
@@ -1288,12 +1382,16 @@ root@iopsys-44d43771b730:~# ubus -v list map.agent
"higher_layer_data":{"agent":"String","protocol":"Integer","data":"String"}
"backhaul_info":{}
"status":{}
"nodes":{}
"info":{}
"assoc_notify":{"bss_status_list":"Array"}
"sync":{}
"timers":{}
"dynamic_backhaul_upgrade":{}
"backhaul_blacklist":{}
"bss_config_request":{}
"ec_key":{}
"dpp_enrollee_uri":{}
```
This diff is collapsed.
Click to expand it.
docs/api/mapagent.md
+
1
−
1
View file @
6b1347b3
This diff is collapsed.
Click to expand it.
schemas/uci/mapagent.json
+
49
−
0
View file @
6b1347b3
...
...
@@ -529,6 +529,55 @@
"description"
:
"Channels to which the preference applies"
}
]
},
{
"section"
:
"dpp_uri"
,
"required"
:
"no"
,
"description"
:
"Values necessary for proper DPP bootstrap URI generation and chirping"
,
"multi"
:
true
,
"options"
:
[{
"name"
:
"device"
,
"type"
:
"string"
,
"required"
:
"no"
,
"default"
:
""
,
"description"
:
"The radio of that of the corresponding interface that wpa_supplicant is running on."
},
{
"name"
:
"band"
,
"type"
:
"integer"
,
"required"
:
"yes"
,
"default"
:
"Unknown (0x10)"
,
"description"
:
"Band of the radio of the radio at which wpa_supplicant is running on."
},
{
"name"
:
"ifname"
,
"type"
:
"string"
,
"required"
:
"yes"
,
"default"
:
""
,
"description"
:
"Interface name of the backhaul station interface."
},
{
"name"
:
"chan"
,
"type"
:
"list"
,
"required"
:
"yes"
,
"default"
:
""
,
"description"
:
"Channel opclass pair provided in the format of '<channel>/<opclass> used for the DPP bootstrap URI."
},
{
"name"
:
"type"
,
"type"
:
"string"
,
"required"
:
"no"
,
"default"
:
"qrcode"
,
"description"
:
"Type of the URI (qrcode, pkex nfc). NOTE: Today only qrcode is supported."
},
{
"name"
:
"chirp_interval"
,
"type"
:
"integer"
,
"required"
:
"no"
,
"default"
:
"10"
,
"description"
:
"The interval at which to send DPP chirp messages."
}
]
}
]
}
\ No newline at end of file
This diff is collapsed.
Click to expand it.
Preview
0%
Loading
Try again
or
attach a new file
.
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Save comment
Cancel
Please
register
or
sign in
to comment