Configure HubSpot for AppFabric
HubSpot is a customer platform with all the software, integrations, and resources you need to connect your marketing, sales, content management, and customer service. HubSpot's connected platform enables you to grow your business faster by focusing on what matters most: your customers.
You can use AWS AppFabric for security to receive audit logs and user data from HubSpot, normalize the data into Open Cybersecurity Schema Framework (OCSF) format, and output the data to an Amazon Simple Storage Service (Amazon S3) bucket or an Amazon Data Firehose stream.
AppFabric support for HubSpot
AppFabric supports receiving user information and audit logs from HubSpot.
Prerequisites
To use AppFabric to transfer audit logs from HubSpot to supported destinations, you must meet the following requirements:
-
You must have an account with the Enterprise subscription in HubSpot to access access audit logs. For more information about HubSpot subscriptions, see Manage your HubSpot subscription
on the HubSpot Knowledge Base. -
You must have a developer account and an app associated with the account.
-
You should be a super admin to install apps in your HubSpot account or have App Marketplace Access permission plus the user permissions to accepts the scopes the app is requesting.
Rate limit considerations
HubSpot imposes rate limits on the HubSpot API. For
more information about the HubSpot API rate limits, including limits
for apps using OAuth, see
Rate
Limits
Data delay considerations
You might see up to a 30-minute delay for an audit event to be delivered to your
destination. This is due to delay in audit events made available by the application
as well as due to precautions taken to reduce data loss. However, this might be
customizable at an account-level. For assistance, contact AWS Support
Connecting AppFabric to your HubSpot account
After you create your app bundle within the AppFabric service, you must authorize AppFabric with HubSpot. To find the information required to authorize HubSpot with AppFabric, use the following steps.
Create an OAuth application
AppFabric integrates with HubSpot using OAuth. To create an OAuth application in HubSpot, use the following steps:
-
Follow the instructions in the Create a public app
section in the HubSpot guide on the HubSpot website. -
From the Auth tab, add the three scopes listed in Required scopes.
-
Use a redirect URL with the following format in Redirect URL.
https://
<region>
.console.aws.amazon.com/appfabric/oauth2In this URL,
<region>
is the code for the AWS Region in which you’ve configured your AppFabric app bundle. For example, the code for the US East (N. Virginia) Region isus-east-1
. For that Region, the redirect URL ishttps://
.us-east-1
.console.aws.amazon.com/appfabric/oauth2 -
Choose Create app.
Required scopes
You must add the following scopes to your HubSpot OAuth application:
-
settings.users.read
-
crm.objects.owners.read
-
account-info.security.read
App authorizations
Tenant ID
Enter an ID that identifies this unique HubSpot organization. For example, enter your HubSpot account ID.
Tenant name
Enter a name that identifies this unique HubSpot organization. AppFabric uses the tenant name to label the app authorizations and any ingestions created from the app authorization.
Client ID
AppFabric will request a client ID. To find your client ID in HubSpot, use the following steps:
-
Navigate to the HubSpot log-in page
and sign in using your developer account credentials. -
From the Apps menu, choose your app.
-
From the Auth tab, look for the Client ID value.
Client secret
AppFabric will request a client secret. To find your client secret in HubSpot, use the following steps:
-
Navigate to the HubSpot log-in page
and sign in using your developer account credentials. -
From the Apps menu, choose your app.
-
From the Auth tab, look for the Client secret value.
Approve authorization
After creating the app authorization in AppFabric, you will receive a pop-up window from HubSpot to approve the authorization. Sign in to your account using your enterprise account credentials (not your developer account) to approve the AppFabric authorization. Choose allow.