Merge pull request #3333 from Jibbarth/fix/oauth-security-definition-openapi

[OpenApi] [Oauth] Fix render oauth when using OpenApi v3

Author: soyuka

src/Swagger/Serializer/DocumentationNormalizer.php

@@ -631,15 +631,29 @@ private function computeDoc(bool $v3, Documentation $documentation, \ArrayObject
         $security = [];
 
         if ($this->oauthEnabled) {
-            $securityDefinitions['oauth'] = [
-                'type' => $this->oauthType,
-                'description' => 'OAuth client_credentials Grant',
-                'flow' => $this->oauthFlow,
+            $oauthAttributes = [
                 'tokenUrl' => $this->oauthTokenUrl,
                 'authorizationUrl' => $this->oauthAuthorizationUrl,
                 'scopes' => $this->oauthScopes,
             ];
 
+            $securityDefinitions['oauth'] = [
+                'type' => $this->oauthType,
+                'description' => sprintf(
+                    'OAuth 2.0 %s Grant',
+                    strtolower(preg_replace('/[A-Z]/', ' \\0', lcfirst($this->oauthFlow)))
+                ),
+            ];
+
+            if ($v3) {
+                $securityDefinitions['oauth']['flows'] = [
+                    $this->oauthFlow => $oauthAttributes,
+                ];
+            } else {
+                $securityDefinitions['oauth']['flow'] = $this->oauthFlow;
+                $securityDefinitions['oauth'] = array_merge($securityDefinitions['oauth'], $oauthAttributes);
+            }
+
             $security[] = ['oauth' => []];
         }
 

tests/Swagger/Serializer/DocumentationNormalizerV2Test.php

@@ -492,7 +492,7 @@ interface_exists(AdvancedNameConverterInterface::class)
             'securityDefinitions' => [
                 'oauth' => [
                     'type' => 'oauth2',
-                    'description' => 'OAuth client_credentials Grant',
+                    'description' => 'OAuth 2.0 application Grant',
                     'flow' => 'application',
                     'tokenUrl' => '/oauth/v2/token',
                     'authorizationUrl' => '/oauth/v2/auth',

tests/Swagger/Serializer/DocumentationNormalizerV3Test.php

@@ -483,7 +483,7 @@ private function doTestNormalizeWithNameConverter(bool $legacy = false): void
             $legacy ? $nameConverter : null,
             true,
             'oauth2',
-            'application',
+            'authorizationCode',
             '/oauth/v2/token',
             '/oauth/v2/auth',
             ['scope param'],
@@ -554,11 +554,14 @@ private function doTestNormalizeWithNameConverter(bool $legacy = false): void
                 'securitySchemes' => [
                     'oauth' => [
                         'type' => 'oauth2',
-                        'description' => 'OAuth client_credentials Grant',
-                        'flow' => 'application',
-                        'tokenUrl' => '/oauth/v2/token',
-                        'authorizationUrl' => '/oauth/v2/auth',
-                        'scopes' => ['scope param'],
+                        'description' => 'OAuth 2.0 authorization code Grant',
+                        'flows' => [
+                            'authorizationCode' => [
+                                'tokenUrl' => '/oauth/v2/token',
+                                'authorizationUrl' => '/oauth/v2/auth',
+                                'scopes' => ['scope param'],
+                            ],
+                        ],
                     ],
                 ],
             ],