Authentication overview
CRXcavator, a service provided by Rapid7, focuses on identifying security risks within browser extensions. Authentication for CRXcavator is integrated into the broader Rapid7 Insight Platform. This means that users do not directly authenticate with CRXcavator as a standalone service but rather gain access through their authenticated session with the Rapid7 Insight Platform. This unified access model allows for centralized user management, role-based access control, and consistent security policies across Rapid7's suite of security products. The primary interface for CRXcavator is web-based, designed for security teams to analyze browser extension risk scores and detailed security reports.
The Rapid7 Insight Platform typically employs standard web authentication protocols to establish and maintain user sessions. This architecture simplifies the user experience by providing a single point of entry to various Rapid7 tools while ensuring that access to sensitive security data, such as CRXcavator's detailed reports on browser extension vulnerabilities, is adequately protected. Understanding this integrated approach is key to managing CRXcavator access effectively, as credential management and security configurations are primarily handled at the Insight Platform level rather than within CRXcavator itself.
Supported authentication methods
CRXcavator leverages the authentication mechanisms provided by the Rapid7 Insight Platform. Direct API authentication for CRXcavator as a standalone product is not the primary mode of interaction, as its core function is a web-based analysis tool. However, integration with other Rapid7 products, such as InsightIDR or InsightVM, may involve API interactions for data correlation or automation, where the Insight Platform's API keys or OAuth flows would be applicable. For direct user access to the CRXcavator web interface, session-based authentication via username and password is the standard approach, often enhanced with multifactor authentication (MFA).
| Method | When to Use | Security Level |
|---|---|---|
| Rapid7 Insight Platform Username/Password | Primary method for accessing the CRXcavator web interface. | Standard, enhanced with MFA. |
| Rapid7 Insight Platform MFA | Recommended for all user logins to the Insight Platform. | High (adds a second factor to authentication). |
| Rapid7 Insight Platform API Key/Token | For programmatic access to Insight Platform data or integrating with other Rapid7 products that can leverage CRXcavator's insights. | High (when properly managed and rotated). |
| Single Sign-On (SSO) via Insight Platform | For organizations integrating with identity providers like Okta, Azure AD, or Ping Identity. | Very High (centralized identity management, conditional access). |
The Insight Platform's support for federated identity management and Single Sign-On (SSO) allows organizations to integrate with their existing identity providers. This capability centralizes user authentication and authorization, streamlining access management for CRXcavator and other Rapid7 products. For detailed information on Insight Platform authentication, consult the Rapid7 Insight Platform documentation.
Getting your credentials
Access to CRXcavator is granted through a Rapid7 Insight Platform account. To obtain your credentials and access CRXcavator, follow these steps:
- Account Provisioning: Your organization's Rapid7 administrator typically provisions your user account within the Rapid7 Insight Platform. This involves assigning you a username (usually your email address) and setting an initial password or integrating with your organization's SSO solution.
- Initial Login: Navigate to the Rapid7 Insight Platform login page. Use the provided username and password to log in. You may be prompted to set a new password upon your first login.
- Multifactor Authentication (MFA) Setup: It is strongly recommended to set up MFA immediately after your initial login. The Insight Platform supports various MFA methods, including authenticator apps (e.g., Google Authenticator, Microsoft Authenticator) and security keys. Follow the on-screen prompts to configure your preferred MFA method within your user profile settings. This adds a critical layer of security to your account.
- Accessing CRXcavator: Once authenticated into the Insight Platform, CRXcavator will be accessible from the main navigation dashboard, provided your user role has the necessary permissions.
- API Keys (for programmatic access): If your use case requires programmatic interaction with the Rapid7 Insight Platform (for integrations or automation that may indirectly leverage CRXcavator data), you can generate API keys or tokens within your Insight Platform user profile or through specific product settings (e.g., InsightVM API keys). Always treat API keys as sensitive credentials and store them securely. Refer to the Insight Platform API documentation for specific instructions on generating and managing these keys.
For enterprise environments utilizing SSO, your organization's IT or identity management team will provide guidance on accessing the Insight Platform through your corporate identity provider. This typically involves authenticating with your existing corporate credentials, which then federates your session to the Rapid7 Insight Platform.
Authenticated request example
Since CRXcavator is primarily a web-based interface accessed through the Rapid7 Insight Platform, direct API requests for CRXcavator itself are not the standard interaction model. Instead, authenticated API requests would typically target the broader Rapid7 Insight Platform API to retrieve data that might be correlated with CRXcavator's insights (e.g., retrieving asset data from InsightVM which might then be analyzed in conjunction with CRXcavator's findings). Below is a conceptual example of how you might make an authenticated request to a Rapid7 Insight Platform API endpoint using an API key, demonstrating the underlying security principle.
Assuming you have an Insight Platform API key (YOUR_RAPID7_API_KEY) and want to fetch asset data from InsightVM:
#!/bin/bash
API_KEY="YOUR_RAPID7_API_KEY"
REGION="us" # e.g., us, ca, eu, au, jp
curl -X GET \
"https://${REGION}.api.insight.rapid7.com/vm/v4/assets" \
-H "X-Api-Key: ${API_KEY}" \
-H "Accept: application/json"
In this example:
X-Api-Key: This header carries your generated API key, authenticating your request to the Rapid7 Insight Platform.${REGION}.api.insight.rapid7.com: The base URL for the Insight Platform API, which varies by the region where your Rapid7 data is hosted./vm/v4/assets: A hypothetical endpoint for retrieving asset data from InsightVM, a common integration point with other Rapid7 security tools.
This illustrates the pattern for authenticating programmatic access within the Rapid7 ecosystem. For specific endpoints and detailed API documentation, refer to the Rapid7 Insight Platform Developer Documentation.
Security best practices
Adhering to security best practices for CRXcavator authentication is critical for protecting your organization's security posture, especially given its role in identifying browser extension risks. Since CRXcavator authentication relies on the Rapid7 Insight Platform, these practices apply broadly to your Insight Platform access:
- Implement Multifactor Authentication (MFA): Always enable MFA for all user accounts accessing the Rapid7 Insight Platform. This significantly reduces the risk of unauthorized access due to compromised passwords. The Insight Platform supports various MFA methods, including TOTP applications and security keys, which offer stronger protection than SMS-based MFA. The FIDO Alliance promotes strong authentication standards for enhanced security.
- Use Strong, Unique Passwords: Ensure all user accounts have strong, unique passwords that are not reused across other services. Enforce complex password policies within your identity provider or directly within the Insight Platform if not using SSO.
- Leverage Single Sign-On (SSO): Integrate the Rapid7 Insight Platform with your organization's existing identity provider (e.g., Okta, Azure Active Directory, Ping Identity). SSO centralizes identity management, simplifies user provisioning/deprovisioning, and allows for consistent application of corporate security policies, such as conditional access.
- Apply Role-Based Access Control (RBAC): Assign users the minimum necessary permissions required for their roles within the Insight Platform. CRXcavator data can be sensitive, so restrict access to reports and configurations only to those who explicitly need it. Regularly review and update user permissions.
- Regularly Audit Access Logs: Periodically review audit logs within the Insight Platform for unusual login activity or access patterns. Anomalous behavior could indicate an attempted or successful breach.
- Secure API Keys: If you utilize Insight Platform API keys for integrations, treat them as sensitive as passwords. Store them securely (e.g., in environment variables, secret management services), avoid hardcoding them, and ensure they are rotated regularly. Restrict the scope of API keys to only the necessary permissions.
- Educate Users: Train users on the importance of strong authentication, recognizing phishing attempts, and reporting suspicious activity. Human factors remain a significant component of overall security.
- Keep Systems Updated: Ensure the browsers and operating systems used to access CRXcavator and the Insight Platform are kept up-to-date with the latest security patches to mitigate known vulnerabilities.