Zilla Universal Sync (ZUS) Browser Extension - collecting application data

The Zilla application supports the collection of many applications' user accounts, permissions, security settings, and integrates with those applications right out of the box.

For those applications which do not integrate right out of the box Zilla can still collect the data through the applications' own web pages using the Zilla Universal Sync (ZUS) browser extension.

Currently, the Zilla Universal Sync (ZUS) browser extension is available for Google Chrome.

 

 

When Zilla Universal Sync (ZUS) browser extension is not installed

  • When Zilla Universal Sync (ZUS) browser extension is not installed In Zilla, add application Adobe instance, click on Sync now in top right corner of Application Details page, enable the ZUS toggle, fill in the URLs the below pop-up should appear mentioning to install ZUS browser extension from Chrome Web Store. After adding extension, come back to Zilla and click on “Next” and proceed with ZUS steps as given below in the documentation.

image-20240215-111738.png

 

Installing the Zilla Universal Sync (ZUS) browser extension

  • The Zilla Universal Sync (ZUS) browser extension is available as a free download on the Google Chrome extension store.

  • Make sure Chrome is updated to the most recent version.

  • In Chrome, go to our extension’s page, and click “Add to Chrome”.

image-20240214-203642.png
  • Click on “Add extension”. A success pop-up comes with message “Zilla Universal Sync (ZUS) has been added to Chrome”

  • The extension “Zilla Universal Sync (ZUS)” should show up in the menu under the puzzle-piece icon

at the upper right corner of the browser. Click pin icon to pin it to the toolbar, so you can see it while browsing.

 

Using the browser extension with a fully supported application

  • To use the Zilla Universal Sync (ZUS) browser extension to collect data from a application, first go to that Application Details page, and click “Sync now” in the upper right corner or the gear icon left to “Sync now”

  • The below dialog should appear, click on the slider below Zilla Universal Sync (ZUS) to enable it.

This may reveal some fields for you to fill in, asking for the URLs that you use when you visit certain pages in the app. Zilla can use this information to figure out how to navigate to all the relevant pages of information for your particular organization. (If something goes wrong, you can fix these fields later by clicking on the gear icon on left of “Sync now”).

Fill in the requested information and click “Sync Now/Next”. You should see something like the following:

That “Launch…” button should open up your app in a new browser tab. If you’re not currently logged into the outside app, you will have to log in, with an administrator account with sufficient privileges to see all of the information that you want to transfer to Zilla. If you then click on the Zilla Universal Sync (ZUS) browser extension icon, the extension popup will appear with a list of items to visit and synchronize:

 

With most web apps, after you log in, the app will redirect you to the first page from which Zilla wants to transfer data.

(For some apps, the login screen will redirect you to some other page instead, in which case you will see the “Visit page” button or navigation directions on step #1 in the list to go to the page where you really want to be.)

Clicking “Send” will generate and show the preview of the data collected and clicking “Send” in Preview window will send information from the page automatically to Zilla, and place a notification of this fact beneath the item in the list.

 

When this page’s sync is done, you can click “Visit page” to go to the application’s next page in the list and work your way down, syncing all the information Zilla knows how to get in this way. The “Zilla Security” link at the bottom will send you back to the Zilla app in a new tab, showing you a summary of everything that was synced. The relevant information should now be visible in the application details page in different tabs, whatever the Zilla Universal Sync (ZUS) browser extension can transfer from the pages you visited.

Show Advanced Options in Preview of collected data window

Collected Data validation in Preview window

  • When Account Status does not exist in the Application’s Web page which is to be sent to Zilla, only Next Steps is visible under Advanced Options in the Preview window.

  • The first and default selected option is “This data is correct. Securely send to Zilla Security.” which means that the collected data in the Preview window looks correct and good to be sent to Zilla. Click Send after reviewing collected data.

  • The second option “This data is missing some attributes. Try again with ZUS integration builder.“ when selected, the Preview window button changes to “Redo" instead of "Send". On clicking "Redo", the Integration Builder window will appear to perform actions to send data (follow this document The “ZUS Browser Extension - Integration Builder”)

  • The third option “ZUS integration builder is not collecting my data correctly. Send a request to customer support.” when selected, shows an additional input text area, for you to enter what was incorrect or what went wrong (it is optional to give input). Click on Send in the Preview window, it will send the information to Zilla Support Team.

 

Account Status validation in Collected Data preview window

  • When Account Status exists in the Application’s Web page which is to be sent to Zilla, 2 sections are visible under Advanced Options - “The following results for account status were found. Please select the labels that indicate an active account.” and “Next Steps” in the Preview window of collected data.

  • Based on the Application’s Account Status values, the options will appear under the section “The following results for account status were found. Please select the labels that indicate an active account.” in the Preview window.

  • You need to mark which Account Status value indicates the account is Active and based on the selected checkbox, the Account Status column will show the status in round brackets (Active).

 

A special case: Long scrolling pages

Some applications may have long scrolling lists, of user accounts for instance, for which the individual web page elements are only dynamically generated when they become visible on the screen. For these pages, Zilla may not be able to get all of the available content from the portion of the page that is visible at any one time.

Currently, you will have to scroll these pages manually and repeatedly click “Send again” to send the user information until all parts of the list have been synced. Zilla is smart enough to not make duplicate entries if there is some overlapping information.

A special case: Manual navigation

Sometimes, there are pages for which Zilla needs information but can’t generate a “Visit page” link to take you there. For instance, some apps have separate pages for user groups, listing their members, but the browser extension doesn’t know the URLs of these pages.

In these cases, there will be no “Visit page” button, but there will be instructions in the Zilla Universal Sync (ZUS) browser extension telling you what to do. Manually navigate in the browser as directed. When you’re on a page where you can send data, the “Send” button should become visible and you can click it to send the data.

Sending screenshots and HTML

For an unsupported or in case audit logs fail to capture the page

Sometimes, you’ll want to extract data from a page where Zilla doesn’t currently have a recipe for extracting data automatically. Maybe the application is an in-house custom app that you use in your organization. Maybe it’s simply a commercial outside app for which we do not yet have the ability to extract data. Or, maybe it’s an app for which we CAN extract data from other pages, but we haven’t done the particular page you’re interested in.

One option you have under these circumstances is to send Zilla a screenshot of the page, along with raw HTML data for the page. We will analyze this information for you and get in touch--we may even be able to construct a new recipe for extracting data automatically from the page.

In such a situation, you activate the Zilla Universal Sync (ZUS) browser extension exactly as described above. If it’s a custom app, or one for which we don’t yet have recipes for extracting data, there will be no additional information to enter here:

The next dialog may not have a Launch button to launch the outside app, but instead just tell you to navigate there manually. Click Next.

  • Do NOT click on Done yet.

 

Open another tab, and go to the app page you want to sync. If you click on the Zilla Universal Sync (ZUS) browser extension’s icon, you will see a message to create a new integration with the ZUS integration builder.

  • Go to the web page where data exists to send to Zilla, click on the ZUS Browser Extension icon and then click on Launch Builder.

(Here we cover The “ZUS Browser Extension - Integration Builder”).

Recipe Wizard will appear there at the very bottom click Having difficulties? Send a request to customer support to assist. which will generate a preview with Option 3, i.e. ZUS integration builder is not collecting my data correctly. Send a request to customer support. pre-set. Clicking Send will open a popup from the browser requesting an additional temporary permission.

Click Allow to capture the Mhtml which will save the complete web page, clicking Deny will save the html which might be missing some key information depending on the application. Once done we remove the requested permission which you can verify in the ZUS browser extension details page. Check the permission section which will either be blank or will say This extension requires no special permissions based on the browser.

You can navigate to as many pages as you like and click “Send/Send again” to sync data with the Zilla application. Someone at Zilla will be notified and will analyze the page to extract the data you need, and perhaps to add a new recipe for data extraction to our browser extension’s repertoire.

Similarly, if you’re syncing an app that we do already support, but go to a specific page where we don’t already know how to extract data, you can still sync data. You won’t see a “Send” button at all on such a page, but there is an “Launch the integration builder” link at the bottom:

USE (The “ZUS Browser Extension - Integration Builder”)

Basic Troubleshooting Tips

The Zilla Universal Sync (ZUS) browser extension requires that your browser settings are configured correctly.
If you are seeing strange behavior with the extension, double check that your extension settings are correct:

 

Ensure that the setting circled in red are enabled;