fix: Bug: AsyncAPI documentation fails when Confluent uses oauth bearer authentication (#2775)

Fixes #2774

Author: yann-combarnous

faststream/security.py

@@ -165,7 +165,7 @@ def get_requirement(self) -> list["dict[str, Any]"]:
 
     def get_schema(self) -> dict[str, dict[str, str]]:
         """Get the security schema for SASL/OAUTHBEARER authentication."""
-        return {"oauthbearer": {"type": "oauth2", "$ref": ""}}
+        return {"oauthbearer": {"type": "oauth2"}}
 
 
 class SASLGSSAPI(BaseSecurity):

tests/asyncapi/confluent/v2_6_0/test_security.py

@@ -113,7 +113,7 @@ class SecurityTestcase(AsyncAPI26Mixin):
                     }),
                     "components": IsPartialDict({
                         "securitySchemes": {
-                            "oauthbearer": {"type": "oauth2", "$ref": ""},
+                            "oauthbearer": {"type": "oauth2"},
                         },
                     }),
                 }),

tests/asyncapi/confluent/v3_0_0/test_security.py

@@ -113,7 +113,7 @@ class SecurityTestcase(AsyncAPI30Mixin):
                     }),
                     "components": IsPartialDict({
                         "securitySchemes": {
-                            "oauthbearer": {"type": "oauth2", "$ref": ""},
+                            "oauthbearer": {"type": "oauth2"},
                         },
                     }),
                 }),

tests/asyncapi/kafka/v2_6_0/test_security.py

@@ -193,7 +193,7 @@ async def test_topic(msg: str) -> str:
         {"oauthbearer": []},
     ]
     sasl_oauthbearer_security_schema["components"]["securitySchemes"] = {
-        "oauthbearer": {"type": "oauth2", "$ref": ""},
+        "oauthbearer": {"type": "oauth2"},
     }
 
     assert schema == sasl_oauthbearer_security_schema

tests/asyncapi/kafka/v3_0_0/test_security.py

@@ -216,7 +216,7 @@ async def test_topic(msg: str) -> str:
         {"$ref": "#/components/securitySchemes/oauthbearer"},
     ]
     sasl_oauthbearer_security_schema["components"]["securitySchemes"] = {
-        "oauthbearer": {"type": "oauth2", "$ref": ""},
+        "oauthbearer": {"type": "oauth2"},
     }
 
     assert schema == sasl_oauthbearer_security_schema