news 2026/4/16 16:16:40

Google身份验证库Node.js版完全使用指南

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
Google身份验证库Node.js版完全使用指南

Google身份验证库Node.js版完全使用指南

【免费下载链接】google-auth-library-nodejs🔑 Google Auth Library for Node.js项目地址: https://gitcode.com/gh_mirrors/go/google-auth-library-nodejs

项目介绍

Google身份验证库(google-auth-library-nodejs)是Google官方支持的Node.js客户端库,专门用于处理OAuth 2.0授权和认证流程,让开发者能够安全地访问各种Google APIs。该库提供了统一的方式来管理认证流程,包括获取和刷新令牌,以及处理多种类型的凭据。

快速开始

安装依赖

npm install google-auth-library

基础用法示例

// 引入Google Auth库 const {GoogleAuth} = require('google-auth-library'); async function main() { // 创建GoogleAuth对象,指定所需权限 const auth = new GoogleAuth({ scopes: 'https://www.googleapis.com/auth/cloud-platform', }); // 获取认证客户端 const client = await auth.getClient(); // 获取项目ID const projectId = await auth.getProjectId(); // 构建请求URL const url = `https://storage.googleapis.com/storage/v1/b?project=${projectId}`; // 发送请求 const res = await client.request({url}); // 打印结果 console.log(res.data); } main().catch(console.error);

认证方式详解

应用程序默认凭据(ADC)

ADC是Google推荐的身份验证方式,特别适合在Google Cloud平台上运行的应用程序。它会根据运行环境自动选择最合适的凭据类型。

const {GoogleAuth} = require('google-auth-library'); const auth = new GoogleAuth({ scopes: 'https://www.googleapis.com/auth/cloud-platform', projectId: 'your-project-id', });

OAuth 2.0认证

适用于需要代表终端用户执行操作的场景。

const {OAuth2Client} = require('google-auth-library'); const keys = require('./oauth2.keys.json'); const oAuth2Client = new OAuth2Client({ clientId: keys.web.client_id, clientSecret: keys.web.client_secret, redirectUri: keys.web.redirect_uris[0] }); // 生成授权URL const authorizeUrl = oAuth2Client.generateAuthUrl({ access_type: 'offline', scope: 'https://www.googleapis.com/auth/userinfo.profile', });

JSON Web Tokens(JWT)

适用于服务器到服务器或服务器到API的通信场景。

const {JWT} = require('google-auth-library'); const keys = require('./jwt.keys.json'); const client = new JWT({ email: keys.client_email, key: keys.private_key, scopes: ['https://www.googleapis.com/auth/cloud-platform'], });

工作负载身份联邦

允许从AWS、Microsoft Azure或任何支持OpenID Connect(OIDC)的身份提供商访问Google Cloud资源。

AWS工作负载配置
# 生成AWS工作负载身份配置 gcloud iam workload-identity-pools create-cred-config \ projects/$PROJECT_NUMBER/locations/global/workloadIdentityPools/$POOL_ID/providers/$AWS_PROVIDER_ID \ --service-account $SERVICE_ACCOUNT_EMAIL \ --aws \ --output-file /path/to/generated/config.json
Azure工作负载配置
# 生成Azure工作负载身份配置 gcloud iam workload-identity-pools create-cred-config \ projects/$PROJECT_NUMBER/locations/global/workloadIdentityPools/$POOL_ID/providers/$AZURE_PROVIDER_ID \ --service-account $SERVICE_ACCOUNT_EMAIL \ --azure \ --output-file /path/to/generated/config.json

高级功能

身份令牌管理

// 获取身份令牌客户端 const {GoogleAuth} = require('google-auth-library'); const url = 'https://cloud-run-1234-uc.a.run.app'; const auth = new GoogleAuth(); const client = await auth.getIdTokenClient(url); const res = await client.fetch(url); console.log(res.data);

模拟凭据客户端

const {GoogleAuth, Impersonated} = require('google-auth-library'); async function main() { const auth = new GoogleAuth(); const sourceClient = await auth.getClient(); const targetClient = new Impersonated({ sourceClient: sourceClient, targetPrincipal: 'impersonated-account@projectID.iam.gserviceaccount.com', lifetime: 30, delegates: [], targetScopes: ['https://www.googleapis.com/auth/cloud-platform'] }); }

降级范围客户端

const {GoogleAuth, DownscopedClient} = require('google-auth-library'); const cabRules = { accessBoundary: { accessBoundaryRules: [ { availableResource: '//storage.googleapis.com/projects/_/buckets/bucket_name', availablePermissions: ['inRole:roles/storage.objectViewer'], availabilityCondition: { expression: 'resource.name.startsWith('projects/_/buckets/bucket_name/objects/customer-a')' } ], }, };

实际应用场景

云端应用认证

在Node.js应用中使用外部身份时,需要将roles/browser角色授予服务账户,同时确保启用Cloud Resource Manager API,以便从当前环境自动发现项目ID。

const auth = new GoogleAuth({ scopes: 'https://www.googleapis.com/auth/cloud-platform', projectId: '<your-project-id>', });

工作负载联邦认证

对于不在Google Cloud上运行的应用,可以利用工作负载身份联邦,通过OpenID Connect认证方式接入AWS、Azure或其他兼容的身份提供商。

安全最佳实践

  1. 验证凭据配置:在将凭据配置提供给任何Google API或库之前,必须对其进行验证
  2. 限制访问权限:遵循最小权限原则
  3. 定期轮换凭据:确保凭据的安全性

项目结构说明

google-auth-library-nodejs/ ├── src/ │ ├── auth/ # 认证客户端实现 │ ├── crypto/ # 加密相关功能 │ └── index.ts # 主入口文件 ├── samples/ # 示例代码 ├── test/ # 测试文件 └── system-test/ # 系统测试

环境要求

  • Node.js版本:>=18
  • 支持的平台:Linux、Windows、macOS

总结

Google身份验证库为Node.js开发者提供了强大而灵活的身份认证解决方案。无论是简单的API调用还是复杂的企业级应用,该库都能提供可靠的安全保障和便捷的使用体验。

通过合理配置和使用各种认证方式,开发者可以构建出既安全又高效的云应用系统。

【免费下载链接】google-auth-library-nodejs🔑 Google Auth Library for Node.js项目地址: https://gitcode.com/gh_mirrors/go/google-auth-library-nodejs

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/4/15 15:00:56

5大核心技术解析:如何用FOC算法彻底改造你的平衡车电机

5大核心技术解析&#xff1a;如何用FOC算法彻底改造你的平衡车电机 【免费下载链接】hoverboard-firmware-hack-FOC With Field Oriented Control (FOC) 项目地址: https://gitcode.com/gh_mirrors/ho/hoverboard-firmware-hack-FOC 你是否曾经被平衡车刺耳的电机噪音困…

作者头像 李华
网站建设 2026/4/16 13:54:47

LaTeX专业简历制作完整指南:打造脱颖而出的求职材料

LaTeX专业简历制作完整指南&#xff1a;打造脱颖而出的求职材料 【免费下载链接】resume Software developer resume in Latex 项目地址: https://gitcode.com/gh_mirrors/res/resume 在当今竞争激烈的就业市场中&#xff0c;一份精心设计的简历是你获得面试机会的关键敲…

作者头像 李华
网站建设 2026/4/16 13:07:41

百考通AI:学术写作全流程智能辅助的深度探索

在当今的学术研究领域&#xff0c;写作不仅是成果输出的最后环节&#xff0c;更是贯穿研究始终的思维整理与表达过程。从选题开题到最终答辩&#xff0c;每个阶段都对研究者提出了不同的写作要求与挑战。特别是对于不同学历层次的研究者而言&#xff0c;学术写作的标准、深度与…

作者头像 李华
网站建设 2026/4/16 11:15:17

GPU算力租赁平台如何集成Miniconda环境模板

GPU算力租赁平台如何集成Miniconda环境模板 在AI模型训练日益复杂的今天&#xff0c;一个看似不起眼的细节往往决定项目成败——你的代码“在我机器上能跑”&#xff0c;但在别人那里却报错不断。这种尴尬不仅发生在实验室里&#xff0c;更频繁出现在GPU算力租赁平台上&#xf…

作者头像 李华
网站建设 2026/4/16 14:29:05

二进制逆向利器fq:三步掌握专业级数据解析技能

二进制逆向利器fq&#xff1a;三步掌握专业级数据解析技能 【免费下载链接】fq jq for binary formats - tool, language and decoders for working with binary and text formats 项目地址: https://gitcode.com/gh_mirrors/fq/fq 你是否曾面对一堆神秘的二进制数据束手…

作者头像 李华
网站建设 2026/4/16 11:11:24

自组织特征映射(SOM)的数据聚类程序。 matlab程序 数据格式为excel

自组织特征映射(SOM)的数据聚类程序。 matlab程序 数据格式为excel。打开MATLAB准备搞点数据魔法&#xff1f;今天咱们整点有意思的——用自组织特征映射(SOM)给Excel数据自动分群。这玩意儿就像给数据画美食地图&#xff0c;让相似的样本自动抱团取暖。先来点准备工作。把Exce…

作者头像 李华