Errors from License server
When the video player connects to license server at license.vdocipher.com, the server can return an error response. The error response tells a unique code for the failure cause and a message that can be displayed to the end-user as a possible next step, if any. The 4-digit code can be looked up in the below table to understand more about the problem.
| Code | Category | Description | Message to end-user |
|---|---|---|---|
| 2011 | Parse | license unwrapping failed | |
| 2012 | Parse | unsupported tech | |
| 2013 | Restrictions | time expired | |
| 2014 | Restrictions | Domain not allowed | |
| 2015 | Restrictions | IP or region blocked | not allowed in your region or network |
| 2017 | Parse | authentication token missing | |
| 2020 | Verify | License hash does not match | License verification failed |
| 2021 | Widevine | widevine license creation failed due to ACCESS_DENIED | Update browser/OS to watch video |
| 2022 | Widevine | widevine license request failed | License creation failed |
| 2023 | Restrictions | time expired | |
| 2024 | Lookup | invalid license rules | |
| 2025 | Lookup | content id mismatch | |
| 2026 | Lookup | content id not found | |
| 2027 | Lookup | API key used to generate license URL not valid | Key id not found |
| 2028 | Lookup | license webhook failed | |
| 2029 | SafetyNet | android attestation response not received | |
| 2030 | SafetyNet | verification response for android safetyNet could not be parsed | |
| 2031 | SafetyNet | android package name mismatch | |
| 2032 | SafetyNet | nonce repeated | |
| 2033 | SafetyNet | integrity failed | |
| 2034 | SafetyNet | cts match failed | |
| 2035 | SafetyNet | incorrect nonce | |
| 2036 | SafetyNet | incorrect re-verify attestation string | |
| 2037 | SafetyNet | apkDigestSha256 verification failed | App could not be verified |
| 2038 | SafetyNet | apkCertificateDigestSha256 verification failed | App could not be verified |
| 2039 | SafetyNet | Internal error | |
| 2041 | Parse | content info could not be parsed | |
| 2042 | Widevine | widevine CDM blocked by request |
caution
If you are using shaka-player, it has its own set of 4-digit error codes. These are different set of errors generated from the license server. Your analytics data-collection should be able to differentiate and keep these two in different fields to avoid confusion.