docs: Release v3.31.1

TheThingsIndustries · Aug 5, 2024 · 77d5fcc · 77d5fcc
1 parent 57e26d3
commit 77d5fcc
Show file tree

Hide file tree

Showing 27 changed files with 1,902 additions and 499 deletions.
diff --git a/doc/config/_default/config.toml b/doc/config/_default/config.toml
@@ -24,7 +24,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.30.2"
+  version = "3.31.1"
 
 [markup]
   [markup.goldmark]

diff --git a/doc/content/the-things-stack/host/aws/ecs/changelog/index.md b/doc/content/the-things-stack/host/aws/ecs/changelog/index.md
@@ -8,6 +8,16 @@ All meaningful changes to templates are documented in this file.
 
 ## Unreleased
 
+## 3.31.1
+
+### Proxy
+
+- Add `TenantAccess` grpc service and routes.
+
+## 3.31.0
+
+- Updated ECS AMIs to the latest versions.
+
 ## 3.30.2
 
 - TimescaleDB replicas are now split to a separate template. Previously replicas had an ephemeral disk that needed to be copied when the replica was re-deployed. This made some upgrades really long to complete. Now the replicas are standalone and have their own disk that can be reattached to a new instance. This change should make upgrades faster and more reliable.

diff --git a/doc/content/ttn-lw-cli/ttn-lw-cli_tenants_create.md b/doc/content/ttn-lw-cli/ttn-lw-cli_tenants_create.md
@@ -25,6 +25,7 @@ ttn-lw-cli tenants create [tenant-id] [flags]
       --billing.provider.stripe.subscription-item-id string                                             
       --configuration.default-cluster.ars.routing.enabled                                               
       --configuration.default-cluster.as.webhooks.queue.enabled                                         
+      --configuration.default-cluster.gs.mtls-authentication.client-ca-pool bytesBase64                 
       --configuration.default-cluster.is.admin-rights.all                                               
       --configuration.default-cluster.is.email.network.branding-base-url string                         
       --configuration.default-cluster.is.end-device-picture.disable-upload                              

diff --git a/doc/content/ttn-lw-cli/ttn-lw-cli_tenants_get.md b/doc/content/ttn-lw-cli/ttn-lw-cli_tenants_get.md
@@ -39,6 +39,9 @@ ttn-lw-cli tenants get [tenant-id] [flags]
       --configuration.default-cluster.as.webhooks                                                select the configuration.default_cluster.as.webhooks field and all allowed sub-fields
       --configuration.default-cluster.as.webhooks.queue                                          select the configuration.default_cluster.as.webhooks.queue field and all allowed sub-fields
       --configuration.default-cluster.as.webhooks.queue.enabled                                  select the configuration.default_cluster.as.webhooks.queue.enabled field
+      --configuration.default-cluster.gs                                                         select the configuration.default_cluster.gs field and all allowed sub-fields
+      --configuration.default-cluster.gs.mtls-authentication                                     select the configuration.default_cluster.gs.mtls_authentication field and all allowed sub-fields
+      --configuration.default-cluster.gs.mtls-authentication.client-ca-pool                      select the configuration.default_cluster.gs.mtls_authentication.client_ca_pool field
       --configuration.default-cluster.is                                                         select the configuration.default_cluster.is field and all allowed sub-fields
       --configuration.default-cluster.is.admin-rights                                            select the configuration.default_cluster.is.admin_rights field and all allowed sub-fields
       --configuration.default-cluster.is.admin-rights.all                                        select the configuration.default_cluster.is.admin_rights.all field

diff --git a/doc/content/ttn-lw-cli/ttn-lw-cli_tenants_list.md b/doc/content/ttn-lw-cli/ttn-lw-cli_tenants_list.md
@@ -39,6 +39,9 @@ ttn-lw-cli tenants list [flags]
       --configuration.default-cluster.as.webhooks                                                select the configuration.default_cluster.as.webhooks field and all allowed sub-fields
       --configuration.default-cluster.as.webhooks.queue                                          select the configuration.default_cluster.as.webhooks.queue field and all allowed sub-fields
       --configuration.default-cluster.as.webhooks.queue.enabled                                  select the configuration.default_cluster.as.webhooks.queue.enabled field
+      --configuration.default-cluster.gs                                                         select the configuration.default_cluster.gs field and all allowed sub-fields
+      --configuration.default-cluster.gs.mtls-authentication                                     select the configuration.default_cluster.gs.mtls_authentication field and all allowed sub-fields
+      --configuration.default-cluster.gs.mtls-authentication.client-ca-pool                      select the configuration.default_cluster.gs.mtls_authentication.client_ca_pool field
       --configuration.default-cluster.is                                                         select the configuration.default_cluster.is field and all allowed sub-fields
       --configuration.default-cluster.is.admin-rights                                            select the configuration.default_cluster.is.admin_rights field and all allowed sub-fields
       --configuration.default-cluster.is.admin-rights.all                                        select the configuration.default_cluster.is.admin_rights.all field

diff --git a/doc/content/ttn-lw-cli/ttn-lw-cli_tenants_search.md b/doc/content/ttn-lw-cli/ttn-lw-cli_tenants_search.md
@@ -40,6 +40,9 @@ ttn-lw-cli tenants search [flags]
       --configuration.default-cluster.as.webhooks                                                select the configuration.default_cluster.as.webhooks field and all allowed sub-fields
       --configuration.default-cluster.as.webhooks.queue                                          select the configuration.default_cluster.as.webhooks.queue field and all allowed sub-fields
       --configuration.default-cluster.as.webhooks.queue.enabled                                  select the configuration.default_cluster.as.webhooks.queue.enabled field
+      --configuration.default-cluster.gs                                                         select the configuration.default_cluster.gs field and all allowed sub-fields
+      --configuration.default-cluster.gs.mtls-authentication                                     select the configuration.default_cluster.gs.mtls_authentication field and all allowed sub-fields
+      --configuration.default-cluster.gs.mtls-authentication.client-ca-pool                      select the configuration.default_cluster.gs.mtls_authentication.client_ca_pool field
       --configuration.default-cluster.is                                                         select the configuration.default_cluster.is field and all allowed sub-fields
       --configuration.default-cluster.is.admin-rights                                            select the configuration.default_cluster.is.admin_rights field and all allowed sub-fields
       --configuration.default-cluster.is.admin-rights.all                                        select the configuration.default_cluster.is.admin_rights.all field

diff --git a/doc/content/ttn-lw-cli/ttn-lw-cli_tenants_update.md b/doc/content/ttn-lw-cli/ttn-lw-cli_tenants_update.md
@@ -25,6 +25,7 @@ ttn-lw-cli tenants update [tenant-id] [flags]
       --billing.provider.stripe.subscription-item-id string                                             
       --configuration.default-cluster.ars.routing.enabled                                               
       --configuration.default-cluster.as.webhooks.queue.enabled                                         
+      --configuration.default-cluster.gs.mtls-authentication.client-ca-pool bytesBase64                 
       --configuration.default-cluster.is.admin-rights.all                                               
       --configuration.default-cluster.is.email.network.branding-base-url string                         
       --configuration.default-cluster.is.end-device-picture.disable-upload                              

diff --git a/doc/content/whats-new/3.31.1.md b/doc/content/whats-new/3.31.1.md
@@ -0,0 +1,13 @@
+---
+date: 2024-08-05T09:19:00Z
+title: "3.31.1"
+featured: {
+  added: [],
+  changed: [],
+  fixed: []
+}
+---
+
+### Changed
+
+- Gateway ID and device ID are not autogenerated and prefilled anymore.
diff --git a/doc/data/api/tti.lorawan.v3/messages/ApplicationEventForwardCount.yml b/doc/data/api/tti.lorawan.v3/messages/ApplicationEventForwardCount.yml
@@ -0,0 +1,16 @@
+name: ApplicationEventForwardCount
+fields:
+- name: time
+  message:
+    package: google.protobuf
+    name: Timestamp
+  rules:
+    required: true
+  default: "0001-01-01T00:00:00Z"
+- name: count
+  comment: Application Server forwarded events count per event name.
+  map_key:
+    type: string
+  map_value:
+    type: uint64
+  default: {}
diff --git a/doc/data/api/tti.lorawan.v3/messages/ApplicationEventsForwardCount.yml b/doc/data/api/tti.lorawan.v3/messages/ApplicationEventsForwardCount.yml
@@ -0,0 +1,7 @@
+name: ApplicationEventsForwardCount
+fields:
+- name: event_forward_count
+  repeated:
+    message:
+      name: ApplicationEventForwardCount
+  default: []
diff --git a/doc/data/api/tti.lorawan.v3/messages/ApplicationWebhookFailureByStatusCodeCount.yml b/doc/data/api/tti.lorawan.v3/messages/ApplicationWebhookFailureByStatusCodeCount.yml
@@ -0,0 +1,15 @@
+name: ApplicationWebhookFailureByStatusCodeCount
+fields:
+- name: time
+  message:
+    package: google.protobuf
+    name: Timestamp
+  rules:
+    required: true
+  default: "0001-01-01T00:00:00Z"
+- name: totals
+  map_key:
+    type: uint32
+  map_value:
+    type: uint64
+  default: {}
diff --git a/doc/data/api/tti.lorawan.v3/messages/ApplicationWebhookFailureCount.yml b/doc/data/api/tti.lorawan.v3/messages/ApplicationWebhookFailureCount.yml
@@ -0,0 +1,12 @@
+name: ApplicationWebhookFailureCount
+fields:
+- name: time
+  message:
+    package: google.protobuf
+    name: Timestamp
+  rules:
+    required: true
+  default: "0001-01-01T00:00:00Z"
+- name: total
+  type: uint64
+  default: 0
diff --git a/doc/data/api/tti.lorawan.v3/messages/ApplicationWebhookFailureToForwardRatio.yml b/doc/data/api/tti.lorawan.v3/messages/ApplicationWebhookFailureToForwardRatio.yml
@@ -0,0 +1,5 @@
+name: ApplicationWebhookFailureToForwardRatio
+fields:
+- name: webhook_failure_to_forward_ratio
+  type: float
+  default: 0
diff --git a/doc/data/api/tti.lorawan.v3/messages/ApplicationWebhookFailuresByStatusCodeCount.yml b/doc/data/api/tti.lorawan.v3/messages/ApplicationWebhookFailuresByStatusCodeCount.yml
@@ -0,0 +1,7 @@
+name: ApplicationWebhookFailuresByStatusCodeCount
+fields:
+- name: counts
+  repeated:
+    message:
+      name: ApplicationWebhookFailureByStatusCodeCount
+  default: []
diff --git a/doc/data/api/tti.lorawan.v3/messages/ApplicationWebhookFailuresCount.yml b/doc/data/api/tti.lorawan.v3/messages/ApplicationWebhookFailuresCount.yml
@@ -0,0 +1,7 @@
+name: ApplicationWebhookFailuresCount
+fields:
+- name: webhook_failure
+  repeated:
+    message:
+      name: ApplicationWebhookFailureCount
+  default: []
diff --git a/...ta/api/tti.lorawan.v3/messages/Configuration.Cluster.GatewayServer.MTLSAuthentication.yml b/...ta/api/tti.lorawan.v3/messages/Configuration.Cluster.GatewayServer.MTLSAuthentication.yml
@@ -0,0 +1,7 @@
+name: Configuration.Cluster.GatewayServer.MTLSAuthentication
+fields:
+- name: client_ca_pool
+  comment: PEM encoded pool of X.509 root certificates to trust for verifying the
+    presented TLS client certificate.
+  type: bytes
+  default: ""
diff --git a/doc/data/api/tti.lorawan.v3/messages/Configuration.Cluster.GatewayServer.yml b/doc/data/api/tti.lorawan.v3/messages/Configuration.Cluster.GatewayServer.yml
@@ -0,0 +1,6 @@
+name: Configuration.Cluster.GatewayServer
+fields:
+- name: mtls_authentication
+  message:
+    name: Configuration.Cluster.GatewayServer.MTLSAuthentication
+  default: {}
diff --git a/doc/data/api/tti.lorawan.v3/messages/Configuration.Cluster.yml b/doc/data/api/tti.lorawan.v3/messages/Configuration.Cluster.yml
@@ -9,6 +9,11 @@ fields:
   message:
     name: Configuration.Cluster.IdentityServer
   default: {}
+- name: gs
+  comment: Gateway Server configuration.
+  message:
+    name: Configuration.Cluster.GatewayServer
+  default: {}
 - name: ns
   message:
     name: Configuration.Cluster.NetworkServer

diff --git a/doc/data/api/tti.lorawan.v3/messages/ResendAdminValidationRequest.yml b/doc/data/api/tti.lorawan.v3/messages/ResendAdminValidationRequest.yml
@@ -0,0 +1,8 @@
+name: ResendAdminValidationRequest
+fields:
+- name: tenant_ids
+  message:
+    name: TenantIdentifiers
+  rules:
+    required: true
+  default: {}
diff --git a/doc/data/api/tti.lorawan.v3/services/Noc.yml b/doc/data/api/tti.lorawan.v3/services/Noc.yml
@@ -201,6 +201,42 @@ methods:
     http:
     - method: POST
       path: /noc/application/{application_ids.application_id}/data_rates/packet-count
+  QueryApplicationEventForwardCount:
+    name: QueryApplicationEventForwardCount
+    input:
+      name: ApplicationTimeBucketQuery
+    output:
+      name: ApplicationEventsForwardCount
+    http:
+    - method: POST
+      path: /noc/application/{application_ids.application_id}/events/forward
+  QueryApplicationWebhookFailure:
+    name: QueryApplicationWebhookFailure
+    input:
+      name: ApplicationTimeBucketQuery
+    output:
+      name: ApplicationWebhookFailuresCount
+    http:
+    - method: POST
+      path: /noc/application/{application_ids.application_id}/events/webhook/failure
+  QueryApplicationWebhookFailureTopFive:
+    name: QueryApplicationWebhookFailureTopFive
+    input:
+      name: ApplicationTimeBucketQuery
+    output:
+      name: ApplicationWebhookFailuresByStatusCodeCount
+    http:
+    - method: POST
+      path: /noc/application/{application_ids.application_id}/events/webhook/failure/top-five
+  QueryApplicationWebhookFailureToForwardRatio:
+    name: QueryApplicationWebhookFailureToForwardRatio
+    input:
+      name: ApplicationTimeWindowQuery
+    output:
+      name: ApplicationWebhookFailureToForwardRatio
+    http:
+    - method: POST
+      path: /noc/application/{application_ids.application_id}/events/webhook/failure/ratio
   QueryEndDevicesActive:
     name: QueryEndDevicesActive
     input:

diff --git a/doc/data/api/tti.lorawan.v3/services/TenantAccess.yml b/doc/data/api/tti.lorawan.v3/services/TenantAccess.yml
@@ -0,0 +1,12 @@
+name: TenantAccess
+methods:
+  ResendAdminValidation:
+    name: ResendAdminValidation
+    input:
+      name: ResendAdminValidationRequest
+    output:
+      package: google.protobuf
+      name: Empty
+    http:
+    - method: POST
+      path: /tenants/{tenant_ids.tenant_id}/resend-admin-validation
diff --git a/...awan.v3/messages/GatewayToken.Payload.yml → ...awan.v3/messages/GatewayToken.Payload.yml b/...awan.v3/messages/GatewayToken.Payload.yml → ...awan.v3/messages/GatewayToken.Payload.yml
@@ -2,12 +2,10 @@ name: GatewayToken.Payload
 fields:
 - name: gateway_ids
   message:
-    package: ttn.lorawan.v3
     name: GatewayIdentifiers
   default: {}
 - name: rights
   message:
-    package: ttn.lorawan.v3
     name: Rights
   default: {}
 - name: created_at

diff --git a/.../tti.lorawan.v3/messages/GatewayToken.yml → .../ttn.lorawan.v3/messages/GatewayToken.yml b/.../tti.lorawan.v3/messages/GatewayToken.yml → .../ttn.lorawan.v3/messages/GatewayToken.yml
diff --git a/.../api/ttn.lorawan.v3/messages/IsConfiguration.TenantRegistration.ContactInfoValidation.yml b/.../api/ttn.lorawan.v3/messages/IsConfiguration.TenantRegistration.ContactInfoValidation.yml
@@ -0,0 +1,7 @@
+name: IsConfiguration.TenantRegistration.ContactInfoValidation
+fields:
+- name: token_ttl
+  message:
+    package: google.protobuf
+    name: Duration
+  default: 0s
diff --git a/doc/data/api/ttn.lorawan.v3/messages/IsConfiguration.TenantRegistration.yml b/doc/data/api/ttn.lorawan.v3/messages/IsConfiguration.TenantRegistration.yml
@@ -0,0 +1,6 @@
+name: IsConfiguration.TenantRegistration
+fields:
+- name: contact_info_validation
+  message:
+    name: IsConfiguration.TenantRegistration.ContactInfoValidation
+  default: {}
diff --git a/doc/data/api/ttn.lorawan.v3/messages/IsConfiguration.yml b/doc/data/api/ttn.lorawan.v3/messages/IsConfiguration.yml
@@ -48,3 +48,7 @@ fields:
   message:
     name: IsConfiguration.CollaboratorRights
   default: {}
+- name: tenant_registration
+  message:
+    name: IsConfiguration.TenantRegistration
+  default: {}