# -*- coding: utf8 -*-
# Copyright (c) 2017-2021 THL A29 Limited, a Tencent company. All Rights Reserved.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
import json
from tencentcloud.common.exception.tencent_cloud_sdk_exception import TencentCloudSDKException
from tencentcloud.common.abstract_client import AbstractClient
from tencentcloud.sts.v20180813 import models
class StsClient(AbstractClient):
_apiVersion = '2018-08-13'
_endpoint = 'sts.tencentcloudapi.com'
_service = 'sts'
def AssumeRole(self, request):
"""申请扮演角色临时访问凭证。
1、角色策略组成
（1）角色信任策略：指定谁可以扮演该角色；
（2）角色权限策略：指定扮演角色后可以执行哪些操作。
2、角色可扮演条件
（1）给用户绑定允许调用AssumeRole的策略 ；
（2）将用户添加为角色信任策略中的主体。
:param request: Request instance for AssumeRole.
:type request: :class:`tencentcloud.sts.v20180813.models.AssumeRoleRequest`
:rtype: :class:`tencentcloud.sts.v20180813.models.AssumeRoleResponse`
"""
try:
params = request._serialize()
headers = request.headers
body = self.call("AssumeRole", params, headers=headers)
response = json.loads(body)
model = models.AssumeRoleResponse()
model._deserialize(response["Response"])
return model
except Exception as e:
if isinstance(e, TencentCloudSDKException):
raise
else:
raise TencentCloudSDKException(type(e).__name__, str(e))
def AssumeRoleWithSAML(self, request):
"""本接口（AssumeRoleWithSAML）用于根据 SAML 断言申请角色临时访问凭证。
注意：当使用签名方法 V3 调用本接口时，请求头无须传入 X-TC-Token, 但 Authorization 需要传入值 SKIP。
:param request: Request instance for AssumeRoleWithSAML.
:type request: :class:`tencentcloud.sts.v20180813.models.AssumeRoleWithSAMLRequest`
:rtype: :class:`tencentcloud.sts.v20180813.models.AssumeRoleWithSAMLResponse`
"""
try:
params = request._serialize()
headers = request.headers
body = self.call("AssumeRoleWithSAML", params, headers=headers)
response = json.loads(body)
model = models.AssumeRoleWithSAMLResponse()
model._deserialize(response["Response"])
return model
except Exception as e:
if isinstance(e, TencentCloudSDKException):
raise
else:
raise TencentCloudSDKException(type(e).__name__, str(e))
def AssumeRoleWithWebIdentity(self, request):
"""申请OIDC角色临时访问凭证。
注意：当使用签名方法 V3 调用本接口时，请求头无须传入 X-TC-Token, 但 Authorization 需要传入值 SKIP。
:param request: Request instance for AssumeRoleWithWebIdentity.
:type request: :class:`tencentcloud.sts.v20180813.models.AssumeRoleWithWebIdentityRequest`
:rtype: :class:`tencentcloud.sts.v20180813.models.AssumeRoleWithWebIdentityResponse`
"""
try:
params = request._serialize()
headers = request.headers
body = self.call("AssumeRoleWithWebIdentity", params, headers=headers)
response = json.loads(body)
model = models.AssumeRoleWithWebIdentityResponse()
model._deserialize(response["Response"])
return model
except Exception as e:
if isinstance(e, TencentCloudSDKException):
raise
else:
raise TencentCloudSDKException(type(e).__name__, str(e))
def GetCallerIdentity(self, request):
"""获取当前调用者的身份信息。
接口支持主账号，子账号长期密钥以及AssumeRole，GetFederationToken生成的临时访问凭证身份获取。
:param request: Request instance for GetCallerIdentity.
:type request: :class:`tencentcloud.sts.v20180813.models.GetCallerIdentityRequest`
:rtype: :class:`tencentcloud.sts.v20180813.models.GetCallerIdentityResponse`
"""
try:
params = request._serialize()
headers = request.headers
body = self.call("GetCallerIdentity", params, headers=headers)
response = json.loads(body)
model = models.GetCallerIdentityResponse()
model._deserialize(response["Response"])
return model
except Exception as e:
if isinstance(e, TencentCloudSDKException):
raise
else:
raise TencentCloudSDKException(type(e).__name__, str(e))
def GetFederationToken(self, request):
"""**使用说明**
返回一组临时访问凭证，典型的应用场景是代理应用程序集中申请临时访问凭证，下发给企业网络内其他分布式终端应用，比如终端应用上传文件到COS场景，本接口仅支持永久密钥调用。
**最佳实践**
1. 临时访问凭据在有效期内都可以使用，建议在有效期内重复使用，以避免业务请求速率上升后被限频
2. 授予临时访问凭证权限的CAM策略，建议按权限最小化原则
3. 调用接口的永久密钥，建议不要使用主账号
:param request: Request instance for GetFederationToken.
:type request: :class:`tencentcloud.sts.v20180813.models.GetFederationTokenRequest`
:rtype: :class:`tencentcloud.sts.v20180813.models.GetFederationTokenResponse`
"""
try:
params = request._serialize()
headers = request.headers
body = self.call("GetFederationToken", params, headers=headers)
response = json.loads(body)
model = models.GetFederationTokenResponse()
model._deserialize(response["Response"])
return model
except Exception as e:
if isinstance(e, TencentCloudSDKException):
raise
else:
raise TencentCloudSDKException(type(e).__name__, str(e))
def QueryApiKey(self, request):
"""拉取API密钥列表
:param request: Request instance for QueryApiKey.
:type request: :class:`tencentcloud.sts.v20180813.models.QueryApiKeyRequest`
:rtype: :class:`tencentcloud.sts.v20180813.models.QueryApiKeyResponse`
"""
try:
params = request._serialize()
headers = request.headers
body = self.call("QueryApiKey", params, headers=headers)
response = json.loads(body)
model = models.QueryApiKeyResponse()
model._deserialize(response["Response"])
return model
except Exception as e:
if isinstance(e, TencentCloudSDKException):
raise
else:
raise TencentCloudSDKException(type(e).__name__, str(e))