鉴权认证
鉴权介绍
鉴权的主要目的是用于校验调用者的身份信息。调用千帆ModelBuilder平台功能OpenAPI需使用基于安全认证AK/SK进行签名计算鉴权。
- 基于安全认证AK/SK进行签名计算鉴权
使用安全认证中的Access Key(即AK)
和Secret Key(即SK)
进行签名计算,将HTTP请求发送到百度智能云时,需要对请求进行签名计算,以便百度智能云可以识别身份。
如何获取安全认证AK/SK
鉴权需要获取 Access Key(即AK)
和Secret Key(即SK)
,用于 API 请求认证和鉴权,如何获取可参考获取AK/SK文档。
HTTP调用API鉴权说明
使用HTTP调用API时,需对请求进行签名,在请求时将签名信息添加到消息头,进行身份认证。
- 签名计算等具体鉴权认证机制,请参考鉴权认证机制。
- 如何使用安全认证AK和SK鉴权调用API,请参考基于安全认证AK/SK鉴权调用API流程。
SDK调用API鉴权说明
通过SDK调用API时,SDK会获取安全认证AK和SK初始化信息,并自动完成鉴权相关步骤。
Python SDK
支持通过参数、内置函数初始化、环境变量三种初始化方式,优先级由低到高为:环境变量初始化<内置函数初始化<参数初始化。
推荐使用环境变量方式初始化,示例如下,其他方式请查看https://github.com/baidubce/bce-qianfan-sdk/blob/main/python/README.pypi.md。
# 通过环境变量传递(作用于全局,优先级最低)
import os
# 替换下列示例中参数,安全认证Access Key替换your_access_key,Secret Key替换your_secret_key
os.environ["QIANFAN_ACCESS_KEY"] = "your_access_key"
os.environ["QIANFAN_SECRET_KEY"] = "your_secret_key"
Go SDK
支持通过环境变量、参数设置两种初始化方式。
推荐使用环境变量初始化,示例如下,其他方式请查看https://github.com/baidubce/bce-qianfan-sdk/tree/main/go。
// 通过环境变量初始化
import (
"os"
)
// 替换下列示例中参数,安全认证Access Key替换your_access_key,Secret Key替换your_secret_key
os.Setenv("QIANFAN_ACCESS_KEY", "your_access_key")
os.Setenv("QIANFAN_SECRET_KEY", "your_secret_key")
Java SDK
支持通过参数初始化、环境变量初始化,环境变量初始化方式如下,其他方式请查看https://github.com/baidubce/bce-qianfan-sdk/tree/main/java。
export QIANFAN_ACCESS_KEY=your_access_key
export QIANFAN_SECRET_KEY=your_secret_key
Node.js SDK
支持通过配置文件、环境变量、参数三种初始化方式。
推荐使用环境变量方式初始化,示例如下。其他初始化方式可以参考https://github.com/baidubce/bce-qianfan-sdk/tree/main/javascript。
import {setEnvVariable} from "@baiducloud/qianfan";
// 环境变量初始化
// 替换下列示例中参数,安全认证Access Key替换your_access_key,Secret Key替换your_secret_key
setEnvVariable('QIANFAN_ACCESS_KEY','your_access_key');
setEnvVariable('QIANFAN_SECRET_KEY','your_secret_key');
SDK调用API流程说明
- Python SDK,请查看Python SDK安装及使用流程
- Go SDK,请查看Go SDK安装及使用流程
- Java SDK,请查看Java SDK安装及使用流程
- Node.js SDK,请查看Node.js SDK安装及使用流程