Skip to main content
Skip table of contents

Conax - Sample requests and responses

1. Definitions

1.1. Consumer mode

The packager acquires the content keys and the DRM signalization from the key server, which assumes the responsibility of generating the content keys and the key IDs.

In the request, the packager includes the content ID and the content type.

The key server generates the corresponding content key value and key id.

This is the only mode supported by the Conax API.

2. Nominal request

2.1. With DRM

LIVE request with WIDEVINE_CENC DRM

Request

XML 
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:v1="http://www.conax.com/ott/xsd/keyserver/v1">
   <soapenv:Header/>
   <soapenv:Body>
      <v1:GetDrmData>
         <v1:GetDrmDataRequest>          
            <v1:ContentId>CONAX-Live</v1:ContentId>          
            <v1:ContentType>LIVE</v1:ContentType>
            <v1:DrmId>WIDEVINE_CENC</v1:DrmId>
         </v1:GetDrmDataRequest>
      </v1:GetDrmData>
   </soapenv:Body>
</soapenv:Envelope>

Response

XML 
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <ns2:GetDrmDataResponse xmlns:ns2="http://www.conax.com/ott/xsd/keyserver/v1" xmlns="http://www.conax.com/cas/xsd/common-types/v1">
         <ns2:DrmDataResponse>
            <TransactionStatus>
               <StatusCode>OK</StatusCode>
            </TransactionStatus>
            <ns2:DrmData>
               <ns2:Key>FQtBgKdUQlj5djyO1LM/Bg==</ns2:Key>
               <ns2:KeyId>4SgSszGfTwGHEWu1kGlqVw==</ns2:KeyId>
               <ns2:ContentRef>CONAX-Live</ns2:ContentRef>
               <ns2:DrmHeaderData>
                  <ns2:DrmId>WIDEVINE_CENC</ns2:DrmId>
                  <ns2:Header>CAESEOEoErMxn08BhxFrtZBpalcaBUNvbmF4IgpDT05BWC1MaXZl</ns2:Header>
                  <ns2:DrmSystemId>edef8ba9-79d6-4ace-a3c8-27dcd51d21ed</ns2:DrmSystemId>
               </ns2:DrmHeaderData>
            </ns2:DrmData>
         </ns2:DrmDataResponse>
      </ns2:GetDrmDataResponse>
   </soap:Body>
</soap:Envelope>

LIVE request with FAIRPLAY_HLS DRM

Request

XML 
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:v1="http://www.conax.com/ott/xsd/keyserver/v1">
   <soapenv:Header/>
   <soapenv:Body>
      <v1:GetDrmData>
         <v1:GetDrmDataRequest>          
            <v1:ContentId>CONAX-FP</v1:ContentId>          
            <v1:ContentType>LIVE</v1:ContentType>                      
            <v1:DrmId>FAIRPLAY_HLS</v1:DrmId>
         </v1:GetDrmDataRequest>
      </v1:GetDrmData>
   </soapenv:Body>
</soapenv:Envelope>

Response

XML 
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Body>
        <ns2:GetDrmDataResponse xmlns:ns2="http://www.conax.com/ott/xsd/keyserver/v1" xmlns="http://www.conax.com/cas/xsd/common-types/v1">
            <ns2:DrmDataResponse>
                <TransactionStatus>
                    <StatusCode>OK</StatusCode>
                </TransactionStatus>
                <ns2:DrmData>
                    <ns2:Key>/cjatwNT9lLtjKVI6/GGzA==</ns2:Key>
                    <ns2:KeyId>PJF0ZuOkTEy1bNhh/+R/7Q==</ns2:KeyId>
                    <ns2:ContentRef>CONAX-FP</ns2:ContentRef>
                    <ns2:DrmHeaderData>
                        <ns2:DrmId>FAIRPLAY_HLS</ns2:DrmId>
                        <ns2:Header>skd://eyJDb250ZW50SWQiOiJDT05BWC1GUCIsIktleUlkIjoiM2M5MTc0NjYtZTNhNC00YzRjLWI1NmMtZDg2MWZmZTQ3ZmVkIiwiSVYiOiJBQUFBQUFBQUFBQUFBQUFBQUFBQUFBPT0ifQ==</ns2:Header>
                        <ns2:IV>AAAAAAAAAAAAAAAAAAAAAA==</ns2:IV>
                    </ns2:DrmHeaderData>
                </ns2:DrmData>
            </ns2:DrmDataResponse>
        </ns2:GetDrmDataResponse>
    </soap:Body>
</soap:Envelope>

VOD request with PLAYREADY_HLS DRM

Request

XML 
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:v1="http://www.conax.com/ott/xsd/keyserver/v1">
   <soapenv:Header/>
   <soapenv:Body>
      <v1:GetDrmData>
         <v1:GetDrmDataRequest>          
            <v1:ContentId>CONAX-Vod</v1:ContentId>          
            <v1:ContentType>VOD</v1:ContentType>                      
            <v1:DrmId>PLAYREADY_HLS</v1:DrmId>
         </v1:GetDrmDataRequest>
      </v1:GetDrmData>
   </soapenv:Body>
</soapenv:Envelope>

Response

XML 
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <ns2:GetDrmDataResponse xmlns:ns2="http://www.conax.com/ott/xsd/keyserver/v1" xmlns="http://www.conax.com/cas/xsd/common-types/v1">
         <ns2:DrmDataResponse>
            <TransactionStatus>
               <StatusCode>OK</StatusCode>
            </TransactionStatus>
            <ns2:DrmData>
               <ns2:Key>D0W0p/ZcLKmNH9n57z090A==</ns2:Key>
               <ns2:KeyId>0DV8AOipTjOiMsxxs8Gg6g==</ns2:KeyId>
               <ns2:ContentRef>CONAX-Vod</ns2:ContentRef>
               <ns2:DrmHeaderData>
                  <ns2:DrmId>PLAYREADY_HLS</ns2:DrmId>
                  <ns2:Header>conaxdrm:200:PFdSTUhFQURFUiB4bWxucz0iaHR0cDovL3NjaGVtYXMubWljcm9zb2Z0LmNvbS9EUk0vMjAwNy8wMy9QbGF5UmVhZHlIZWFkZXIiIHZlcnNpb249IjQuMC4wLjAiPjxEQVRBPjxQUk9URUNUSU5GTz48S0VZTEVOPjE2PC9LRVlMRU4-PEFMR0lEPkFFU0NUUjwvQUxHSUQ-PC9QUk9URUNUSU5GTz48TEFfVVJMPmh0dHBzOi8vY29ubmVjdC5jb25heC5jb20vbGljZW5zZS9wbGF5cmVhZHk8L0xBX1VSTD48TFVJX1VSTD5odHRwczovL2Nvbm5lY3QuY29uYXguY29tL2xpY2Vuc2UvcGxheXJlYWR5PC9MVUlfVVJMPjxLSUQ-QUh3MTBLbm9NMDZpTXN4eHM4R2c2Zz09PC9LSUQ-PENVU1RPTUFUVFJJQlVURVMgeG1sbnM9IiI-PENvbnRlbnRSZWY-Q09OQVgtVm9kPC9Db250ZW50UmVmPjwvQ1VTVE9NQVRUUklCVVRFUz48Q0hFQ0tTVU0-K3JkenhieG1BaFk9PC9DSEVDS1NVTT48L0RBVEE-PC9XUk1IRUFERVI-</ns2:Header>
               </ns2:DrmHeaderData>
            </ns2:DrmData>
         </ns2:DrmDataResponse>
      </ns2:GetDrmDataResponse>
   </soap:Body>
</soap:Envelope>

VOD request with CCA_CENC DRM

Request

XML 
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:v1="http://www.conax.com/ott/xsd/keyserver/v1">
   <soapenv:Header/>
   <soapenv:Body>
      <v1:GetDrmData>
         <v1:GetDrmDataRequest>          
            <v1:ContentId>CONAX-CCA</v1:ContentId>          
            <v1:ContentType>VOD</v1:ContentType>                      
            <v1:DrmId>CCA_CENC</v1:DrmId>
         </v1:GetDrmDataRequest>
      </v1:GetDrmData>
   </soapenv:Body>
</soapenv:Envelope>

Response

XML 
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Body>
        <ns2:GetDrmDataResponse xmlns:ns2="http://www.conax.com/ott/xsd/keyserver/v1" xmlns="http://www.conax.com/cas/xsd/common-types/v1">
            <ns2:DrmDataResponse>
                <TransactionStatus>
                    <StatusCode>OK</StatusCode>
                </TransactionStatus>
                <ns2:DrmData>
                    <ns2:Key>xiF8flfO0dsCPlKhn9aThA==</ns2:Key>
                    <ns2:KeyId>ylRzmlJ+S86EsKi2IO9dYA==</ns2:KeyId>
                    <ns2:ContentRef>CONAX-CCA</ns2:ContentRef>
                    <ns2:DrmHeaderData>
                        <ns2:DrmId>CCA_CENC</ns2:DrmId>
                        <ns2:Header>eyJjb250ZW50SWQiOiJDT05BWC1DQ0EiLCJrZXlJZCI6ImNhNTQ3MzlhLTUyN2UtNGJjZS04NGIwLWE4YjYyMGVmNWQ2MCJ9</ns2:Header>
                        <ns2:DrmSystemId>adb41c24-2dbf-4a6d-958b-4457c0d27b95</ns2:DrmSystemId>
                    </ns2:DrmHeaderData>
                </ns2:DrmData>
            </ns2:DrmDataResponse>
        </ns2:GetDrmDataResponse>
    </soap:Body>
</soap:Envelope>

2.2. Without DRM

LIVE request without DRM

Request

XML 
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:v1="http://www.conax.com/ott/xsd/keyserver/v1">
   <soapenv:Header/>
   <soapenv:Body>
      <v1:GetDrmData>
         <v1:GetDrmDataRequest>          
            <v1:ContentId>CONAX-Live-NoDRM</v1:ContentId>          
            <v1:ContentType>LIVE</v1:ContentType>
         </v1:GetDrmDataRequest>
      </v1:GetDrmData>
   </soapenv:Body>
</soapenv:Envelope>

Response

XML 
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <ns2:GetDrmDataResponse xmlns:ns2="http://www.conax.com/ott/xsd/keyserver/v1" xmlns="http://www.conax.com/cas/xsd/common-types/v1">
         <ns2:DrmDataResponse>
            <TransactionStatus>
               <StatusCode>OK</StatusCode>
            </TransactionStatus>
            <ns2:DrmData>
               <ns2:Key>N20B/Vg2E3HqpuvnB0gZAg==</ns2:Key>
               <ns2:KeyId>ML8YZ90gRPKjJnRomXedIQ==</ns2:KeyId>
               <ns2:ContentRef>CONAX-Live-NoDRM</ns2:ContentRef>
               <ns2:DrmHeaderData>
                  <ns2:DrmId>PLAYREADY_CENC</ns2:DrmId>
                  <ns2:Header>qAMAAAEAAQCeAzwAVwBSAE0ASABFAEEARABFAFIAIAB4AG0AbABuAHMAPQAiAGgAdAB0AHAAOgAvAC8AcwBjAGgAZQBtAGEAcwAuAG0AaQBjAHIAbwBzAG8AZgB0AC4AYwBvAG0ALwBEAFIATQAvADIAMAAwADcALwAwADMALwBQAGwAYQB5AFIAZQBhAGQAeQBIAGUAYQBkAGUAcgAiACAAdgBlAHIAcwBpAG8AbgA9ACIANAAuADAALgAwAC4AMAAiAD4APABEAEEAVABBAD4APABQAFIATwBUAEUAQwBUAEkATgBGAE8APgA8AEsARQBZAEwARQBOAD4AMQA2ADwALwBLAEUAWQBMAEUATgA+ADwAQQBMAEcASQBEAD4AQQBFAFMAQwBUAFIAPAAvAEEATABHAEkARAA+ADwALwBQAFIATwBUAEUAQwBUAEkATgBGAE8APgA8AEwAQQBfAFUAUgBMAD4AaAB0AHQAcABzADoALwAvAGMAbwBuAG4AZQBjAHQALgBjAG8AbgBhAHgALgBjAG8AbQAvAGwAaQBjAGUAbgBzAGUALwBwAGwAYQB5AHIAZQBhAGQAeQA8AC8ATABBAF8AVQBSAEwAPgA8AEwAVQBJAF8AVQBSAEwAPgBoAHQAdABwAHMAOgAvAC8AYwBvAG4AbgBlAGMAdAAuAGMAbwBuAGEAeAAuAGMAbwBtAC8AbABpAGMAZQBuAHMAZQAvAHAAbABhAHkAcgBlAGEAZAB5ADwALwBMAFUASQBfAFUAUgBMAD4APABLAEkARAA+AFoAeABpAC8ATQBDAEQAZAA4AGsAUwBqAEoAbgBSAG8AbQBYAGUAZABJAFEAPQA9ADwALwBLAEkARAA+ADwAQwBVAFMAVABPAE0AQQBUAFQAUgBJAEIAVQBUAEUAUwAgAHgAbQBsAG4AcwA9ACIAIgA+ADwAQwBvAG4AdABlAG4AdABSAGUAZgA+AEMATwBOAEEAWAAtAEwAaQB2AGUALQBOAG8ARABSAE0APAAvAEMAbwBuAHQAZQBuAHQAUgBlAGYAPgA8AC8AQwBVAFMAVABPAE0AQQBUAFQAUgBJAEIAVQBUAEUAUwA+ADwAQwBIAEUAQwBLAFMAVQBNAD4AdABOAG8AbABXAG8ATgB2AHkARABnAD0APAAvAEMASABFAEMASwBTAFUATQA+ADwALwBEAEEAVABBAD4APAAvAFcAUgBNAEgARQBBAEQARQBSAD4A</ns2:Header>
                  <ns2:DrmSystemId>9a04f079-9840-4286-ab92-e65be0885f95</ns2:DrmSystemId>
                  <ns2:LicenseServer>https://connect.conax.com/license/playready</ns2:LicenseServer>
               </ns2:DrmHeaderData>
               <ns2:DrmHeaderData>
                  <ns2:DrmId>WIDEVINE_CENC</ns2:DrmId>
                  <ns2:Header>CAESEDC/GGfdIETyoyZ0aJl3nSEaBUNvbmF4IhBDT05BWC1MaXZlLU5vRFJN</ns2:Header>
                  <ns2:DrmSystemId>edef8ba9-79d6-4ace-a3c8-27dcd51d21ed</ns2:DrmSystemId>
               </ns2:DrmHeaderData>
               <ns2:DrmHeaderData>
                  <ns2:DrmId>CCA_CENC</ns2:DrmId>
                  <ns2:Header>eyJjb250ZW50SWQiOiJDT05BWC1MaXZlLU5vRFJNIiwia2V5SWQiOiIzMGJmMTg2Ny1kZDIwLTQ0ZjItYTMyNi03NDY4OTk3NzlkMjEifQ==</ns2:Header>
                  <ns2:DrmSystemId>adb41c24-2dbf-4a6d-958b-4457c0d27b95</ns2:DrmSystemId>
               </ns2:DrmHeaderData>
            </ns2:DrmData>
         </ns2:DrmDataResponse>
      </ns2:GetDrmDataResponse>
   </soap:Body>
</soap:Envelope>

VOD request without DRM

Request

XML 
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:v1="http://www.conax.com/ott/xsd/keyserver/v1">
   <soapenv:Header/>
   <soapenv:Body>
      <v1:GetDrmData>
         <v1:GetDrmDataRequest>          
            <v1:ContentId>CONAX-VOD-NoDRM</v1:ContentId>          
            <v1:ContentType>VOD</v1:ContentType>
         </v1:GetDrmDataRequest>
      </v1:GetDrmData>
   </soapenv:Body>
</soapenv:Envelope>

Response

XML 
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Body>
        <ns2:GetDrmDataResponse xmlns:ns2="http://www.conax.com/ott/xsd/keyserver/v1" xmlns="http://www.conax.com/cas/xsd/common-types/v1">
            <ns2:DrmDataResponse>
                <TransactionStatus>
                    <StatusCode>OK</StatusCode>
                </TransactionStatus>
                <ns2:DrmData>
                    <ns2:Key>ahot9QB8avxKWI9R4rNqUw==</ns2:Key>
                    <ns2:KeyId>xKPuB78AToyELp3E30gEIg==</ns2:KeyId>
                    <ns2:ContentRef>CONAX-VOD-NoDRM</ns2:ContentRef>
                    <ns2:DrmHeaderData>
                        <ns2:DrmId>PLAYREADY_CENC</ns2:DrmId>
                        <ns2:Header>pgMAAAEAAQCcAzwAVwBSAE0ASABFAEEARABFAFIAIAB4AG0AbABuAHMAPQAiAGgAdAB0AHAAOgAvAC8AcwBjAGgAZQBtAGEAcwAuAG0AaQBjAHIAbwBzAG8AZgB0AC4AYwBvAG0ALwBEAFIATQAvADIAMAAwADcALwAwADMALwBQAGwAYQB5AFIAZQBhAGQAeQBIAGUAYQBkAGUAcgAiACAAdgBlAHIAcwBpAG8AbgA9ACIANAAuADAALgAwAC4AMAAiAD4APABEAEEAVABBAD4APABQAFIATwBUAEUAQwBUAEkATgBGAE8APgA8AEsARQBZAEwARQBOAD4AMQA2ADwALwBLAEUAWQBMAEUATgA+ADwAQQBMAEcASQBEAD4AQQBFAFMAQwBUAFIAPAAvAEEATABHAEkARAA+ADwALwBQAFIATwBUAEUAQwBUAEkATgBGAE8APgA8AEwAQQBfAFUAUgBMAD4AaAB0AHQAcABzADoALwAvAGMAbwBuAG4AZQBjAHQALgBjAG8AbgBhAHgALgBjAG8AbQAvAGwAaQBjAGUAbgBzAGUALwBwAGwAYQB5AHIAZQBhAGQAeQA8AC8ATABBAF8AVQBSAEwAPgA8AEwAVQBJAF8AVQBSAEwAPgBoAHQAdABwAHMAOgAvAC8AYwBvAG4AbgBlAGMAdAAuAGMAbwBuAGEAeAAuAGMAbwBtAC8AbABpAGMAZQBuAHMAZQAvAHAAbABhAHkAcgBlAGEAZAB5ADwALwBMAFUASQBfAFUAUgBMAD4APABLAEkARAA+AEIAKwA2AGoAeABBAEMALwBqAEUANgBFAEwAcAAzAEUAMwAwAGcARQBJAGcAPQA9ADwALwBLAEkARAA+ADwAQwBVAFMAVABPAE0AQQBUAFQAUgBJAEIAVQBUAEUAUwAgAHgAbQBsAG4AcwA9ACIAIgA+ADwAQwBvAG4AdABlAG4AdABSAGUAZgA+AEMATwBOAEEAWAAtAFYATwBEAC0ATgBvAEQAUgBNADwALwBDAG8AbgB0AGUAbgB0AFIAZQBmAD4APAAvAEMAVQBTAFQATwBNAEEAVABUAFIASQBCAFUAVABFAFMAPgA8AEMASABFAEMASwBTAFUATQA+AFoAeABNAGYAMABoADYAZwBQADkANAA9ADwALwBDAEgARQBDAEsAUwBVAE0APgA8AC8ARABBAFQAQQA+ADwALwBXAFIATQBIAEUAQQBEAEUAUgA+AA==</ns2:Header>
                        <ns2:DrmSystemId>9a04f079-9840-4286-ab92-e65be0885f95</ns2:DrmSystemId>
                        <ns2:LicenseServer>https://connect.conax.com/license/playready</ns2:LicenseServer>
                    </ns2:DrmHeaderData>
                    <ns2:DrmHeaderData>
                        <ns2:DrmId>WIDEVINE_CENC</ns2:DrmId>
                        <ns2:Header>CAESEMSj7ge/AE6MhC6dxN9IBCIaBUNvbmF4Ig9DT05BWC1WT0QtTm9EUk0=</ns2:Header>
                        <ns2:DrmSystemId>edef8ba9-79d6-4ace-a3c8-27dcd51d21ed</ns2:DrmSystemId>
                    </ns2:DrmHeaderData>
                    <ns2:DrmHeaderData>
                        <ns2:DrmId>CCA_CENC</ns2:DrmId>
                        <ns2:Header>eyJjb250ZW50SWQiOiJDT05BWC1WT0QtTm9EUk0iLCJrZXlJZCI6ImM0YTNlZTA3LWJmMDAtNGU4Yy04NDJlLTlkYzRkZjQ4MDQyMiJ9</ns2:Header>
                        <ns2:DrmSystemId>adb41c24-2dbf-4a6d-958b-4457c0d27b95</ns2:DrmSystemId>
                    </ns2:DrmHeaderData>
                </ns2:DrmData>
            </ns2:DrmDataResponse>
        </ns2:GetDrmDataResponse>
    </soap:Body>
</soap:Envelope>


JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.

Contact Support Close