如何在IBM Cloud Function中通过API密钥认证CloudantV1服务？

问题原因 #

CloudantV1.new_instance()方法默认会从系统环境变量中读取IBMCLOUDANT_APIKEY和IBMCLOUDANT_URL自动创建认证器，但IBM Cloud Functions运行环境不会自动注入这些变量，因此触发了认证器缺失的错误。

解决方案 #

无需依赖环境变量，手动创建IAM认证器并初始化Cloudant服务即可，步骤如下：

1. 导入IAMAuthenticator类（IBM Cloud SDK核心认证组件）
2. 使用你的Cloudant API密钥和服务URL创建认证器实例
3. 手动初始化CloudantV1服务，传入认证器并设置服务地址

修改后的代码示例：

from ibmcloudant.cloudant_v1 import CloudantV1
from ibm_cloud_sdk_core.authenticators import IAMAuthenticator

def main(params_dict):
    # 从函数参数中获取Cloudant凭证（建议在Function配置中绑定为参数或环境变量）
    api_key = params_dict.get('CLOUDANT_API_KEY')
    service_url = params_dict.get('CLOUDANT_URL')
    
    # 初始化IAM认证器
    authenticator = IAMAuthenticator(api_key)
    
    # 创建Cloudant服务实例并配置认证信息
    service = CloudantV1(authenticator=authenticator)
    service.set_service_url(service_url)
    
    # 示例：调用Cloudant API获取数据库列表
    # db_list = service.list_databases().get_result()
    # return { "databases": db_list }
    
    return { "message" : "Cloudant服务初始化成功" }

额外说明 #

• 不要将API密钥硬编码在代码中，建议在IBM Cloud Functions的函数配置页面，将CLOUDANT_API_KEY和CLOUDANT_URL添加为环境变量或绑定参数，既保证凭证安全，也符合代码与配置分离的最佳实践。
• 如果坚持使用new_instance()方法，只需在Function的环境变量中添加IBMCLOUDANT_APIKEY和IBMCLOUDANT_URL两个变量，SDK就能自动完成认证器创建，这是IBM官方推荐的标准做法，并非非常规方案。

内容的提问来源于stack exchange，提问作者David Hill