06.会话Sessions

会话

会话表示登录到设备的用户实例。当用户登录或注册时会自动创建会话。当用户注销时,它们会自动删除。每个“user-installation”对都有一个不同的Session对象; 如果用户从已经登录的设备发出登录请求,该用户Installation上之前的Session对象将被自动删除。Session对象存储在Parse上的Session类中,您可以在Parse数据浏览器上查看它们。我们提供一组API来管理您应用中的Session对象。

Session是Parse Object的子类,因此您可以以与Parse中操作正常对象相同的方式查询、更新和删除sessions。因为Parse Cloud会在您登录或注册用户时自动创建sessions,因此您不应手动创建Session对象,除非您正在构建“Parse IoT”应用程序(如Arduino或Embedded C)。删除Session将会把正在使用此会话令牌的设备中的用户注销掉。

与其他Parse对象不同,Session类没有Cloud Code触发器。所以你不能为Session类注册一个beforeSave或者afterSave处理程序。

1.Session 属性

Session对象具有以下特殊字段:

  • sessionToken(只读):用于在Parse API请求上进行身份验证的字符串令牌。在Session查询响应中,只有当前Session对象包含一个会话令牌。
  • user:(只读)指向此会话所用User对象的指针。
  • createdWith(只读):有关如何创建此会话的信息(例如{ "action": "login", "authProvider": "password"})。
    • action可以有以下值:login,signup,create,或upgrade。create action是指开发者通过存储Session对象手动创建会话。upgrade action是指用户从旧会话令牌升级到可撤销会话。
    • authProvider可以有以下值:password,anonymous,facebook,或twitter。
  • restricted (只读):此会话是否受限制,为布尔值。
    • 受限的会话没有对Parse上的User和Session,和Role类的写入权限。受限的会话也无法读取不受限的会话。
    • 在用户登录/注册期间,Parse Cloud自动创建的所有会话将不受限制。开发人员从客户端(仅对“Parse for IoT”应用程序)通过保存一个新的Session对象而手动创建的所有会话都是受限的。
  • expiresAt(只读):该Session对象将被自动删除时的大约UTC日期。您可以在应用程序的Parse.com dashboard设置页面中配置会话过期时间(1年不活动则到期或无过期)。
  • installationId(只能设置一次):表示会话登录位置的Installation字符串。对于Parse SDK,当用户登录或注册时,该字段将自动设置。除installationId外的所有特殊字段,只能由Parse Cloud自动设置。您可以将自定义字段添加到Session对象中,但请记住,任何已登录的设备(带有会话令牌)都可以读取属于同一用户的其他会话(除非您禁用类级权限,请参见下文)。

2.处理无效的session Token错误

对于可撤销会话,如果从Parse Cloud中删除其对应的Session对象,则当前会话令牌可能无效。如果您实现了一个会话管理器UI可允许用户在其他设备上注销,或者手动通过Cloud Code,REST API或数据浏览器删除会话,则可能会发生这种情况。会话也可能由于自动过期(如果在应用设置中配置)被删除。只要设备的会话令牌不再与Parse Cloud上的Session对象相对应时,来自该设备的所有API请求都将失败,并显示“错误209:无效的会话令牌”(Error 209: invalid session token)。

为了处理这个错误,我们建议您编写一个由所有Parse请求错误回调调用的全局公用函数。然后,您可以在此全局函数中处理“无效会话令牌”错误。您应该提示用户再次登录,以便他们可以获得一个新的会话令牌。代码如下所示:

function handleParseError(err) {
  switch (err.code) {
    case Parse.Error.INVALID_SESSION_TOKEN:
      Parse.User.logOut();
      ... // If web browser, render a log in screen
      ... // If Express.js, redirect the user to the log in route
      break;

    ... // Other Parse API errors that you want to explicitly handle
  }
}

// For each API request, call the global error handler
query.find().then(function() {
  ...
}, function(err) {
  handleParseError(err);
});

3.Session 安全

Session对象只能由用户字段中指定的用户访问。所有Session对象都具有只有该用户可读写的ACL。您不能更改此ACL。这意味着查询会话只会返回与当前登录用户匹配的对象。

当您通过User login方法登录用户时,Parse会自动在Parse Cloud中创建一个新的不受限Session对象。注册操作和Facebook/Twitter登录时也一样。

从客户端SDK手动创建会话对象(创建一个Session实例并保存)始终是受限的。您不能使用对象创建API手动创建一个不受限的会话。

受限会话被禁止创建、修改、或删除User、Session以及Role类中的任何数据。受限会话也无法读取不受限的会话。受限会话对于“Parse for IoT”设备(例如Arduino或 Embedded C)很有用,相对移动应用程序,它们很可能运行在不太可靠的物理环境。但是,请记住,受限会话仍然可以读取User,Session以及Role类的数据,并可以像正常的session一样读/写任何其他类的数据。因此,对于物联网设备,使其处于安全的物理环境,理想情况下使用加密存储来保存会话令牌,仍然至关重要。

如果你想防止受限会话修改User、Session或者Role之外的其他类,你可以为该类写一个Cloud Code beforeSave处理程序:

Parse.Cloud.beforeSave("MyClass", function(request, response) {
  Parse.Session.current().then(function(session) {
    if (session.get('restricted')) {
      response.error('write operation not allowed');
    }
    response.success();
  });
});

您可以像Parse中的其他类一样为Session类配置类级别权限(CLP)。CLP通过Session API 限制会话的读取/写入,但是当用户登录,注册和注销时,不会限制Parse Cloud的自动会话创建/删除操作。我们建议您禁用应用程序不需要的所有CLP。以下是会话CLP的常见用例:

  • Find, Delete - 用于构建了UI界面,允许用户在所有设备上查看其活动会话,并在其他设备上注销会话。如果您的应用没有此功能,您应该禁用这些权限。
  • Create - 用于“Parse for IoT”应用程序(例如Arduino或嵌入式C),为除手机应用程序之外的其他设备提供受限的用户会话。在构建移动和网络应用程序时,应禁用此权限。对于“Parse for IoT”应用程序,您应该检查您的IoT设备是否实际需要访问用户特定的数据。如果没有,那么您的IoT设备不需要用户会话,您应该禁用此权限。
  • Get, Update, Add Field - 除非需要这些操作,否则应禁用这些权限。
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 194,242评论 5 459
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 81,769评论 2 371
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 141,484评论 0 319
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,133评论 1 263
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 61,007评论 4 355
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,080评论 1 272
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,496评论 3 381
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,190评论 0 253
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,464评论 1 290
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,549评论 2 309
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,330评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,205评论 3 312
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,567评论 3 298
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,889评论 0 17
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,160评论 1 250
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,475评论 2 341
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,650评论 2 335

推荐阅读更多精彩内容

  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,494评论 18 139
  • 安全 随着应用程序开发的进行,您将需要使用Parse的安全功能来保护数据。本文档介绍了如何保护应用程序。 如果您的...
    xiangdong_9013阅读 910评论 2 1
  • 构建用户管理微服务翻译自:https://springuni.com 构建用户管理微服务(一):定义领域模型和 R...
    极乐君阅读 1,503评论 0 10
  • 点击查看原文 Web SDK 开发手册 SDK 概述 网易云信 SDK 为 Web 应用提供一个完善的 IM 系统...
    layjoy阅读 13,590评论 0 15
  • 还记得我之前准备店长会作业的时候,别人都是特别重视,提前就会把自己将要演讲的内容先整理一下,而我每次都不提前准备都...
    城市格调刘姣阅读 219评论 0 0