Skip to main content
insightsoftware Docs insightsoftware Docs
{%article.title%}
Published:
Was this article helpful?
0 out of 0 found this helpful

Installing the Jet Service Tier / Jet Hub with Microsoft Entra ID

This features is available in Jet Reports 2019 R2 and higher.

Overview

When you first start the Jet Setup program, you will be asked to select the type of user management your organization uses.

2021-04-05_10-25-27.png

Assuming you have an Azure account for your organization and that you have already created an Microsoft Entra ID, you can create Microsoft Client Applications that allow you to use Microsoft Entra ID to manage your users within Jet Products.

This functionality does not require additional or premium licensing on the part of Microsoft Entra ID.

Register your App

  1. Log in to your Azure portal (portal.azure.com)

  2. Navigate to your Microsoft Entra ID

  3. Click on App registrations

    • Click on +New registration to register a new app
      • Give your app a name
      • Under Supported Account Types , select Account in this organizational directory only (This is the default setting)
      • Under Redirect URI (optional) , select the type of Web and enter your Jet Hub URL

        This entry must start with https:// and contain the base URL that your users will use to sign in to your Jet Hub. The URL could contain the machine name to which you will install Jet Hub or the DNS entry for this site. Examples are: https://myservername.mydomain.com https://dnsname.mydomain.com

      • Click Register

    2021-04-05_10-36-45.png

Configure your App

Now that your app is registered, there are additional settings that are needed.

  1. Navigate to the Authentication page

    • Add the following additional Redirect URIs of type Web:

      • https://<JetHubURL>/account/logout
      • https://<JetHubURL>/signin-aad
      • https://<JetHubURL>/identity/signin-aad
      • https://<JetHubURL>/identity/external/callback

        Replace "<JetHubURL > " with what you specified above for your Jet Hub URL.

        Double-check your entries to insure there are no misspellings as this can cause the Jet Hub web client to not function correctly.

    • Add the following logout redirect under Front-channel logout URL
      • https://<JetHubURL>/account/logout
    • Check the boxes for Access tokens and ID tokens to enable implicit grant and hybrid flow
    • Click Save

      2021-04-06_14-54-31.png

  2. Navigate to Certificates & secrets , click +New client secret to set up your Client Secret

      • Give your client secret a description, select when it expires, then click 'Add'.

        24 months is recommended for the Jet app expire option.

        Copy the generated Secret Value and paste into Notepad (or other text editor) for saving.

        This will be your only chance to copy it, and it will be required information during the install of Jet Products. If you forget to copy it, you can just create another secret.

  3. Navigate to API permissions tab, click +Add a permission , APIs my organization uses, Microsoft Graph .

    2021-04-05_16-30-35.png
  4. Select Application permissions

        • Expand Directory and check Directory.Read.All
        • Expand Group and check Group.Read.All
        • Click Add permissions
  5. Click Add permissions, again. Select APIs my organization uses then Microsoft Graph .

    • Select Delegate permissions
    • Expand Group and check Group.Read.All
    • Click Add permissions
  6. From the API Permissions page, click on the Grant admin consent for <DomainName> button. Then, click Yes in the confirmation dialog.

  7. Go to the Overview page and copy the Application (Client) ID and the Directory (tenant).

Install Jet Reports

Note: Not all steps are shown, just those pertaining directly to configuring for use with Microsoft Entra ID

  1. Run Jet Setup.exe

  2. When prompted, Enter the Jet Hub URL. Click Next .

    Next, you will need to specify some information needed by Jet Hub - specifically: the name of the server and port number used to access for the Jet Service Tier, and the URL (web address) that will be used for connecting to Jet Hub.

    The Jet Service Tier field will pull the fully-qualified domain name (FQDN) of the machine that the installer is running on. If this is the machine that you are installing the Jet Service Tier on, this will need to stay the same.

    The Jet Hub URL should also usually be set to the FQDN of the server it will reside on. If you do not know what to put here, it is generally correct to copy the first box into the third box, and click Next.

    2021-04-06_9-53-31.png

  3. Select Microsoft Entra ID . Click Next

  4. Enter the Client Application details that you saved to Notepad and click Next .

    Please note that the Client Secret is the Secret Value and not the Secret ID
  5. On the Jet Service Tier settings page, sign into an Microsoft 365 account.  This will be the first user and administrator in the Jet Service Tier and Jet Hub. Click Next to continue the install.

  6. Installation was a success! You are now able to utilize the Jet components you have installed!

Add Users and Data Sources

Now that you have Jet successfully installed, the next step would be to add Jet users and Data Sources to run your reports against. Please navigate to User And Data Source Management In Jet Hub . This article will walk through the process of configuring both.

Published:

Installing the Jet Service Tier / Jet Hub with Microsoft Entra ID

This features is available in Jet Reports 2019 R2 and higher.

Overview

When you first start the Jet Setup program, you will be asked to select the type of user management your organization uses.

2021-04-05_10-25-27.png

Assuming you have an Azure account for your organization and that you have already created an Microsoft Entra ID, you can create Microsoft Client Applications that allow you to use Microsoft Entra ID to manage your users within Jet Products.

This functionality does not require additional or premium licensing on the part of Microsoft Entra ID.

Register your App

  1. Log in to your Azure portal (portal.azure.com)

  2. Navigate to your Microsoft Entra ID

  3. Click on App registrations

    • Click on +New registration to register a new app
      • Give your app a name
      • Under Supported Account Types , select Account in this organizational directory only (This is the default setting)
      • Under Redirect URI (optional) , select the type of Web and enter your Jet Hub URL

        This entry must start with https:// and contain the base URL that your users will use to sign in to your Jet Hub. The URL could contain the machine name to which you will install Jet Hub or the DNS entry for this site. Examples are: https://myservername.mydomain.com https://dnsname.mydomain.com

      • Click Register

    2021-04-05_10-36-45.png

Configure your App

Now that your app is registered, there are additional settings that are needed.

  1. Navigate to the Authentication page

    • Add the following additional Redirect URIs of type Web:

      • https://<JetHubURL>/account/logout
      • https://<JetHubURL>/signin-aad
      • https://<JetHubURL>/identity/signin-aad
      • https://<JetHubURL>/identity/external/callback

        Replace "<JetHubURL > " with what you specified above for your Jet Hub URL.

        Double-check your entries to insure there are no misspellings as this can cause the Jet Hub web client to not function correctly.

    • Add the following logout redirect under Front-channel logout URL
      • https://<JetHubURL>/account/logout
    • Check the boxes for Access tokens and ID tokens to enable implicit grant and hybrid flow
    • Click Save

      2021-04-06_14-54-31.png

  2. Navigate to Certificates & secrets , click +New client secret to set up your Client Secret

      • Give your client secret a description, select when it expires, then click 'Add'.

        24 months is recommended for the Jet app expire option.

        Copy the generated Secret Value and paste into Notepad (or other text editor) for saving.

        This will be your only chance to copy it, and it will be required information during the install of Jet Products. If you forget to copy it, you can just create another secret.

  3. Navigate to API permissions tab, click +Add a permission , APIs my organization uses, Microsoft Graph .

    2021-04-05_16-30-35.png
  4. Select Application permissions

        • Expand Directory and check Directory.Read.All
        • Expand Group and check Group.Read.All
        • Click Add permissions
  5. Click Add permissions, again. Select APIs my organization uses then Microsoft Graph .

    • Select Delegate permissions
    • Expand Group and check Group.Read.All
    • Click Add permissions
  6. From the API Permissions page, click on the Grant admin consent for <DomainName> button. Then, click Yes in the confirmation dialog.

  7. Go to the Overview page and copy the Application (Client) ID and the Directory (tenant).

Install Jet Reports

Note: Not all steps are shown, just those pertaining directly to configuring for use with Microsoft Entra ID

  1. Run Jet Setup.exe

  2. When prompted, Enter the Jet Hub URL. Click Next .

    Next, you will need to specify some information needed by Jet Hub - specifically: the name of the server and port number used to access for the Jet Service Tier, and the URL (web address) that will be used for connecting to Jet Hub.

    The Jet Service Tier field will pull the fully-qualified domain name (FQDN) of the machine that the installer is running on. If this is the machine that you are installing the Jet Service Tier on, this will need to stay the same.

    The Jet Hub URL should also usually be set to the FQDN of the server it will reside on. If you do not know what to put here, it is generally correct to copy the first box into the third box, and click Next.

    2021-04-06_9-53-31.png

  3. Select Microsoft Entra ID . Click Next

  4. Enter the Client Application details that you saved to Notepad and click Next .

    Please note that the Client Secret is the Secret Value and not the Secret ID
  5. On the Jet Service Tier settings page, sign into an Microsoft 365 account.  This will be the first user and administrator in the Jet Service Tier and Jet Hub. Click Next to continue the install.

  6. Installation was a success! You are now able to utilize the Jet components you have installed!

Add Users and Data Sources

Now that you have Jet successfully installed, the next step would be to add Jet users and Data Sources to run your reports against. Please navigate to User And Data Source Management In Jet Hub . This article will walk through the process of configuring both.

For an optimal Community experience, Please view on Desktop