Hygiara Docs

Product guidance for running structured Azure reviews.

Use these guides to move from first setup through customers, connections, reviews, reports, ESLZ assessment, and user access without guesswork.

Start Here

Follow the first-review workflow from setup to report download.

If you are new to the product, start with the getting-started guides. If you are already running reviews, jump directly into the section that matches the part of the workflow you need.

Getting Started

4 pages

What Hygiara is for, what a review produces, and how the main workflow fits together.

Projects

4 pages

Why projects exist in Hygiara and how to use them properly.

Connections And Credentials

5 pages

What reusable Azure connections are, why they matter, and when to use them.

Reviews

5 pages

What each step in the review modal is for and how to use it well.

Reports

3 pages

Where the report download appears and what report readiness means on the review page.

Landing Zone

3 pages

What the optional Landing Zone assessment is checking and when it is worth enabling.

Settings And Users

5 pages

What the organization settings page controls now that personal preferences live elsewhere.

API

1 pages

Where to find the generated Hygiara REST API reference and OpenAPI document.

Troubleshooting

3 pages

What to check first when a review does not start, does not finish, or returns unexpected scope.

Choose A Path

Start from the guidance that matches how you use the product.

Full Navigation

Getting Started

  • Overview

    What Hygiara is for, what a review produces, and how the main workflow fits together.

  • First Review

    A step-by-step walkthrough from an empty workspace to a completed Azure review and report.

  • Choosing Authentication

    When to use a stored Azure connection and when to use an access token.

  • Understanding The Workspace

    How the dashboard, projects, reviews, and settings fit together in day-to-day use.

Projects

  • Managing Projects

    Why projects exist in Hygiara and how to use them properly.

  • Project Workspace

    How to use the project page to manage reviews, templates, schedules, and connection usage.

  • Review Templates

    How to save a review template, use it when creating a review, and manage templates from the project page.

  • Review Schedules

    How to set up a recurring review schedule using a saved template.

Connections And Credentials

  • Azure Connections

    What reusable Azure connections are, why they matter, and when to use them.

  • Azure Permissions

    What Azure role Hygiara needs, how to create a service principal, and where to find the credentials.

  • Adding A Connection

    How to add a reusable Azure connection to the organization, step by step.

  • Editing And Validating A Connection

    How to update a saved connection and when to revalidate it.

  • Access Tokens

    How token mode works, how to get the right Azure token, and what changes in the review flow.

Reviews

Reports

  • Downloading Reports

    Where the report download appears and what report readiness means on the review page.

  • Understanding The Report

    What the generated Word report contains, section by section, and how to use it well.

  • Report Notifications

    When report-ready emails are sent and how the user preference affects delivery.

Landing Zone

Settings And Users

  • Organization Settings

    What the organization settings page controls now that personal preferences live elsewhere.

  • Users And Invitations

    How to invite users, manage roles, and avoid common access-management mistakes.

  • API Keys

    How to create, manage, and revoke API keys for programmatic access to Hygiara.

  • Notification Preferences

    How the personal notification and dashboard preferences work for your user account.

  • Two-Factor Authentication

    How to enable two-factor authentication, use recovery codes, and manage trusted devices.

API

  • API Reference

    Where to find the generated Hygiara REST API reference and OpenAPI document.

Troubleshooting