Django项目python3-saml SSO登出失败：提示“No hostname defined”

问题原因 #

不是使用了错误的包，问题出在OneLogin_Saml2_Auth初始化时传入的Django请求对象缺少http_host和server_name参数——python3-saml依赖这些参数生成SAML登出请求的回调地址，登出流程中这些参数未被正确传入就会触发该错误。

解决方案：手动构造适配的请求参数 #

不要直接将Django的request对象传给OneLogin_Saml2_Auth，而是手动构造符合python3-saml要求的请求字典，补充缺失的主机相关参数：

修改你的登出视图代码如下：

def get(self, request, pkuser=None):
    try:
        get_user_model().objects.get(pk=pkuser)
    except get_user_model().DoesNotExist:
        return redirect('HomePage')

    logger = logging.getLogger('iam')
    logger.info('IAM logout')

    # 手动构造python3-saml需要的请求参数
    saml_request_data = {
        'http_host': request.META.get('HTTP_HOST'),
        'server_name': request.META.get('SERVER_NAME'),
        'server_port': request.META.get('SERVER_PORT'),
        'script_name': request.META.get('PATH_INFO'),
        'request_uri': request.META.get('PATH_INFO'),
        'method': request.method,
        'https': 'on' if request.is_secure() else 'off',
        'query_string': request.META.get('QUERY_STRING', '')
    }

    # 使用构造好的请求数据初始化Auth对象
    auth = OneLogin_Saml2_Auth(saml_request_data, custom_base_path=settings.SAML_FOLDER)

    logger.info('account logout')

    try:
        auth.logout(
            name_id=request.session['samlNameId'],
            session_index=request.session['samlSessionIndex'],
            nq=request.session['samlNameIdNameQualifier'],
            name_id_format=request.session['samlNameIdFormat'],
            spnq=request.session['samlNameIdSPNameQualifier']
        )
        logger.info('account logout success')
        OneLogin_Saml2_Utils.delete_local_session()
        logger.info('account logout: deleted local session')
    except Exception as e:
        logger.info('account logout failed: {}'.format(str(e)))

    logout(request)
    return redirect('HomePage')

额外注意事项 #

• 如果部署环境使用了反向代理（如Nginx），需确保代理服务器正确传递Host头，同时在Django配置中设置USE_X_FORWARDED_HOST = True；若使用HTTPS，还需添加SECURE_PROXY_SSL_HEADER = ('HTTP_X_FORWARDED_PROTO', 'https')，保证request.META里的HTTP_HOST和SERVER_NAME能正确获取。
• 登出时建议先调用auth.logout()再清除本地session，避免提前清除session导致登出请求所需的SAML参数丢失。

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