Bigleaf Networks Setup

Bigleaf Networks is an SD-WAN and internet-connectivity optimization platform. Once connected, Junto can look up a customer's SD-WAN sites and circuits, check live circuit health, and review Bigleaf's risk findings -- so the agent can answer "is the internet down or degraded at this site?" and triage Bigleaf alerts during a ticket.

This integration is read-only -- Junto reads status and inventory from Bigleaf but never changes any Bigleaf configuration.

Beta

The Bigleaf integration is currently in beta.

How Junto Connects

You connect Bigleaf once for your organization using an API token from your Bigleaf dashboard. After connecting, you map each Junto company to its Bigleaf company so the agent returns the right customer's sites and status.

Prerequisites

• A Bigleaf account with permission to generate an API token
• Admin access in Junto to configure integrations
• Your Junto companies already imported from your PSA (needed for company mapping)

Step 1: Generate an API Token in Bigleaf

1. Sign in to your Bigleaf dashboard.
2. Open the API token page.
3. Generate a token. Bigleaf provides two values as a pair:
   • Token Key -- used as the username.
   • Token Auth -- used as the password.
4. Copy both values and store them securely.

Step 2: Configure in Junto

1. In Junto, go to Settings → Integrations → Bigleaf.
2. Click Add Configuration and enter:
   • Token Key -- from Step 1.
   • Token Auth -- from Step 1. Both values are encrypted before storage.
3. Save, then use Test to verify the credentials.

Leave the configuration Active to keep it in use. You can toggle it off to pause the integration without deleting your credentials.

Step 3: Map Companies

Bigleaf's data isn't filtered by customer on its own, so Junto scopes results using your company mapping. Mapping is required for the agent to return a company's sites and status.

1. On the configuration, open Company mapping. Junto lists the Bigleaf companies your token can see.
2. Link each Junto company to its Bigleaf company.
3. Run auto-map to match companies by name, with exact and close-match suggestions.
4. Save mappings.

What the Agent Can Do

Once connected and mapped, the agent can answer connectivity questions for a company's SD-WAN environment. All Bigleaf capabilities are read-only, so none require approval.

Capability	Description	Risk Level
List Sites	List a company's SD-WAN sites with their circuits -- carrier, connection type (Fiber, Cable, Cellular), and bandwidth	Low
Get Site	View a site's full configuration: service plan, points of presence, and each circuit's carrier, type, bandwidth, and usage	Low
Get Site Status	A live health snapshot -- per-site, per-device, and per-circuit up / degraded / down state. The "is it down?" view	Low
List Site Risks	Bigleaf's current risk findings for a site -- the conditions behind Bigleaf's risk-alert emails, with recommended actions	Low

Troubleshooting

• Test fails with an authentication error -- Re-check the Token Key and Token Auth, and confirm the token is still active in your Bigleaf dashboard. Regenerate the token in Bigleaf and reconnect if needed.
• No companies listed for mapping -- Confirm the API token has permission to see your customer companies in Bigleaf. A token that's invalid, revoked, or lacking permission returns no companies.
• The agent can't find a site -- Confirm the company is mapped to the correct Bigleaf company (Step 3), and check the site name against List Sites.
• No Junto companies to map -- Import your companies from your PSA first, then return to company mapping.