如何通过REST API登录Portal for ArcGIS

时间：2023-03-10 05:05:33
如何通过REST API登录Portal for ArcGIS

Portal for ArcGIS 提供了两种登录方式：OAuth 2.0和传统的token登录方式。

OAuth 2.0的登录原理在之前的一篇文章中已经描述，所以今天就不重复了。下面将介绍对于不支持OAuth2.0的应用，如何通过REST API登录Portal for ArcGIS。

其关键是通过ArcGIS REST API中提供的一个生成令牌的接口获得token，然后把token和相关的登录账户信息保存到一个名为esri_auth的cookie中。同时要注意cookie的domain必须和Portal for ArcGIS的访问地址一致，如果不一致，可通过代理页来完成cookie的写入和页面跳转工作。

生成令牌的接口说明如下：

https://<root-url>/generateToken(POST only)

该接口只支持HTTP POST方法。

相关参数为：

参数 说明
username 用户名
password 密码
client 只支持取值为referer
referer 登录后，跳转的应用基础url
expiration token超时设置，默认为60分钟

下面为示例代码，这里使用jQuery作为前端JS发送POST请求，实际应用时建议采用后端代码执行方式：

 <!DOCTYPE html>

 <html lang="en">

     <head>

         <meta charset="UTF-8">

         <meta name="viewport" content="width=device-width">

         <title>Demo</title>

         <link rel="stylesheet" href="css/style.css">

         <script src="components/jquery/dist/jquery.js"></script>

         <script src="components/jquery-ui/jquery-ui.js"></script>

         <script src="components/jquery.cookie/jquery.cookie.js"></script>

         <script src="js/index.js"></script>

     </head>

     <body>

         <p>Name</p>

         <input id="Name" type="text">

         <p>Password</p>

         <input id="Password" type="text">

         <br>

         <button>Login</button>

         <br>

         <a href="https://webgis40.esrigz.com/portal">Portal</a>

     </body>

 </html>

下面是对应的JavaScript代码，实际在请求获得token后，还需要通过REST API请求登录用户的个人信息，包括email、culture、accountId、role，为了简单演示，把这些信息硬编码写在代码中了：

 $(function () {

   $("button").click(function () {

     $.cookie('name','value')

     let n = $('#Name').val()

     let p = $('#Password').val()

     let url = 'https://webgis40.esrigz.com/portal/sharing/rest/generateToken'

     let redirect = 'https://webgis40.esrigz.com/portal'

     data = { username: n, password: p, referer: redirect, client: 'referer',f:'json'}

     $.post(url, data).done((d) => {

       let tokenHolder = JSON.parse(d)

       let encode_token = encodeURI(tokenHolder.token)

       let expires = tokenHolder.expires

       //console.log(encode_token)

       let auth = { "portalApp": true, "email": "portaladmin", "token": tokenHolder.token, "culture": "en", "region": null, "expires": tokenHolder.expires,"allSSL":false,"accountId":"0123456789ABCDEF","role":"org_admin"}

       $.cookie('esri_auth', JSON.stringify(auth), { path: '/', domain:'webgis40.esrigz.com'})

       window.location = redirect //支持自动跳转，如果不需要，则屏蔽该行代码。

     }

     )

   })

 }

 )

相关文章