使用Python调用Okta API授权时返回500错误求助

认证环节已成功执行（控制台输出"Authentication is successful"），但发起授权请求时返回500错误，错误提示为：

Oops! Something went wrong. For more information contact your server administrator.

我的代码实现如下：

import json
import urllib.parse
import random
import requests

active_session = requests.Session()

headers = {'Accept': 'application/json', 'Content-Type': 'application/json'}
auth_data = {
    "username": "mail@mail.com",
    "password": "mypassword",
    "options": {
        "multiOptionalFactorEnroll": False,
        "warnBeforePasswordExpired": False
    }
}
okta_response = active_session.post('https://<my_okta>/api/v1/authn', headers=headers,
                                    json=auth_data)
okta_json_response = json.loads(okta_response.content)
if okta_json_response['status'] != "SUCCESS":
    raise RuntimeError(f"Authentication failed")
else:
    print("Authentication is successful")
session_token = okta_json_response['sessionToken']
okta_app_authorize_data = urllib.parse.urlencode({
    'client_id': '<my_client_id>',
    'redirect_uri': 'https://<my_website>/oauth2/callback',
    'response_type': 'code',
    'state': random.random(),
    'scope': 'openid profile',
    'sessionToken': session_token
})
okta_app_authorize_response = active_session.get('https://<my_okta>/oauth2/default/v1/authorize',
                                                 params=okta_app_authorize_data)

可能的原因及排查方向 #

• state参数类型错误：
  代码中使用random.random()生成state，返回的是浮点数类型，但Okta要求state必须是字符串格式的随机值。服务器解析非字符串的state时可能触发内部异常，导致500错误。建议替换为字符串类型的随机值，例如：

  import uuid
  'state': uuid.uuid4().hex
  

• 授权请求方法不符合规范：
  携带sessionToken的授权请求，Okta官方推荐使用POST方法发送。GET请求会将参数暴露在URL中，部分场景下可能因URL长度限制或参数解析逻辑引发服务器内部错误。可以修改为POST请求，将参数放在请求体中：

  okta_app_authorize_response = active_session.post(
      'https://<my_okta>/oauth2/default/v1/authorize',
      data=okta_app_authorize_data,
      headers={'Content-Type': 'application/x-www-form-urlencoded'}
  )
  

• Okta应用配置存在问题：

  • 确认redirect_uri已添加到Okta应用的「允许重定向URI」列表中，即使认证成功，授权环节的URI不匹配可能触发非标准的500错误。
  • 核对client_id是否与Okta应用的客户端ID完全一致，避免拼写错误或大小写差异。

• Okta租户内部异常：
  登录Okta管理员后台，查看「Reports > System Log」，搜索该授权请求的日志条目，里面会包含具体的错误详情，这是定位500错误最有效的方式。临时的租户服务故障或内部配置问题也可能导致这类错误。

内容的提问来源于stack exchange，提问作者Alex