Initial Setup and Configuration

This guide walks you through the initial setup process for the Partner Fleet In-App Marketplace.

Marketplace Provisioning

Partner Fleet will provision your In-App marketplace instance. Once provisioned, you'll find your Marketplace configuration panel at:

Settings > Marketplaces > In-App Marketplace

In this section, you can customize your marketplace experience by configuring:

• Filters
• Taxonomies
• Sort options
• Layout styles
• Customer design elements

Domain Configuration

Domain Whitelisting

Before implementation, provide Partner Fleet with:

• All domains where the marketplace will be embedded
• Include all environment URLs:
  • Development
  • Staging
  • Production
  • Any additional test environments

⚠️

Important

This is a critical security step. Partner Fleet implements Content Security Policy (CSP) restrictions to ensure your marketplace can only be embedded on approved domains.

In-App Domain Setup

Before go-live, you'll need to:

1. Set up a CNAME to the marketplace on your own domain
2. Example: inapp.company.com

📝

Note

This ensures all data is served by your domain and avoids any cross-domain issues.

JWT Secret Configuration

Create Identity Provider

1. Navigate to:
   Text

   Settings > Advanced > Identity Providers

2. Create a new provider:
   • Select type: "Embedded"
   • Configure a secure shared secret

🔒

Security Note

The shared secret will be used for:

• Partner Fleet: JWT validation
• Your system: JWT encryption

Custom Fields Configuration

Before implementing JWT authentication, set up custom fields that will drive dynamic marketplace behavior:

1. Navigate to:

   Text

   Settings > Advanced > Custom Fields

2. Create fields for user-level data:

   • User type
   • Region
   • Role

3. Create fields for account-level data:

   • Tier
   • Status
   • Industry

💡

Tip

Only create fields that will be used for dynamic marketplace behavior to keep the JWT payload efficient.

Validation Checklist

• Marketplace configuration section is accessible in Settings
• All intended domains have been provided to Partner Fleet
• CNAME has been configured
• JWT Identity Provider has been created
• Shared secret has been securely stored
• Custom fields have been configured

Troubleshooting

Common setup issues:

• Can't access marketplace configuration: Verify your Partner Fleet permissions
• Domain not working: Check CNAME configuration
• CSP errors: Ensure all domains are whitelisted