Whether you are just starting your observability journey or already are an expert, our courses will help advance your knowledge and practical skills.
Expert insight, best practices and information on everything related to Observability issues, trends and solutions.
Explore our guides on a broad range of observability related topics.
Coralogix custom API Keys offer a robust and flexible way to manage access and permissions within your organization. API keys can be generated as personal or shared keys through Coralogix’s adaptable RBAC management system. This system allows you to assign specific permissions or groups of permissions, known as role presets, to each API key, ensuring precise control over access and operations.
Use Coralogix API keys to:
Personal keys are specific to individual Coralogix users. They can be created for personal purposes such as integration testing or experimentation and should not be used for production.
This category includes legacy keys, which are maintained for existing customers.
These shared data ingestion keys ensure secure telemetry data transmission to Coralogix while authenticating the sender’s identity. Multiple Send-Your-Data API keys with advanced security systems are supported by our Send-Your-Data Management API.
Shared team keys authenticate API actions for team members for users with programmatic access to Coralogix. Only team members with the roles and permissions contained in a team key may access it. Team key creation and viewing are restricted to members of groups without data scope limitations.
The following permissions are necessary to create and view API keys.
API Key | Permission | Role Preset |
---|---|---|
Personal | personal-custom-api-keys:Manage | APIKeys |
personal-custom-api-keys:ReadConfig | APIKeys | |
personal-custom-api-keys:ReadConfig | APIKeys | |
Send-Your-Data | data-ingest-api-keys:Manage | APIKeys |
data-ingest-api-keys:ReadConfig | APIKeys | |
Team | team-custom-api-keys:Manage | APIKeys |
team-custom-api-keys:ReadConfig | APIKeys |
As a security best practice, Coralogix suggests generating multiple keys for your organization, with the option to view and download them once. Employing multiple API keys enables you to regularly rotate keys to enhance security or to revoke a specific key in case of accidental exposure or when discontinuing the associated service.
To activate advanced security settings, navigate to Settings > API Key Security Settings.
Once the API Key Security Settings have been activated, when generating a new API key, you will have a one-time opportunity to view and copy it on your UI upon its creation. You must download it as a text file to be saved locally.
Notes:
team-api-keys-security-settings:Manage
permission can control this attribute. Those with the team-api-keys-security-settings:ReadConfig
permission may view it.STEP 1. From the Coralogix toolbar, click the user icon at the top right corner and click Settings.
STEP 2. In the left-hand menu, select Keys.
STEP 3. Select the key type of your choice and click + KEY.
STEP 4. Add a key name.
STEP 5. Attach permissions to the key using role presets, manual customization, or a combination of the two.
Notes:
STEP 6. Click NEXT.
STEP 7. You can save your key locally by copying and downloading it or in your Coralogix UI. If your [API Key Security Settings] have been activated, you will have a one-time opportunity to view and copy it and will be required to download it as a text file to be saved locally.
Once added, your key will appear in Keys with all of your existing keys, along with its name, creator name and type, creation date, and status. You can view, copy, activate, deactivate, and even delete it as necessary.
Legacy keys, such as the Alerts, Rules, & Tags API key, the Logs Query API key, and the Team API key, will appear under Personal keys in the Keys UI.
Legacy Send-Your-Data API keys will appear under Send-Your-Data API keys.
Legacy SCIM keys will appear under Team keys.
Click the eye icon next to each legacy key to view its role presets and permissions. You can recreate these keys using this information as more streamlined, customized API keys.
Need help?
Our world-class customer success team is available 24/7 to walk you through your setup and answer any questions that may come up.
Feel free to reach out to us via our in-app chat or by emailing [email protected].