让 AI 用密码,但碰不到密码。

MimiKey SDK 让你的 App 或 AI 助手向用户借用一条凭据。用户在 MimiKey 的批准卡上点头,你拿到的是只有这台设备能打开的一条结果,别的什么都没有。

从接入到拿到结果,四步。

  1. 1

    登记你的应用

    在 MimiKey 的「开发者接入」里登记,拿到 client_id。手机和桌面 App 用公共客户端,不需要 secret。

  2. 2

    用户授权

    SDK 打开 MimiKey,用户在同意卡上选择授权哪些库、每次询问还是信任。

  3. 3

    发起请求,用户在卡上批准

    调用 pickItem、getItem、createItem 或 updateItem。MimiKey 显示对应的批准卡,由用户选择、填写或确认。

  4. 4

    密封结果送回

    结果加密给这次授权的密钥,回到你的 App 后由 SDK 解开,只存在于进程内存里。

几行 Swift 就能接入。

MimiKeySDK 是一个 Swift 包,只依赖 CryptoKit、Security 和 SwiftUI。

Package.swift
// 或在 Xcode 中:File → Add Package Dependencies
dependencies: [
    .package(path: "../MimiKeySDK"),
],
targets: [
    .target(name: "MyApp", dependencies: ["MimiKeySDK"]),
]

看一遍示例 App 怎么跑。

MimiKey Demo 是用 SDK 写的第三方 App。它请 MimiKey 授权、选条目、新建和修改,全程碰不到你没批准的东西。

  1. 1
    在示例 App 里点「选一个条目」

    示例 App 只负责发起请求,自己不画任何输入密码的界面。

  2. 2
    第一次使用,先在 MimiKey 里授权

    同意卡列出它能做的事,你选授权哪个库、每次询问还是信任。

  3. 3
    在 MimiKey 的选条目卡上点「用这条」

    候选按网址排好序,卡片由 MimiKey 自己的进程显示。

  4. 4
    回到示例 App,只拿到这一条

    结果密封给这次授权,SDK 在进程内存里解开。

MimiKey SDK(Swift)

可用

版本 0.1.0 · iOS 17 / macOS 14,Swift Package

包内含 MimiKeySDK Swift Package 与示例 App 源码(Examples/MimiKeyDemo)。

SDK 示例 App(Mac)

可用

版本 0.1.0 · macOS 14+,需安装 MimiKey for Mac

演示第三方 App 通过 SDK 请 MimiKey 授权、选条目、新建与修改,全程不接触未授权的明文。

SDK 永远看不到的

  • 用户的主密码、Secret Key、库密钥与身份私钥
  • 条目列表,以及用户没有批准的任何条目
  • 新建条目的密码:它在 MimiKey 的安全卡上输入
  • 修改请求里的新值:SDK 先把它密封给用户账号,服务器只见密文

SDK 不写日志、不缓存明文;审批钥与密封钥存在系统钥匙串里,不同步、不迁移。

批准卡由 MimiKey 渲染,不在你的 App 里。

任何让用户决定「给不给、给哪条、填什么、改什么」的界面,都只在 MimiKey 自己的进程里出现。你的 App 可以定制名称、图标和品牌色,卡片的结构、按钮和风险提示由 MimiKey 决定。

  • 同意卡
  • 选条目卡
  • 读取批准卡
  • 安全卡(新建)
  • 修改卡

平台支持

  • iOS 17+
    Swift SDK,公共客户端 + PKCE
    可用
  • macOS 14+
    Swift SDK,与 iOS 同一套 API
    可用
  • Web 与服务器
    机密客户端,通过 REST 接口与签名请求接入
    可用

开发者平台与 MimiKey 一同处于内测阶段,接口可能还会调整。

文档