Skip to main content

BigDataCloud

BigDataCloud is a free online service that provides IP address and domain information.

Overview

BigDataCloud is a comprehensive IP geolocation and threat intelligence service that provides detailed information about IP addresses, domains, and network infrastructure. By integrating BigDataCloud with Qevlar AI, you can enhance your security investigations with precise geolocation data, network insights, and IP reputation information.

How to integrate BigDataCloud with Qevlar

Step 1: Navigate to Integrations

  1. Log in to your Qevlar AI platform
  2. In the left sidebar, click on Integrations
  3. Browse or search for the BigDataCloud integration
  4. Click on the BigDataCloud integration card
Qevlar Integrations Page

Step 2: Open BigDataCloud Integration

Click the Manage button on the BigDataCloud integration card to open the configuration dialog.

Step 3: Choose your integration method

Similar to other integrations, Qevlar offers two options for integrating BigDataCloud.

  • Option 1: Use Qevlar's account (Quick Start)

    If you want to start using BigDataCloud immediately without setting up your own API key:

    1. Check the box "I want to use Qevlar's account"
    2. Click Save

    This option allows you to use BigDataCloud's features through Qevlar's shared account with no additional configuration required.

    info

    Using Qevlar's account may have usage limitations. Consider using your own API key for higher rate limits and personalized usage tracking.

  • Option 2: Use your personal BigDataCloud API key

    For unlimited access and dedicated usage:

    1. Leave the "I want to use Qevlar's account" checkbox unchecked
    2. Enter your BigDataCloud API key in the API Key field
    3. Click Test connection to verify your API key is valid
    4. Once the connection test passes, click Save

Step 4: Obtain your BigDataCloud API key

If you choose to use your personal API key, follow these steps to obtain it:

  1. Go to BigDataCloud.com and sign in to your account
  2. Click on the Account button in the top navigation bar:
BigDataCloud Account Menu
  1. From the dropdown menu, select Credentials:
BigDataCloud Account Dropdown
  1. On the Credentials page, you'll see your API keys listed:
BigDataCloud Credentials Page
  1. Click the Show Key button to reveal your API key
  2. Copy the API key
  3. Return to Qevlar and paste the API key in the integration dialogs
info

You can rename your API key by clicking on the name field (e.g., "Qevlar AI") in the credentials table. This helps you identify which key is being used for Qevlar integration.

Step 5: API key propagation

After creating a new API key or making changes, you may see a warning message:

BigDataCloud API Key Propagation
warning

BigDataCloud API keys can take up to 10 minutes to propagate across their worldwide network of servers. During this time, your key status will show as "Pending". Please wait for the propagation to complete before using the key in Qevlar. informational callout with custom styling.

You can check the propagation status by:

  • Clicking the REFRESH button on the credentials page
  • Waiting for the status to change from "Pending" to "Active"

Step 6: Test and Save

  1. After entering your API key in Qevlar, click Test connection
  2. Wait for the connection test to complete
  3. If successful, click Save to finalize the integration
  4. If the test fails, ensure your API key is "Active" in BigDataCloud and try again

Using BigDataCloud in Qevlar

Once integrated, you can leverage BigDataCloud features within your Qevlar investigations:

  • IP Geolocation: Get precise location data for any IP address
  • Network Intelligence: Obtain ASN, ISP, and network ownership information
  • Reverse IP Lookup: Find all domains hosted on a specific IP
  • IP Reputation: Check if an IP is associated with threats or abuse
  • Domain Information: Get comprehensive domain registration and hosting details
  • Network Range Analysis: Investigate entire IP ranges and subnets

Best Practices

  1. Naming Convention: Use descriptive names for your API keys
  2. Key Rotation: Regularly rotate your API keys for security
  3. Monitor Usage: Check your API usage statistics in BigDataCloud dashboard
  4. Separate Keys: Use different API keys for different environments or integrations

Troubleshooting

1. Connection Test Failed

  • Verify your API key is in "Active" status, not "Pending"
  • Ensure you've copied the entire API key without extra spaces
  • Check if your BigDataCloud account is active and in good standing
  • Wait for the full propagation time if you just created the key

2. API key shows "Pending" status

  • This is normal for new keys
  • Wait up to 10 minutes for propagation
  • Use the REFRESH button to check current status
  • Don't attempt to use the key until it shows "Active"

3. Rate limiting issues

  • If using Qevlar's shared account, you may hit rate limits during peak usage
  • Consider getting your own BigDataCloud API key for dedicated limits
  • Check your usage statistics in the BigDataCloud dashboard

4. Invalid API key error

  • Ensure you're copying the key after clicking "Show Key"
  • Verify no extra characters or spaces are included
  • Check if the key has been deleted or regenerated in BigDataCloud