> ## Documentation Index
> Fetch the complete documentation index at: https://hc.saas-manager.biz.nuro.jp/llms.txt
> Use this file to discover all available pages before exploring further.

# 4. How to Use the Shadow IT Management Ledger

> Setup instructions and usage guide for the Shadow IT Management Ledger.

#### What you can do with the Shadow IT Management Ledger

The tool uses SaaS access history from event logs to identify SaaS services the IT department has not yet noticed.

You can then categorize those services into a whitelist or blacklist.

#### Shadow IT management workflow

Review the flow diagram below to understand how shadow IT is defined and handled when operating this tool.

<img src="https://mintcdn.com/admina-sbn/PEEndzio9f5-afJr/images/it-management/fazgtahebn/1742247657985-image.png?fit=max&auto=format&n=PEEndzio9f5-afJr&q=85&s=d38f8204ab381f708089f53d7621e5fc" alt="Shadow IT management workflow" width="1920" height="1080" data-path="images/it-management/fazgtahebn/1742247657985-image.png" />

#### Supported environments

* Google Sheets

<Warning>
  Excel (Windows/Mac) is not currently supported.
  Support for Microsoft Excel (Windows) is planned for a future release.
</Warning>

#### Prerequisites

* Event logs must already be collected (browser extension setup or equivalent is required).

Reference: [Shadow IT detection using browser extensions](/en/it-management/shadow-it/7q1wryx3dk-extension)

[Shadow IT detection using Google Workspace](/en/it-management/shadow-it/8nwq5urwh5-shadow-it)

[How to review event logs](/en/it-management/shadow-it/oepl0j5y5g-eventlog)

#### Setup instructions

#### Preparation

1. Go to **Settings** > **API Key List** to obtain your **Organization ID** and **API Key**.

   <img src="https://mintcdn.com/admina-sbn/PEEndzio9f5-afJr/images/it-management/fazgtahebn/1733404488057-image.png?fit=max&auto=format&n=PEEndzio9f5-afJr&q=85&s=4efd1e54c0e14b35ca620f2cb826e09d" alt="API Key List" width="1970" height="472" data-path="images/it-management/fazgtahebn/1733404488057-image.png" />

   <img src="https://mintcdn.com/admina-sbn/PEEndzio9f5-afJr/images/it-management/fazgtahebn/1733404518444-image.png?fit=max&auto=format&n=PEEndzio9f5-afJr&q=85&s=acae359318e4333147dce9140cf15985" alt="API Key retrieval" width="1742" height="651" data-path="images/it-management/fazgtahebn/1733404518444-image.png" />

2. Download the ledger using the link below.

   \[Spreadsheet]

   [Admina\_Shadow IT Management Ledger\_ver1.0](https://docs.google.com/spreadsheets/d/1jUKf9h6H9QVZSVNwnoWQTiKQaMvJ9_GHJrzc8eggrq4/copy)

   A screen like the one shown below will appear. Save the file to your own environment to start using it.

   <img src="https://mintcdn.com/admina-sbn/PEEndzio9f5-afJr/images/it-management/fazgtahebn/1740581991730-2025-02-26-23-59-46.png?fit=max&auto=format&n=PEEndzio9f5-afJr&q=85&s=098837c7908a89be5142fe83526e26f0" alt="Download screen" width="1260" height="648" data-path="images/it-management/fazgtahebn/1740581991730-2025-02-26-23-59-46.png" />

3. \[Spreadsheet]

   Open **Extensions** > **Apps Script**, then go to **Project Settings** > **Script Properties**.
   Add properties named `APIToken` and `OrgId`, and enter the **API Key** and **Organization ID** you obtained in step 1.

   <img src="https://mintcdn.com/admina-sbn/PEEndzio9f5-afJr/images/it-management/fazgtahebn/1740582502770-2025-02-27-0-08-18.png?fit=max&auto=format&n=PEEndzio9f5-afJr&q=85&s=9d6d7f70884eba48c7297d59f06a5e40" alt="Script properties setup 1" width="1536" height="316" data-path="images/it-management/fazgtahebn/1740582502770-2025-02-27-0-08-18.png" />

   <img src="https://mintcdn.com/admina-sbn/PEEndzio9f5-afJr/images/it-management/fazgtahebn/1740582537444-2025-02-27-0-08-52.png?fit=max&auto=format&n=PEEndzio9f5-afJr&q=85&s=15a590a8ac388b87be093456d004f800" alt="Script properties setup 2" width="570" height="624" data-path="images/it-management/fazgtahebn/1740582537444-2025-02-27-0-08-52.png" />

   <img src="https://mintcdn.com/admina-sbn/PEEndzio9f5-afJr/images/it-management/fazgtahebn/1740582426713-2025-02-18-22-51-52.png?fit=max&auto=format&n=PEEndzio9f5-afJr&q=85&s=4c41c6811d2878f8949a56a7c983dee6" alt="Script properties setup 3" width="1448" height="580" data-path="images/it-management/fazgtahebn/1740582426713-2025-02-18-22-51-52.png" />

   \[Excel]

   Open the Excel file and go to the **Setting** sheet. Enter the **Organization ID** obtained in step 1 into the `OrgID` field, and the **API Key** into the `APIToken` field.

<img src="https://mintcdn.com/admina-sbn/PEEndzio9f5-afJr/images/it-management/fazgtahebn/1733404228368-unnamed.png?fit=max&auto=format&n=PEEndzio9f5-afJr&q=85&s=9c912d71ec0edd9908d77f68430f6b7e" alt="Excel settings screen" width="661" height="91" data-path="images/it-management/fazgtahebn/1733404228368-unnamed.png" />

#### How to use the Shadow IT Management Ledger

1. On the **HOME** sheet, enter the year and month you want to review (in `yyyy-mm` format).

   Click **Fetch Data** to retrieve the data.

   <img src="https://mintcdn.com/admina-sbn/PEEndzio9f5-afJr/images/it-management/fazgtahebn/1733403640495-2-png.PNG?fit=max&auto=format&n=PEEndzio9f5-afJr&q=85&s=d20290abd764f6f225ab8ce99ad530be" alt="Fetch data" width="325" height="329" data-path="images/it-management/fazgtahebn/1733403640495-2-png.PNG" />

2. The event log for the entered month is generated as a sheet named `eventLog_yyyymm`.

   <Info>
     The `eventLog` sheet updates on a per-sheet basis.
     Event logs for months other than the one you entered are not updated,
     so past months remain as historical records, one sheet per month.
   </Info>

   Update the **List Type** using the **LinkedList**, **WhiteList**, and **BlackList** sheets.

   <img src="https://mintcdn.com/admina-sbn/PEEndzio9f5-afJr/images/it-management/fazgtahebn/1733404016598-3-png.PNG?fit=max&auto=format&n=PEEndzio9f5-afJr&q=85&s=cff5d287e564e36a59f2d019698e2271" alt="Update list type" width="583" height="433" data-path="images/it-management/fazgtahebn/1733404016598-3-png.PNG" />

   The list of SaaS services already connected is also generated as the **LinkedList** sheet.

   <img src="https://mintcdn.com/admina-sbn/PEEndzio9f5-afJr/images/it-management/fazgtahebn/1733404797698-image.png?fit=max&auto=format&n=PEEndzio9f5-afJr&q=85&s=9bbebeff41db79416895672c912a1535" alt="LinkedList" width="1420" height="627" data-path="images/it-management/fazgtahebn/1733404797698-image.png" />

   <Info>
     The `eventLog_yyyymm` and `LinkedList` sheets are generated using the Admina API.

     \[/en/api-reference/it-management/introduction)

     \[/en/api-reference/it-management/introduction)
   </Info>

   A **Service Matrix** is also generated at the same time.

   <img src="https://mintcdn.com/admina-sbn/PEEndzio9f5-afJr/images/it-management/fazgtahebn/1740583535358-2025-02-27-0-25-30.png?fit=max&auto=format&n=PEEndzio9f5-afJr&q=85&s=d8dba049eb57c0a95a92073e4c5dfbce" alt="Service Matrix" width="2260" height="1098" data-path="images/it-management/fazgtahebn/1740583535358-2025-02-27-0-25-30.png" />

   This table combines data from **WhiteList**, **BlackList**, **LinkedList**, and all `eventLog_yyyymm` sheets. It includes past months and shows which list each service belongs to.

3. Define your **WhiteList** and **BlackList** in accordance with your security policy.

   <img src="https://mintcdn.com/admina-sbn/PEEndzio9f5-afJr/images/it-management/fazgtahebn/1733405191097-image.png?fit=max&auto=format&n=PEEndzio9f5-afJr&q=85&s=69070ccdef62d29174cea3339b4c3487" alt="WhiteList settings" width="1075" height="140" data-path="images/it-management/fazgtahebn/1733405191097-image.png" />

   <img src="https://mintcdn.com/admina-sbn/PEEndzio9f5-afJr/images/it-management/fazgtahebn/1733405199812-image.png?fit=max&auto=format&n=PEEndzio9f5-afJr&q=85&s=4c505f1c72d8dbd793c27fb08b204689" alt="BlackList settings" width="1161" height="142" data-path="images/it-management/fazgtahebn/1733405199812-image.png" />

4. To reflect new integrations or updates to the **WhiteList** and **BlackList**, click **Fetch Data** again on the **HOME** sheet.

   The following items are overwritten:

   * **LinkedList**
   * `eventLog_yyyymm` (the existing sheet for the same month is overwritten; a new sheet is created if none exists)
   * **Detection Total** and **Unprocessed** counts on the **HOME** sheet
   * **Service Matrix**

   <img src="https://mintcdn.com/admina-sbn/PEEndzio9f5-afJr/images/it-management/fazgtahebn/1733405753164-image.png?fit=max&auto=format&n=PEEndzio9f5-afJr&q=85&s=e692101ccc863fbffdb65e48e406db8d" alt="After update screen 1" width="320" height="320" data-path="images/it-management/fazgtahebn/1733405753164-image.png" />

   <img src="https://mintcdn.com/admina-sbn/PEEndzio9f5-afJr/images/it-management/fazgtahebn/1733405761498-image.png?fit=max&auto=format&n=PEEndzio9f5-afJr&q=85&s=2b6f4ca9714afdf5dbedfb4de666d87a" alt="After update screen 2" width="580" height="352" data-path="images/it-management/fazgtahebn/1733405761498-image.png" />

This completes the guide on how to use the Shadow IT Management Ledger.

If you have any questions or need assistance, please contact our chat support.
