Manage IAM keys

Imply Lumi uses Identity and Access Management (IAM) keys for authentication and authorization of external systems and applications. You need an IAM key to add and search events in Lumi.

You can use a single IAM key across multiple integrations. To enable an IAM key for a specific integration, you add the integration to the key. Depending on the integration type, you may also need to configure integration-specific attributes.

This topic provides details on creating and managing IAM keys in Lumi. For information on IAM key attributes and integrations, see IAM keys reference.

Prerequisites

To create and manage IAM keys, you need access to Lumi with the Manager or higher role. For more information on roles, see Manage roles.

Create an IAM key

info

Lumi doesn't support creating IAM keys for administrative purposes.

You can create an IAM key from the Keys page or while configuring an integration on the Integrations page. You need to add at least one integration to the IAM key before you can use it. When you create an IAM key from a specific integration, the integration is automatically added to the key.

Keys page

To create an IAM key from the Keys page:

1. From the Lumi navigation menu, click Keys.
2. Click + Create key.
3. Enter IAM key details:
   • Name: Name of the IAM key. Only the Name field is required to create the IAM key.
   • Description (optional): Description for the IAM key.
   • Global attributes: Environment and Team system attributes associated with the IAM key. See System attributes for more information.
4. Click Create. The key is created in an inactive state. To activate it for a specific application, add the integration for that application.
5. On the key details page, click + Add in the Integrations pane.
6. Select an integration and configure any attributes specific to that integration. See Integrations for more information. Then click Add.

Integrations page

To create an IAM key while configuring an integration:

1. From the Lumi navigation menu, click Integrations.
2. Select the integration you want to configure.
3. In the Select or create an IAM key pane, click Select or create key > Create key.
4. Enter IAM key details:
   • Name: Name of the IAM key. Only the Name field is required to create the IAM key.
   • Description (optional): Description for the IAM key.
   • Global attributes: Environment and Team system attributes associated with the IAM key. See System attributes for more information.
   • User attributes: Attributes specific to the selected integration. See Integrations for more information.
5. Click Create.

View an IAM key

You can view the list of IAM keys and key metadata, such as the key ID and authorized integrations, on the Keys page. For each IAM key, a bar chart shows activity over the past 24 hours. Hover over a bar to see the number of events processed during that hour.

Click the information icon next to a key to view the key ID, description, token, and timestamps for when it was created and last modified.

Select an IAM key to open its details page, where you can view key properties and related information.

To view all IAM keys for a specific integration, search for that integration type on the Keys page.

Update an IAM key

You can update an IAM key's description and global attributes, add or remove integrations, and edit integration-specific attributes.

info

The changes you make to the IAM key or its properties can affect the key's ability to add and query events.

To update an IAM key:

1. From the Lumi navigation menu, click Keys.
2. Select an IAM key to open its details page.
3. Edit the key's properties as desired:
   • In the Overview pane, click Edit to update the description or global attributes.
   • In the Integrations pane:
     • Click + Add to add an integration.
     • Click the ellipsis next to an integration to open the menu. Click Edit to update integration-specific attributes or Remove to remove the integration.

To link an existing IAM key to an integration from the Integrations page:

1. Select the integration.
2. In the Select or create key dialog, select your key.
3. Configure any integration-specific attributes, then click Add.

Delete an IAM key

Deleting an IAM key is a permanent action. It affects all integrations relying on that IAM key for authentication. We recommend that before you delete an IAM key, you update any related integrations with a new IAM key first. This allows the integration to function without interruption.

To delete an IAM key:

1. From the Lumi navigation menu, click Keys.
2. Click the ellipsis next to the IAM key you want to delete.
3. Click Delete.
4. When prompted, type the name of the IAM key you want to delete; then click Delete.

Learn more

For details on IAM keys, see IAM keys reference.