Release 3.34.2 documentation (#1455)

TheThingsBot · happyRip · vlasebian · commit 7a67ec55a5f1 · 2025-09-09T13:32:27.000+03:00
* docs: Release 3.34.2

* doc: Update the `featured` section

---------

Co-authored-by: Aleksander Borowski &lt;aleksander.borowski@thethingsindustries.com&gt;
diff --git a/doc/config/_default/config.toml b/doc/config/_default/config.toml
@@ -23,7 +23,7 @@ pygmentsUseClasses = true
   github_repository = "https://github.com/TheThingsIndustries/lorawan-stack-docs"
   github_repository_edit = "https://github.com/TheThingsIndustries/lorawan-stack-docs/blob/master/doc/content"
   tts_github_repository = "https://github.com/TheThingsNetwork/lorawan-stack"
-  version = "3.34.1"
+  version = "3.34.2"
 
 [markup]
   [markup.goldmark]
diff --git a/doc/content/enterprise/aws/ecs/changelog/index.md b/doc/content/enterprise/aws/ecs/changelog/index.md
@@ -8,6 +8,8 @@ All meaningful changes to templates are documented in this file.
 
 ## Unreleased
 
+## 3.34.2
+
 ## 3.34.1
 
 - Resolve issues with certificate renewal in the certbot scheduled task to ensure proper execution.
diff --git a/doc/content/ttn-lw-cli/ttn-lw-cli_authentication-providers_create.md b/doc/content/ttn-lw-cli/ttn-lw-cli_authentication-providers_create.md
@@ -14,14 +14,15 @@ ttn-lw-cli authentication-providers create [provider-id] [flags]
 ### Options
 
 ```
-      --allow-registrations                                
-      --allowed-email-domains strings                      
-      --configuration.provider.oidc.client-id string       
-      --configuration.provider.oidc.client-secret string   
-      --configuration.provider.oidc.provider-url string    
-  -h, --help                                               help for create
-      --name string                                        
-      --provider-id string                                 
+      --allow-registrations                                          
+      --allowed-email-domains strings                                
+      --configuration.provider.oidc.client-id string                 
+      --configuration.provider.oidc.client-secret string             
+      --configuration.provider.oidc.preferred-response-type string   
+      --configuration.provider.oidc.provider-url string              
+  -h, --help                                                         help for create
+      --name string                                                  
+      --provider-id string                                           
 ```
 
 ### Options inherited from parent commands
diff --git a/doc/content/ttn-lw-cli/ttn-lw-cli_authentication-providers_get.md b/doc/content/ttn-lw-cli/ttn-lw-cli_authentication-providers_get.md
@@ -14,16 +14,17 @@ ttn-lw-cli authentication-providers get [provider-id] [flags]
 ### Options
 
 ```
-      --allow-registrations                         select the allow_registrations field
-      --allowed-email-domains                       select the allowed_email_domains field
-      --configuration                               select the configuration field and all allowed sub-fields
-      --configuration.provider.oidc                 select the configuration.provider.oidc field and all allowed sub-fields
-      --configuration.provider.oidc.client-id       select the configuration.provider.oidc.client_id field
-      --configuration.provider.oidc.client-secret   select the configuration.provider.oidc.client_secret field
-      --configuration.provider.oidc.provider-url    select the configuration.provider.oidc.provider_url field
-  -h, --help                                        help for get
-      --name                                        select the name field
-      --provider-id string                          
+      --allow-registrations                                   select the allow_registrations field
+      --allowed-email-domains                                 select the allowed_email_domains field
+      --configuration                                         select the configuration field and all allowed sub-fields
+      --configuration.provider.oidc                           select the configuration.provider.oidc field and all allowed sub-fields
+      --configuration.provider.oidc.client-id                 select the configuration.provider.oidc.client_id field
+      --configuration.provider.oidc.client-secret             select the configuration.provider.oidc.client_secret field
+      --configuration.provider.oidc.preferred-response-type   select the configuration.provider.oidc.preferred_response_type field
+      --configuration.provider.oidc.provider-url              select the configuration.provider.oidc.provider_url field
+  -h, --help                                                  help for get
+      --name                                                  select the name field
+      --provider-id string                                    
 ```
 
 ### Options inherited from parent commands
diff --git a/doc/content/ttn-lw-cli/ttn-lw-cli_authentication-providers_list.md b/doc/content/ttn-lw-cli/ttn-lw-cli_authentication-providers_list.md
@@ -14,18 +14,19 @@ ttn-lw-cli authentication-providers list [flags]
 ### Options
 
 ```
-      --allow-registrations                         select the allow_registrations field
-      --allowed-email-domains                       select the allowed_email_domains field
-      --configuration                               select the configuration field and all allowed sub-fields
-      --configuration.provider.oidc                 select the configuration.provider.oidc field and all allowed sub-fields
-      --configuration.provider.oidc.client-id       select the configuration.provider.oidc.client_id field
-      --configuration.provider.oidc.client-secret   select the configuration.provider.oidc.client_secret field
-      --configuration.provider.oidc.provider-url    select the configuration.provider.oidc.provider_url field
-  -h, --help                                        help for list
-      --limit uint32                                maximum number of results to get (default 50)
-      --name                                        select the name field
-      --order string                                order by this field
-      --page uint32                                 results page number (default 1)
+      --allow-registrations                                   select the allow_registrations field
+      --allowed-email-domains                                 select the allowed_email_domains field
+      --configuration                                         select the configuration field and all allowed sub-fields
+      --configuration.provider.oidc                           select the configuration.provider.oidc field and all allowed sub-fields
+      --configuration.provider.oidc.client-id                 select the configuration.provider.oidc.client_id field
+      --configuration.provider.oidc.client-secret             select the configuration.provider.oidc.client_secret field
+      --configuration.provider.oidc.preferred-response-type   select the configuration.provider.oidc.preferred_response_type field
+      --configuration.provider.oidc.provider-url              select the configuration.provider.oidc.provider_url field
+  -h, --help                                                  help for list
+      --limit uint32                                          maximum number of results to get (default 50)
+      --name                                                  select the name field
+      --order string                                          order by this field
+      --page uint32                                           results page number (default 1)
 ```
 
 ### Options inherited from parent commands
diff --git a/doc/content/ttn-lw-cli/ttn-lw-cli_authentication-providers_update.md b/doc/content/ttn-lw-cli/ttn-lw-cli_authentication-providers_update.md
@@ -14,15 +14,16 @@ ttn-lw-cli authentication-providers update [provider-id] [flags]
 ### Options
 
 ```
-      --allow-registrations                                
-      --allowed-email-domains strings                      
-      --configuration.provider.oidc.client-id string       
-      --configuration.provider.oidc.client-secret string   
-      --configuration.provider.oidc.provider-url string    
-  -h, --help                                               help for update
-      --name string                                        
-      --provider-id string                                 
-      --unset strings                                      list of fields to unset
+      --allow-registrations                                          
+      --allowed-email-domains strings                                
+      --configuration.provider.oidc.client-id string                 
+      --configuration.provider.oidc.client-secret string             
+      --configuration.provider.oidc.preferred-response-type string   
+      --configuration.provider.oidc.provider-url string              
+  -h, --help                                                         help for update
+      --name string                                                  
+      --provider-id string                                           
+      --unset strings                                                list of fields to unset
 ```
 
 ### Options inherited from parent commands
diff --git a/doc/content/ttn-lw-cli/ttn-lw-cli_end-devices_list-bands.md b/doc/content/ttn-lw-cli/ttn-lw-cli_end-devices_list-bands.md
@@ -15,6 +15,7 @@ ttn-lw-cli end-devices list-bands [flags]
 
 ```
       --band-id string       
+      --custom-bands         
   -h, --help                 help for list-bands
       --phy-version string   allowed values: PHY_UNKNOWN, unknown, 1.0, 1.0.0, PHY_V1_0, TS001_V1_0, V1_0, 1.0.1, PHY_V1_0_1, TS001_V1_0_1, V1_0_1, 1.0.2, 1.0.2-a, PHY_V1_0_2_REV_A, RP001_V1_0_2, V1_0_2, V1_0_2_REV_A, 1.0.2-b, PHY_V1_0_2_REV_B, RP001_V1_0_2_REV_B, V1_0_2_REV_B, 1.1-a, 1.1.0-a, PHY_V1_1_REV_A, RP001_V1_1_REV_A, V1_1_REV_A, 1.1-b, 1.1.0-b, PHY_V1_1_REV_B, RP001_V1_1_REV_B, V1_1_REV_B, 1.0.3-a, PHY_V1_0_3_REV_A, RP001_V1_0_3_REV_A, V1_0_3_REV_A, RP002_V1_0_0, RP002_V1_0_1, RP002_V1_0_2, RP002_V1_0_3, RP002_V1_0_4
 ```
diff --git a/doc/content/ttn-lw-cli/ttn-lw-cli_end-devices_list-phy-versions.md b/doc/content/ttn-lw-cli/ttn-lw-cli_end-devices_list-phy-versions.md
@@ -15,6 +15,7 @@ ttn-lw-cli end-devices list-phy-versions [flags]
 
 ```
       --band-id string   
+      --custom-bands     
   -h, --help             help for list-phy-versions
 ```
 
diff --git a/doc/content/whats-new/3.34.2.md b/doc/content/whats-new/3.34.2.md
@@ -0,0 +1,46 @@
+---
+date: 2025-08-04T11:10:12Z
+title: "3.34.2"
+featured:
+  {
+    added:
+      [
+        Support to associate/disassociate MAC settings profiles to batch of end devices,
+        Show normalized payload in the Console,
+        "Introduced a backoff mechanism to the CLI device import process, allowing imports to exceed the default rate limit",
+        Support for selecting the preferred `response_type` used with the configured authentication provider,
+      ],
+    changed: [Improve error messages when claiming a managed gateway],
+    fixed:
+      [
+        Network Operations Center no longer returns zero in the `x-total-count` header,
+        Improve query performance of label related requests envolving end devices,
+        Searching users in User management in the Console,
+        CLI no longer causes a panic when running from a docker container in a Linux machine,
+      ],
+  }
+---
+
+### Added
+
+- Support to associate/disassociate MAC settings profiles to batch of end devices
+  - This feature is experimental and subject to change.
+- Show normalized payload in the Console.
+- New modal in the gateway overview page for simplifying creation of API keys in the Console.
+- Introduced a backoff mechanism to the CLI device import process, allowing imports to exceed the default rate limit.
+- Added support for selecting the preferred `response_type` used with the configured authentication provider.
+  - Configure this via the `--oidc.preferred-response-type` flag in the create-auth-provider tti-lw-stack command.
+  - If unset, the default is either `code id_token` or `code`, depending on provider compatibility.
+
+### Changed
+
+- Improve error messages when claiming a managed gateway.
+
+### Fixed
+
+- Network Operations Center no longer returns zero in the `x-total-count` header.
+  - This previously only happened in gateway traffic rates query.
+- Improve query performance of label related requests envolving end devices.
+  - This previously caused timeouts if the number of end-devices using labels was too large.
+- Fixed searching users in User management in the Console.
+- CLI no longer causes a panic when running from a docker container in a Linux machine.
diff --git a/doc/data/api/tti.lorawan.v3/messages/AuthenticationProvider.OIDC.yml b/doc/data/api/tti.lorawan.v3/messages/AuthenticationProvider.OIDC.yml
@@ -11,3 +11,17 @@ fields:
   rules:
     uri: true
   default: ""
+- name: preferred_response_type
+  type: string
+  rules:
+    in:
+    - ""
+    - code
+    - token
+    - id_token
+    - code token
+    - code id_token
+    - id_token code
+    - id_token token
+    - code id_token token
+  default: ""
diff --git a/doc/data/api/tti.lorawan.v3/messages/Label.yml b/doc/data/api/tti.lorawan.v3/messages/Label.yml
@@ -23,7 +23,9 @@ fields:
 - name: name
   type: string
   rules:
-    max_len: 50
+    min_len: 3
+    max_len: 36
+    pattern: '^[a-zA-Z0-9]+(?: [a-zA-Z0-9\-]+)?$'
   default: ""
 - name: description
   type: string
diff --git a/doc/data/api/ttn.lorawan.v3/messages/BatchSetMACSettingsProfileRequest.yml b/doc/data/api/ttn.lorawan.v3/messages/BatchSetMACSettingsProfileRequest.yml
@@ -0,0 +1,22 @@
+name: BatchSetMACSettingsProfileRequest
+fields:
+- name: application_ids
+  message:
+    name: ApplicationIdentifiers
+  rules:
+    required: true
+  default: {}
+- name: mac_settings_profile_ids
+  message:
+    name: MACSettingsProfileIdentifiers
+  default: {}
+- name: device_ids
+  rules:
+    min_items: 1
+    max_items: 20
+  repeated:
+    type: string
+    rules:
+      max_len: 36
+      pattern: ^[a-z0-9](?:[-]?[a-z0-9]){2,}$
+  default: []
diff --git a/doc/data/api/ttn.lorawan.v3/messages/GetPhyVersionsRequest.yml b/doc/data/api/ttn.lorawan.v3/messages/GetPhyVersionsRequest.yml
@@ -6,3 +6,7 @@ fields:
     If unused, all supported Bands and their versions are returned.
   type: string
   default: ""
+- name: custom_bands
+  comment: Optional field to include custom bands too.
+  type: bool
+  default: false
diff --git a/doc/data/api/ttn.lorawan.v3/messages/ListBandsRequest.yml b/doc/data/api/ttn.lorawan.v3/messages/ListBandsRequest.yml
@@ -15,3 +15,7 @@ fields:
   rules:
     defined_only: true
   default: PHY_UNKNOWN
+- name: custom_bands
+  comment: Optional field to include custom bands too.
+  type: bool
+  default: false
diff --git a/doc/data/api/ttn.lorawan.v3/services/NsEndDeviceBatchRegistry.yml b/doc/data/api/ttn.lorawan.v3/services/NsEndDeviceBatchRegistry.yml
@@ -16,3 +16,13 @@ methods:
     http:
     - method: DELETE
       path: /ns/applications/{application_ids.application_id}/devices/batch
+  SetMACSettingsProfile:
+    name: SetMACSettingsProfile
+    comment: Set the MAC settings profile for a batch of end devices.
+    input:
+      name: BatchSetMACSettingsProfileRequest
+    output:
+      name: EndDevices
+    http:
+    - method: POST
+      path: /ns/applications/{application_ids.application_id}/devices/mac_settings_profile/batch
diff --git a/doc/data/api/tts.swagger.json b/doc/data/api/tts.swagger.json
