Skip to main content
Skip table of contents

Configure NetDocuments access for Shinydocs Pro Control Center

Pre-requisites

  • A NetDocuments account with administrator rights

  • Internet connection

  • Shinydocs Pro installed

Registering Shinydocs Pro as a NetDocuments Application and Creating a Service Account

You will need the following information about the Shinydocs Pro application to register it in the NetDocuments Admin Console.

  • Client ID: AP-MT00CP73

  • Client Secret: DvMnrCCHfPCeVbyKqyrJ2MovRWy2k5Nu53mYx9aQb9p5EOOr

  • Your NetDocuments Repository ID

Registering Shinydocs Pro as a NetDocuments Application

  1. Login to your NetDocuments Admin Console as an Administrator.

  2. Under Cabinets, select the cabinet you wish to analyze with Shinydocs Pro.

    1. If there are multiple cabinets, you will need to register the application for each, using the same steps.

  3. Select the Integrate External Applications tab.

  4. In the new window, click the Add unpublished app button in the top right.

  5. A popup window will open asking for the application Client ID, paste the Shinydocs Pro Client ID: AP-MT00CP73. Click Add App when done.

  6. Shinydocs will be added to the application list, ensure the box to the left of it is checked to enable the application.

  7. Click the Save button at the bottom of the page

  8. Congratulations, the registration is now complete!

Creating and Mapping the Service Account

NetDocuments requires an internal service account that is mapped to the registered Shinydocs application.

  1. In the NetDocuments Admin Console, select Users & Groups.

  2. Click Add User.

  3. In the Add User popup, enter the email address for the new service account user and click OK.

  4. In the Details tab, enter the required details and any additional details you would like to add to the account. Then, select these options near the bottom of the window:

    1. User type: Internal

    2. Repository admin type: Full

    3. Other options: Non-Interactive Application Service Account

  5. Click the Save button.

  6. Navigate to the Service Accounts tab in Users & Groups and click the Create Service Account button.

  7. Enter the email address you provided in Step 3, and click the Create button.

  8. Enter the Client ID (AP-MT00CP73) and click the Create Mapping button.

  9. Click the Save button.

  10. On the NetDocuments Cabinets page, select the cabinet to map to the service account

    1. You will need to repeat this process for each cabinet you want to analyze

  11. Go to the Cabinet Administrators and add the service account you created as a cabinet administrator.

  12. Ensure the created service account has DEFAULT rights to your selected cabinet.

Next steps

With the application registered and the service account created and mapped, you will need to gather your NetDocuments Repository ID. This ID will be used in the Shinydocs Pro NetDocuments configuration.

  1. In the NetDocuments Admin Console, go to Information and Settings

  2. In the General section, copy the ID displayed (ex. AB-CDE1FGH2), which is your NetDocuments Repository ID.

Shinydocs Pro can analyze all cabinets it has access to or you can provide specific Cabinet IDs. If you want to use Cabinet IDs, gather those now.

Add NetDocuments to Shinydocs Pro

Once you have registered the Shinydocs Pro application in NetDocuments Admin Console, you are ready to make the connection and start analyzing your content.

  1. In either Quick-Start or + Add Source, select NetDocuments as your source

  2. On the next page, Shinydocs Pro will ask you for the following information

    image-20240711-194953.png

    Name: Provide a name for the source, this name will be used in Shinydocs Pro to differentiate from other sources.
    Server Url: Enter the URL for NetDocuments, this is typically https://api.vault.netvoyage.com
    Client Id: AP-MT00CP73
    Client Secret: DvMnrCCHfPCeVbyKqyrJ2MovRWy2k5Nu53mYx9aQb9p5EOOr
    Repository ID: Your NetDocuments Repository ID
    Example: AB-CDE1FGH2

  3. Click Next

  4. Optionally, enter the Cabinet ID of the NetDocuments cabinet you wish to crawl. If you do not enter an ID, all cabinets will be crawled where permissions are granted to Shinydocs.

  5. Click Start Analysis to begin the crawl.

  6. Congratulations, you have connected Shinydocs Pro to your NetDocuments repository! Your crawl will be added to the queue or will start crawling immediately

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.