add servers params. SWAGGER-UI password impl is broken

+    # TODO: Because SWAGGER-UI password-flow doesn't follow the oauth2 RFC it needs location='form' for it to work.
+    #       Rewrite is being discussed in swagger-api/swagger-ui#3227
+    #       https://www.oauth.com/oauth2-servers/access-tokens/password-grant/

Author: qcho

app/apis/auth.py

@@ -67,7 +67,10 @@ def sanitize_fields(self, item):
             item['username'] = item['username'].lower().strip()
             return item
 
-    @blp.arguments(TokenSchema, location='form')
+    # TODO: Because SWAGGER-UI password-flow doesn't follow the oauth2 RFC it needs location='form' for it to work.
+    #       Rewrite is being discussed in https://github.com/swagger-api/swagger-ui/issues/3227
+    #       https://www.oauth.com/oauth2-servers/access-tokens/password-grant/
+    @blp.arguments(TokenSchema, location='json')
     @response_error(Unauthorized('Invalid credentials'))
     @blp.response(UserCredentialsSchema)
     def post(self, login_payload):

app/app.py

@@ -11,8 +11,9 @@
 from apis.corpora import blp as corpora
 from apis.users import blp as users
 
-
 app = Flask('NERd')
+app.config['PREFERRED_URL_SCHEME'] = os.environ.get('NERD_URL_SCHEME', 'http')
+app.config['SERVER_NAME'] = os.environ.get('NERD_SERVER_NAME', '127.0.0.1:5000')
 
 mongoengine.connect(
     db=os.environ.get('NERD_MONGO_DB_NAME', 'nerd'),
@@ -37,6 +38,13 @@
 app.config['OPENAPI_SWAGGER_UI_VERSION'] = '3.21.0'
 app.config['API_VERSION'] = '1.0.0'
 app.config['API_SPEC_OPTIONS'] = {
+    'servers': [{
+        'url': '{}://{}'.format(
+            app.config['PREFERRED_URL_SCHEME'],
+            app.config['SERVER_NAME']
+        ),
+        'description': 'Default api endpoint'
+    }],
     'components': {
         'securitySchemes': {
             'oAuth2Password': {