This article relates to Smoothwall Browser for iPad, version 102.2 or later.
Symptoms
An alert similar to the following appears on the iPad:
Incorrect Smoothwall Configuration Some configuration information is incorrect. Please contact your administrator. Code: 6001
OK |
The main text of the alert will be consistent, but you might get different error code values. The alert may be shown several times during the first 24 hours after deployment. After 24 hours it will be shown once per day at most.
In all cases the problem is related to the Smoothwall Tenant ID that the iPad has been provisioned with, either via MDM, or manually on the iPad itself.
These are the current possible error code values:
Code | Description |
6001 | The Tenant ID you supplied does not match any tenants associated with the supplied Smoothwall Serial Number. |
6002 | A Tenant ID was not supplied, but the supplied Smoothwall Serial Number belongs to a multi-tenanted account. |
6003 | If you are a Monitoring (MMS) customer, a legacy OrgID might have been entered for the Tenant ID field. |
Effects
The software may seem to work correctly on a misconfigured iPad, but certain functionality will not work as expected due to the incorrect Tenant ID:
- Cloud Filter: any group-based policies will not be matched.
- Cloud Filter: Safeguarding Alerts will not work.
- Cloud Filter: the Realtime Log Viewer functionality in the Admin portal will not be able to find the iPad.
- Cloud Filter: access logs may not be accessible for the iPad.
- Monitoring: captures may not be available for the iPad.
Solution
In all of these cases, the solution is to ensure that the correct Smoothwall Tenant ID is specified.
If you are deploying via MDM, then ensure that the SmoothwallTenantID field is correctly specified in the per-app configuration and re-deploy. See Installing Cloud Filter for iOS.
If the app has been deployed without MDM and you entered the provisioning manually within the app itself, then you will need to delete the app off the iPad, reinstall it and re-enter provisioning with the correct Tenant ID.
Whether deployed by MDM or manually, if you are a Single-Tenanted customer then you should never enter a Tenant ID. Likewise, if you are Multi-Tenanted customer then you should always enter a Tenant ID.
Common Mistakes
- If you manually type the Tenant ID it can be very easy to mistype. Where possible you should copy and paste it from a reliable source.
- A Smoothwall Tenant ID is unrelated to a Microsoft Tenant ID, even though they share the same format. Do not enter a Microsoft Tenant ID nor any similar string that was not obtained from a Smoothwall system.