LogoLogo
HomePricingSelf-hosted docsAPI docsLogin
  • Home
  • Login to hava
  • Developer
  • Getting Started
    • Quickstart
      • Create New Account
      • Import Demo Data
      • Creating Environments
      • Exporting Diagrams
  • AWS Marketplace
  • Using Hava
    • Providers & Sources
    • Environments
      • Creating Environments
      • Filtering Environments
  • Importing Data
    • Demo Data
    • AWS
      • Getting Started with AWS
        • Cross Account Role
        • Read Only IAM User
        • Minimum Access IAM User
      • AWS Supported Resources
      • AWS Views
        • Infrastructure
        • Security
        • Container - ECS
        • List
    • Azure
      • Getting Started with Azure
        • Powershell
        • Azure Portal
      • Azure Supported Resources
      • Azure Views
        • Infrastructure
        • Azure Security View
        • List
    • Google Cloud
      • Getting Started with GCP
        • Service Account
        • Import Multiple Projects
        • Enabling APIs
      • GCP Supported Resources
      • GCP Views
        • Infrastructure
        • List
    • Kubernetes
      • Getting Started with Kubernetes
        • Read Only Kubeconfig
        • Automatic Import of Managed Kubernetes
          • AWS EKS Cluster Configuration
        • Converting certificate files to certificate data fields
      • Kubernetes Supported Resources
      • Kubernetes Views
        • Container
        • List
    • Import Errors
  • Discover
    • Importing
    • Searching
      • Search Overview
      • Search Syntax
        • VPC Search
        • Wildcard Search
        • Tag Search
        • Deep Search
      • Search Examples
        • Discover Resources From Regions
        • Create a multiple VPC diagram
        • Defining Custom Environments
    • Versioning
      • Tracking Changes in Cloud Architecture
    • Manual Sync
  • Diagram
    • Listing Environments
      • Filtering Environments
      • Favouriting Environments
    • Viewing Environments
      • Diagram Controls
      • Diagram Layout
      • Switch Between Views
      • Diagram Canvas Resource Filters
    • Draw Custom Connections
  • Diagnose
    • Architectural Monitoring Alerts
    • Attributes
    • Cost Estimation
    • Diff View - Comparing Diagrams
    • Infrastructure
      • View Route Tables
      • View ACLs
      • View Security Groups
    • Reports
      • AWS Compliance Reports
  • Document
    • Environment Notes
    • Embed
    • Exporting Diagrams
    • Edit
      • Draw.io
  • Collaboration
    • Teams
    • Inviting Users
    • Disabling users
    • SSO/SAML
      • Overview
      • Azure AD - SAML Setup
      • Azure AD - OIDC Setup
      • Okta - SAML Setup
      • Okta - OIDC Setup
      • Trouble Shooting SSO
    • Project folders
  • Integrations
    • AWS Control Tower
    • CLI
    • Confluence Cloud
    • GitHub
    • Terraform
  • API
    • API Docs
  • Account & Billing
    • Types Of Hava Accounts
    • Change Subscription
    • Switch to AWS marketplace
    • Change Password
    • MFA
    • Download Invoice
    • Cancel Account
    • Account Audit Log
  • Quick Look
    • Quick AWS Overview
    • Security Overview
    • Customize the Hava Dashboard
Powered by GitBook
On this page
  • Adding an environment to Confluence
  • Getting the key
  • Self-Hosted

Was this helpful?

  1. Integrations

Confluence Cloud

PreviousCLINextGitHub

Last updated 1 year ago

Was this helpful?

The integration with Confluence Cloud provides a quick and easy way to display Hava environment diagrams inside a Confluence page. It can be installed through our Atlassian Marketplace listing:

Once a diagram is embedded, it can be viewed without consuming a Hava user licence or being logged into Hava.

Adding an environment to Confluence

To add an environment to your confluence page, you need to add and configure the Hava Viewer macro.

You can do this either by pressing the + button on the toolbar, or by typing / and then search for Hava

This will add a blank view in your page editor like below.

You can modify the size of this using the context menu on the bottom (when selected)

To configure the macro, press the edit button to open up the configuration pane

The configuration page has a single input field where you put the embedded view key.

Getting the key

Interactive Views

The interactive view give readers the ability to click on objects in the view and see more information about them.

To get a key for an Interactive View open the specific environment you would like to add to Confluence and press the share button on the top toolbar.

EMBED and EMBED LIGHT are Interactive Views, select the one you prefer, and copy the ID by pressing the COPY ID button.

Add the ID to the Embedded View Key input in the macro configuration and the macro should update with the embedded view.

Non-Interactive Views

The Non-Interactive View gives a static representation of the environment as a rasterized image. It does not allow users to interact with it, but it will load faster when opening the confluence page.

To get a key for a non Interactive View open the specific environment you would like to add to Confluence and press the share button on the top toolbar.

Select EMBED PNG in the modal and copy the full URL for the embedded PNG.

Add the URL to the Embedded View Key input in the macro configuration and the macro will update with the embedded view.

Once an interactive or static diagram is inserted into your confluence page, it will remain up to date. This includes the static PNG.

When Hava auto updates your network diagrams in response to configuration changes being detected, the diagrams at the end of your embedded diagram endpoints are also updated which means when you view diagrams within a confluence page, you are always looking at the latest version without the need to update anything in Confluence.

Self-Hosted

The Atlassian Confluence integration for Hava can be configured to work with a self-hosted version of Hava. This is achieved by configuring a different URL for the integration.

To configure the Hava Viewer application in Confluence, go to the main settings page and locate the Manage Application section on the left menu. Under Hava Viewer press the Configure button to bring up the Hava Viewer configuration page.

On the Hava Viewer configuration page enter the URL for your self-hosted instance of Hava. This needs to be a fully qualified DNS entry with either "http://" or "https://" at the start.

Once the URL has been entered, press Save to save the changes.

There are several different embedded views in Hava, and they are all supported by the plugin. They can loosely be categorized into interactive and non-interactive views. For more details on our embedded views have a look at the .

embedded documentation
Hava Viewer
Search for Hava to find the Hava Viewer macro
Press the edit button in the context menu to configure the macro
Add your key to the input box
Select your view type and copy the ID
Select the URL and copy it to the clipboard
Confluence - Manage Applications
Hava Configuration Page