{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":39342,"path":"platform-administration/search-administration/configure-aha-roadmaps-external-content-indexing.md","title":"Configure Aha! Roadmaps for external content indexing","bundle":null,"doc_type":null,"release":"australia","body":"\n# Configure Aha! Roadmaps for external content indexing\n\nGenerate an API key in Aha! Roadmaps to allow the Aha! Roadmaps external content connector to access content from your workspaces.\n\n## Before you begin\n\nYour organization must have already set up a custom Aha! domain.\n\nYour Aha! Roadmaps account needs either the owner role for your organization's workspace or the account admin role. To learn about non-administrator and administrator roles in Aha! Roadmaps, see [https://support.aha.io/aha-roadmaps/account/billing-and-users/user-permissions~7444657360296913475](https://support.aha.io/aha-roadmaps/account/billing-and-users/user-permissions~7444657360296913475).\n\nRole required: none\n\n## About this task\n\nThe Aha! Roadmaps external content connector retrieves Features, Goals, Ideas, Notes, and Releases from workspaces in your Aha! Roadmaps source system using the Aha! REST API.\n\nTo allow the connector to access your Aha! Roadmaps content via the REST API, you must generate an API key in Aha! Roadmaps. Your connector administrator can use this API key to configure the Aha! Roadmaps external content connector for proper connection to your source system.\n\n## Procedure\n\n1.  In Aha! Roadmaps, generate a new API key for use by the Aha! Roadmaps external content connector.\n\n    1.  Navigate to [https://secure.aha.io/settings/api\\_keys](https://secure.aha.io/settings/api_keys) and log in with your administrator or workspace owner credentials when prompted.\n\n    2.  Select **Generate API Key**.\n\n    3.  Enter a name for your new API key, then select **Generate API Key**.\n\n    4.  Copy your new API key and store it in a secure location.\n\n        **Important:** Your external content connector administrator needs this API key when configuring the Aha! Roadmaps external content connector.\n\n\n## What to do next\n\nProvide the following items to your connector administrator:\n\n-   The host URL for your Aha! Roadmaps instance. This is typically `https://<organization>.aha.io/`, where `<organization>` is the name of your organization.\n-   The API key value that you copied in step [1.d](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-administration/search-administration/configure-aha-roadmaps-external-content-indexing.md).\n\nYour connector administrator needs these items to configure a Aha! Roadmaps external content connector to retrieve Features, Goals, Ideas, Notes, and Releases and security principals from your Aha! Roadmaps source system.\n\nFor details on creating and configuring a Aha! Roadmaps external content connector, see [Create an Aha! Roadmaps external content connector](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-administration/search-administration/create-ext-cont-connector-aha-roadmaps.md).\n\n**Parent Topic:**[Aha! Roadmaps external content connector](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-administration/search-administration/aha-roadmaps-external-content-connector.md)\n\n"}}