SMB File Shares Onboarding

Use this method to connect to file share servers and scan accessible network shares. You can onboard manually through the UI or upload a JSON file with required fields.

This page describes both supported onboarding options: Manual Onboarding and JSON Upload.

---

Option 1 - Manual Onboarding

1. Create a service account

   Create a service account with read permissions over your file shares. Save the credentials for later.

2. Open Accounts & Integrations

   Log in to SailPoint Entro and go to Management → Accounts & Integrations.

3. Add new account

   Select Add new account and choose File Shares Scanning.

4. Enter credentials

   Enter the following credential details in the onboarding form:

   Field	Description
   Nickname	Name to display in SailPoint Entro for this file share
   Username	The service account name, including domain (e.g. myOrg.demo\johndoe)
   Password	The password for the service account
   File Share IP or Hostname	e.g. 183.12.13.13:445 or FILE‑SHARE.myOrg.demo:445 (ensure port 445 is included)
   Worker Group	Select your assigned Worker Group. If unsure, contact support@entro.security

5. Next

   Select Next.

6. Optional: Exclude shares

   On the 2^nd step, specify file shares to exclude from scanning.

   • Enter each file share name on the server to exclude.

   • Select Save when complete.

Option 2 - JSON Upload (Bulk Onboarding)

1. Create a service account

   Create a service account with read permissions over your shares. Save the credentials.

2. Open Accounts & Integrations

   Log in to SailPoint Entro → Management → Accounts & Integrations → Add new account → File Shares Scanning.

3. Choose JSON Upload

   Choose the JSON Upload option.

4. Select Worker Group

   Select your assigned Worker Group. If you are unsure, contact support@entro.security.

5. Review template

   Review the provided JSON template and example. Download it for editing.

6. Upload JSON

   Upload the edited JSON file in SailPoint Entro.

7. Save

   Select Save to complete onboarding.

JSON Fields

Field	Description
nickname	The file share name to be displayed in SailPoint Entro
user	Full username path (e.g. myOrg.demo\johndoe)
password	The service account password
url	The file share IP or hostname (e.g. 183.12.13.13:445)
ignore_shares	Array of share names to exclude from scanning

---

Example JSON for 3 Servers

smb-file-shares.json

[
  {
    "nickname": "ENVIRONMENT_NAME",
    "user": "USERNAME_PATH",
    "password": "PASSWORD",
    "url": "FILE_SHARE_IP_WITH_PORT_OR_HOSTNAME",
    "ignore_shares": [
      "FILESHARE_NAME", "FILESHARE_NAME", "FILESHARE_NAME"
    ]
  },
  {
    "nickname": "ENVIRONMENT_NAME",
    "user": "USERNAME_PATH",
    "password": "PASSWORD",
    "url": "FILE_SHARE_IP_WITH_PORT_OR_HOSTNAME",
    "ignore_shares": [
      "FILESHARE_NAME", "FILESHARE_NAME", "FILESHARE_NAME"
    ]
  },
  {
    "nickname": "ENVIRONMENT_NAME",
    "user": "USERNAME_PATH",
    "password": "PASSWORD",
    "url": "FILE_SHARE_IP_WITH_PORT_OR_HOSTNAME",
    "ignore_shares": [
      "FILESHARE_NAME", "FILESHARE_NAME", "FILESHARE_NAME"
    ]
  }
]

---