接入jira OAuth权限流程

如果要在自己的系统中操作jira的api完成这些单据的创建、审批等操作，就不得不要先完成jira的第三方授权，才能在第三方系统去做这些jira的操作。

1. 首先必须在jira系统配置客户端的相关信息，须配置几个指标：

   • 客户端访问地址需要先配置
   • Consumer key：客户端关键字（可自定义）
   • Consumer name：客户端名称（接入系统的名称）
   • Public key：公钥（自己生成公钥/私钥对）
   • Callback url：回调地址，用于jira验证登录成功之后回调到客户端系统，并传入准入令牌等信息，客户端再次请求获取access token，并将access token保存在客户端，后面再次请求jira的api就可以携带accesstoken进行请求

2. 生成 RSA 公钥/私钥对
   
   在macos或者linux终端中，运行以下 openssl 命令。
   
   您可以在文件系统的任何位置执行此操作，但请注意，这是创建文件的位置。

生成 1024 位私钥：

openssl genrsa -out jira_privatekey.pem 1024

创建 X509 证书：

openssl req -newkey rsa:1024 -x509 -key jira_privatekey.pem -out jira_publickey.cer -days 365

将私钥（PKCS8格式）提取到 jira_privatekey.pcks8 文件中：

openssl pkcs8 -topk8 -nocrypt -in jira_privatekey.pem -out jira_privatekey.pcks8

将证书中的公钥提取到 jira_publickey.pem文件中：

openssl x509 -pubkey -noout -in jira_publickey.cer  > jira_publickey.pem

• 最终将jira_privatekey.pcks8文件中的私钥字符串考出来，放在客户端程序。
• 将jira_publickey.pem文件中的公钥字符串考出来，放在jira公钥配置的栏目。
• 参考文档：Oauth授权流程

1. 配置好jira的四个配置以后，来到客户端程序，需要在你的客户端系统中配置并保存好两个对应配置，后面需要基于此两个配置来发起授权请求：
   • consumerKey 客户端关键字（和jira配置的一致）
   • privateKey 私钥，上面生成的私钥/公钥对
2. 客户端的后端程序提供接口，获取jira的登陆校验地址，此时后端程序中就需要用到consumerKey和privateKey两个参数，最终此后端接口返回一个授权登录的url给前端服务，由前端页面打开链接窗口。
3. 在前端服务器页面打开的授权登录窗口中，输入jira登录密码，完成授权，此时之前配置在jira的回调地址，会把授权完成产生的oauth_token和oauth_verifier回调到客户端的后端接口程序。
4. 客户端后端的回调方法再次根据获得的oauth_token和oauth_verifier，请求jira换取accesstoken令牌，获得令牌后并保存在服务端数据库。
5. 完成此一系列操作后，最终此回调方法可以返回一个关闭窗口命令的字符串给前端，让前端关掉此前的授权窗口。
6. 所有客户端后端服务需要接口有两个：

获取jira授权地址接口

@ApiOperation(value = "返回jira登录验证页面地址", notes = "返回jira登录验证页面地址", httpMethod = "GET")
    @GetMapping(value = ["/jiraLogin"])
    fun jiraLogin(): Map<String, String> {
        // 请求jira认证
        try {
            return mapOf("redirectUrl" to jiraApiService.getAuthorizeUrl())
        } catch (e: HttpResponseException) {
            Log.get().error("""JIRA 登陆失败: ${e.message}""")
            throw Exception("JIRA 登陆失败!!")
        }
    }

回调接口——在获取授权token和授权码之后调用回调函数换取accessToken

@ApiOperation(value = "jira回调地址完成授权，保存accesstoken", notes = "jira回调地址完成授权，保存accesstoken", httpMethod = "GET")
    @GetMapping(value = ["/oauth"])
    fun jiraLoginCallback(
        @RequestParam(value = "oauth_token") requestToken: String,
        @RequestParam(value = "oauth_verifier") secret: String,
        request: HttpServletRequest,
        response: HttpServletResponse
    ) {
        try {
            val token = jiraApiService.requestJiraAccessToken(requestToken, secret)
            jiraApiService.saveAccessToken(token)
        } catch (e: Exception) {
            Log.get().error("JIRA认证失败: ${e.message}")
        } finally {
            response.addHeader("Content-Type", "text/html; charset=utf-8")
            val out = response.writer
            out.write("""<script language="javascript"> setTimeout("window.close()", 500); </script>""")
            out.close()
        }
    }

1. 流程参考地址：授权完整流程，可下载demo