@ distilled.cloud/单词
效果-内生 1 Password SDK,由 1Password 所出版的 OpenAPI 规格所产生 : 连接, (中文(简体) ), 活动, (中文(简体) ), 用户, (中文(简体) ), 奥奥特 财务报告和审定财务报表 伙伴关系。 。 。 .
安装
npm install @distilled.cloud/onepassword effect
APIs 密码
每个API是一个服务命名空间,有自己的证书层和协议. 服务本身也可进口,例如:. @distilled.cloud/onepassword/connect。 。 。 .
| API 密码 | 业务 | 全权证书 | 议定书 |
|---|---|---|---|
| 连接 | Onepassword.connect.getVaults,, , , , , , , , | ConnectCredentialsFromEnv | ConnectProtocol |
| 活动 | Onepassword.events.getAuditEventsV2,, , , , , , , , | EventsCredentialsFromEnv | EventsProtocol |
| 用户 | Onepassword.users.listUsers,, , , , , , , , | UsersCredentialsFromEnv | UsersProtocol |
| 奥奥特 | Onepassword.oauth.requestAccessToken,, , , , , , , , | OAuthCredentialsFromEnv | OAuthProtocol |
| 伙伴关系 | Onepassword.partnership.createPartnerAccount,, , , , , , , , | PartnershipCredentialsFromEnv | PartnershipProtocol |
快开始
连接( 自托管的连接服务器) :
import { Effect, Layer } from "effect";
import * as FetchHttpClient from "effect/http/FetchHttpClient";
import * as Onepassword from "@distilled.cloud/onepassword";
const program = Effect.gen(function* () {
const vaults = yield* Onepassword.connect.getVaults({});
return vaults;
});
const Live = Layer.mergeAll(
FetchHttpClient.layer,
Onepassword.ConnectCredentialsFromEnv,
Onepassword.ConnectProtocol,
);
program.pipe(Effect.provide(Live), Effect.runPromise);
事件(审计活动从一个报告综合处获得):
import { Effect, Layer } from "effect";
import * as FetchHttpClient from "effect/http/FetchHttpClient";
import * as Onepassword from "@distilled.cloud/onepassword";
const program = Effect.gen(function* () {
// Start a cursor with a page size and a start time, then pass the returned
// `cursor` back as `{ body: { cursor } }` to continue.
const page = yield* Onepassword.events.getAuditEventsV2({
body: { limit: 100, start_time: "2026-10-01T00:00:00Z" },
});
return page.items;
});
const Live = Layer.mergeAll(
FetchHttpClient.layer,
Onepassword.EventsCredentialsFromEnv,
Onepassword.EventsProtocol,
);
program.pipe(Effect.provide(Live), Effect.runPromise);
用户( 暂停一个用户; 请求访问令牌并为您刷新):
import { Effect, Layer } from "effect";
import * as FetchHttpClient from "effect/http/FetchHttpClient";
import * as Onepassword from "@distilled.cloud/onepassword";
const program = Onepassword.users.suspendUser({
account: "ABCDEFGHIJKLMNOPQRSTUVWXYZ",
user: "ZYXWVUTSRQPONMLKJIHGFEDCBA",
});
const Live = Layer.mergeAll(
FetchHttpClient.layer,
Onepassword.UsersCredentialsFromEnv,
Onepassword.UsersProtocol,
);
program.pipe(Effect.provide(Live), Effect.runPromise);
认证
| API 密码 | 需求 | 可选 | 发送为 |
|---|---|---|---|
| 连接 | OP_CONNECT_TOKEN | OP_CONNECT_HOST 或者说 OP_CONNECT_API_BASE_URL (默认) http://localhost:8080/v1(中文(简体) ) | Authorization: Bearer |
| 活动 | OP_EVENTS_API_TOKEN | OP_EVENTS_API_BASE_URL (默认) https://events.1password.com(中文(简体) ) | Authorization: Bearer |
| 用户 | OP_USERS_API_CLIENT_ID, (中文(简体) ), OP_USERS_API_CLIENT_SECRET | OP_USERS_API_BASE_URL (默认) https://api.1password.com(中文(简体) ) | Authorization: Bearer <access token> |
| 奥奥特 | OP_USERS_API_CLIENT_ID, (中文(简体) ), OP_USERS_API_CLIENT_SECRET | OP_USERS_API_BASE_URL (默认) https://api.1password.com(中文(简体) ) | Authorization: Basic |
| 伙伴关系 | OP_PARTNERSHIP_API_TOKEN | OP_PARTNERSHIP_API_BASE_URL (默认) https://billing.1password.com(中文(简体) ) | Authorization: Bearer |
1Password 不为事件、用户或
伙伴API;以上名称为SDK. 美国境外账户使用a
区域东道主: *.1password.ca, (中文(简体) ), *.1password.eu 或者说 *.ent.1password.com。 。 。 .
用户证书交换 OAuth 应用程序的客户端ID 和秘密
15分钟的出入证 POST /v1/oauth/token并请求
新的,在它到期前不久。 要直接传递值, 请使用 connectCredentials({ token }), (中文(简体) ),
eventsCredentials({ token }), (中文(简体) ), usersCredentials({ clientId, clientSecret }), (中文(简体) ),
usersCredentialsFromAccessToken({ accessToken }), (中文(简体) ), oauthCredentials(...) 或者说
partnershipCredentials({ token }); 秘密为 Redacted<string>。 。 。 .