docstrings

Author: byewokko

seacatauth/authz/rbac/handler.py

@@ -17,7 +17,7 @@ class RBACHandler(object):
 	Resource-based access control
 
 	---
-	tags: ["Authorization"]
+	tags: ["Resources"]
 	"""
 
 	def __init__(self, app, rbac_svc):
@@ -28,9 +28,9 @@ def __init__(self, app, rbac_svc):
 		web_app.router.add_get("/rbac/{tenant}/{resources}", self.rbac)
 
 	@access_control()
-	async def rbac(self, request, *, tenant):
+	async def rbac(self, request, *, tenant=None):
 		"""
-		Validate the current credentials' access to requested resources
+		Verify whether the current session is authorized to access requested resources
 
 		Multiple resources must be separated by `+`.
 		"""

seacatauth/openidconnect/handler/token.py

@@ -271,7 +271,9 @@ async def token_error_response(self, request, error_description):
 
 	async def validate_id_token(self, request):
 		"""
-		Read the JWT token either from the request body or from the Authorization header.
+		Check the validity of a JWToken
+
+		Read the JWToken either from the request body or from the Authorization header.
 		Validate the token: send back the contents if successful; otherwise respond with error.
 		"""
 		body = await request.read()