1Password 事件API规范

接入教程

1. 注册1Password开发者账号并获取API密钥
2. 在应用中配置API密钥和端点URL
3. 调用Events API查询特定时间段内的账户活动
4. 解析返回的JSON数据获取事件详情
5. 实现异常事件监控和告警机制
6. 定期审查API使用日志和安全策略

Python 获取事件列表示例

python

import requests

base_url = 'https://api.example.com'
headers = {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
}

try:
    response = requests.get(f'{base_url}/v1/events', headers=headers, params={'limit': 10})
    response.raise_for_status()
    events = response.json()
    print(f'Retrieved {len(events.get("data", []))} events')
except requests.exceptions.RequestException as e:
    print(f'Error fetching events: {e}')

PHP 查询特定事件示例

php

<?php

$baseUrl = 'https://api.example.com';
$apiKey = 'YOUR_API_KEY';

$options = [
    'http' => [
        'header' => "Authorization: Bearer {$apiKey}\r\nContent-Type: application/json",
        'method' => 'GET'
    ]
];

$context = stream_context_create($options);
$response = file_get_contents($baseUrl . '/v1/events?event_type=login', false, $context);

if ($response !== false) {
    $data = json_decode($response, true);
    echo 'Found ' . count($data['data'] ?? []) . ' login events';
} else {
    echo 'Failed to fetch events';
}

?>

JavaScript 创建事件监听示例

javascript

const baseUrl = 'https://api.example.com';
const apiKey = 'YOUR_API_KEY';

async function fetchRecentEvents() {
    try {
        const response = await fetch(`${baseUrl}/v1/events?sort=created_at&order=desc`, {
            method: 'GET',
            headers: {
                'Authorization': `Bearer ${apiKey}`,
                'Content-Type': 'application/json'
            }
        });
        
        if (!response.ok) {
            throw new Error(`HTTP error! status: ${response.status}`);
        }
        
        const data = await response.json();
        console.log(`Latest events fetched: ${data.data.length}`);
        return data;
    } catch (error) {
        console.error('Error fetching events:', error);
    }
}

// Call the function
fetchRecentEvents();

常见问题

1Password Events API 的主要用途是什么？

1Password Events API 主要用于安全监控和审计，提供对 1Password 账户活动的编程访问接口。它可以追踪登录事件、密码修改、权限变更、项目访问记录等安全相关操作，帮助企业实现合规性要求和安全事件响应。

API 请求需要哪些认证信息？

访问 1Password Events API 需要使用 Bearer Token 认证。您需要在请求头中包含 'Authorization: Bearer YOUR_API_KEY'。API 密钥需要在 1Password 管理控制台中生成和管理，确保妥善保管并定期轮换以保障安全。

API 返回的事件数据包含哪些信息？

API 返回的事件数据通常包含事件类型、发生时间、触发用户、IP地址、设备信息、操作结果（成功/失败）、相关资源ID等字段。具体字段可能因事件类型而异，详细结构请参考官方 API 文档中的事件模式定义。