当前位置：首页 > news >正文

使用python调用JIRA6 REST API及遇到的问题

news 2026/2/8 11:59:29

JIRA认证方式简述

JIRA接口调用有两种认证方式访问Jira Rest API，基本认证⽅式(⽤户名和密码)和OAuth1认证方式。

基本认证⽅式：因为⽤户名和密码会被浏览器重复地请求和发送，即使采⽤ SSL/TLS 发送，也会有安全隐患，因此不建议使⽤。
OAuth 认证⽅式： OAuth 是⼀种认证协议，允许Jira⽤户(Resource Owner) 授权第三⽅应⽤访问他们能操作的Jira 内容，Jira 使⽤ OAuth 1.0a版本。

java方式使用的依赖包

以前写的java的方式是通过google的oauth-client实现的。

<dependency><groupId>com.google.oauth-client</groupId><artifactId>google-oauth-client</artifactId><version>1.22.0</version>
</dependency>

python代码示例

之前用Java程序调用过JIRA接口，这次改成python调用接口，发现跟java程序有些不一样，同样的凭证，通过java访问JIRA接口没有问题，但是使用python时就会出现一些问题。

下面是调通后没有问题的代码

import requests
from requests_oauthlib import OAuth1# 配置 OAuth 信息
# 替换为你的 JIRA 服务器地址
JIRA_BASE_URL = "https://jira.example.com"
# 在 JIRA 应用链接中配置的 Consumer Key
CONSUMER_KEY = "your_consumer_key"
# 私钥，对应的公钥是配置在JIRA中的
PRIVATE_KEY = """
-----BEGIN RSA PRIVATE KEY-----
<your_private_key_here>
-----END RSA PRIVATE KEY-----
"""
# 在获取 Access Token中，根据生成的链接，获取到的secret
CLIENT_SECRET = "your_consumer_secret"
# 从 JIRA 获取的 Access Token
ACCESS_TOKEN = "your_access_token"
# 从 JIRA 获取的 Access Token Secret
ACCESS_TOKEN_SECRET = "your_access_secret" # 创建 OAuth1 对象，这块比较重要，主要是这里的参数跟java程序有些不同
oauth = OAuth1(client_key=CONSUMER_KEY,rsa_key=PRIVATE_KEY,client_secret=CLIENT_SECRETresource_owner_key=ACCESS_TOKEN,resource_owner_secret=ACCESS_TOKEN_SECRET,signature_method="RSA-SHA1"
)# 调用 JIRA REST API 示例：获取问题详情
# 替换为实际的 Issue Key
issue_key = "TEST-123"
# 最终请求的URL
url = f"{JIRA_BASE_URL}/rest/api/2/issue/{issue_key}"# 发起请求
response = requests.get(url, auth=oauth)# 处理响应
if response.status_code == 200:print("Issue Details:", response.json())
else:print(f"Failed to fetch issue. Status Code: {response.status_code}")print("Response:", response.text)

遇到的问题及解决方式

ModuleNotFoundError: No module named 'jwt'

ModuleNotFoundError: No module named 'jwt' 错误表明你的 Python 环境中没有安装 jwt 模块。这个模块通常是 PyJWT，它用于处理 JSON Web Token (JWT) 的生成和验证。

安装PyJWT

pip install PyJWT

验证安装

python -c "import jwt; print(jwt.__version__)"

如果没有报错，说明安装成功，并会打印 PyJWT 的版本号。

jwt.exceptions.InvalidKeyError:cound not parse th provided public key

这也是让我最困惑的问题，public key不是在客户端的，是在JIRA中配置的，但是却提示public key有问题，但是我通过java程序去访问是成功的，所以JIRA中配置的应该也没有问题。

密钥内容应该没有问题，所以我就检查了密钥的格式。

这也是python跟java不一样的，我在java中，就是将RSA私钥作为一个字符串使用是没有问题的，所以也习惯的在python中使用字符串使用，结果就出问题了。

检查公钥的格式

确保公钥的格式正确，通常公钥以 PEM 格式存储，包含以下内容：

-----BEGIN PUBLIC KEY-----
<base64_encoded_key>
-----END PUBLIC KEY-----

检查点

公钥需要完整，包括 -----BEGIN PUBLIC KEY----- 和 -----END PUBLIC KEY----- 标志。
中间的内容应为 Base64 编码的公钥。

如果没有这些标志，尝试手动添加。

signature_method_rejected

signature_method_rejected 错误表明 JIRA 不接受你在 OAuth1 请求中指定的签名方法。这通常是由于以下原因之一导致的：

签名方法配置不正确（JIRA 只支持 RSA-SHA1）。
JIRA 中的应用链接未正确配置。
使用了不匹配的密钥对，或者密钥格式错误。

这也是python方式跟java方式另外一个不同的地方，在python中生成OAuth1对象时，必须指定signature_method="RSA-SHA1"

AttributeError: module 'jwt.algorithms' has no attribute 'hashes'

可能由于一下原因导致：

没有安装cryptography
jwt和PyJWT同时存在引起冲突

安装 cryptography

pip install -U cryptography

解决冲突

# jwt卸载
pip uninstall jwt
# 保险起见，将PyJWT一同卸载
pip uninstall PyJWT
# 重新安装PyJWT
pip install PyJWT

报没有权限，必须登录

这又是一个让我很莫名奇妙的问题，用java都是可以了，用python就说没有权限，必须登录，难道让我使用基本认证方式。

想到了client_secret这个参数，因为这个凭证在java中是用到的，但是在网上找的示例中都没有提示用这个参数，然后就尝试在生成OAuth1对象时加上这个，结果成功了。

client_secret=CLIENT_SECRET