skyplatform-iam 1.0.5__py3-none-any.whl → 1.1.0__py3-none-any.whl

skyplatform_iam/connect_agenterra_iam.py

@@ -83,53 +83,6 @@ class ConnectAgenterraIam(object):
         # 标记为已初始化
         self._initialized = True
 
-    @classmethod
-    def get_instance(cls):
-        """
-        获取已初始化的ConnectAgenterraIam单例实例
-        
-        如果实例尚未初始化，会抛出异常提示用户先进行配置
-        这个方法通常在用户已经通过setup_auth()进行配置后使用
-        
-        返回:
-        - ConnectAgenterraIam: 已初始化的单例实例
-        
-        异常:
-        - RuntimeError: 当实例未初始化时抛出
-        """
-        if cls._instance is None or not cls._initialized:
-            raise RuntimeError(
-                "ConnectAgenterraIam实例尚未初始化。请先使用以下方式之一进行配置：\n"
-                "1. 使用setup_auth()进行一键配置\n"
-                "2. 手动创建ConnectAgenterraIam实例：ConnectAgenterraIam(config=your_config)"
-            )
-        return cls._instance
-
-    @classmethod
-    def get_instance_lazy(cls):
-        """
-        获取已初始化的单例实例（延迟模式）
-        
-        此方法支持延迟初始化，当实例未初始化时返回 None 而不是抛出异常。
-        适用于在模块导入时需要获取实例但可能尚未初始化的场景。
-        
-        返回:
-        - ConnectAgenterraIam: 已初始化的单例实例，如果未初始化则返回 None
-        """
-        if cls._instance is None or not cls._initialized:
-            return None
-        return cls._instance
-
-    @classmethod
-    def is_initialized(cls):
-        """
-        检查单例实例是否已初始化
-        
-        返回:
-        - bool: 如果实例已初始化返回 True，否则返回 False
-        """
-        return cls._instance is not None and cls._initialized
-
     def reload_config(self, config):
         """
         重新加载配置
@@ -236,7 +189,7 @@ class ConnectAgenterraIam(object):
             self.logger.info(f"[{method_name}] 响应状态码: {response.status_code}")
             self.logger.info(f"[{method_name}] 响应内容解析失败: {str(e)}")
 
-    def register(self, cred_type=None, cred_value=None, password=None, nickname=None, avatar_url=None, 
+    def register(self, cred_type=None, cred_value=None, password=None, nickname=None, avatar_url=None,
                  username=None, phone=None):
         """
         注册用户时，同步至iam
@@ -259,8 +212,9 @@ class ConnectAgenterraIam(object):
         - 失败: 返回False
         """
         method_name = "register"
-        self.logger.info(f"[{method_name}] 开始用户注册 - cred_type: {cred_type}, cred_value: {self._mask_sensitive(str(cred_value))}")
-        
+        self.logger.info(
+            f"[{method_name}] 开始用户注册 - cred_type: {cred_type}, cred_value: {self._mask_sensitive(str(cred_value))}")
+
         try:
             # 参数映射：支持旧的调用方式
             if cred_type is None and cred_value is None:
@@ -296,10 +250,10 @@ class ConnectAgenterraIam(object):
 
             uri = "/api/v2/service/register"
             url = self.agenterra_iam_host + uri
-            
+
             # 记录请求信息
             self._log_request(method_name, url, self.headers, body)
-            
+
             response = requests.post(
                 url=url,
                 headers=self.headers,
@@ -319,7 +273,7 @@ class ConnectAgenterraIam(object):
                     self.logger.warning(f"[{method_name}] 用户注册失败 - 响应: {result}")
             else:
                 self.logger.warning(f"[{method_name}] 用户注册失败 - 状态码: {response.status_code}")
-            
+
             return False
         except Exception as e:
             self.logger.error(f"[{method_name}] 注册请求异常: {str(e)}")
@@ -327,7 +281,7 @@ class ConnectAgenterraIam(object):
             return False
 
     def login_with_password(self, cred_type=None, cred_value=None, password=None, ip_address=None, user_agent=None,
-                           username=None):
+                            username=None):
         """
         账号密码登陆时，同步至iam，由iam签发token
 
@@ -343,8 +297,9 @@ class ConnectAgenterraIam(object):
         - password: 用户密码
         """
         method_name = "login_with_password"
-        self.logger.info(f"[{method_name}] 开始密码登录 - cred_type: {cred_type}, cred_value: {self._mask_sensitive(str(cred_value))}")
-        
+        self.logger.info(
+            f"[{method_name}] 开始密码登录 - cred_type: {cred_type}, cred_value: {self._mask_sensitive(str(cred_value))}")
+
         try:
             # 参数映射：支持旧的调用方式
             if cred_type is None and cred_value is None:
@@ -375,10 +330,10 @@ class ConnectAgenterraIam(object):
 
             uri = "/api/v2/service/login"
             url = self.agenterra_iam_host + uri
-            
+
             # 记录请求信息
             self._log_request(method_name, url, self.headers, body)
-            
+
             response = requests.post(
                 url=url,
                 headers=self.headers,
@@ -394,7 +349,7 @@ class ConnectAgenterraIam(object):
                 return response
             else:
                 self.logger.warning(f"[{method_name}] 密码登录失败 - 状态码: {response.status_code}")
-            
+
             return False
         except Exception as e:
             self.logger.error(f"[{method_name}] 密码登录请求异常: {str(e)}")
@@ -402,7 +357,7 @@ class ConnectAgenterraIam(object):
             return False
 
     def login_without_password(self, cred_type=None, cred_value=None, ip_address=None, user_agent=None,
-                              username=None):
+                               username=None):
         """
         短信验证码登陆时，机机接口请求token
 
@@ -418,8 +373,9 @@ class ConnectAgenterraIam(object):
         返回: response对象或False
         """
         method_name = "login_without_password"
-        self.logger.info(f"[{method_name}] 开始免密登录 - cred_type: {cred_type}, cred_value: {self._mask_sensitive(str(cred_value))}")
-        
+        self.logger.info(
+            f"[{method_name}] 开始免密登录 - cred_type: {cred_type}, cred_value: {self._mask_sensitive(str(cred_value))}")
+
         try:
             # 参数映射：支持旧的调用方式
             if cred_type is None and cred_value is None:
@@ -449,10 +405,10 @@ class ConnectAgenterraIam(object):
 
             uri = "/api/v2/service/login_without_password"
             url = self.agenterra_iam_host + uri
-            
+
             # 记录请求信息
             self._log_request(method_name, url, self.headers, body)
-            
+
             response = requests.post(
                 url=url,
                 headers=self.headers,
@@ -468,7 +424,7 @@ class ConnectAgenterraIam(object):
                 return response
             else:
                 self.logger.warning(f"[{method_name}] 免密登录失败 - 状态码: {response.status_code}")
-            
+
             return False
         except Exception as e:
             self.logger.error(f"[{method_name}] 免密登录请求异常: {str(e)}")
@@ -483,7 +439,7 @@ class ConnectAgenterraIam(object):
         """
         method_name = "logout"
         self.logger.info(f"[{method_name}] 开始用户登出 - token: {self._mask_sensitive(token)}")
-        
+
         try:
             body = {
                 "server_name": self.server_name,
@@ -492,7 +448,7 @@ class ConnectAgenterraIam(object):
             }
             uri = "/api/v2/service/logout"
             url = self.agenterra_iam_host + uri
-            
+
             # 记录请求信息
             self._log_request(method_name, url, self.headers, body)
 
@@ -511,7 +467,7 @@ class ConnectAgenterraIam(object):
                 return True
             else:
                 self.logger.warning(f"[{method_name}] 用户登出失败 - 状态码: {response.status_code}")
-            
+
             return False
         except Exception as e:
             self.logger.error(f"[{method_name}] 登出请求异常: {str(e)}")
@@ -531,8 +487,9 @@ class ConnectAgenterraIam(object):
         - token无效或其他错误: 返回None
         """
         method_name = "verify_token"
-        self.logger.info(f"[{method_name}] 开始token验证 - api: {api}, method: {method}, token: {self._mask_sensitive(token)}")
-        
+        self.logger.info(
+            f"[{method_name}] 开始token验证 - api: {api}, method: {method}, token: {self._mask_sensitive(token)}")
+
         try:
             body = {
                 "server_name": self.server_name,
@@ -544,16 +501,16 @@ class ConnectAgenterraIam(object):
                 "server_sk": server_sk,
             }
             uri = "/api/v2/service/verify"
-            
+
             # 检查agenterra_iam_host是否为None
             if self.agenterra_iam_host is None:
                 raise ValueError("AGENTERRA_IAM_HOST 配置未设置或为空，请确保传入正确的AuthConfig对象")
-                
+
             url = self.agenterra_iam_host + uri
-            
+
             # 记录请求信息
             self._log_request(method_name, url, self.headers, body)
-            
+
             response = requests.post(
                 url=url,
                 headers=self.headers,
@@ -577,7 +534,8 @@ class ConnectAgenterraIam(object):
                             "microservice": result.get("microservice"),
                             "is_whitelist": result.get("is_whitelist", False)
                         }
-                        self.logger.info(f"[{method_name}] token验证成功，用户有权限 - user_id: {user_info.get('user_id')}")
+                        self.logger.info(
+                            f"[{method_name}] token验证成功，用户有权限 - user_id: {user_info.get('user_id')}")
                         return user_info
                     else:
                         # token有效但无权限，抛出403异常
@@ -587,7 +545,8 @@ class ConnectAgenterraIam(object):
                             detail=result.get("message", "用户无权限访问此API")
                         )
                 else:
-                    self.logger.warning(f"[{method_name}] token验证失败 - success: {result.get('success')}, valid: {result.get('valid')}")
+                    self.logger.warning(
+                        f"[{method_name}] token验证失败 - success: {result.get('success')}, valid: {result.get('valid')}")
 
             elif response.status_code == 403:
                 result = response.json()
@@ -623,11 +582,11 @@ class ConnectAgenterraIam(object):
         """
         method_name = "reset_password"
         self.logger.info(f"[{method_name}] 开始重置密码 - user_id: {user_id}")
-        
+
         # 记录旧参数格式的使用
         if username or password:
             self.logger.debug(f"[{method_name}] 检测到旧参数格式 - username: {username}")
-        
+
         try:
             # 参数映射：支持旧的调用方式
             if user_id is None and new_password is None:
@@ -646,26 +605,26 @@ class ConnectAgenterraIam(object):
             }
             uri = "/api/v2/service/reset_password"
             url = self.agenterra_iam_host + uri
-            
+
             # 记录请求信息
             self._log_request(method_name, url, self.headers, body)
-            
+
             response = requests.post(
                 url=url,
                 headers=self.headers,
                 json=body,
                 verify=False
             )
-            
+
             # 记录响应信息
             self._log_response(method_name, response)
-            
+
             if response.status_code == 200:
                 self.logger.info(f"[{method_name}] 密码重置成功")
                 return True
             else:
                 self.logger.warning(f"[{method_name}] 密码重置失败 - 状态码: {response.status_code}")
-            
+
             return False
         except Exception as e:
             self.logger.error(f"[{method_name}] 重置密码请求异常: {str(e)}")
@@ -683,7 +642,7 @@ class ConnectAgenterraIam(object):
         """
         method_name = "refresh_token"
         self.logger.info(f"[{method_name}] 开始刷新令牌 - refresh_token: {self._mask_sensitive(refresh_token)}")
-        
+
         try:
             body = {
                 "server_name": self.server_name,
@@ -692,10 +651,10 @@ class ConnectAgenterraIam(object):
             }
             uri = "/api/v2/service/refresh_token"
             url = self.agenterra_iam_host + uri
-            
+
             # 记录请求信息
             self._log_request(method_name, url, self.headers, body)
-            
+
             response = requests.post(
                 url=url,
                 headers=self.headers,
@@ -711,7 +670,7 @@ class ConnectAgenterraIam(object):
                 return response
             else:
                 self.logger.warning(f"[{method_name}] 令牌刷新失败 - 状态码: {response.status_code}")
-            
+
             return False
         except Exception as e:
             self.logger.error(f"[{method_name}] 刷新令牌请求异常: {str(e)}")
@@ -730,7 +689,7 @@ class ConnectAgenterraIam(object):
         """
         method_name = "assign_role_to_user"
         self.logger.info(f"[{method_name}] 开始角色分配 - user_id: {user_id}, role_id: {role_id}")
-        
+
         try:
             body = {
                 "server_name": self.server_name,
@@ -740,10 +699,10 @@ class ConnectAgenterraIam(object):
             }
             uri = "/api/v2/service/assign_role"
             url = self.agenterra_iam_host + uri
-            
+
             # 记录请求信息
             self._log_request(method_name, url, self.headers, body)
-            
+
             response = requests.post(
                 url=url,
                 headers=self.headers,
@@ -759,7 +718,7 @@ class ConnectAgenterraIam(object):
                 return True
             else:
                 self.logger.warning(f"[{method_name}] 角色分配失败 - 状态码: {response.status_code}")
-            
+
             return False
         except Exception as e:
             self.logger.error(f"[{method_name}] 角色分配请求异常: {str(e)}")
@@ -772,7 +731,7 @@ class ConnectAgenterraIam(object):
                 """
         method_name = "get_userinfo_by_token"
         self.logger.info(f"[{method_name}] 开始获取用户信息 - token: {self._mask_sensitive(token)}")
-        
+
         try:
             body = {
                 "server_name": self.server_name,
@@ -781,10 +740,10 @@ class ConnectAgenterraIam(object):
             }
             uri = "/api/v2/service/token"
             url = self.agenterra_iam_host + uri
-            
+
             # 记录请求信息
             self._log_request(method_name, url, self.headers, body)
-            
+
             response = requests.post(
                 url=url,
                 headers=self.headers,
@@ -800,7 +759,7 @@ class ConnectAgenterraIam(object):
                 return response
             else:
                 self.logger.warning(f"[{method_name}] 获取用户信息失败 - 状态码: {response.status_code}")
-            
+
             return False
         except Exception as e:
             self.logger.error(f"[{method_name}] 获取用户信息请求异常: {str(e)}")
@@ -810,7 +769,7 @@ class ConnectAgenterraIam(object):
     def add_custom_config(self, user_id, config_name, config_value=None):
         """
         机机接口：添加用户自定义配置
-        
+
         为指定用户添加或更新自定义属性配置。
 
         参数:
@@ -818,13 +777,13 @@ class ConnectAgenterraIam(object):
         - config_name: 配置项名称
         - config_value: 配置项值（可选）
 
-        返回: 
+        返回:
         - 成功: 返回响应对象
         - 失败: 返回False
         """
         method_name = "add_custom_config"
         self.logger.info(f"[{method_name}] 开始添加用户自定义配置 - user_id: {user_id}, config_name: {config_name}")
-        
+
         try:
             body = {
                 "server_name": self.server_name,
@@ -839,10 +798,10 @@ class ConnectAgenterraIam(object):
 
             uri = "/api/v2/service/add_custom_config"
             url = self.agenterra_iam_host + uri
-            
+
             # 记录请求信息
             self._log_request(method_name, url, self.headers, body)
-            
+
             response = requests.post(
                 url=url,
                 headers=self.headers,
@@ -858,7 +817,7 @@ class ConnectAgenterraIam(object):
                 return response
             else:
                 self.logger.warning(f"[{method_name}] 添加用户自定义配置失败 - 状态码: {response.status_code}")
-            
+
             return False
         except Exception as e:
             self.logger.error(f"[{method_name}] 添加用户自定义配置请求异常: {str(e)}")
@@ -868,19 +827,19 @@ class ConnectAgenterraIam(object):
     def get_custom_configs(self, user_id):
         """
         机机接口：获取用户自定义配置
-        
+
         获取指定用户的所有自定义属性配置。
 
         参数:
         - user_id: 用户ID
 
-        返回: 
+        返回:
         - 成功: 返回响应对象
         - 失败: 返回False
         """
         method_name = "get_custom_configs"
         self.logger.info(f"[{method_name}] 开始获取用户自定义配置 - user_id: {user_id}")
-        
+
         try:
             body = {
                 "server_name": self.server_name,
@@ -890,10 +849,10 @@ class ConnectAgenterraIam(object):
 
             uri = "/api/v2/service/get_custom_configs"
             url = self.agenterra_iam_host + uri
-            
+
             # 记录请求信息
             self._log_request(method_name, url, self.headers, body)
-            
+
             response = requests.post(
                 url=url,
                 headers=self.headers,
@@ -909,7 +868,7 @@ class ConnectAgenterraIam(object):
                 return response
             else:
                 self.logger.warning(f"[{method_name}] 获取用户自定义配置失败 - 状态码: {response.status_code}")
-            
+
             return False
         except Exception as e:
             self.logger.error(f"[{method_name}] 获取用户自定义配置请求异常: {str(e)}")
@@ -919,20 +878,20 @@ class ConnectAgenterraIam(object):
     def delete_custom_config(self, user_id, config_name):
         """
         机机接口：删除用户自定义配置
-        
+
         删除指定用户的指定自定义属性配置。
 
         参数:
         - user_id: 用户ID
         - config_name: 配置项名称
 
-        返回: 
+        返回:
         - 成功: 返回响应对象
         - 失败: 返回False
         """
         method_name = "delete_custom_config"
         self.logger.info(f"[{method_name}] 开始删除用户自定义配置 - user_id: {user_id}, config_name: {config_name}")
-        
+
         try:
             body = {
                 "server_name": self.server_name,
@@ -943,10 +902,10 @@ class ConnectAgenterraIam(object):
 
             uri = "/api/v2/service/delete_custom_config"
             url = self.agenterra_iam_host + uri
-            
+
             # 记录请求信息
             self._log_request(method_name, url, self.headers, body)
-            
+
             response = requests.post(
                 url=url,
                 headers=self.headers,
@@ -962,7 +921,7 @@ class ConnectAgenterraIam(object):
                 return response
             else:
                 self.logger.warning(f"[{method_name}] 删除用户自定义配置失败 - 状态码: {response.status_code}")
-            
+
             return False
         except Exception as e:
             self.logger.error(f"[{method_name}] 删除用户自定义配置请求异常: {str(e)}")
@@ -972,7 +931,7 @@ class ConnectAgenterraIam(object):
     def merge_credential(self, target_user_id, cred_type, cred_value, merge_reason=None):
         """
         机机接口：凭证合并
-        
+
         为第三方服务提供凭证合并功能，处理用户绑定新凭证时的账号合并场景。
         例如用户先用账号密码注册，后续又绑定手机号时的账号合并需求。
 
@@ -982,13 +941,14 @@ class ConnectAgenterraIam(object):
         - cred_value: 要绑定的凭证值
         - merge_reason: 合并原因（可选）
 
-        返回: 
+        返回:
         - 成功: 返回响应对象
         - 失败: 返回False
         """
         method_name = "merge_credential"
-        self.logger.info(f"[{method_name}] 开始凭证合并 - target_user_id: {target_user_id}, cred_type: {cred_type}, cred_value: {self._mask_sensitive(cred_value)}")
-        
+        self.logger.info(
+            f"[{method_name}] 开始凭证合并 - target_user_id: {target_user_id}, cred_type: {cred_type}, cred_value: {self._mask_sensitive(cred_value)}")
+
         try:
             # 验证凭证类型
             if isinstance(cred_type, str):
@@ -1009,10 +969,10 @@ class ConnectAgenterraIam(object):
 
             uri = "/api/v2/service/merge_credential"
             url = self.agenterra_iam_host + uri
-            
+
             # 记录请求信息
             self._log_request(method_name, url, self.headers, body)
-            
+
             response = requests.post(
                 url=url,
                 headers=self.headers,
@@ -1028,7 +988,7 @@ class ConnectAgenterraIam(object):
                 return response
             else:
                 self.logger.warning(f"[{method_name}] 凭证合并失败 - 状态码: {response.status_code}")
-            
+
             return False
         except Exception as e:
             self.logger.error(f"[{method_name}] 凭证合并请求异常: {str(e)}")
@@ -1038,20 +998,21 @@ class ConnectAgenterraIam(object):
     def get_user_by_credential(self, cred_type, cred_value):
         """
         机机接口：通过凭证获取用户信息
-        
+
         为第三方服务提供通过用户名或手机号等认证凭据获取用户信息的功能。
 
         参数:
         - cred_type: 凭证类型 (CredentialTypeEnum: username, email, phone, wechat_openid)
         - cred_value: 凭证值
 
-        返回: 
+        返回:
         - 成功: 返回响应对象
         - 失败: 返回False
         """
         method_name = "get_user_by_credential"
-        self.logger.info(f"[{method_name}] 开始获取用户信息 - cred_type: {cred_type}, cred_value: {self._mask_sensitive(cred_value)}")
-        
+        self.logger.info(
+            f"[{method_name}] 开始获取用户信息 - cred_type: {cred_type}, cred_value: {self._mask_sensitive(cred_value)}")
+
         try:
             # 验证凭证类型
             if isinstance(cred_type, str):
@@ -1066,10 +1027,10 @@ class ConnectAgenterraIam(object):
 
             uri = "/api/v2/service/get_user_by_credential"
             url = self.agenterra_iam_host + uri
-            
+
             # 记录请求信息
             self._log_request(method_name, url, self.headers, body)
-            
+
             response = requests.post(
                 url=url,
                 headers=self.headers,
@@ -1085,7 +1046,7 @@ class ConnectAgenterraIam(object):
                 return response
             else:
                 self.logger.warning(f"[{method_name}] 获取用户信息失败 - 状态码: {response.status_code}")
-            
+
             return False
         except Exception as e:
             self.logger.error(f"[{method_name}] 获取用户信息请求异常: {str(e)}")