使用官方 SDK 使用租户令牌
使用官方 SDK 使用租户令牌有两个步骤:生成租户令牌,以及使用该令牌发出搜索请求。
要求
- 一个可用的 Meilisearch 项目
- 一个支持身份验证用户的应用程序
- 安装了 Meilisearch 的官方 SDK 之一
使用官方 SDK 生成租户令牌
首先,导入 SDK。然后创建一组搜索规则
{
"patient_medical_records": {
"filter": "user_id = 1"
}
}
搜索规则必须是一个对象,其中每个键对应于您实例中的索引。您可以为每个索引配置任意数量的过滤器。
接下来,找到您的默认搜索 API 密钥。查询获取 API 密钥端点并检查 uid
字段以获取您的 API 密钥的 UID
curl \
-X GET 'MEILISEARCH_URL/keys/API_KEY' \
-H 'Authorization: Bearer MASTER_KEY'
为了最大程度的安全,您还应该为租户令牌定义过期日期。
最后,将此数据发送到您选择的 SDK 的租户令牌生成器
import { generateTenantToken } from 'meilisearch/token'
const searchRules = {
patient_medical_records: {
filter: 'user_id = 1'
}
}
const apiKey = 'B5KdX2MY2jV6EXfUs6scSfmC...'
const apiKeyUid = '85c3c2f9-bdd6-41f1-abd8-11fcf80e0f76'
const expiresAt = new Date('2025-12-20') // optional
const token = await generateTenantToken({ apiKey, apiKeyUid, searchRules, expiresAt })
SDK 将返回一个有效的租户令牌。
使用租户令牌发出搜索请求
创建令牌后,您必须将其发送到您应用程序的前端。具体如何操作取决于您的具体设置。
租户令牌可用后,使用它来验证搜索请求,就像它是 API 密钥一样
const frontEndClient = new MeiliSearch({ host: 'http://localhost:7700', apiKey: token })
frontEndClient.index('patient_medical_records').search('blood test')
应用程序在搜索时可以互换使用租户令牌和 API 密钥。例如,同一个应用程序可能会对公共索引上的查询使用默认搜索 API 密钥,而对登录用户搜索私有数据时使用租户令牌。