Install the Axiad Portal Extension (macOS)
  • 29 Apr 2024
  • 4 Minutes to read
  • Dark
    Light
  • PDF

Install the Axiad Portal Extension (macOS)

  • Dark
    Light
  • PDF

Article Summary

The Axiad Portal Extension works with WebPCSC to allow the Unified Portal to access a connected device. You must install WebPCSC before installing the Axiad Portal Extension.

Manually Install the Axiad Portal Extension on a Browser

Install on Google Chrome

  1. Open the Chrome browser application.

  2. Navigate to the Chrome web store.

  3. In the search bar, enter Axiad Portal Extension.

  4. Click Axiad Portal Extension.

  5. Click Add to Chrome.
    A pop-up message displays.

  6. Click Add extension.
    The Axiad Portal Extension installs and displays on your Chrome extension page.

  7. Browse and sign into your Axiad Cloud site.
    The MyIdentities page displays by default.

  8. Validate the extension:

    1. On the MyIdentities page, click Add Identity Device.
      An error message displays, informing you that the WebPCSC extension is not yet enabled.

    2. To the right of your address bar, click the Axiad Portal Extension icon.
      A pop-up displays, asking for access to your smart cards.

    3. Click Always.
      The pop-up closes.

    4. Refresh the page.
      The Axiad Portal Extension validates.

Install on Microsoft Edge

  1. Open the Microsoft Edge browser application.

  2. Click the Extensions icon, to the right of your browser address bar.

  3. Select Open Microsoft Edge Add-ons.

  4. In the search bar, enter Axiad Portal Extension.

  5. Click Get. A pop-up message displays.

  6. Click Add extension.
    The Axiad Portal Extension installs and displays to the right of your browser address bar.

  7. At the top right of your Edge browser, click the Extensions icon.

  8. To the right of the Axiad Portal Extension, click ... > Manage Extension.

    manage_edge_extension

    The Extensions page displays.

  9. Enable Allow inPrivate.

    allow-inprivate
  10. Browse and sign into your Axiad Cloud site.
    The MyIdentities page displays by default.

  11. Validate the extension:

    1. On the MyIdentities page, click Add Identity Device.
      An error message displays, informing you that the WebPCSC extension is not yet enabled.

    2. To the right of your address bar, click the Axiad Portal Extension icon.
      A pop-up displays, asking for access to your smart cards.

    3. Click Always.
      The pop-up closes.

    4. Refresh the page.
      The Axiad Portal Extension validates.

Automatically Deploy and Configure the Axiad Portal Extension to Managed Workstations

Jamf Pro can be used to remotely deploy and install software packages to managed workstations.

Deploy the Axiad Portal Extension

  1. In Jamf PRO, navigate to Computers > Configuration Profiles.

    1config-ext-external-app
  2. Create a new computer configuration profile, or modify an existing one. 

  3. Navigate to Application & Customer settings > External Applications.

  4. Click Add.

    install-ext-jamf-external-applications
  5. Set the Source and Preference Domain to the following values: 

    • Source: Custom Schema

    • Preference Domain (depending on which browser you are configuring): com.google.Chrome or com.microsoft.Edge
      The image below, shows the settings for Google Chrome browser:

      install-ext-jamf-pref-domain
  6. Click Add schema and upload the axiad-portal-extension-deploy-jamf.json file (below).

    {
      "title": "Multiple Extensions",
      "description": "Administrative controls for Multiple Extensions.",
      "properties": {
        "ExtensionInstallForcelist": {
          "title": "Extension Install Forcelist",
          "description": "Add a List of Extension IDs. Paste the extension IDs in front of the default text.",
          "property_order": 1,
          "type": "array",
          "items": {
            "title": "Extension ID",
            "default": "mheiphfcfdhlkecdhpgblhpemkecaheh;pbabkmdefcmabmlmnkmnlcijhcgmmdnc",
            "type": "string"
          }
        }
      }
    }
  7. Click Save.

    install-ext-jamf-add-schema
  8. Under Preference Domain Properties > Extension Install Forcelist, for Axiad Portal Extension, click Add Extension ID.

  9. Add the following:

    1. Extension ID 1 (for Chrome): pbabkmdefcmabmlmnkmnlcijhcgmmdnc;https://clients2.google.com/service/update2/crx

    2. Extension ID 1 (for Edge): mheiphfcfdhlkecdhpgblhpemkecaheh;https://edge.microsoft.com/extensionwebstorebase/v1/crx

      install-ext-jamf-extID1
  10. Optionally, click Add on the External Applications page to add additional extension definitions for other external applications.

  11. Set the Scope to the desired target workstations:

    install-ext-jamf-scope1
  12. Click Add to add and manage new devices:

    install-ext-jamf-scope
  13. Click Add to the right of each device you want to add. 

  14. Click Done when all devices are added.

    install-ext-jamf-click-done
  15. Click Save to save the new configuration profile.

Configure the Axiad Portal Extension

To configure and whitelist the Axiad Portal Extension using a configuration profile in Jamf Pro, follow the steps below:

  1. In Jamf PRO navigate to Computers > Configuration Profiles, create a new computer configuration profile or modify (edit) an existing one.
    You can update the one you just created or manage two different ones.

    1config-ext-external-app
  2. Navigate to Options > Application & Custom Settings > External Applications, and add an External Application for the Axiad Portal Extension.

    2config-ext-external-app-add
  3. Click Add.

  4. Set the Source and Preference Domain to the following values:

    • Source: Custom Schema

    • Preference Domain:

      • For Chrome: com.google.Chrome.extensions.pbabkmdefcmabmlmnkmnlcijhcgmmdnc

      • For Edge: com.microsoft.Edge.extensions.mheiphfcfdhlkecdhpgblhpemkecaheh


        3config-ext-custom_schema
  5. Click Add schema and upload the axiad-portal-extension-config-jamf.json file (below).

    {
      "title": "Axiad Portal Extension",
      "description": "Administrative controls for the Axiad Portal Extension.",
      "properties": {
        "whitelist": {
          "property_order": 1,
          "title": "Pre-authorized domain names",
          "description": "The provided domain names (e.g. portal-customer.cloud.axiadids.net) will be authorized to use the Axiad Portal Extension without any action required from the end-user.",
          "type": "array",
          "items": {
            "type": "string",
            "title": "Domain Name"
          }
        },
        "noedit": {
          "property_order": 2,
          "title": "Prevent end-users from authorizing new domains",
          "description": "By default, end-users may manually authorize domains to use the Axiad Portal Extension. Activating this option prevents end-users from authorizing domains, and causes the Axiad Portal Extension to ignore any domains they previously whitelisted. Only domains pre-authorized by policy will be allowed.",
          "type": "boolean"
        }
      }
    }
  6. Click Save.

    4config-ext-custom_schema-save
  7. Click Add Domain Name.

  8. Enter a pre-authorized domain name. If needed, click Add Domain Name again to add more pre-authorized domain names (for example, Domain Name 1 = portal-anycorp.demo.axiadids.net).

    5config-ext-add-domain
  9. Set the Prevent end-users from authorizing new domains option to true or false, depending on your company policy:

    6config-ext-prevent
  10. Click Save.

  11. Set the Scope to the desired target workstations:

    install-ext-jamf-scope1
  12. Click Add to add and manage new devices:

    install-ext-jamf-scope


  13. Click Add to the right of each device you want to add. 

  14. Click Done when all devices are added.

    install-ext-jamf-click-done
  15. Click Save to save the new configuration profile.

    install-ext-jamf-final
  16. In a target computer, validate that the two Axiad Portal Extension policies ( noedit and whitelist) are set correctly.

    1. Chrome: Go to chrome://policy

    2. Edge: Go to edge://policy

      7config-ext-target
  17. Login to one of the pre-authorized domain names.

  18. Click the Extensions icon in the browser and select the Axiad Portal Extension to validate.
    When the icon is green, the site is included in the trusted whitelist.

    8config-ext-verify


Was this article helpful?

Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.