# qweather_key

**Repository Path**: Ergou-/qweather_key

## Basic Information

- **Project Name**: qweather_key
- **Description**: No description available
- **Primary Language**: Python
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-01
- **Last Updated**: 2025-06-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Ed25519密钥生成器

这是一个用于生成和风天气API JWT认证所需的Ed25519密钥对的Python程序。

## 功能特性

- 🔐 生成安全的Ed25519密钥对
- 💾 自动保存为PEM格式文件
- 🔍 计算公钥SHA256哈希值用于验证
- 📋 直接显示公钥内容便于复制
- ⚡ 简单易用的命令行界面

## 安装依赖

在运行程序之前，请先安装所需的Python依赖：

```bash
pip install -r requirements.txt
```

或者直接安装cryptography库：

```bash
pip install cryptography
```

## 使用方法

1. 运行密钥生成程序：

```bash
python generate_ed25519_keys.py
```

2. 程序将在当前目录生成两个文件：
   - `ed25519-private.pem` - 私钥文件（请妥善保管）
   - `ed25519-public.pem` - 公钥文件（需要上传到控制台）

3. 程序会显示：
   - 公钥内容（可直接复制）
   - 公钥的SHA256哈希值（用于验证）
   - 详细的使用说明

## 上传公钥到和风天气控制台

1. 登录[和风天气控制台](https://console.qweather.com/)
2. 进入"项目管理"
3. 选择需要添加凭据的项目
4. 点击"添加凭据"按钮
5. 输入凭据名称
6. 选择身份认证方式"JSON Web Token"
7. 复制程序输出的公钥内容（包括BEGIN和END行）
8. 粘贴到公钥文本框中
9. 点击"保存"按钮
10. 验证控制台显示的SHA256值与程序输出的哈希值是否一致

## 安全提醒

⚠️ **重要安全提醒：**
- 私钥文件(`ed25519-private.pem`)包含敏感信息，请妥善保管
- 不要将私钥上传到任何在线服务或分享给他人
- 建议将私钥存储在安全的位置，并做好备份
- 只有公钥需要上传到和风天气控制台

## 文件说明

- `generate_ed25519_keys.py` - 主程序文件
- `requirements.txt` - Python依赖列表
- `ed25519-private.pem` - 生成的私钥文件（运行后生成）
- `ed25519-public.pem` - 生成的公钥文件（运行后生成）

## 系统要求

- Python 3.6+
- cryptography库 3.4.8+

## 故障排除

如果遇到导入错误，请确保已正确安装cryptography库：

```bash
pip install --upgrade cryptography
```

在Windows系统上，如果遇到编译问题，可以尝试安装预编译的wheel包：

```bash
pip install --only-binary=cryptography cryptography
```