admin: setup base for oauth2 sessions endpoints

Author: sandhose

crates/handlers/src/admin/mod.rs

@@ -64,6 +64,11 @@ where
         .nest("/api/admin/v1", self::v1::router())
         .finish_api_with(&mut api, |t| {
             t.title("Matrix Authentication Service admin API")
+                .tag(Tag {
+                    name: "oauth2-session".to_owned(),
+                    description: Some("Manage OAuth2 sessions".to_owned()),
+                    ..Tag::default()
+                })
                 .tag(Tag {
                     name: "user".to_owned(),
                     description: Some("Manage users".to_owned()),

crates/handlers/src/admin/v1/mod.rs

@@ -23,6 +23,7 @@ use mas_storage::BoxRng;
 use super::call_context::CallContext;
 use crate::passwords::PasswordManager;
 
+mod oauth2_sessions;
 mod users;
 
 pub fn router<S>() -> ApiRouter<S>

crates/handlers/src/admin/v1/oauth2_sessions/mod.rs

@@ -0,0 +1,13 @@
+// Copyright 2024 The Matrix.org Foundation C.I.C.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.

docs/api/spec.json

@@ -1027,6 +1027,10 @@
     }
   ],
   "tags": [
+    {
+      "name": "oauth2-session",
+      "description": "Manage OAuth2 sessions"
+    },
     {
       "name": "user",
       "description": "Manage users"