> For the complete documentation index, see [llms.txt](https://authing.gitbook.io/authing/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://authing.gitbook.io/authing/sdk/sdk-for-node.md). # SDK for Node.js Node SDK 用于 Node 环境下，可以用于管理用户池中所有用户，拥有全部操作权限。 **请注意** [**SDK for JavaScript**](/authing/sdk/sdk-for-node.md) **与** [**SDK for Node.js**](/authing/sdk/sdk-for-node.md) **接口存在差异，请根据需求选择 SDK。** Github：。 ## 安装 **NPM** 当构建大规模应用时，我们推荐使用 `npm` 进行安装。 ```bash # latest stable $ npm install authing-js-sdk --save ``` ## 初始化 先从 [Authing 控制台](https://authing.cn/dashboard) 中 [获取用户池 ID 和 Secret](https://learn.authing.cn/authing/others/faq#ru-he-huo-qu-client-id-he-client-secret)。 初始化代码： ```javascript const Authing = require('authing-js-sdk'); const auth = new Authing({ userPoolId: 'your_userpool_id', secret: 'your_userpool_secret' }); // 初始化之后可以直接使用相关代码 auth.register({...}).then((info) => { }); auth.login({...}).then((info) => { }); ``` 也可以通过用户池管理员的 token 初始化，获得此用户池管理员的权限，之后可以操作用户池中的所有用户，例如获取任意用户池中用户的信息。 * accessToken * 用户池管理员 token **示例** ```javascript const auth = new Authing({ accessToken: 'userpool_manager_token', }); // authing.user({id: '任意用户池中的用户 id'}).then(info => {}) ``` #### 其他参数 * **preflight** * 是否开启网络状况预检，默认为 false。此参数适用于检查用户的网络是否屏蔽了 authing.cn 这个域名（某些企业的内网会屏蔽这个域名），检查成功不进行任何通知，检查失败后会调用传入的错误处理函数。**执行预检之后会导致 SDK 初始化速度变慢，请谨慎使用。** * **cdnPreflight** * 是否开启 CDN 网络状况预检，默认为 false。此参数适用于检查用户的网络是否可以访问七牛云 CDN（某些开了代理的场景下无法访问），检查成功不进行任何通知，检查失败后会调用传入的错误处理函数。**执行 CDN 预检之后会导致 SDK 初始化速度变慢，请谨慎使用。** * **timeout** * 超时时间，默认为 10000 毫秒（10 秒）。 * **passwordEncPublicKey** * PEM 格式密码加密公钥，默认为 Authing 官方的加密公钥。私有化部署用户需要传入自己的加密公钥。 * **onInitError，**`function(err) {}` * 错误处理函数，用于处理初始化失败错误、预检错误。 ## 使用 Authing SDK 的所有 API 都支持 **Promise**。 ```javascript const Authing = require('authing-js-sdk'); const authing = new Authing({ userPoolId: 'your_userpool_id', secret: 'your_userpool_secret' }); authing.login({ email: 'test@testmail.com', password: 'testpassword' }).then(function(user) { console.log(user); }).catch(function(error) { console.log(error); }); ``` 如果你使用 `ES6+` 推荐用 `await` 处理异步，示例如下： ```javascript const Authing = require('authing-js-sdk'); const main = async () => { let auth = new Authing({ userPoolId: 'your_client_id', secret: 'your_userpool_secret' }); let user; //使用async时需要使用 try...catch... 捕捉错误 try { user = await auth.login({ email: 'test@testmail.com', password: 'testpassword' }); }catch(error) { console.log('登录失败:', error); } if(user) { console.log('login success'); }else { console.log('login failed'); } } main(); ``` ## 异常捕获 所有失败的操作，都需要使用 try catch 捕获异常。操作失败有两种情况： * 网络请求出错，常见情况包括：传递参数不合法，这会被 GraphQL 过滤层直接拦截；网络无法连接。 * 业务逻辑出错，常见情况包括：密码不正确，删除某资源传递的 id 不存在等。 为了方便开发者快速定位出错原因，我们提供一个 formatError 函数： ```javascript function formatError(error) { if (typeof error === 'string') return error; if (error.request) { // 网络请求错误 if(error.response) return JSON.stringify(error.response.data); else return JSON.stringify(error.request); } else if (typeof error.message === 'object') { // 业务逻辑错误 if (error.message.message) { return JSON.stringify(error.message.message); } else { return JSON.stringify(error.message); } } else { return error; } } ``` 示例如下： ```javascript try { const res = await authing.authz.deleteGroup("不存在的 groupId") console.log(res) } catch (error) { console.log(formatError(error)) } ``` ## 注册 {% hint style="info" %} 如果你希望用手机号注册用户，可以使用 loginByPhone （手机验证码登录）方法，该方法在用户不存在的时候会自动创建。 {% endhint %} **Authing.register(options)** * **参数:** * `{Object} options` * **email** * **password** * **unionid**，若不使用 email 和 password 则 unionid 必选 * **oauth** 可选，oauth 信息的字符串，或者其他自定义的用户字段都可以以 JSON 字符串的形式存在这里 * **username**，可选，用户名 * **phone**，可选，手机号 * **nickname**，可选，昵称 * **company**，可选，公司名称 * **photo**，可选，用户头像 * **lastIP**，可选，用户登录的 IP 地址 * **signedUp** `{JS Date Object}`，可选，注册时间 * **lastLogin** `{JS Date Object}`，可选，上次登录时间 * **使用方法:** * ```javascript (async function() { const authing = new Authing({ userPoolId: 'your_userpool_id', secret: 'your_userpool_secret' }); const userInfo = await authing.register({ email: email, password: password }).catch((error) => { ... });; })(); ``` * **返回数据:** * ```javascript { "_id": "59e5ff4935eebf1913cfe8a1", "email": "test@test.com", "emailVerified": false, "username": "test@test.com", "nickname": "", "company": "", "photo": "http://www.xiaohehe.net/uploads/allimg/150305/304-1503051H136.png", "browser": "", "token": null, "tokenExpiredAt": null, "loginsCount": 0, "lastLogin": "Tue Oct 17 2017 21:02:01 GMT+0800 (CST)", "lastIP": null, "signedUp": "Tue Oct 17 2017 21:02:01 GMT+0800 (CST)", "blocked": false, "isDeleted": false, "group": { "_id": "59e374332023830871913ebd", "name": "default", "descriptions": "default", "createdAt": "Sun Oct 15 2017 22:44:03 GMT+0800 (CST)" } } ``` ## 登录 **Authing.login(options)** * **参数:** * `{Object} options` * **email** * **password** * **unionid，**若不使用 email 和 password 则 unioinid 必选 * **verifyCode，**可选，频繁注册时会要求输入验证码，返回数据会包含 * **MFACode，**可选，如果用户开启了 MFA 会要求输入 6 位动态口令，返回数据会出现 1635 错误代码 * **lastIP，**可选，若连续出现验证码验证失败情况，请将客户端 IP 填入 * **使用方法:** * ```javascript (async function() { const authing = new Authing({ userPoolId: 'your_userpool_id', secret: 'your_userpool_secret' }); const userInfo = await authing.login({ email: email, password: password }).catch((error) => { /* 如果错误信息提示需要输入验证码，则登录参数应为 { email: email, password: password, verifyCode: verifyCode } /* }); })(); ``` * **返回数据:** * ```javascript { "_id": "59e5ff4935eebf1913cfe8a1", "email": "86700229ww6ss@163.com", "emailVerified": false, "username": "86700229ww6ss@163.com", "nickname": "", "company": "", "photo": "http://www.xiaohehe.net/uploads/allimg/150305/304-1503051H136.png", "browser": "", "token": null, "tokenExpiredAt": null, "loginsCount": 0, "lastLogin": "Tue Oct 17 2017 21:02:01 GMT+0800 (CST)", "lastIP": null, "signedUp": "Tue Oct 17 2017 21:02:01 GMT+0800 (CST)", "blocked": false, "isDeleted": false, "group": { "_id": "59e374332023830871913ebd", "name": "default", "descriptions": "default", "createdAt": "Sun Oct 15 2017 22:44:03 GMT+0800 (CST)" } } ``` ## ## 使用 ODIC 登录 ### Authing.loginByOidc(option) * **参数**: * `{object} options` * **client\_id 必填** （必填）OIDC 应用 ID * **client\_secret** （必填）OIDC 应用 Secret * **email** （必填） 用户 Email * **password** （必填） 用户密码 ```javascript (async function() { const authing = new Authing({ userPoolId: 'your_userpool_id' }); const response = await authing.loginByOidc({ client_id: 'your userpoolId', client_secret: 'your client_serret', email: 'your email', password: 'your password ', }).catch((error) => { ... }) })(); ``` ## 刷新 OIDC Token **Authing.refreshOidcToken(options)** * **参数：** * `{Object} options` * **client\_id** OIDC 应用 id * **client\_secret** OIDC 应用 secret * **refresh\_token** 要刷新的 Token ```javascript (async function() { const authing = new Authing({ userPoolId: 'your_userpool_id' }); const response = await authing.refreshOidcToken({ client_id: 'your OIDC client_id', client_secret: 'your OIDC secret', refresh_token: 'your Token ' }).catch((error) => { ... }) })(); ``` ## AuthingToken 换 OIDC Token 需要先在[**控制台**](https://authing.cn/dashboard) > **第三方登录** > **OIDC 应用**，授权模式中勾选 authingToken。 **Authing.authingTokenToOidcToken(options)** * **参数：** * `{Object} options` * **client\_id**，OIDC 应用 id * **client\_secret**，OIDC 应用 secret * **authingToken，**Authing Token ```javascript (async function() { const authing = new Authing({ userPoolId: 'your_userpool_id' }); const response = await authing.authingTokenToOidcToken({ client_id: 'your OIDC client_id', client_secret: 'your OIDC secret', authingToken: 'your Authing Token' }).catch((error) => { ... }) })(); ``` 返回数据： * 请求成功 ``` { "access_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6IlJJQ015UV9yVFFESlZGYkJEclBDdml0ME9LczBSNWNRX3N1Vmt4alRmOUkifQ.eyJqdGkiOiJXWEl3TldJZ3ZCZ0tXN0lncnVzdXQiLCJzdWIiOiI1ZTg1YWRlZDljYzE4ZTRjYzY3ZTc4MGEiLCJpc3MiOiJodHRwczovL3Rlc3Q4OC5jZWxlYmVzLmxpdmUvb2F1dGgvb2lkYyIsImlhdCI6MTU4NTgxOTExOCwiZXhwIjoxNTg1ODIyNzE4LCJzY29wZSI6Im9wZW5pZCBwcm9maWxlIGVtYWlsIHBob25lIG9mZmxpbmVfYWNjZXNzIiwiYXVkIjoiNWU1ZmMzNGZmMTRiYjI1OTkyZWUyNzgxIn0.Tk4npueRIyJPVxrfiOVQgMKEbk4z_KOvOkOGNyVKyeMtSHEcvU8tMRhjBP_ZrISaT4XO-vu_O1tDUBFhCKMDXWnPMwNotbbcRwRdmzueoe1G0YyxHvcuNihAFyfT_99Skaq3TuG7EzeeFuuvkUejFKRmaODraQY1vQrJl_0WNX1f6NZVYNUcOTCslb_R6qNodFQvjfOJv73FyArETKRAKN5sdTtUWuwxf9QfNm5jwJ_iratqSb5GYU-hd6U-47JKzqv_NEEVrGcRSDrW4ICrulOVPduKOwUqwg7VjHqpvAk2cIt5UdgSh2aaj3KpBhRWm2Exp2AY62sP-oLU3qigBQ", "id_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6IlJJQ015UV9yVFFESlZGYkJEclBDdml0ME9LczBSNWNRX3N1Vmt4alRmOUkifQ.eyJzdWIiOiI1ZTg1YWRlZDljYzE4ZTRjYzY3ZTc4MGEiLCJiaXJ0aGRhdGUiOiIiLCJmYW1pbHlfbmFtZSI6IiIsImdlbmRlciI6IiIsImdpdmVuX25hbWUiOiIiLCJsb2NhbGUiOiIiLCJtaWRkbGVfbmFtZSI6IiIsIm5hbWUiOiIiLCJuaWNrbmFtZSI6IiIsInBpY3R1cmUiOiJodHRwczovL3VzZXJjb250ZW50cy5hdXRoaW5nLmNuL2F1dGhpbmctYXZhdGFyLnBuZyIsInByZWZlcnJlZF91c2VybmFtZSI6IiIsInByb2ZpbGUiOiIiLCJ1cGRhdGVkX2F0IjoiIiwid2Vic2l0ZSI6IiIsInpvbmVpbmZvIjoiIiwidXNlcm5hbWUiOiJwNGdnMnVhcWRjZUB0ZXN0LmNvbSIsImNvbXBhbnkiOiIiLCJicm93c2VyIjoiIiwiZGV2aWNlIjoiIiwibG9naW5zX2NvdW50IjoxLCJyZWdpc3Rlcl9tZXRob2QiOiJkZWZhdWx0OnVzZXJuYW1lLXBhc3N3b3JkIiwiYmxvY2tlZCI6ZmFsc2UsImxhc3RfaXAiOiIxMjQuMjA0LjU2Ljk4IiwicmVnaXN0ZXJfaW5fdXNlcnBvb2wiOiI1ZTE5OTQyMTg4YjAxMzA3ODEyN2MwMjQiLCJsYXN0X2xvZ2luIjoiMjAyMC0wNC0wMlQwOToxODozNy4zNDJaIiwic2lnbmVkX3VwIjoiMjAyMC0wNC0wMlQwOToxODozNy4xODFaIiwiZW1haWwiOiJwNGdnMnVhcWRjZUB0ZXN0LmNvbSIsImVtYWlsX3ZlcmlmaWVkIjpmYWxzZSwicGhvbmVfbnVtYmVyIjoiIiwicGhvbmVfbnVtYmVyX3ZlcmlmaWVkIjpmYWxzZSwiYXdzIjoiZGVtbyIsImF1ZCI6IjVlNWZjMzRmZjE0YmIyNTk5MmVlMjc4MSIsImV4cCI6MTU4NTgyMjcxOCwiaWF0IjoxNTg1ODE5MTE4LCJpc3MiOiJodHRwczovL3Rlc3Q4OC5jZWxlYmVzLmxpdmUvb2F1dGgvb2lkYyJ9.XUOWiKi0mpkcw570rCBZVz0wHWz1gBi5N5Bgz8mqU08FA2dlFradoZ9m_pZYlZPHW6A9R54rI7MzONQlt-sDjGqxLkL6wSNrYIJuYlysRldK3E1NRmziVukMQn8jkyq1DLhKK3WzX_ODbkasHTxdFmJ6iAgouuTjdCdcGv1B1ZTXIKJoIgXwMnYjrWbDULkJg_5_o7eP1GCVG8l5UgIRy5YNunEg7nEVLAu0aj-ob613x5k7ceb-jYLjCX2_9PVIEDeE5exGbz-3txhAxn77xjTi7m1-NEhusTHhd_p315fs0ziCYCaXXsO9eRlJ7I78geP87Thq3-vgQH7YgNy8tA", "refresh_token": "vRZXKWcvyVE9_kKq26OD2gFyame", "expires_in": 3600, "token_type": "Bearer", "scope": "openid profile email phone offline_access" } ``` * 请求失败 ``` { error: 'invalid_grant', error_description: 'invalid credentials provided', } ``` ## 发送手机验证码 此接口可结合[使用手机验证码登录](/authing/sdk/sdk-for-node.md#shi-yong-shou-ji-yan-zheng-ma-deng-lu)使用。 **Authing.getVerificationCode(phone)** * **参数:** * `{String} phone` * 手机号 * **使用方法:** * ```javascript (async function() { const authing = new Authing({ userPoolId: 'your_userpool_id', secret: 'your_userpool_secret' }); const result = await authing.getVerificationCode('phone number') })(); ``` * **返回数据:** * ```javascript { code: 200, // 500 为失败 message: '发送成功' } ``` **短信模版** > 【Authing】{S8} 是你的验证码，有效时间为 {S2} 分钟。如非本人操作请忽略。 {% hint style="info" %} 当前不支持修改短信模版。 {% endhint %} ## 使用手机验证码登录 **Authing.loginByPhoneCode(options)** * **参数:** * `{Object} options` * **phone**，必填，手机号 * **phoneCode**，必填，使用发送短信接口获取 * **使用方法:** * ```javascript (async function() { const authing = new Authing({ userPoolId: 'your_userpool_id', secret: 'your_userpool_secret' }); const userInfo = await authing.loginByPhoneCode({ phone: 'Your Phone', phoneCode: 'Your Phone Code', }).catch((error) => { ... }) })(); ``` * **返回数据:** * ```javascript { "_id": "59e5ff4935eebf1913cfe8a1", "email": "用户邮箱", "emailVerified": false, "username": "用户名", "nickname": "", "phone": "用户手机号", "company": "", "photo": "https://usercontents.authing.cn/client/logo@2.png", "browser": "", "token": null, "tokenExpiredAt": null, "loginsCount": 0, "lastLogin": "Tue Oct 17 2017 21:02:01 GMT+0800 (CST)", "lastIP": null, "signedUp": "Tue Oct 17 2017 21:02:01 GMT+0800 (CST)", "blocked": false, "isDeleted": false, } ``` ## 检测手机号验证码是否正确 **Authing.verifyPhoneCode(options)** * **参数:** * `{Object} options` * **phone**，必填，手机号 * **phoneCode**，必填，使用发送短信接口获取 * **使用方法:** ```javascript (async function() { const authing = new Authing({ userPoolId: 'your_userpool_id', secret: 'your_userpool_secret' }); const result = await authing.verifyPhoneCode({ phone: 'Your Phone', phoneCode: 'Your Phone Code', }) })(); ``` * 返回数据 ```javascript // 验证码正确的返回数据 { code: 200, message: '验证码正确', status: true } // 验证码不正确的示例 { code: 2300, message: '验证码过期', status: false } ``` ## 使用手机号注册 ### 1. 发送验证码 Authing.sendRegisterPhoneCode(phone) ```javascript (async function() { const authing = new Authing({ userPoolId: 'your_userpool_id' }); const response = await authing.sendRegisterPhoneCode( 'Your Phone' ).catch((error) => { ... }) })(); ``` ### 2. 调用接口注册 Authing.register(options) * **参数:** * `{Object} options` * **phone** 手机号 * **phoneCode** 使用步骤一中的发送短信接口获取 * **password** 可选，密码 ```javascript (async function() { const authing = new Authing({ userPoolId: 'your_userpool_id' }); const userInfo = await authing.register({ phone: 'Your Phone', password: 'password', phoneCode: 'Your Phone Code', }).catch((error) => { ... }) })(); ``` ## 使用手机号密码登录 **Authing.loginByPhonePassword(options)** * **参数:** * {Object} options * **phone**，必填，手机号 * **password**，必填，密码 * 使用方法： * ```javascript (async function() { const authing = new Authing({ userPoolId: 'your_userpool_id' }); const userInfo = await authing.loginByPhonePassword({ phone: ‘Your Phone’, password: ‘Your Password’, }).catch((error) => { ... }) })(); ``` * 返回数据： * ```javascript { "_id": "59e5ff4935eebf1913cfe8a1", "email": "86700229ww6ss@163.com", "emailVerified": false, "username": "86700229ww6ss@163.com", "nickname": "", "company": "", "photo": "http://www.xiaohehe.net/uploads/allimg/150305/304-1503051H136.png", "browser": "", "token": null, "tokenExpiredAt": null, "loginsCount": 0, "lastLogin": "Tue Oct 17 2017 21:02:01 GMT+0800 (CST)", "lastIP": null, "signedUp": "Tue Oct 17 2017 21:02:01 GMT+0800 (CST)", "blocked": false, "isDeleted": false, "group": { "_id": "59e374332023830871913ebd", "name": "default", "descriptions": "default", "createdAt": "Sun Oct 15 2017 22:44:03 GMT+0800 (CST)" } } ``` ## 使用 AD 登录 Active Directory 的连接流程请参考： {% content-ref url="/pages/-M4j2-nYtxayAA-VNOWB" %} [接入 Active Directory](/authing/authentication/active-directory.md) {% endcontent-ref %} **Authing.loginByAd(options)** * **参数:** * `{Object} options` * `username`，必传，在 Active Directory 服务中的用户名，必须是 `username@domain.com` 或 `domain\username` 形式。 * `password`，必传，AD 域用户密码。 * `adConnectorId`，必传，AD Connector ID，可以在[**控制台**](https://authing.cn/dashboard) > **第三方登录** > **Active Directory** 获得。 * **使用方法：** ```javascript (async function() { const authing = new Authing({ userPoolId: 'your_userpool_id', secret: 'your_userpool_secret' }); const userInfo = await authing.loginByAd({ adConnectorId: 'Your AD Connector ID', username: 'Your AD domain username', passowrd: 'Your AD domain password', }).catch((error) => { ... }) })(); ``` * **返回数据**： ```javascript { "_id": "5e95788552c17c38d6674fbf", "email": "mary@123.com", "phone": "13112341234", "name": null, "givenName": null, "familyName": null, "username": "mycompany\\mary.smith", "nickname": "Mary Smith", "company": "acompany", "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJkYXRhIjp7ImVtYWlsIjoibWFyeUAxMjMuY29tIiwidW5pb25pZCI6ImFkfDVlOTJkOGVlNjZlY2Y3NWI4MTI3ODNhNHxDTj1NYXJ5IFNtaXRoLENOPVVzZXJzLERDPW15Y29tcGFueSxEQz1sb2NhbCIsImlkIjoiNWU5NTc4ODU1MmMxN2MzOGQ2Njc0ZmJmIiwiY2xpZW50SWQiOiI1ZThjMWY4MmUzYWUxNDJlY2I3YWZhNjciLCJwaG9uZSI6IjEzMTEyMzQxMjM0In0sImlhdCI6MTU4Njg3Mzk2MSwiZXhwIjoxNTg4MTY5OTYxfQ.cmP9k9CKvqqrskcW42LHlOEbvJ2gG2ERJ8VaCmBRRi4", "registerMethod": "ad", "unionid": "ad|5e92d8ee66ecf75b812783a4|CN=Mary Smith,CN=Users,DC=mycompany,DC=local", "postalCode": null } ``` ## 使用 LDAP 登录 LDAP 服务的配置流程请参考[配置 LDAP 服务](/authing/authentication/ldap/ldap.md)。 **Authing.loginByLDAP(options)** * **参数:** * `{Object} options` * `username`，在 LDAP 服务中的登录名，可以是邮箱或用户名 * `password`，在 LDAP 服务中的密码 * **使用方法:** * ```javascript (async function() { const authing = new Authing({ userPoolId: 'your_userpool_id', secret: 'your_userpool_secret' }); const userInfo = await authing.loginByLDAP({ username: 'Your LDAP username', passowrd: 'Your LDAP password', }).catch((error) => { ... }) })(); ``` * **返回数据:** * ```javascript { "_id": "5cbe9a4347618069372e75ff", "username": "Nikola Tesla", "nickname": "Nikola Tesla", "oauth": "{\"dn\":\"uid=tesla,dc=example,dc=com\",\"controls\":[],\"objectClass\":[\"inetOrgPerson\",\"organizationalPerson\",\"person\",\"top\",\"posixAccount\"],\"cn\":\"Nikola Tesla\",\"sn\":\"Tesla\",\"uid\":\"tesla\",\"mail\":\"tesla@ldap.forumsys.com\",\"uidNumber\":\"88888\",\"gidNumber\":\"99999\",\"homeDirectory\":\"home\"}", "unionid": "uid=tesla,dc=example,dc=com", "registerMethod": "ldap:default::from-undefined", "email": "tesla@ldap.forumsys.com", "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJkYXRhIjp7ImVtYWlsIjoidGVzbGFAbGRhcC5mb3J1bXN5cy5jb20iLCJ1bmlvbmlkIjoidWlkPXRlc2xhLGRjPWV4YW1wbGUsZGM9Y29tIiwiaWQiOiI1Y2JlOWE0MzQ3NjE4MDY5MzcyZTc1ZmYiLCJjbGllbnRJZCI6IjVjYTQwMjdjOGEzNjJjODIyZTI2ZDA0ZiJ9LCJpYXQiOjE1NTU5OTY1MjUsImV4cCI6MTU1NzI5MjUyNX0.gcKasWAzO0ZS4ay_KGGp_ihPKG_GaGXk5iQKzP6R4_w", "company": "" } ``` ## 验证用户 Token **Authing.checkLoginStatus(token)** * **参数：** * `token {String}`，必填，Authing 签发的用户 token * **使用方法:** * ```javascript (async () => { const authing = new Authing({ userPoolId: 'your_userpool_id', secret: 'your_userpool_secret' }); const result = await authing.checkLoginStatus('USER_JWT_TOKEN'); })() ``` * **返回数据:** 若 Token 合法，则返回数据为： ```javascript { status: true, code: 200, message: '已登录', token: { ... // Token 数据 } } ``` 当 status 为 false 时，有三种情况，分别返回： ```javascript { status: false, code: 2020, message: '未登录' } ``` ```javascript { status: false, code: 2206, message: '登录信息已过期' } ``` ```javascript { status: false, code: 2207, message: '登录信息有误' } ``` ## 刷新用户 Token **Authing.refreshToken(options)** * **参数:** * `{Object} options` * **user**，必填，用户的 \_id * **使用方法:** * ```javascript (async function() { const authing = new Authing({ userPoolId: 'your_userpool_id', secret: 'your_userpool_secret' }); const token = await authing.refreshToken({ user: '59e5ff4935eebf1913cfe8a1' }) .catch((error) => { ... }) })(); ``` * **返回数据:** * ```javascript { "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJkYXRhIjp7ImVtYWlsIjoieGlleWFuZ0Bkb2RvcmEuY24iLCJpZCI6IjVkMDQ2M2FjODdkNmU5NTEwM2E3MTBjNSJ9LCJpYXQiOjE1NjA1NzEwNzYsImV4cCI6MTU2MTg2NzA3Nn0.qs-Q7UOC5wFa40uIau-50-VjSAVOVjr5nw2opzQeLYg", "iat": 1560571076, "exp": 1561867076, "thirdPartyIdentity": { "refreshSuccess": true, "message": "qq token 刷新成功", "provider": "qq", "refreshToken": "929BF76A31B5F32D3A10F871ABC809F4", "accessToken": "5B99DCFB144917B3D04E522499BD340C", "updatedAt": "2020-02-08T18:12:04+08:00" } } ``` ## 刷新用户三方 Token **Authing.refreshThirdPartyToken(userId)** 此接口用于刷新用户在社会化登录时产生的 access\_token。例如使用 QQ 登录后的 access\_token，可用于调用 QQ 相关业务接口。 * **参数:** * `{String} userId`必填，用户的 \_id * **使用方法:** * ```javascript (async function() { const authing = new Authing({ userPoolId: 'your_userpool_id', secret: 'your_userpool_secret' }); const token = await authing.refreshToken('59e5ff4935eebf1913cfe8a1') .catch((error) => { ... }) })(); ``` * **返回数据:** * ```javascript { "refreshSuccess": true, "message": "qq token 刷新成功", "provider": "qq", "refreshToken": "929BF76A31B5F32D3A10F871ABC809F4", "accessToken": "5B99DCFB144917B3D04E522499BD340C", "updatedAt": "2020-02-08T18:12:04+08:00" } ``` ## 退出 **Authing.logout(uid)** * **参数:** * `{String} uid`，必填，用户的 \_id * **使用方法:** * ```javascript (async function() { const authing = new Authing({ userPoolId: 'your_userpool_id', secret: 'your_userpool_secret' }); await authing.logout('59e5ff4935eebf1913cfe8a1') .catch((error) => { ... }) })(); ``` * **返回数据:** * ```javascript { id: "59e5ff4935eebf1913cfe8a1" } ``` ### 退出 SSO 如果你使用了 OAuth、OIDC 或 SAML 实现了单点登录，那么使用户退出登录需要跳转到一个 URL： > https\://<你的域名>.authing.cn/login/profile/logout?app\_id=\\&redirect\_uri=<退出之后的回调地址> 其中 `app_id` 和 `redirect_uri` 都是必填选项，`redirect_uri` 是退出后你想要返回的地址。 ## 管理用户权限 {% content-ref url="/pages/-LdsvfH3FefEwkF3we-a" %} [配置用户权限](/authing/advanced/roles.md) {% endcontent-ref %} {% content-ref url="/pages/-LrEOJBpsUnzhZ8dcGkc" %} [老版权限控制（deprecated）](/authing/sdk/sdk-for-node/update-user-permissions.md) {% endcontent-ref %} ## 获取单个用户资料 **Authing.user(options)** 除 Authing 用户信息外，`thirdPartyIdentity` 字段包含用户在**第三方社会化登录时**产生的 **access\_token**，可用于调用第三方相关业务接口。 * **参数:** * `{Object} options` * **id**，必填，用户的 \_id * **使用方法:** * ```javascript (async function() { const authing = new Authing({ userPoolId: 'your_userpool_id', secret: 'your_userpool_secret' }); const userInfo = await authing.user({ id: '59e5ff4935eebf1913cfe8a1' }) .catch((error) => { ... }) })(); ``` * **返回数据:** * ```javascript { "_id": "5a584dcd32e6510001a8f144", "email": "1968198962@qq.com", "emailVerified": false, "username": "1968198962@qq.com", "nickname": "", "company": "", "photo": "http://oxacbp94f.bkt.clouddn.com/user-avatars/Fqy_de1Jj5TmngEFiiY1-RsCCDcO", "browser": "", "registerInClient": "59f86b4832eb28071bdd9214", "registerMethod": "default:username-password", "oauth": "", "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJkYXRhIjp7ImVtYWlsIjoiMTk2ODE5ODk2MkBxcS5jb20iLCJpZCI6IjVhNTg0ZGNkMzJlNjUxMDAwMWE4ZjE0NCJ9LCJpYXQiOjE1MTcwMzI1MjV9.Ah0Oii741L_wJHhiE5KtWDgRU1Q3x_fNZBNNM5MhqDc", "tokenExpiredAt": "Sat Jan 27 2018 13:55:25 GMT+0800 (CST)", "loginsCount": 0, "lastLogin": "Fri Jan 12 2018 13:55:25 GMT+0800 (CST)", "lastIP": null, "signedUp": "Fri Jan 12 2018 13:55:25 GMT+0800 (CST)", "blocked": false, "isDeleted": false, "thirdPartyIdentity" : { "provider" : "wechat-mp", "refreshToken" : "30_dfRXbdXTTb3MLeQawh3v-Qcs94cLWbQixkSXlzTtOyaM0ym-K_0kcytTspceZcvu3CCkb6g1NAjId82Vw2DWfGv8sayIjHDFepR1H0SKxyc", "accessToken" : "30_MFUPDUNMrQ-3Z9GSlpZaM3VZjz4guazxZwTyD9pH4640xy1XAYKpFA6eBhYhXFvyTSwtVC3TvyXBemTEkqrALwQ3FzCQsHl43MePbEbzg1Y", "expiresIn" : 7200, "updatedAt" : "2020-02-08T18:11:37.807+08:00" }, "__typename": "ExtendUser" } ``` ## 一次性获取多个用户的资料 **Authing.userPatch(options)** * **参数:** * `{Object} options` * ids * 要获取的用户 id 列表，使用逗号分割，不要出现多余的空格；如果使用非法 id 查询时系统会自动忽略。 * **使用方法:** * ```javascript (async function() { const authing = new Authing({ userPoolId: 'your_userpool_id', secret: 'your_userpool_secret' }); const userInfo = await authing.userPatch({ ids: '5a584dcd32e6510001a8f144,5c08fa74583d9d00019d245e' }) .catch((error) => { ... }) })(); ``` * **返回数据:** * ```javascript { list: [ { _id: '5c0a3565583d9d000219d3960', unionid: 'oVzVG4wo1v0c7uyiFQtHc3Nrl2hg', email: null, emailVerified: false, username: 'xxxxxxxxxxxxxxxxx', nickname: 'xxxxxxxxxxxxxxxxx', company: '', photo: 'xxxxxxxxxxxxxxxxx', browser: '', registerInClient: 'xxxxxxxxxxxxxxxxx', registerMethod: 'oauth:wechat', oauth: 'xxxxxxxxxxxxxxxxx', token: 'xxxxxxxxxxxxxxxxx', tokenExpiredAt: 'Sat Dec 22 2018 16:55:01 GMT+0800 (CST)', loginsCount: 1, lastLogin: 'Fri Dec 07 2018 16:55:01 GMT+0800 (CST)', lastIP: '114.93.36.228', signedUp: 'Fri Dec 07 2018 16:55:01 GMT+0800 (CST)', blocked: false, isDeleted: false, userLocation: null, userLoginHistory: null }, { _id: '5c08fa74583d9d00019d24ee', unionid: 'xxxxxxxxxxxxxxxxx', email: null, emailVerified: false, username: 'xxxxxxxxxxxxxxxxx', nickname: 'xxxxxxxxxxxxxxxxx', company: '', photo: 'xxxxxxxxxxxxxxxxx', browser: '', registerInClient: 'xxxxxxxxxxxxxxxxx', registerMethod: 'oauth:wechat', oauth: 'xxxxxxx', token: 'xxxxxxx', tokenExpiredAt: 'Fri Dec 21 2018 18:31:16 GMT+0800 (CST)', loginsCount: 1, lastLogin: 'Thu Dec 06 2018 18:31:16 GMT+0800 (CST)', lastIP: '221.192.178.75', signedUp: 'Thu Dec 06 2018 18:31:16 GMT+0800 (CST)', blocked: false, isDeleted: false, userLocation: null, userLoginHistory: null } ], totalCount: 2 } ``` ## 获取用户列表 **Authing.list(page, count)** * **参数:** * `{Number} page` * Default: `1` * `{Number} count` * Default: `10` * **使用方法:** * ```javascript (async function() { const authing = new Authing({ userPoolId: 'your_userpool_id', secret: 'your_userpool_secret' }); const userInfo = await authing.list() .catch((error) => { ... }) })(); ``` * **返回数据:** * ```javascript { totalCount: 222, list: [{ "_id": "59e5ff4935eebf1913cfe8a1", "email": "86700229ww6ss@163.com", "emailVerified": false, "username": "86700229ww6ss@163.com", "nickname": "", "company": "", "photo": "http://www.xiaohehe.net/uploads/allimg/150305/304-1503051H136.png", "browser": "", "token": null, "tokenExpiredAt": null, "loginsCount": 0, "lastLogin": "Tue Oct 17 2017 21:02:01 GMT+0800 (CST)", "lastIP": null, "signedUp": "Tue Oct 17 2017 21:02:01 GMT+0800 (CST)", "blocked": false, "isDeleted": false, "group": { "_id": "59e374332023830871913ebd", "name": "default", "descriptions": "default", "createdAt": "Sun Oct 15 2017 22:44:03 GMT+0800 (CST)" } }, ... ] } ``` ## 删除用户 **Authing.remove(uid)** * **参数:** * `{String} uid` * **使用方法:** * ```javascript (async function() { const authing = new Authing({ userPoolId: 'your_userpool_id', secret: 'your_userpool_secret' }); const uid = '59e5ff4935eebf1913cfe8a1'; const userInfo = await authing.remove(uid) .catch((error) => { ... }) })(); ``` * **返回数据:** * ```javascript { _id: '59e5ff4935eebf1913cfe8a1' } ``` ## 修改密码 **Authing.update(options)** * **参数:** * `{Object} options` * password: `{String}，必填，用户新密码` * oldPassword: `{String}，选填，用户原始密码` * **使用方法:** * ```javascript (async function() { const authing = new Authing({ userPoolId: 'your_userpool_id' }); // 以用户身份登录 const login = await authing.login({ email: 'test@test.com', password: '123456' }) // 修改邮箱 await authing.update({ _id: login._id, password: '123456', }); })(); ``` * **返回数据:** * ```javascript { "_id": "59e5ff4935eebf1913cfe8a1", "email": "xxx@xxx.com", "emailVerified": false, "username": "premail@premail.com", "nickname": "", "company": "", "photo": "http://www.xiaohehe.net/uploads/allimg/150305/304-1503051H136.png", "browser": "", "token": null, "tokenExpiredAt": null, "loginsCount": 0, "lastLogin": "Tue Oct 17 2017 21:02:01 GMT+0800 (CST)", "lastIP": null, "signedUp": "Tue Oct 17 2017 21:02:01 GMT+0800 (CST)", "blocked": false, "isDeleted": false, "group": { "_id": "59e374332023830871913ebd", "name": "default", "descriptions": "default", "createdAt": "Sun Oct 15 2017 22:44:03 GMT+0800 (CST)" } } ``` ## 修改用户资料 {% hint style="info" %} 此接口不能用来直接修改手机号和邮箱！ 修改手机号请使用 changePhone 接口。 修改邮箱请使用 changeEmail 接口。 {% endhint %} 若使用 `JavaScript` 调用，需要使用 `then().catch()` 捕获结果和错误。 **Authing.update(options)** 此接口可以用来修改密码、昵称、头像等各种用户信息 * **参数:** * `{Object} options` * \_id `{String} 必填` * email `{String}，选填` * emailVerified: `{Boolean}，选填，邮箱是否经过验证` * username: `{String}，选填` * nickname: `{String}，选填` * company: `{String}，选填` * phone: `{String}，选填` * oauth: `{String}，选填，oauth 信息` * photo: `{String || file object}，选填，用户头像` * browser: `{String}，选填，用户注册时所用的浏览器` * password: `{String}，选填，用户密码` * oldPassword: `{String}（`当有 password 时，旧密码参数必需填写） * token: `{String}，选填` * tokenExpiredAt: `{String}，选填，token 过期时间` * loginsCount: `{Number}，选填，登录次数` * lastLogin: `{String}，选填，最后登录时间` * lastIP: `{String}，选填，最后登录 IP` * signedUp: `{String}，选填，注册时间` * blocked: `{Boolean}，选填，是否被锁定` * isDeleted: `{Boolean}，选填，是否被删除` * **使用方法:** * ```javascript (async function() { const authing = new Authing({ userPoolId: 'your_userpool_id', secret: 'your_userpool_secret' }); // 修改邮箱 await authing.update({ _id: "59e5ff4935eebf1913cfe8a1", email: 'xxx@xxx.com', }); })(); ``` * **返回数据:** * ```javascript { "_id": "59e5ff4935eebf1913cfe8a1", "email": "xxx@xxx.com", "emailVerified": false, "username": "premail@premail.com", "nickname": "", "company": "", "photo": "http://www.xiaohehe.net/uploads/allimg/150305/304-1503051H136.png", "browser": "", "token": null, "tokenExpiredAt": null, "loginsCount": 0, "lastLogin": "Tue Oct 17 2017 21:02:01 GMT+0800 (CST)", "lastIP": null, "signedUp": "Tue Oct 17 2017 21:02:01 GMT+0800 (CST)", "blocked": false, "isDeleted": false, "group": { "_id": "59e374332023830871913ebd", "name": "default", "descriptions": "default", "createdAt": "Sun Oct 15 2017 22:44:03 GMT+0800 (CST)" } } ``` ## 修改邮箱 如果用户已经绑定了邮箱，默认情况下，需要同时验证原有邮箱（目前账号绑定的邮箱）和当前邮箱（将要绑定的邮箱）。也就是说，用户 A 当前绑定的邮箱为 <123456@qq.com>，想修改为 <1234567@qq.com>，那么就需要同时验证这两个邮箱。 开发者也可以选择不开启 “验证原有邮箱“ ，可以在 [Authing 控制台](https://authing.cn/dashboard) 的 **基础配置** - **基础设置** 页面的**安全设置**模块进行关闭。如下图所示： ![](/files/-LvLaDulvTVel_HNbNsV) > 验证码通过的 sendChangeEmailVerifyCode 接口发送。 **Authing.updateEmail(options)** * 参数： * {Object} options * email : 当前邮箱，必填。 * emailCode: 当前邮箱验证码，必填。 * oldEmail：原有邮箱，选填。 * oldEmailCode: 原有邮箱验证码，选填。 * 使用方法 ```javascript (async function() { const authing = new Authing({ userPoolId: 'your_userpool_id' }); // 以用户身份登录 const login = await authing.login({ email: 'test@test.com', password: '123456' }) await authing.updateEmail({ email: "YOUR_NEW_EMAIL" emailCode: "YOUR_EMAIL_CODE" }); })(); ``` * 返回数据：最新的用户信息 ```javascript { "_id": "5a584dcd32e6510001a8f144", "email": "1968198962@qq.com", "emailVerified": false, "username": "1968198962@qq.com", "nickname": "", "company": "", "photo": "http://oxacbp94f.bkt.clouddn.com/user-avatars/Fqy_de1Jj5TmngEFiiY1-RsCCDcO", "browser": "", "registerInClient": "59f86b4832eb28071bdd9214", "registerMethod": "default:username-password", "oauth": "", "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJkYXRhIjp7ImVtYWlsIjoiMTk2ODE5ODk2MkBxcS5jb20iLCJpZCI6IjVhNTg0ZGNkMzJlNjUxMDAwMWE4ZjE0NCJ9LCJpYXQiOjE1MTcwMzI1MjV9.Ah0Oii741L_wJHhiE5KtWDgRU1Q3x_fNZBNNM5MhqDc", "tokenExpiredAt": "Sat Jan 27 2018 13:55:25 GMT+0800 (CST)", "loginsCount": 0, "lastLogin": "Fri Jan 12 2018 13:55:25 GMT+0800 (CST)", "lastIP": null, "signedUp": "Fri Jan 12 2018 13:55:25 GMT+0800 (CST)", "blocked": false, "isDeleted": false, "__typename": "ExtendUser" } ``` ## 发送修改邮箱验证码 开发者可以在 **消息服务 - 邮件模版** 中设置邮件模板，默认的邮件如下图所示： ![](/files/-LvLEkmHl8J-O26OwcBw) 开发者可以自定义 CSS 样式、主题等。 注意：如果请求发送的邮箱已经注册过了，会提示 “该邮箱已绑定，请换一个吧“ 错误。 **Authing.sendChangeEmailVerifyCode(options)** * 参数： * `{Object} options` * `email` * 使用方法 ```javascript (async function() { const authing = new Authing({ userPoolId: 'your_userpool_id' }); // 以用户身份登录 const login = await authing.login({ email: 'test@test.com', password: '123456' }) await authing.sendChangeEmailVerifyCode({ email: "YOUR_NEW_EMAIL" }); })(); ``` * 返回数据 成功示例 ```javascript { code: 200, message: "成功" } ``` 失败示例： ```javascript { code: 2035, message: "该邮箱已绑定，请换一个吧" } ``` ## 修改手机号 和修改邮箱一样，默认情况下，如果用户当前已经绑定了手机号，需要同时验证原有手机号（目前账号绑定的手机号）和当前邮箱（将要绑定的手机号）。也就是说，用户 A 当前绑定的手机号为 15888888888，想修改为 15899999999，那么就需要同时验证这两个手机号。 开发者也可以选择不开启 “验证原有手机号“ ，可以在 [Authing 控制台](https://authing.cn/dashboard) 的 **基础配置** - **基础设置** 页面的**安全设置**模块进行关闭。如下图所示： ![](/files/-LvLb0pZ5EB-IwwPbIwS) > 手机号短信验证码通过 **getVerificationCode** 接口发送**。** **Authing.updatePhone(options)** * 参数： * {Object} options * phone : 当前手机号，必填。 * phoneCode: 当前手机号短信验证码，必填。 * oldPhone：原有手机号，选填。 * oldPhoneCode: 原有手机号短信验证码，选填。 * 使用方法 ```javascript (async function() { const authing = new Authing({ userPoolId: 'your_userpool_id' }); // 以用户身份登录 const login = await authing.login({ email: 'test@test.com', password: '123456' }) await authing.updateEmail({ phone: "YOUR_NEW_PHONE_NUMBER" phoneCode: "YOUR_PHONE_CODE", oldPhone: "YOUR_CURRENT_PHONE_NUMBER", oldPhoneCode: "YOUR_CURRENT_PHONE_CODE" }); })(); ``` * 返回数据：最新的用户信息。 ## ## 重置密码 ### **1. 发送验证码 Authing.sendResetPasswordEmail(options)** * **参数:** * `{Object} options` * email * **使用方法:** * ```javascript (async function() { const authing = new Authing({ userPoolId: 'your_userpool_id', secret: 'your_userpool_secret' }); // 发送验证码到指定邮箱 await authing.sendResetPasswordEmail({ email: 'xxx@xxx.com', }); })(); ``` * **返回数据:** * ```javascript { "message":"成功", "code":null, "__typename": "CommonMessage" } ``` ### **2. 验证验证码 Authing.verifyResetPasswordVerifyCode(options)** * **参数:** * `{Object} options` * email * verifyCode * **使用方法:** * ```javascript (async function() { const authing = new Authing({ userPoolId: 'your_userpool_id', secret: 'your_userpool_secret' }); // 验证验证码 await authing.verifyResetPasswordVerifyCode({ email: 'xxx@xxx.com', verifyCode: 'verifyCode', }); })(); ``` * **返回数据:** * ```javascript { "message": "验证成功，请输入新密码", "code": null, "__typename": "CommonMessage" } ``` ### **3. 发送新密码 Authing.changePassword(options)** * **参数:** * `{Object} options` * email * password * verifyCode * **使用方法:** * ```javascript (async function() { const authing = new Authing({ userPoolId: 'your_userpool_id', secret: 'your_userpool_secret' }); await authing.changePassword({ email: 'xxx@xxx.com', password: 'new_password', verifyCode: 'verifyCode', }); })(); ``` * **返回数据:** * ```javascript { "_id":"5a2a723d598e37000106786a", "email":"1968108962@qq.com", "emailVerified":true, "username":"1968108962@qq.com", "nickname":"", "company":"","photo":"http://oxacbp94f.bkt.clouddn.com/authing-avatar.png","browser":"", "registerInClient":"59f86b4832eb28071bdd9214","registerMethod":"default:username-password", "oauth":"","token":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJkYXRhIjp7ImVtYWlsIjoiMTk2ODEwODk2MkBxcS5jb20iLCJpZCI6IjVhMmE3MjNkNTk4ZTM3MDAwMTA2Nzg2YSJ9LCJpYXQiOjE1MTQwMjcyNDd9.vWrlzKY-Qr0SXwx8k__BF0ADCBjqGgMWP-wVOWgbH7A","tokenExpiredAt":"Sat Dec 23 2017 19:07:27 GMT+0800 (CST)","loginsCount":1,"lastLogin":"Fri Dec 08 2017 19:07:27 GMT+0800 (CST)","lastIP":"172.20.0.1", "signedUp":"Fri Dec 08 2017 19:06:37 GMT+0800 (CST)", "blocked":false,"isDeleted":false, "__typename":"ExtendUser" } ``` ## 验证用户邮箱 ### **发送验证邮件 Authing.sendVerifyEmail(options)** * **参数:** * `{Object} options` * email: 需要验证的邮箱 * **使用方法:** * ```javascript (async function() { const authing = new Authing({ userPoolId: 'your_userpool_id', secret: 'your_userpool_secret' }); await authing.sendVerifyEmail({ email: 'xxx@xxx.com', }); })(); ``` * **返回数据:** * ```javascript { message: "发送验证邮件成功", __typename: "CommonMessage" } ``` 发送之后，用户将会收到一个包含验证链接的邮件，当用户打开此链接，我们将进行验证。 ## 解绑邮箱 若使用 `JavaScript` 调用，需要使用 `then().catch()` 捕获结果和错误。 **Authing.unbindEmail(options)** * **参数:** * `{Object} options` * user `{String} 用户 ID，可选，默认为当前登录用户的 ID` * client `{String} 应用 ID，可选，默认为当前登录应用的 ID` * **使用方法:** * ```javascript Authing.unbindEmail(); (async function() { const authing = new Authing({ userPoolId: 'your_userpool_id', secret: 'your_userpool_secret' }); await authing.unbindEmail(); })(); ``` * **返回数据:** * ```javascript { "_id": "59e5ff4935eebf1913cfe8a1", "email": "86700229ww6ss@163.com", "emailVerified": false, "username": "86700229ww6ss@163.com", "nickname": "", "company": "", "photo": "http://www.xiaohehe.net/uploads/allimg/150305/304-1503051H136.png", "browser": "", "token": null, "tokenExpiredAt": null, "loginsCount": 0, "lastLogin": "Tue Oct 17 2017 21:02:01 GMT+0800 (CST)", "lastIP": null, "signedUp": "Tue Oct 17 2017 21:02:01 GMT+0800 (CST)", "blocked": false, "isDeleted": false } ``` **注意事项** 若未绑定其他登录方式, 则不可解绑邮箱 ## 查询用户授权的 SSO 应用列表 该接口返回用户在一个用户池下授权过的 OAuth 和 OIDC 应用列表。 ### **Authing.**getAuthedAppList**(options)** * **参数:** * `{Object} options` * **clientId**: 用户池 id，必传 * **userId**：用户 id，必传 * **page**：页数，可选，默认 1 * **count**：每页数目，可选，默认 10 * **使用方法:** * ```javascript (async function() { const authing = new Authing({ userPoolId: 'your_userpool_id', secret: 'your_userpool_secret' }); await authing.getAuthedAppList({ clientId: "5d023c7b5642461234b9c62e", userId: "5d765d4013d73a5e90b7857a", page: 1, count: 10 }); })(); ``` * **返回数据:** * ```javascript { "OAuthApps": [ { "_id": "5d5a8a7bbc7275af2cb71920", "name": "test1", "domain": "test123", "clientId": "5d5921ffaa016518f658498d", "description": "", "isDeleted": false, "grants": [ "authorization_code", "implicit", "refresh_token" ], "redirectUris": [ "http://qq.com" ], "when": "Mon Aug 19 2019 19:39:39 GMT+0800 (CST)" }, { "_id": "5d5e2e8b026f9d145bf89203", "name": "oauth1", "domain": "oauth1", "clientId": "5d5921ffaa016518f658498d", "description": "", "isDeleted": false, "grants": [ "authorization_code", "implicit", "refresh_token" ], "redirectUris": [ "http://qq.com" ], "when": "Thu Aug 22 2019 13:56:27 GMT+0800 (CST)" } ], "OIDCApps": [ { "_id": "5d5a85e258375a32d1133d45", "name": "test1", "client_id": "5d5a85e258375a32d1133d45", "domain": "test1", "description": "test1", "authorization_code_expire": "600", "when": "Mon Aug 19 2019 19:20:02 GMT+0800 (CST)", "isDeleted": false, "id_token_signed_response_alg": "HS256", "response_types": [ "code" ], "grant_types": [ "authorization_code", "refresh_token" ], "token_endpoint_auth_method": "client_secret_post", "redirect_uris": [ "http://qq.com" ], "image": "https://usercontents.authing.cn/client/logo@2.png", "access_token_expire": "3600", "id_token_expire": "3600", "cas_expire": "3600" } ], "totalCount": 3 } ``` ## 撤回用户对 SSO 应用的授权 ### **Authing.revokeAuthedApp(options)** * **参数:** * `{Object} options` * **userPoolId**: 用户池 id，必传 * **userId**：用户 id，必传 * **appId**：SSO 应用的 id，必传 * **使用方法:** * ```javascript (async function() { const authing = new Authing({ userPoolId: 'your_userpool_id', secret: 'your_userpool_secret' }); await authing.revokeAuthedApp({ userPoolId: "5d023c7b5642461234b9c62e", userId: "5d765d4013d73a5e90b7857a", appId: "5d5e2e8b026f9d145bf89203" }); })(); ``` * **返回数据:** * ```javascript { "isRevoked": "true", "_id": "5d7661e17a9f981da5fa8098", "scope": "profile", "appId": "5d5e2e8b026f9d145bf89203", "userId": "5d765d4013d73a5e90b7857a", "type": "oauth" } ``` ## 自定义请求链接 `Authing` 构造函数包含一个名为 `host` 对象，可接收自定义的请求链接（适合私有部署 Authing 的用户使用），使用方法如下： ```javascript const auth = new Authing({ userPoolId: 'xxxx', secret: 'xxx', host: { user: 'https://users.authing.cn/graphql', oauth: 'https://oauth.authing.cn/graphql' } }); ``` `host` 对象中 `user` 和 `oauth` 的默认值是 Authing 官方的请求链接： * *