托管用户 API 密钥 — Java SDK

在此页面上

Realm 现为 Atlas Device SDK — 了解详情

应用程序用户可以使用 SDK 生成用户 API 密钥。您可以将唯一的用户 API 密钥与每个设备或服务相关联，从而允许设备或服务代表用户与 Realm 进行通信。

用户 API 密钥始终与其他非匿名身份验证提供商创建的用户对象相关联。每个用户最多可以将 20 个用户密钥与其帐户关联。

提示

用户 API 密钥与服务器 API 密钥不同，服务器 API 密钥允许用户或服务使用API 密钥身份验证提供程序直接向 Realm 进行身份验证。要了解有关服务器 API 密钥的更多信息，请参阅API 密钥身份验证。

要创建新的用户 API 密钥，请调用已登录用户的 apiKeyAuth 实例的 create() 或 createAsync() 方法。用户 API 密钥将与登录的用户相关联，并可用于代表用户与 Realm 进行交互。您无法为匿名用户创建用户 API 密钥。

SDK 仅在您创建用户 API 密钥时返回该密钥的值。请确保安全存储 key值，以便使用它登录。

如果丢失或未存储key值，则无法恢复。您需要创建新的用户 API 密钥。

要获取与已登录用户关联的所有用户 API 密钥的列表，请调用已登录用户的 ApiKeyAuth 实例的同步 fetchAll() 方法或异步 fetchAll() 方法。

要查找已登录用户的特定用户 API 密钥，请将该密钥的 id 传递给已登录用户的 ApiKeyAuth 实例的 fetch() 或 fetchAsync() 方法。

要禁用特定的用户 API 密钥而不删除它，请将该密钥的 id 传递给已登录用户的 ApiKeyAuth 实例的 disable() 或 disableAsync() 方法。

要启用之前禁用的特定用户 API 密钥，请将该密钥的 id 传递给已登录用户的 ApiKeyAuth 实例的 enable() 或 enableAsync() 方法。

要永久删除特定用户 API 密钥，请将该密钥的 id 传递给已登录用户的 ApiKeyAuth 实例的 delete() 或 deleteAsync() 方法。