Google Admin Console (GAC) allows IT teams to view all devices and users within their organization. By having this data with FMX, these IT teams can assign devices to users, create tickets on their behalf, and audit what they have available

This article will explain how to set up your Google Admin Console(GAC) integration with FMX. These instructions are for users who have purchased the Google Admin Console integration and have already been added to prismatic. If you are interested in adding this integration please reach out to your account manager at FMX.

Before completing the below steps make sure to do the steps in this support article in order to authenticate the Google Admin Console Integration.

*If you have already completed the GAC authentication and set up your prismatic account for the user integration go the heading "GAC - Chrome Devices" and start there. 

Setup a Prismatic Account

Prismatic is a platform that you will use to set up the integration between your GAC and FMX. You will receive an email to set up an account from Prismatic. Follow the steps in the email by clicking the “Set up your account” button. If you did not receive an email please double check your spam folder and reach out to your primary contact at FMX. 

Once you have created your account you can login. When you have logged in you will be taken to your home page. To set up your integration go to the “Instances” section.

Once you are in this section you can choose which integrations you would like to set up. "GAC Chrome Devices" and "GAC - Users" are set up separately. See this article on how to setup users

GAC - Chrome Devices

Before setting up this portion of the integration, please make sure that you have the equipment types in FMX updated for what you would like them to map from in GAC. If they are not then you will have to go back in to reconfigure the integration for those types to be an option in prismatic.  See this support center article on how to add equipment types. 

Also add any custom fields in FMX for what information from GAC you would like to sync over to in FMX.  Make sure to create non required text custom fields that the Integration user type is a permitted user for. Below are the available GAC Options for devices:

 

**See this support center article for how to add custom fields. The custom fields you create for the integration need to be a text field, URL, or date(to be used with dates only). Other FMX custom field types will not work.

To set up the GAC integration for your chrome devices select the “GAC - Chrome Devices’ box in the instances view. In order to start this process click the “Reconfigure” button in top right of the screen.

Initial Configuration 

Once you select “Reconfigure”, click the next button to move to the “Configuration” section. There is nothing you need to do in this first section.

Configuration

*If you have completed the GAC User integration already this would be the same information you entered in for the configuration section.

Next, fill out the following fields

  • Hostname - this is your FMX hostname. This can be found in the URL of your site and it is the text before “.gofmx.com”. For example: https://fmxschool.gofmx.com/. The bolded text is your hostname. 
  • Password - this is the password of the FMX integration user you add(see details on this below

You will need to create an account in your FMX site for the integration to sync with. Put the log in information in the password and user field. In order to do this you will need to create a new user type that will not be updated. If the integration’s user type is updated this can cause the integration to not work.

To create a new user type click the “Admin Settings" in the left sidebar then select the” User Types" tab at the top of the page. You can either select add “User Type” at the top of the page or click the vertical 3 dots next to a user type that may have full access like “FMX Administrator” and click “copy”. Name the user type “FMX Integration”. For more information user types go to this support center article.

Next go to the following setting and make sure the user type has the following permissions:

  • Building & Resource Access
    • Read - Any
  • Equipment Access
    • Create 
    • Read - Any
    • Update- Any
    • Retire - Any
    • Permitted Equipment Types Includes All Desired
      • If the user type does not have access to an equipment type you would want to sync with GAC then those devices would not sync.
  • User & Contact Access
    • Administer
    • Read Users
    • Read Contacts
    • Delete
  • Permitted Access to All Desired Custom Fields

Fill out the next fields with the information you gathered from GAC. To obtain the information for these fields make sure to complete the authentication steps from this support article . These steps should be done prior to reconfiguring the instance. If this has not been done click cancel and complete the authentication. Then follow the steps.

The fields that need filled out are 

  • Client ID
  • Client Secret 
  • GAC Customer ID 

When finished select next.

Org Unit Mapping

The next step is to map the Org Units in GAC to the FMX Equipment Type, and Building. This is how your devices in GAC will correctly sync over to FMX. To begin click the “+ Add to Org Unit Mapping” button. 

Once clicked you can now map the Org Unit Path to the FMX Equipment Types and FMX Building. This will then bring over the devices in that Org Unit Path with FMX equipment type and building that you choose. 

In the Org Unit Paths dropdown you can choose the path you would like to map. When the “Apply parent configuration to child org units” toggle is on, all child org units will automatically inherit the same mapping configuration as their parent, unless a child org unit is separately mapped with a different configuration from its parent. When this toggle is off, all child org units will need to be individually mapped, regardless of whether they share the same configuration as the parent.

Below the parent configuration toggle you will see the “Keep in Sync” toggle. When this is toggled on, changes made to org units in GAC will be automatically reflected in the mapped user types and accessible buildings in FMX. Any changes made to mapped user types or accessible buildings in FMX while this is toggled on will be overridden by what is in GAC.

Then select the FMX Equipment and FMX Building for the devices in that org path to be mapped too. Repeat these steps to map over the devices you would like to bring to FMX. When finished click “Next”. You can return to map more Org units by reconfiguring the integration and going to this step.

Status Mapping

Once you select next you can start mapping which GAC status’ will correspond to the FMX Status. Click the “Add Status Mapping” button to begin. Then choose a GAC status from the list. Next select the FMX status you would like the device to be when the device has the corresponding GAC status. The options for FMX are “active” (equipment that is able to be used in FMX) or “Retired” (equipment that has been retired in FMX. These can be filtered and view their logs) 

Field Mapping

Once you have finished the “Status Mapping” click the “Next” button to begin mapping the fields.  The equipment tag will be the name of the device in FMX. Choose the GAC field to match records from Google to FMX. This field should contain a unique identifier that will be used as the equipment tag in FMX. Changes made to chrome devices in GAC will be automatically reflected in the mapped equipment types and buildings in FMX. Any changes made to mapped equipment types or buildings in FMX will be overridden by what is in GAC.

The “Link To URL Custom Field*” dropdown has you choose the FMX custom field that the GAC URL will sync to. This field will have a link to that device in GAC. The GAC URL field is the primary way we will identify which equipment in FMX matches which devices in GAC.

If the URL is not found in FMX (mostly when first turning on the integration) the integration will attempt to find an equipment item with the same equipment tag (using the selected field from the configuration field). If found, it will update the existing record. If not found, a new record will be created.

***When first setting up the integration If you already have devices in FMX that you would like to have sync with what is in GAC so that they match. Then those equipment items in FMX need to have the equipment tag in FMX updated to the GAC field you will be using for the equipment tag. For example if you are choosing the serial number field (from GAC) for the FMX equipment tag field then you will need to bulk update your FMX equipment items to have that as the tag in FMX. For steps on how to bulk update equipment in FMX see this support center article.****

Lastly choose which GAC fields you would like to map to FMX custom fields. You have the option to map any GAC field on the list. To do this select the GAC field from the drop down you would like. Then find the corresponding FMX field. Continue this process until you have all the fields you would like. 

If you see something in GAC you want to sync over to GAC but do not have a FMX field you can add a custom field in FMX and go back to this step later. 

 

Click “Finish” when you are done. If you would like the integration to not sync right away click the "Pause" button in the instance view. 

 

To set up the integration for users from GAC go to this support article. 

Was this article helpful?

  • 0 out of 0 found this helpful