AWS Builder ID Authentication Flow

Educational OIDC Authentication Tool · Research & Development

📚 Full Documentation | 完整文档

⚠️ Disclaimer | 免责声明

This project is provided for educational and research purposes only.

本项目仅供教育和研究目的使用。

This tool does NOT:

• Automate account creation for third-party services
• Circumvent security mechanisms or anti-bot protections
• Violate any Terms of Service

Users are responsible for complying with all applicable Terms of Service and laws.

What is this? | 这是什么？

An educational CLI tool that demonstrates how OIDC device authorization flows work in modern authentication systems. This project is intended for learning authentication concepts, testing OAuth/OIDC flows in your own development environments, and developer education.

一个教育性 CLI 工具，演示现代认证系统中 OIDC 设备授权流程的工作原理。本项目旨在学习认证概念、在您自己的开发环境中测试 OAuth/OIDC 流程以及开发者教育。

Features | 功能特性

• CLI-based demonstration of OIDC device flows | 基于 CLI 的 OIDC 设备流程演示
• Modular authentication flow simulation | 模块化认证流程模拟
• Configurable test parameters | 可配置的测试参数
• Developer-friendly logging | 开发者友好的日志记录
• Beautiful CLI with ASCII crow animations | 精美的 CLI 界面和 ASCII 乌鸦动画
• Multi-language support (English/中文) | 多语言支持
• Debug mode for learning | 用于学习的调试模式
• Cross-platform Node.js CLI | 跨平台 Node.js CLI

How It Works | 工作原理

1. Demonstrates OIDC client registration
   演示 OIDC 客户端注册
   ↓
2. Simulates device authorization flow
   模拟设备授权流程
   ↓
3. Shows authentication response handling
   展示认证响应处理
   ↓
4. Demonstrates token response structure (mock data)
   演示令牌响应结构（模拟数据）
   ↓
5. Educational output for learning purposes
   用于学习目的的教育性输出

Note: All tokens and credentials shown are mock data for educational purposes only.

注意： 所有显示的令牌和凭据均为用于教育目的的模拟数据。

Live Demo | 实时演示

Watch the OIDC authentication flow demonstration with our signature ASCII crow animation

观看带有标志性 ASCII 乌鸦动画的 OIDC 认证流程演示

Quick Start | 快速开始

# Install globally | 全局安装
npm install -g aws-builder-id

# Run the CLI | 运行
aws-builder-id

Or use directly with npx | 或直接使用 npx:

npx aws-builder-id

NPM Package: https://www.npmjs.com/package/aws-builder-id

Installation | 安装

Requirements | 环境要求:

• Node.js >= 18.0.0
• For educational testing only | 仅用于教育测试

npm install -g aws-builder-id

Usage | 使用方法

aws-builder-id

The CLI interface will guide you through | CLI 界面将引导您完成:

1. Language selection | 语言选择 (English/中文)
2. Configuration options | 配置选项
3. Flow demonstration | 流程演示

Demonstration Modes | 演示模式

• Single Flow | 单次流程: Demonstrate one complete OIDC flow | 演示一个完整的 OIDC 流程
• Multiple Flows | 多次流程: Sequential flow demonstrations | 顺序流程演示
• Continuous Mode | 连续模式: Continuous flow testing for development | 用于开发的连续流程测试

Configuration | 配置

Test Configuration | 测试配置

Configure test parameters for OIDC flow demonstrations:

配置 OIDC 流程演示的测试参数：

{
  "test_mode": true,
  "simulation": {
    "enabled": true,
    "mock_responses": true
  },
  "logging": {
    "debug": false,
    "verbose": false
  }
}

Development Settings | 开发设置

For testing in your own development environment:

用于在您自己的开发环境中测试：

• Configure endpoints for your test environment | 为您的测试环境配置端点
• Set up mock authentication servers | 设置模拟认证服务器
• Enable detailed logging for learning | 启用详细日志记录以便学习

Output | 输出

Sample Response Format | 示例响应格式:

{
  "refreshToken": "mock_token_example_only",
  "ClientId": "mock_client_id_example",
  "clientSecret": "mock_secret_example",
  "provider": "BuilderId",
  "email": "[email protected]",
  "password": "ExamplePassword123!"
}

⚠️ Important: All tokens and credentials shown are mock data and placeholders for educational purposes only. This tool does not generate real credentials.

⚠️ 重要提示： 所有显示的令牌和凭据均为模拟数据和占位符，仅用于教育目的。此工具不生成真实凭据。

Output Directory | 输出目录:

• Windows: Documents/AWS Builder ID Test
• macOS: Documents/AWS Builder ID Test
• Linux: ~/aws-builder-id-test

Advanced | 高级功能

Environment Variables | 环境变量

DEBUG=true                    # Enable debug mode | 启用调试模式
TEST_MODE=true                # Enable test mode | 启用测试模式
SIMULATION_DELAY=30           # Delay between simulations | 模拟间延迟（秒）

Development Usage | 开发使用

For integration in your own development projects:

用于集成到您自己的开发项目中：

npm install aws-builder-id

Use in your test environment to understand OIDC flows.

在您的测试环境中使用以了解 OIDC 流程。

Troubleshooting | 故障排除

Common Issues | 常见问题:

1. Configuration errors | 配置错误: Check configuration file syntax | 检查配置文件语法
2. Connection issues | 连接问题: Verify network connectivity | 验证网络连接
3. Timeout errors | 超时错误: Adjust timeout settings | 调整超时设置
4. Simulation errors | 模拟错误: Enable debug mode for details | 启用调试模式查看详情

Get Help | 获取帮助:

• Enable debug mode | 启用调试模式
• Check logs in output directory | 检查输出目录中的日志
• Join Discord | 加入 Discord

Community | 社区

Discord:

discord.gg/crowllm

• Technical support | 技术支持
• Feature requests | 功能建议
• Business partnerships | 商业合作
• Updates & news | 更新和新闻

CrowLLM Ecosystem | CrowLLM 生态系统:

This project is part of the CrowLLM ecosystem - building AI-powered automation tools.

本项目是 CrowLLM 生态系统的一部分 - 构建 AI 驱动的自动化工具。

• Website | 官网: CrowLLM.com (Coming Soon | 即将推出)
• Discord: discord.gg/crowllm

License | 许可证

MIT License - see LICENSE file for details.

MIT 许可证 - 详见 LICENSE 文件。

Acknowledgments | 致谢

• Puppeteer Team - Browser automation framework | 浏览器自动化框架
• 2Captcha - CAPTCHA solving service | 验证码解决服务
• CrowLLM Community - Support and feedback | 支持和反馈

Made with ❤️ by CrowLLM Team

Questions? Business partnerships? | 问题？商业合作？

discord.gg/crowllm