Skip to content

Latest commit

 

History

History
33 lines (19 loc) · 2.7 KB

overview.md

File metadata and controls

33 lines (19 loc) · 2.7 KB
Raw

Introduction

Overview

The User Import - Azure utility provides Hornbill customers with a safe and secure way to manage user accounts on the Hornbill platform by synchronizing with accounts held in Entra ID (formerly known as Azure AD).

The utility is designed to run behind a corporate firewall, connect to Entra ID and query the required information, before transforming and loading the resulting data into your Hornbill instance as new or updated user records. It supports both the initial bulk import as well as incremental adds and updates. You can schedule the tool to run periodically to perform the import/update tasks as required.

Download

The utility can be downloaded from GitHub. Please ensure to download the latest version of the ZIP archive that is relevant to the architecture of the computer it will be executed and scheduled to run on.

Installation

Once downloaded, the ZIP archive for the utility should be extracted into a new folder within the local user profile of the user who will run the tool - whether that be your user profile to manually run the utility or the profile of a service account that will be used to schedule the running of it. For example:

C:\Users\YourUserOrServiceAccountID\Hornbill\user_import_azure

Updates

The utility will self-update when it detects that a newer minor or patch version has been released on GitHub. All of the import tools use semantic versioning, where:

  • Major version updates will contain new feature(s), and include breaking changes to the tool configuration
  • Minor version updates will contain new feature(s) and do not include breaking changes to the tool configuration
  • Patch version updates will contain bug fixes only

When there is a Major version update, the utility will not self-update but instead will output a message to the command line & log(s) stating that there is a newer version available to download from GitHub. In this instance, you should download the latest release from GitHub, and review the breaking configuration changes against your existing import configuration before implementation. You can also check the Hornbill Community Forum for real-time release updates.

Requirements

[[INCLUDE https://raw.githubusercontent.com/Hornbill-Docs/hdoc-library/main/hdoc-library/dataimports/requirements.md]]

  • https://login.microsoftonline.com/* - allows access generate access tokens for Azure, to cache your defined Azure information
  • https://graph.microsoft.com/* - allows access to cache your defined Azure information