Package Installation Guide

Guide to install the Salesforce Integration Package and Sync with Kernel

Kernel Salesforce Integration - Installation & Setup Guide

📋 Prerequisites

• Salesforce System Administrator access in your target org

• Your Kernel Tenant ID & API Key

• Package Version: Latest v2.0 release

🚀 Quickstart Guide

🔗 Step 1: Install the Kernel Package

Open the installation link provided by Kernel:

https://{YOUR_ORG_DOMAIN}/packaging/installPackage.apexp?p0=04tgL0000007MS1QAM

Select installation options:

• Install for: Admins Only

• You will be prompted to grant the Kernel API access to the user & permission set you create. (This allows us to sync your CRM to Kernel and we only have access based on Permission Sets)

• Click Install

• Wait for "Install Complete" confirmation

Verify installation:

• Navigate to Setup → Installed Packages

• Confirm "Kernel SF Connected App" appears with status "Installed"

Open App Launcher (9-dot grid icon)

1. Select "Kernel Integration" app

2. Click the "Kernel Setup" tab

👤 Step 2: Create Integration User

The integration user is a dedicated System Administrator account that Kernel uses to access your Salesforce data securely.

Creating the User:

1. In the Kernel Setup tab, locate the Integration User panel

2. Review default settings:

   • Email: [email protected]

   • First Name: Kernel

   • Last Name: Integration

   • Username Prefix: kernel-integration

3. Click "Create Integration User"

   • The system creates a unique username: kernel-integration@{OrgId}.kernel.ai

   • A password reset email is sent to the specified email address

   • The user is created with System Administrator profile

   
4. Verify user creation:

   • You'll see a success message with the user details

   

Permission Set Assignment:

Object	Read	View-All	Edit
Account	✓ (All or select fields)	✓ (All or select fields)	✓ (Kernel fields)
Lead Required if you don’t use accounts	✓ (All or select fields)	✓ (All or select fields)	✓ (Kernel fields)
Contact	✓ (All or select fields)	✓ (All or select fields)
Opportunity	✓ (All or select fields)	✓ (All or select fields)
Task	✓ (All or select fields)	✓ (All or select fields)

The system automatically assigns the Kernel_SF_Connected_App_PermissionSet to the integration user, which provides:

• API access

• Read access to standard and custom objects

• Access to Kernel-specific settings

You can also choose to assign a your own custom permission set

🔗 Step 3: Authorize Kernel Connection

Before authorizing the connection, you need your Kernel API credentials (We will provide these):

• Tenant ID: Your unique organization identifier (e.g., tenant_abc123xyz)

• API Key: Your secure API key for authentication

1. In the Kernel Setup tab, locate the Authorize Access panel

2. Enter your Kernel credentials:

   
3. Click "Authorize Kernel"

   

🔧 Configuration Options

Custom Permission Sets

By default, Kernel uses its standard permission set. For custom requirements:

1. In the Permission Sets panel:

   • Select "Choose Custom Permission Sets"

   • Select your organization's permission sets

   • Click "Save"

2. The selected permission sets will be assigned to the integration user

🔒 Security & Compliance

OAuth Scopes

The Kernel Connected App requests these OAuth scopes:

• api - Access and manage your data

• refresh_token - Perform requests while you're offline

• openid - Access unique user identifier

• profile - Access basic profile information

• email - Access email address

Data Access

• Access is logged and auditable

• All API calls are tracked in Setup Audit Trail

• Data transmission is encrypted via TLS 1.2+

🚨 Troubleshooting

Common Issues and Solutions

Issue	Solution
App not visible in App Launcher	Assign the Kernel Integration app to your user profile via Setup → App Manager
"Authorize" button disabled	Ensure Tenant ID and API Key are entered correctly
Permission Set assignment failed	Check if integration user is active; manually assign via Setup → Permission Sets

🔄 Managing the Integration

Revoking Access

To temporarily or permanently disconnect:

1. Revoke OAuth Token:

   • Setup → Connected Apps OAuth Usage

   • Find "Kernel SF Connected App"

   • Click "Revoke"

2. Deactivate Integration User:

   • Setup → Users

   • Find the kernel-integration user

   • Uncheck "Active"

   • Click Save

Re-establishing Connection

1. Reactivate the integration user (if deactivated)

2. Return to Kernel Setup tab

3. Click "Authorize Kernel" again

4. Complete OAuth flow

Updating Credentials

If your Kernel API credentials change:

1. Obtain new credentials from Kernel

2. In Salesforce Kernel Setup:

   • Click "Disconnect" (if connected)

   • Enter new Tenant ID and API Key

   • Click "Authorize Kernel"

   • Complete OAuth flow

📞 Support

Getting Help

• Email: [email protected]

• Include in your support request:

  • Organization ID

  • Environment type (Sandbox/Production)

  • Integration user username

  • Error messages or screenshots

  • Sync job IDs (from Kernel Portal)

📦 Package Components Reference

What Gets Installed

Component	Purpose
Connected App	OAuth 2.0 authentication with Kernel
Lightning App	Kernel Integration application container
Custom Tab	Kernel Setup configuration interface
Apex Classes	Integration logic and API handlers
LWC Components	User interface for setup and management
Permission Set	Default access configuration
Custom Settings	Store integration configuration
Static Resources	Application icons and assets

Version History

• v2.0.1 - Current release

  • System Administrator profile by default

  • Simplified user creation flow

  • Enhanced permission management

  • Improved error handling

---

Last Updated: Version 2.0.1 For the latest updates, visit docs.kernel.ai