CensysAPI开放平台

Censys.io 是一个提供全互联网扫描平台的网站。它拥有一个公共 API，允许用户以编程方式访问其服务。在这篇博客中，我们将讨论如何使用 Censys.io 的 API 文档，包括一些用 JavaScript 编写的示例代码。

在我们可以使用 Censys.io API 之前，我们需要注册一个免费账户并获取一个 API 密钥。一旦我们有了 API 密钥，我们就可以用它来向 API 发送请求。

Censys.io 在他们的网站上提供了全面的 API 文档。文档被组织成涵盖 API 不同方面的部分，如认证、数据检索和搜索。每个部分都提供了关于 API 的端点、参数和响应格式的详细信息。

为了帮助你开始使用 Censys.io API，这里有一些用 JavaScript 编写的示例代码。

要与 Censys.io API 进行认证，我们需要在发送的请求中包含我们的 API 密钥。以下是如何使用 axios 库将 API 密钥添加到请求中的示例。

const axios = require('axios');

const apiKey = 'your-api-key';

axios.get('https://censys.io/api/v1/data', {
  headers: {
    'Content-Type': 'application/json',
    'Authorization': `Basic ${Buffer.from(apiKey).toString('base64')}`
  }
})
.then((response) => {
  console.log(response.data);
})
.catch((error) => {
  console.error(error);
});

要从 Censys.io API 检索数据，我们可以使用 /data 端点。以下是如何发送请求以检索特定 IP 地址信息的示例。

const axios = require('axios');

const apiKey = 'your-api-key';
const ipAddress = '192.0.2.1';

axios.post('https://censys.io/api/v1/data', {
  query: `ip:${ipAddress}`,
  fields: ['ip', 'protocols', 'ports']
}, {
  headers: {
    'Content-Type': 'application/json',
    'Authorization': `Basic ${Buffer.from(apiKey).toString('base64')}`
  }
})
.then((response) => {
  const data = response.data.results[0];
  console.log(`IP address: ${data.ip}`);
  console.log(`Protocols: ${data.protocols.join(', ')}`);
  console.log(`Ports: ${data.ports.join(', ')}`);
})
.catch((error) => {
  console.error(error);
});

要使用 Censys.io API 搜索数据，我们可以使用 /search 端点。以下是如何发送请求以搜索具有特定通用名称的 SSL 证书的示例。

const axios = require('axios');

const apiKey = 'your-api-key';
const commonName = 'example.com';

axios.post('https://censys.io/api/v1/search/certificates', {
  query: `parsed.subject.common_name:"${commonName}"`,
  fields: ['parsed.subject.common_name', 'parsed.validity.start', 'parsed.validity.end']
}, {
  headers: {
    'Content-Type': 'application/json',
    'Authorization': `Basic ${Buffer.from(apiKey).toString('base64')}`
  }
})
.then((response) => {
  const results = response.data.results;
  console.log(`Found ${results.length} SSL certificates with common name "${commonName}":`);
  results.forEach((result) => {
    console.log(`- Common Name: ${result.parsed.subject.common_name}`);
    console.log(`  Validity: ${result.parsed.validity.start} to ${result.parsed.validity.end}`);
  });
})
.catch((error) => {
  console.error(error);
});

在这篇博客中，我们讨论了如何使用 Censys.io 的公共 API 文档，包括一些用 JavaScript 编写的示例代码。有了这些知识，你应该能够开始使用 Censys.io API 来访问他们的全互联网扫描服务。