To get started with Honeydew, you need to complete the following steps:
  1. Honeydew Application org and admin user provisioning
  2. Snowflake Native Application installation
  3. Snowflake access setup
Optional:
  1. SSO Setup
  2. Git Integration
  3. BI Integration
At Honeydew, we are committed to data residency and full compliance with EU regulations. Our deployment options ensure that data is stored within the European Union, adhering to GDPR and other regulatory requirements. If you need an EU-based installation, please reach out to our team at support@honeydew.ai to discuss your requirements.

​
Honeydew Application

​
Org provisioning and admin user

Get your Honeydew org set up, and have an admin user provisioned. Contact Honeydew support to help with this step (support@honeydew.ai). Once provided, you will be able to access the Honeydew application. The admin user will be able to invite additional users to the org, and manage org settings.

​
Network Access

If your organization is using Zscaler or similar security solutions, Honeydew application access might be blocked by default within the organization’s network. In that case, please make sure that *.honeydew.cloud is added to the allowlist. If specific domains are required (wildcards not allowed), please add the following domains to the allowlist:
  1. api.honeydew.cloud
  2. app.honeydew.cloud
  3. auth.honeydew.cloud
  4. jdbc.honeydew.cloud
If you are using a private Honeydew deployment, the domains will be different. Please contact support@honeydew.ai for the exact domains to add to the allowlist.

​
User Sign-up and Login

​
Authentication Methods

Honeydew supports user sign-up and login using the following methods:
  1. Username / Password
  2. Basic SSO, using Google and Microsoft accounts
  3. Enterprise SSO, using one of the supported identity providers (see below).

​
Multi-Factor Authentication (MFA)

MFA is enabled and enforced for all users by default, with the option to manage it through user settings. It requires a one-time password generated by Google Authenticator, Duo Security or similar tools. MFA is not required when using basic or enterprise SSO for authentication, as the SSO provider is expected to handle MFA.

​
Inviting Additional Users

To invite additional users, navigate to the Settings section in the Honeydew application, and click on Users. You can invite users by entering their email addresses, and assigning them a role.
Only users with Admin role can invite additional users.

​
User Roles

Honeydew supports the following user roles:
  • Admin: Required for setup, integration, credential management, deployment, and cache management functions.
  • Editor: Required for modifying any semantic layer definitions.
  • Viewer: Required for read-only access, reviewing semantic layer definitions, querying data, or retrieving metadata.

​
API Keys

Honeydew allows the use of API Keys for API integration, supporting BI tools, Snowflake Native App, SQL interface and more. Honeydew supports two types of API Keys: organization-level and per-user API keys. For more details, see the API Keys documentation.

​
IP Access Control

Honeydew supports IP Access Control, allowing you to restrict access to the Honeydew application and API to specific IP addresses or ranges. This feature is recommended for organizations that require additional security measures. For more details, see the IP Access Control documentation.

​
Snowflake Native Application

Install the Honeydew Native Application for Snowflake. Follow the steps listed here.

​
Snowflake Integration

Honeydew is built on top of Snowflake and requires access to Snowflake in order to operate. For more details on how to set up Snowflake access, please refer to the Snowflake Integration guide.

​
Git Integration

Honeydew uses Git as the underlying storage for any created semantics as well as for version control. You can either onboard using a Honeydew-managed GitHub private repository, or use your own Git repository. The following Git providers are supported (click the link for detailed integration instructions):

​
BI Integration

You can find more details on how to integrate Honeydew with your BI tool here.

​
Support & Training

​
Support During Onboarding and Trial Period

  1. For any questions during the onboarding phase or the trial period, please reach out to support@honeydew.ai.
  2. We recommend setting up a Slack or Microsoft Teams channel for real-time support during the onboarding phase. To set this up, please contact us at support@honeydew.ai.
  3. We can provision a support user in your Honeydew organization to help troubleshoot any issues. These users can be assigned viewer, editor, or admin access, depending on the level of support required. They can also be provisioned with or without data access, based on your organization’s preference. Each account is tied to a named Honeydew representative and can be removed or blocked at any time by your organization’s admin. This option is especially helpful when dealing with complex modeling or data issues that require direct investigation by our team. To set this up, please reach out at support@honeydew.ai or via Slack or Microsoft Teams.
    If it better suits your security or compliance requirements, you can create login accounts for Honeydew support users within your own organization and assign them to your Honeydew organization. This ensures their access is managed according to your internal policies.

​
Training Workshop

We offer a free 1-hour training workshop during the trial period. It is recommended to schedule the workshop on the 2nd week of the trial period. You can book your training workshop using this link.

​
Uninstalling Honeydew

In order to uninstall Honeydew, please follow the next steps:
  1. Snowflake:
  2. Remove the Honeydew Native Application from Snowflake.
  3. Remove Snowflake integration user, role, warehouse if these were created for Honeydew integration.
  4. Remove Honeydew IP addresses from the Snowflake “Allowed IP Addresses” list, if these were added.
  5. Git:
  6. If using GitHub, remove the Honeydew GitHub application from your GitHub account.
  7. If using GitLab or Bitbucket, revoke the GitLab or Bitbucket token used for Honeydew integration.
  8. Remove Honeydew IP addresses from the Git provider’s “Allowed IP Addresses” list, if these were added.
  9. Optionally, remove the dedicated Git repository created for Honeydew.
  10. SSO:
  11. If using SSO integration, remove the Honeydew application from your identity provider (Okta, Entra ID, PingIdentity, etc.).
  12. Revoke any tokens or credentials created for Honeydew SSO integration.
  13. Remove any SCIM integrations if configured.
  14. BI Tools:
  15. Remove any created data sources from your BI tool.
  16. Remove any drivers that might have been installed for Honeydew integration.
  17. Contact Honeydew support at support@honeydew.ai, to remove your Honeydew org and users.