Swif's Windows Custom CSP Policy feature provides administrators the flexibility to apply custom Configuration Service Provider (CSP) settings to Windows devices. Using this policy, you can define highly specific configurations beyond standard policy offerings.
Benefits of Using Custom CSP Policies
Greater Flexibility: Configure advanced Windows settings that aren't available through the standard Swif UI.
Precision Management: Define exact configurations required by your organization.
Enhanced Control: Apply complex CSP configurations directly via Swif.
Creating a Windows Custom CSP Policy
Follow these steps to create a Custom CSP Policy:
Log in to your Swif Console.
Navigate to Device Management > Policies.
Click Create Policy and select New Custom Policy.
Select Windows type
Provide a descriptive Policy Name and optional Description.
Configuring Custom CSP Settings
Each CSP setting includes:
Target Tag: Unique identifier for your CSP configuration.
SyncML Operation: Defines the operation to perform (
Add,Replace,Delete).Body Type: Format of the configuration (
bool,int,string,float,xml).Body: The actual CSP payload or value.
SyncML Operations:
Add: Adds a new configuration.
Replace: Updates an existing configuration.
Delete: Removes the configuration.
Example Configuration:
{ "cspCollections": [ { "tag": "./Vendor/MSFT/SharedPC/KioskModeUserTileDisplayText", "syncMLOperation": "Add", "bodyType": "string", "body": "Hello World!" } ] }This example adds a custom message displayed in Shared PC kiosk mode.
Important Considerations
Each CSP entry must have a unique Target Tag to prevent conflicts.
The SyncML Operation determines how the policy is applied; incorrect operations may cause policy errors.
Ensure the Body Type matches the format expected by the CSP.
Some CSP settings may not support all operations (e.g., some may support
AddandDelete, but notReplace).
Deploying Custom CSP Policies
After configuring your policy:
Click Assign to target specific devices or groups.
Choose the appropriate devices or groups, then click Save.
Your Custom CSP configurations will then be automatically applied by Swif.
Troubleshooting Common Issues
404 Errors: Occur when attempting to delete or replace CSP configurations that are not supported or do not exist.
405 Errors: Occur if the CSP setting does not support the operation you attempted (e.g., replacing non-replaceable configurations).
Need Further Assistance?
Visit the Swif Help Center or contact Swif Support.
Last Updated: March, 2025